Scoreboards Documentation
Everything you need to create and manage Discord leaderboards
- Bot जोड़ें — होमपेज पर दिए गए इनवाइट लिंक से Scoreboards को अपने Discord server में बुला लीजिए।
- Setup wizard चलाएँ —
/get startedसे leaderboard का टाइप चुनिए, नाम दीजिए और उसे किसी channel में पोस्ट कर दीजिए। Point, Highscore और Time boards कुछ नमूना एंट्रियों के साथ शुरू होते हैं ताकि आप board को चलते हुए देख सकें; पहला असली score आते ही वे ग़ायब हो जाती हैं। - Roles तय करें — dashboard खोलकर <arg>bot permission</arg> role (जो leaderboards मैनेज कर सकें) और <arg>validator</arg> role (जो submissions approve कर सकें) सेट कीजिए।
- पहला leaderboard बनाएँ —
/scoreboard createसे leaderboard बनाइए। नाम, टाइप और क्रम चुन लीजिए। - इसे दिखाएँ — किसी channel में
/scoreboard showचलाइए और submit तथा पेज बदलने वाले बटनों के साथ leaderboard वहीं पोस्ट हो जाएगा।
/scoreboard create से leaderboard बनाते समय इन छह टाइप में से एक चुनिए:
Classic
पॉइंट्स एक चलते हुए जोड़ में जुड़ते या घटते रहते हैं। जहाँ score जुड़ता जाता है, वहाँ यही सबसे बढ़िया है।
Highscore
सिर्फ़ हर खिलाड़ी का अपना सबसे बढ़िया score रखा जाता है। इससे कम वाले पुराने scores अपने आप हट जाते हैं।
Time (Speedrun)
समय 00:00:00 (सौवाँ हिस्सा) या 00:00:000 (मिलीसेकंड) में भेजें — board किस फ़ॉर्मैट में दिखाए, यह dashboard की सेटिंग है, और नए boards डिफ़ॉल्ट रूप से मिलीसेकंड लेते हैं। सबसे तेज़ वाले को ऊपर रखना हो तो बढ़ते क्रम में, और सबसे लंबे को ऊपर रखना हो तो घटते क्रम में सेट कीजिए।
ELO - Ranked
मुक़ाबले वाला ELO rating सिस्टम — 1v1 या 2v2 से 8v8 तक की टीमें। Match का नतीजा भेजिए और हर खिलाड़ी की rating अपने आप अपडेट हो जाएगी।
Rating
तस्वीरें भेजिए और community उन्हें 1–10 स्टार देती है। सब वोटों का औसत ही score बनता है। आर्ट कॉन्टेस्ट और क्रिएटिव चैलेंज के लिए एकदम सही।
League
फ़ुटबॉल, क्रिकेट, बास्केटबॉल और FIFA जैसे खेलों के लिए मैच-दर-मैच पॉइंट्स। जीत/ड्रॉ/हार पर कितने पॉइंट्स मिलें यह आप तय करते हैं (डिफ़ॉल्ट 3/1/0), साथ में match का स्कोर भी (जैसे 3-1)।
Leaderboard मैनेज करना
| Command | क्या करता है | किसे इजाज़त है |
|---|---|---|
/scoreboard create | नाम, टाइप, क्रम और कुछ ज़रूरी सेटिंग्स के साथ नया leaderboard बनाता है | Admin / Bot permission |
/scoreboard show | इसी channel में leaderboard को बटनों के साथ पोस्ट करता है | Admin / Bot permission |
/scoreboard settings | इस scoreboard की सेटिंग्स (क्रम, किसे दिखे, headers, व्यू मोड, ELO सेटअप वग़ैरह) के लिए dashboard खोलता है | Admin / Bot permission |
/scoreboard delete | Leaderboard और उससे जुड़ा सारा डेटा हमेशा के लिए मिटा देता है (पहले पुष्टि माँगता है) | Admin / Bot permission |
/scoreboard season end | आख़िरी standings संभालता है, पोडियम पोस्ट करता है और अगले season के लिए board रीसेट कर देता है (पहले पुष्टि माँगता है) | Admin / Bot permission |
/import | CSV फ़ाइल से leaderboard में scores भरता है (किसी दूसरे bot या स्प्रेडशीट से आ रहे हों तो) | Admin / Bot permission |
Score और match भेजना
| Command | क्या करता है | किसे इजाज़त है |
|---|---|---|
/submit | किसी भी leaderboard पर भेजने के लिए। टाइप के हिसाब से bot अगला सही क़दम खोल देता है — score का modal (Classic/Highscore/Time), खिलाड़ी + विजेता चुनने वाला पिकर (ELO), खिलाड़ी + score वाला पिकर (League), या नाम का modal (Rating, जिसमें तस्वीर slash command के साथ लगती है)। टीम वाले board पर पिकर हर तरफ़ की पूरी टीम माँगते हैं। | सभी |
/set | किसी खिलाड़ी का score या ELO rating ख़ुद सेट करता है | Admin / Bot permission |
/adjust | किसी खिलाड़ी के score में कोई वैल्यू जोड़ता या घटाता है (घटाने के लिए माइनस में लिखें) | Admin / Bot permission |
/player remove | किसी खिलाड़ी को leaderboard से हटाता है | Admin / Bot permission |
सेटअप
| Command | क्या करता है | किसे इजाज़त है |
|---|---|---|
/get started | पहली बार सेटअप के लिए setup wizard खोलता है | Admin |
/help | सारे विषयों के साथ मदद की डॉक्यूमेंटेशन खोलता है | सभी |
भेजने के दो रास्ते हैं:
/submitचलाइए और leaderboard चुन लीजिए। Leaderboard के टाइप के हिसाब से bot सही modal या फ़्लो खोल देता है — Classic/Highscore/Time के लिए score डालने का बॉक्स, ELO के लिए खिलाड़ी + विजेता चुनने वाला पिकर, League के लिए खिलाड़ी + score वाला पिकर, या Rating के लिए नाम का बॉक्स (तस्वीर slash command के साथ लगाइए)। टीम वाले leaderboard पर पिकर एक खिलाड़ी की जगह हर तरफ़ की पूरी टीम चुनने को कहते हैं।- पोस्ट किए गए leaderboard मैसेज पर Submit बटन दबाइए — वही submission फ़्लो खुल जाएगा।
जाँच कैसे होती है
- Submission उस log channel में पोस्ट हो जाती है जो आपने सेट किया है (अगर सेट किया हो)।
- कोई validator या admin Approve या Reject दबाता है।
- Reject होने पर भेजने वाले को DM में वजह मिल जाती है।
- Approve होते ही leaderboard तुरंत अपडेट हो जाता है।
ऑटो-मंज़ूरी
हर leaderboard पर तय किया जा सकता है कि submissions कितनी देर बाद अपने आप approve हो जाएँ: बंद, तुरंत, 1 घंटा, 3 घंटे, 24 घंटे, 3 दिन या 7 दिन। ELO leaderboards पर डिफ़ॉल्ट 24 घंटे है।
Score रद्द करना
Admins और validators पहले से approve हुए score को भी रद्द कर सकते हैं — submission वाले मैसेज पर राइट-क्लिक करके "Cancel Score/Match" चुनिए। इससे score वाला बदलाव पलट जाता है, और रद्द करने की वजह लिखनी पड़ती है।
ELO - Ranked वाला leaderboard खिलाड़ियों को ELO rating सिस्टम से rank करता है — 1v1 में भी और हर तरफ़ आठ खिलाड़ियों तक की टीमों में भी।
यह कैसे काम करता है
- हर खिलाड़ी एक तय शुरुआती ELO से शुरू करता है (डिफ़ॉल्ट: 1200)।
- Match का नतीजा जीत, हार या ड्रॉ हो सकता है।
- Ratings 32 के K-फ़ैक्टर से निकाली जाती हैं।
- मंज़ूरी मिलते ही हर खिलाड़ी की rating एक साथ अपडेट हो जाती है।
टीम matches (2v2 – 8v8)
ELO और League leaderboards पर टीम का साइज़ पक्का किया जा सकता है — leaderboard बनाते समय चुन लीजिए, या बाद में dashboard में Match format के नीचे बदल दीजिए। फिर 3v3 वाले leaderboard पर हर match में तीन-तीन खिलाड़ी होंगे, और leaderboard फिर भी खिलाड़ियों को अलग-अलग rank करेगा।
ELO में हर टीम का अपेक्षित नतीजा उसकी औसत rating से निकलता है, और जो बदलाव आता है वह उस टीम के हर खिलाड़ी पर लगता है — यानी मज़बूत टीम को हराने पर जीतने वाली तरफ़ के सबको बराबर फ़ायदा मिलता है। League में जीतने वाली टीम के हर खिलाड़ी को जीत के पॉइंट्स मिलते हैं और पूरी हारने वाली टीम को हार के।
Matchmaking queue (बीटा)
अगर leaderboard पर queue बटन चालू है, तो खिलाड़ी उसे दबाकर matchmaking queue में लग सकते हैं। सिस्टम एक-सी ELO वाले खिलाड़ियों को जोड़ता है और ज़रूरत पड़ने पर दायरा धीरे-धीरे बढ़ाता जाता है। Match बनते ही उसके लिए एक thread बन जाता है जिसमें community के वोटिंग बटन होते हैं। 5 मिनट में match न मिले तो queue की एंट्री ख़त्म हो जाती है।
टीम वाले leaderboard पर queue तब तक इंतज़ार करती है जब तक दोनों तरफ़ के लिए पूरे खिलाड़ी न हो जाएँ — 3v3 के लिए छह — और फिर उन्हें ऐसे दो हिस्सों में बाँट देती है कि दोनों की औसत rating जितनी हो सके उतनी पास रहे, यानी सबसे मज़बूत और सबसे कमज़ोर खिलाड़ी आमने-सामने पड़ें। सबको Ready दबाना होता है; कोई न दबाए तो वह बाहर हो जाता है और बाक़ी सब अपनी जगह बचाकर वापस queue में चले जाते हैं।
हर टीम को अपना voice channel मिलता है, ताकि आप बिना विरोधी के सुने रणनीति बना सकें — आपको सिर्फ़ अपनी टीम का channel दिखता है और उसी में आप जा सकते हैं। Match ख़त्म होते ही दोनों channels हट जाते हैं। नतीजा तभी पक्का होता है जब दोनों टीमों का बहुमत उसे वोट दे (3v3 में तीन में से दो), यानी कोई टीम अकेले अपनी जीत घोषित नहीं कर सकती; इसके अलावा जो भी हो, वह विवाद बन जाता है जिसे validator सुलझाता है।
पक्की टीमें
टीम साइज़ वाला ELO या League leaderboard fixed teams मोड में भी चल सकता है (dashboard में Match format के बग़ल में यह टॉगल है)। नाम वाली पक्की टीमें leaderboard के Team sign-up बटन से एक बार रजिस्टर होती हैं — नाम चुनिए, फिर टीम चुनिए, जिसमें टीम साइज़ के ऊपर दो रिज़र्व खिलाड़ी तक रखे जा सकते हैं। फिर leaderboard ख़ुद टीमों को rank करता है: ELO board पर हर टीम की अपनी rating होती है और मज़बूत टीम को हराने पर ज़्यादा मिलता है; League board पर टेबल टीमों को पॉइंट्स से rank करती है, बिलकुल असली स्पोर्ट्स लीग की तरह। League की पक्की टीमें अपने matches /submit से दर्ज करती हैं — नीचे बताई गई matchmaking queue सिर्फ़ ELO के लिए है।
टीम का कोई भी मेंबर Queue दबाए तो पूरी टीम queue में लग जाती है और सबको DM चला जाता है। जोड़ी टीम की rating के हिसाब से टीम बनाम टीम बनती है, और ready-check ही लाइनअप भी तय कर देता है: हर टीम में जो पहले टीम साइज़ जितने खिलाड़ी Ready दबाते हैं वही खेलते हैं, बाक़ी उस match में बाहर बैठते हैं। नतीजे पर वही खिलाड़ी वोट करते हैं जो खेले, और वही दोनों तरफ़ के बहुमत वाला नियम लागू रहता है।
League leaderboard खिलाड़ियों को matches में जमा हुए पॉइंट्स के हिसाब से rank करता है। फ़ुटबॉल, क्रिकेट, बास्केटबॉल, फ़ुटसल, हॉकी — और हर उस 1v1 या टीम मुक़ाबले के लिए यही सही फ़ॉर्मैट है जहाँ season की टेबल ही आख़िरी सच होती है।
यह कैसे काम करता है
/submitसे match भेजिए — bot दोनों तरफ़ और दोनों का score पूछता है (जैसे 3 और 1)।- जिसका score ज़्यादा वही जीता; बराबर हो तो ड्रॉ।
- जीतने वाली तरफ़ को points_win, हारने वाली को points_loss और ड्रॉ में दोनों को points_draw मिलते हैं। टीम वाली league में उस तरफ़ के हर खिलाड़ी को वही पॉइंट्स मिलते हैं।
- Leaderboard खिलाड़ियों को कुल पॉइंट्स से rank करता है; जीत/ड्रॉ/हार की गिनती अलग से रखी जाती है।
डिफ़ॉल्ट पॉइंट्स
नई leagues में डिफ़ॉल्ट 3 / 1 / 0 है (1994 से चला आ रहा FIFA का तरीक़ा)। तीनों वैल्यू हर leaderboard के लिए dashboard से बदली जा सकती हैं। हॉकी के लिए 2 / 1 / 0, रग्बी के लिए 4 / 2 / 0, या अपने खेल के हिसाब से जो ठीक लगे वह रख लीजिए।
Match भेजना
वेबसाइट पर leaderboard खोलिए और Submit दबाइए — दोनों तरफ़ और match का score डाल दीजिए। Discord में /submit वही फ़ॉर्म खोलता है। एक ही खिलाड़ी दोनों तरफ़ हो या score माइनस में हो, तो submission वहीं रोक दी जाती है।
टीम leagues
League leaderboard पर टीम का साइज़ 2v2 से 8v8 तक पक्का किया जा सकता है — बनाते समय, या बाद में dashboard में Match format के नीचे। टेबल फिर भी खिलाड़ियों को अलग-अलग rank करती है: जीतने वाली तरफ़ के हर खिलाड़ी को जीत के पॉइंट्स मिलते हैं, पूरी हारने वाली तरफ़ को हार के, और match का score हर खिलाड़ी के लिए किए और खाए गए गोल के तौर पर गिना जाता है।
असली स्पोर्ट्स लीग जैसी टेबल चाहिए, जिसमें टीमें ही पंक्तियाँ हों? Match format के बग़ल में Fixed teams चालू कर दीजिए: नाम वाली पक्की टीमें leaderboard के Team sign-up बटन से रजिस्टर होती हैं (हर टीम दो रिज़र्व तक रख सकती है), matches टीम बनाम टीम स्कोर के साथ भेजे जाते हैं, और टेबल टीमों को पॉइंट्स से rank करती है।
जाँच और रद्द करना
League के matches भी वही जाँच वाली queue इस्तेमाल करते हैं जो ELO के matches करते हैं: validator हर submission को approve या reject करता है, मंज़ूरी मिलते ही पॉइंट्स लग जाते हैं, और approve हुए matches बाद में रद्द भी किए जा सकते हैं (जिससे दिए गए पॉइंट्स ठीक वैसे ही वापस हो जाते हैं)।
Rating वाले leaderboard पर community के लोग तस्वीरें भेजते हैं और एक-दूसरे की entries को स्टार देकर रेट करते हैं।
यह कैसे काम करता है
- लोग
/submitसे तस्वीरें भेजते हैं — तस्वीर slash command के साथ लगाइए, फिर बॉक्स में नाम लिख दीजिए। - Submissions सेट किए हुए log channel में rating वाले ड्रॉपडाउन के साथ दिखती हैं।
- कोई भी 1 से 10 स्टार दे सकता है। सब ratings का औसत ही score बनता है।
- अपना वोट कभी भी बदला जा सकता है — हर submission पर हर व्यक्ति का एक ही वोट गिना जाता है।
- Leaderboard submissions को उनकी औसत rating से rank करता है।
वेबसाइट पर rating देना
वेबसाइट पर submissions Entries टैब में दिखती हैं। किसी भी एंट्री पर क्लिक कीजिए, पूरी तस्वीर देखिए और स्टार बटनों से उसे रेट कर दीजिए। आपके दिए हुए वोट अगली बार भी याद रहते हैं।
Scoreboards की वेबसाइट पर आपके leaderboards कौन देख सकता है, यह आप तय करते हैं:
वेबसाइट पर सबको दिखता है।
सिर्फ़ आपके Discord server के मेंबर देख सकते हैं (लॉग इन ज़रूरी है)।
सिर्फ़ उन्हीं मेंबर्स को दिखता है जिनके पास तय किया हुआ Discord role हो।
वेबसाइट पर बिलकुल नहीं दिखता।
Leaderboard पर rank के हिसाब से खिलाड़ियों को अपने आप Discord roles दिलवाइए। जैसे टॉप 3 को "Champion" role, rank 4–10 को "Veteran" role, और आगे भी इसी तरह।
- हर leaderboard की सेटिंग्स में जाकर वेब dashboard से tiers सेट कीजिए।
- तय कीजिए कि tier किस आधार पर बने: rank से (rank 1–3), percentile से (ऊपर के 10% खिलाड़ी), या score से (जिनके 2000+ पॉइंट्स हों)। एक leaderboard के सारे tiers एक ही आधार पर चलते हैं।
- हर tier के लिए Discord का कोई भी मौजूदा role चुन लीजिए।
- Rankings बदलते ही roles अपने आप मिलते और हटते रहते हैं।
- Server Settings → Roles में Scoreboards का role उन सभी roles से ऊपर होना चाहिए जो वह देता है। Discord bots को अपने बराबर या अपने से ऊपर वाले roles छूने नहीं देता, और ऐसा होने पर bot leaderboard के channel में चेतावनी पोस्ट कर देता है।
मुक़ाबला पहले से कहीं और चल रहा है? /import एक CSV फ़ाइल लेकर उससे पूरा leaderboard भर देता है, ताकि कुछ भी दोबारा टाइप न करना पड़े।
दो रास्ते हैं: Discord में /import चलाइए, leaderboard चुनिए और फ़ाइल लगा दीजिए; या वेबसाइट पर dashboard खोलिए, leaderboard चुनिए और Import from CSV इस्तेमाल कीजिए। निजी leaderboards का कोई Discord server नहीं होता, इसलिए उनके लिए dashboard ही रास्ता है। फ़ाइल दोनों तरफ़ एक जैसी है — हर लाइन पर एक <arg>name,score</arg>:
name,score Alex,120 "Cooney, EM",95 Sam,88
- ऊपर की हेडर लाइन पहचानकर अपने आप छोड़ दी जाती है।
- कॉमा, सेमीकोलन और टैब — तीनों सेपरेटर चलते हैं, यानी आपकी स्प्रेडशीट जो भी निकाले।
- नाम में कॉमा हो तो उसे कोट में लिख दीजिए, जैसे <arg>"Cooney, EM"</arg>।
- अगर नाम की जगह Discord यूज़र id है, तो वह एंट्री उसी मेंबर से जुड़ जाती है और उसका डिस्प्ले नेम दिखता है। बाक़ी सब सादी entries बन जाती हैं।
- एक ही नाम दो बार हो तो आख़िरी वैल्यू रहती है, इसलिए ठीक की हुई फ़ाइल दोबारा import की जा सकती है।
- जो लाइनें पढ़ी न जा सकें वे छोड़ दी जाती हैं और उनके नंबर बता दिए जाते हैं — बाक़ी सब फिर भी import हो जाता है, तो दो-चार लाइनें ठीक करके दोबारा चला लीजिए।
समय के लिए <arg>mm:ss</arg>, <arg>hh:mm:ss</arg> चलते हैं, और चाहें तो दशमलव भी: <arg>1:30</arg>, <arg>1:12:44.081</arg>। सिर्फ़ अंक लिखा हो तो उसे मिलीसेकंड माना जाता है। ध्यान रहे, कोलन से बँटे तीन अंकों का मतलब <arg>hours:minutes:seconds</arg> होता है, इसलिए सेकंड से छोटी सटीकता डॉट के बाद लिखिए।
लिमिट: हर फ़ाइल में 500 लाइनें और 100 KB — इससे बड़े export को टुकड़ों में बाँटकर import कीजिए। Image Rating leaderboards import नहीं हो सकते, क्योंकि उनकी entries scores नहीं बल्कि अपलोड की हुई तस्वीरें होती हैं।
Seasons से आप एक मुक़ाबले पर लकीर खींचकर नए सिरे से शुरू कर सकते हैं, और जो हुआ वह भी नहीं खोता। /scoreboard season end चलाइए, पुष्टि कीजिए, और आख़िरी standings संभाल ली जाती हैं, leaderboard के channel में पोडियम की पोस्ट चली जाती है, और board अगले season के लिए रीसेट हो जाता है।
- ELO boards अपने खिलाड़ी नहीं खोते, बस हर rating शुरुआती वैल्यू पर लौट आती है — खाली ladder भला किस काम की।
- Classic, Highscore, Time और League boards साफ़ कर दिए जाते हैं, क्योंकि शून्य वाला score कोई असली एंट्री नहीं होती।
- Image Rating boards पर seasons नहीं होते — रीसेट होने से भेजी हुई तस्वीरें ही मिट जातीं।
- संभाली हुई standings हमेशा के लिए रहती हैं, चाहे board बाद में दोबारा रीसेट हो जाए।
हफ़्ते का recap हर सोमवार leaderboard के channel में छोटा-सा हाल पोस्ट करता है: टॉप तीन, हफ़्ते की सबसे बड़ी छलाँग, और कितना खेला गया। यह सिर्फ़ उन्हीं boards को मिलता है जिन पर पिछले हफ़्ते कम से कम तीन scores आए हों, इसलिए सुस्त leaderboard चुपचाप पड़ा रहता है। हर leaderboard के लिए recap को /scoreboard settings या वेबसाइट के dashboard से बंद किया जा सकता है।