इन-गेम लीडरबोर्ड: रैंकिंग, राउंड और इनाम

खिलाड़ी क्या देखता है

• टैब के रूप में बोर्ड: हर एक में एक कार्ड, जिसमें खिलाड़ी का स्कोर, रैंक और राउंड खत्म होने की उलटी गिनती।
• टॉप खिलाड़ी, खिलाड़ी हाइलाइट और टॉप तीन को मेडल।
• पॉपअप में रैंक इनाम और पॉइंट इनाम; पॉइंट इनाम वहीं ले लिए जाते हैं।
• पिछले राउंड के इनाम वाला पॉपअप: राउंड खत्म होने पर "लें" बटन के साथ खुद दिखता है।
• अगर गेम में पॉइंट कमाने वाला मोड है, तो कार्ड पर "खेलें" बटन।
• इनाम इंतज़ार में हो तो टैब पर बैज।

बोर्ड कैसे बना है

• राउंड। बोर्ड चक्र में दोहराता है (जैसे हर हफ़्ते), समय-सारणी पर चलता है या राउंड की शृंखला के रूप में।
• स्कोर कैसे गिना जाता है। सभी नतीजों का जोड़, सबसे अच्छा नतीजा, सबसे अच्छा समय या आखिरी मान।
• रैंक इनाम: राउंड के अंत में जगहों की रेंज के हिसाब से: पहली जगह, दूसरी से तीसरी, चौथी से दसवीं वगैरह।
• पॉइंट इनाम: राउंड के अंदर के पड़ाव: "इस हफ़्ते 1000 पॉइंट कमाओ"।

पॉइंट कहाँ से आते हैं

पॉइंट बोर्ड पर सेट किए गए स्रोतों से आते हैं:

• गेम से नतीजा (ClientScore)। गेम एक संख्या भेजता है, जैसे एक दौड़ का स्कोर। ⚠ स्रोत पर सीमाएँ लगाएँ: प्रति भेजाव अधिकतम, प्रति दिन अधिकतम और भेजावों के बीच का अंतराल। इस स्रोत के बिना बोर्ड गेम से कोई संख्या लेता ही नहीं।
• वे इवेंट जिन्हें सर्वर खुद गिनता है, जैसे खरीद या पूरे क्वेस्ट। इन्हें गेम से नकली नहीं बनाया जा सकता।

डेवलपर के लिए

लीडरबोर्ड @idosgames/core में client.leaderboard से काम करता है।

// नतीजा भेजें: सर्वर गिनती का नियम और सीमाएँ लागू करता है
const sub = await client.leaderboard.submitScore('weekly_score', 150)
if (!sub.ok) return showError(sub.error)
sub.data.NewScore // गिनती के बाद का स्कोर

// कई बोर्ड वाली स्क्रीन: टॉप सूचियाँ और खिलाड़ी की प्रगति एक ही अनुरोध में
const overview = await client.leaderboard.getOverviewBatch(['weekly_score', 'season_pvp'])

// इंतज़ार में सब कुछ लें: रैंक इनाम और पॉइंट इनाम
await client.leaderboard.claimAllRewardsBatch(['weekly_score', 'season_pvp'])

• SDK शून्य या उससे कम स्कोर को बिना अनुरोध भेजे खुद अस्वीकार करता है।
• नया स्कोर जवाब के NewScore से लें: "सबसे अच्छा नतीजा" में खराब नतीजा स्कोर नहीं बदलता।
• दोस्तों की रैंकिंग getFriendsLeaderboard(leaderboardID) है।

हर फ़ील्ड leaderboard-system स्किल में बताई गई है, जिसे SDK का MCP सर्वर देता है।