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

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

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

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

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

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

कीमतें

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

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

• हमेशा के लिए: जैसे स्टार्टर पैक एक बार।
• प्रति दिन: 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 सर्वर देता है।