दस्तावेज़

वोट इनाम (Votifier)

जब कोई आपकी लिस्टिंग पर वोट करता है, MineBuff तुरंत आपके Minecraft सर्वर को बता सकता है ताकि आपका इनाम प्लगइन आइटम, रैंक, या कुंजी दे सके।

खिलाड़ी वोट वे आपका MineBuff वोट पेज खोलते हैं और अपना Minecraft नाम दर्ज करते हैं।
हम आपके सर्वर को सूचित करते हैं MineBuff आपके Votifier पोर्ट से कनेक्ट होता है और वोट डिलीवर करता है।
इनाम सक्रिय करें NuVotifier / क्लासिक Votifier / GAListener (या समान) इनाम को संभालता है।

इसे चार चरणों में सेट करें

अपने Minecraft सर्वर पर Votifier इंस्टॉल करें
क्लासिक Votifier या NuVotifier का उपयोग करें। फ़ायरवॉल / होस्ट पैनल में पोर्ट 8192 (या आपका चयनित पोर्ट) खोलें ताकि सार्वजनिक इंटरनेट इसे पहुँच सके।
अपनी कुंजी या टोकन कॉपी करें
v1: plugins/Votifier/rsa/public.key (या NuVotifier rsa/public.key) पेस्ट करें। v2: NuVotifier config.yml से एक टोकन कॉपी करें (अकसर डिफ़ॉल्ट)।
इसे अपनी लिस्टिंग पर सक्षम करें
डैशबोर्ड → सर्वर संपादित करें → Votifier। फॉरवर्डिंग चालू करें, होस्ट सेट करें (अपना Java IP इस्तेमाल करने के लिए खाली छोड़ दें), पोर्ट, और प्रोटोकॉल, फिर की/टोकन पेस्ट करें और सहेजें।
एक टेस्ट वोट भेजें
उसी फॉर्म पर “Send test vote” का उपयोग करें। अगर यह काम करता है, तो असली वोट भी काम करेंगे।

ऑटो (सिफारिश की गई)

जब चैलेंज + टोकन उपलब्ध हो तो NuVotifier v2 चुनता है; अन्यथा v1 RSA पर वापस जाता है।

v1 — RSA की

क्लासिक Votifier और NuVotifier RSA। सार्वजनिक कुंजी फ़ाइल की सामग्री की आवश्यकता है।

v2 — टोकन

NuVotifier HMAC टोकन config.yml से। यदि आप पहले से NuVotifier का उपयोग करते हैं तो तेज़ और सरल।

इनाम प्लगइन्स जो सूची साइट द्वारा फ़िल्टर करते हैं उन्हें सेवा नाम “MineBuff” की अनुमति होनी चाहिए। अगर डिलीवरी असफल हो जाती है, तो साइट वोट अभी भी गिना जाएगा — अपने फ़ायरवॉल और प्रमाण-पत्र जांचें।

डैशबोर्ड खोलें सर्वर कैसे जोड़ें

वोट जाँच API

पूछें “क्या इस IP ने आज पहले ही मेरे सर्वर के लिए वोट किया है?” मुफ़्त, सार्वजनिक, कोई API कुंजी नहीं।

यह वोट नहीं डालता

खिलाड़ी फिर भी MineBuff वोट पृष्ठ पर वोट करते हैं। ये URL केवल यह पढ़ते हैं कि आज के लिए पहले से ही कोई वोट मौजूद है या नहीं (UTC)।

GET

सादा पाठ

सरल प्लगइन्स के लिए सबसे अच्छा — पूरा उत्तर केवल एक अक्षर है।

https://minebuff.com/api/vote/{slug}/{ip}

1: आज पहले ही वोट किया जा चुका है
0: अभी तक वोट नहीं किया गया (या अज्ञात / अप्रकाशित सर्वर)

उदाहरण curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

JSON

वही उत्तर, साथ ही उन्होंने कब वोट किया और दैनिक रीसेट तक कितना समय बचेगा।

https://minebuff.com/api/vote/{slug}/{ip}/json

फ़ील्ड	अर्थ
`vote`	“1” या “0” (स्ट्रिंग्स) — आज वोट किया या नहीं।
`voted_at`	UTC आज के वोट का समय, या शून्य।
`reset_at_midnight`	हमेशा सही — दैनिक वोट-चेक विंडो 00:00 UTC पर रीसेट होती है (रैंकिंग टोटल अलग हैं और लगभग मासिक रूप से रीसेट होते हैं)।
`time_until_next_vote`	अगले UTC मध्यरात्रि तक के सेकंड यदि उन्होंने पहले ही वोट दिया है; अन्यथा 0।

उदाहरण

{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

URL में क्या डालें

यूआरएल में	अर्थ
`{slug}`	आपकी सर्वर का स्लग लिस्टिंग URL से (जैसे /servers/your-slug)।
`{ip}`	खिलाड़ी का IP पता। हम इसे हैश करते हैं; प्रति IP प्रति सर्वर प्रति UTC दिन एक ही वोट।

ब्राउज़र से भी काम करता है (CORS)। अज्ञात सर्वर 0 सादे टेक्स्ट में लौटाते हैं, या HTTP 404 JSON के साथ error server_not_found।

वोट नियम

एक छोटा चेकलिस्ट ताकि आपका प्लगइन टाइमिंग हमारे साथ मेल खाए।

आप प्रति सर्वर प्रति IP प्रत्येक UTC दिन (00:00 UTC) एक बार वोट कर सकते हैं। रैंकिंग वोट टोटल लगभग महीने में एक बार रीसेट होते हैं।
एक IP पते पर प्रति प्रकाशित सर्वर प्रति UTC दिन एक वोट।
वोट के लिए MineBuff फॉर्म पर एक Minecraft उपयोगकर्ता नाम की आवश्यकता होती है (Votifier के लिए आवश्यक)।
चेक API कभी भी वोट नहीं बनाता; यह केवल आज की स्थिति की रिपोर्ट करता है।

मदद

सामान्य समस्याएं जब पुरस्कार या API सही तरीके से काम नहीं करते।

टेस्ट वोट असफल होता है या गेम में कुछ भी नहीं आता

पुष्टि करें कि पोर्ट 8192 (या आपका पोर्ट) इंटरनेट के लिए खुला है, होस्ट एक पहुंच योग्य पते से मेल खाता है, और कुंजी/टोकन प्लगइन फ़ाइलों के साथ बिल्कुल मेल खाता है (कोई अतिरिक्त जगह नहीं)।

मुझे कौन सा प्रोटोकॉल चुनना चाहिए?

ऑटो से शुरू करें। यदि आपके पास केवल NuVotifier टोकन है तो v2 का उपयोग करें। यदि आपके पास केवल RSA सार्वजनिक कुंजी है तो v1 का उपयोग करें।

API हमेशा 0 लौटाता है

जांचें कि लिस्टिंग प्रकाशित है, स्लग सटीक है, और आप खिलाड़ी का वास्तविक IP पास कर रहे हैं (127.0.0.1 नहीं, जब तक कि उन्होंने उसी मशीन से मतदान न किया हो)।

क्या विफल Votifier डिलीवरी वोट रद्द कर देती है?

नहीं। MineBuff वोट अभी भी गिना जाता है। कनेक्टिविटी ठीक करें और डैशबोर्ड टेस्ट वोट फिर से आजमाएं।

क्या मैं API के माध्यम से वोट डाल सकता हूँ?

नहीं। वोट सार्वजनिक वोट पृष्ठ पर डाले जाते हैं। API केवल आज के वोट की जांच के लिए पढ़ने योग्य है।