इन-गेम क्वेस्ट: रोज़ के काम और इनाम

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

• टैब के रूप में साइकिल: रोज़ के, हफ़्ते के, उपलब्धियाँ, अगली साइकिल तक के टाइमर के साथ।
• हर काम पर प्रगति पट्टी और उसके सभी लक्ष्यों वाला विवरण पॉपअप।
• पूरे कामों के लिए "सब लें" बटन।
• पॉइंट ट्रैक, जिस पर पॉइंट जुड़ते ही चेस्ट खुलते हैं।
• पूरे काम इंतज़ार में हों तो टैब पर बैज।

क्वेस्ट कैसे बने हैं

• साइकिल: समय-सारणी वाले कामों का सेट: रोज़ का, हफ़्ते का, स्थायी या समयबद्ध इवेंट। साइकिल चरणों में एक के बाद एक चल सकती है, जैसे आठ हफ़्ते का सीज़न, जिसमें हर हफ़्ते के अपने काम और अपना पॉइंट ट्रैक हो।
• क्वेस्ट: एक या ज़्यादा लक्ष्य, हर एक का अपना काउंटर ("20 राक्षस हराओ"), और एक इनाम। क्वेस्ट पहले किसी दूसरे क्वेस्ट के पूरे होने की शर्त रख सकता है: शृंखलाएँ ऐसे बनती हैं।

इनाम तीन तरह के हैं, और सब एक साथ काम करते हैं:

1. क्वेस्ट का इनाम: जब सारे लक्ष्य पूरे हों।
2. पॉइंट ट्रैक पर चेस्ट: लिया गया क्वेस्ट साइकिल पॉइंट जोड़ता है, और ज़रूरी कुल पर चेस्ट खुलता है।
3. समूह बोनस: जब एक समूह के तय संख्या में क्वेस्ट पूरे हों।

प्रगति कहाँ से आती है

डेवलपर के लिए

क्वेस्ट @idosgames/core में client.quest से काम करते हैं। प्रगति क्वेस्ट के हिसाब से नहीं, काउंटर के नाम से भेजी जाती है: सर्वर उसे उस काउंटर को सुनने वाले हर चालू काम को दे देता है।

// जहाँ यह होता है: एक राक्षस हराया गया
await client.quest.addQuestProgress('monsters_defeated', 1)

// क्वेस्ट स्क्रीन: खिलाड़ी की प्रगति; साइकिल अपने आप आगे बढ़ती हैं
const state = await client.quest.getUserQuestState()

// पूरे क्वेस्ट का इनाम लें
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)

• addQuestProgress सिर्फ़ उन लक्ष्यों को आगे बढ़ाता है जिनका स्रोत गेम है। जिन लक्ष्यों को सर्वर खुद गिनता है, वे अस्वीकार होते हैं।
• कभी "एहतियातन" मान न भेजें: अगर लक्ष्य की प्रति कॉल अधिकतम सीमा है, तो उससे ऊपर जाने पर खिलाड़ी का अकाउंट बैन हो जाता है।
• दिए गए इनाम SDK कैश के बैलेंस में पहले ही लागू हैं, उन्हें दोबारा लोड करने की ज़रूरत नहीं।

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