इन-गेम स्टोर: स्टोरफ़्रंट, ऑफ़र और कीमतें

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

• टैब के रूप में स्टोरफ़्रंट। स्टोरफ़्रंट का पहला सेक्शन कैरोसेल है, बाकी कार्ड की ग्रिड।
• रोज़ का मुफ़्त गिफ़्ट, जो लिए जाने तक चमकता है।
• कार्ड पर टाइमर: "इतने में नया", "इतने में खुलेगा", "बिक गया"।
• खरीद की पुष्टि वाला पॉपअप (फ़ोन पर नीचे से खुलने वाली शीट)।
• "आपको मिला" एनिमेशन: इनाम बैलेंस काउंटर की ओर उड़ते हैं।
• मुफ़्त ऑफ़र इंतज़ार में हो तो स्टोर टैब पर बैज।

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

स्टोर एक पेड़ है: स्टोरफ़्रंट → सेक्शन → स्लॉट → ऑफ़र।

• ऑफ़र: जो बिकता है। कीमत, इनाम, सीमाएँ, रिबन ("सबसे फ़ायदेमंद", "x2")। सारे ऑफ़र एक कैटलॉग में रहते हैं।
• स्लॉट: स्टोरफ़्रंट की शेल्फ़ पर एक जगह। ऑफ़र सिर्फ़ स्लॉट से खरीदा जा सकता है: जो ऑफ़र किसी स्लॉट में नहीं, वह बिकता ही नहीं।
• रोटेशन: स्लॉट किसी पूल से ऑफ़र दिखा सकता है और उसे समय-सारणी से बदल सकता है, जैसे रोज़ की शॉप। रोटेशन सर्वर गिनता है, इसलिए खिलाड़ी हर डिवाइस पर एक ही स्टोर देखता है।

कीमतें

Aspis पूरे प्लेटफ़ॉर्म की करेंसी है: खिलाड़ी इसे एक बार टॉप अप करता है और किसी भी गेम में खर्च करता है। ऑफ़र को Aspis में बेचने के लिए ऑफ़र की कीमत में Aspis चुनें। Aspis की यही कीमत हर उस जगह काम करती है जहाँ आप बेचते हैं: लूटबॉक्स, कलेक्शन पैक, क्राफ्टिंग, डील, बूस्ट, VIP, आइटम और किरदारों का अपग्रेड, स्किन, को-ऑप स्पिन, बोर्ड का खास मोड, वर्कशॉप में प्रकाशन शुल्क और AI जनरेशन। यह खिलाड़ियों के बीच की कीमतों (मार्केट, PvP) में काम नहीं करती और कभी इनाम नहीं होती। हर खरीद की पुष्टि खिलाड़ी idosgames.com पर करता है - गेम खुद Aspis खर्च नहीं कर सकता। हर बिक्री से आपको आपके खाते में कमाए गए Aspis के रूप में कमाई मिलती है। कमाए गए Aspis से AI, बिल्ड और प्लेटफ़ॉर्म की दूसरी सेवाओं का भुगतान भी होता है - प्लान के AI क्रेडिट और खरीदे गए Aspis के बाद। गेम की DEV कॉपी में Aspis से खरीद मुफ़्त परीक्षण है। Android पर iDos Games ऐप में खिलाड़ी Google Play से Aspis टॉप अप करते हैं और गेम में उसी तरह खर्च करते हैं; iPhone ऐप में Aspis से खरीदारी उपलब्ध नहीं है।

आप कटी हुई "पुरानी" कीमत दिखा सकते हैं, और छूट का प्रतिशत सर्वर गिनता है। एक ऑफ़र के कई कीमत विकल्प हो सकते हैं, जैसे सिक्के या जेम।

खरीद की सीमाएँ

• हमेशा के लिए: जैसे स्टार्टर पैक एक बार।
• प्रति दिन: UTC आधी रात को रीसेट।
• कूलडाउन: अगली खरीद तय समय के बाद।
• प्रति रोटेशन अवधि: जब तक यह ऑफ़र शेल्फ़ पर है, तब तक स्लॉट की सीमा।

"पहली खरीद" और "बिक गया" निशान और टाइमर सर्वर हर खिलाड़ी के लिए गिनता है।

डेवलपर के लिए

स्टोर @idosgames/core में client.store से काम करता है। स्क्रीन getStorefront() से बनाएँ: यह इस खिलाड़ी के लिए पहले से गिना हुआ स्टोरफ़्रंट है (रोटेशन, सीमाएँ, टाइमर)। getDefinitions() सिर्फ़ कॉन्फ़िग है, सबके लिए एक जैसा।

const res = await client.store.getStorefront()
if (!res.ok) return showError(res.error)

for (const store of res.data.Stores ?? [])
  for (const section of store.Sections ?? [])
    for (const slot of section.Slots ?? []) {
      // खाली स्लॉट Offer === null के साथ आता है: खाली फ़्रेम बनाएँ ताकि शेल्फ़ न उछले।
      if (!slot.Offer) continue
      drawCard(slot.Offer, slot.RefreshesAtUtc)
    }

const buy = await client.store.purchase(offer.OfferID, 1, {
  selectedOptionID: option.OptionID,
  slot: { storeID: store.StoreID, sectionID: section.SectionID, slotID: slot.SlotID },
})

• अगर खरीद OFFER_NOT_IN_ROTATION लौटाए, तो स्टोरफ़्रंट बदल गया है: बिना एरर दिखाए उसे फिर से लोड करें।
• अनुरोध चलते समय "खरीदें" बटन बंद रखें: purchase की हर कॉल अलग खरीद है।
• टाइमर डिवाइस की घड़ी से नहीं, जवाब के ServerTimeUtc से गिनें।
• बची सीमा में null का मतलब "कोई सीमा नहीं" और 0 का मतलब "बिक गया" है।

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