Ойын ішіндегі дүкен: витриналар, тауарлар және бағалар

Ойыншы не көреді

• Қойындылар түріндегі витриналар. Витринаның бірінші бөлімі - карусель, қалғандары - карточкалар торы.
• Тегін күн сыйлығы, алынғанша жарқырап тұрады.
• Карточкалардағы таймерлер: «жаңаруына», «ашылуына», «сатылып кетті».
• Сатып алуды растау терезесі (телефонда төменгі панель).
• «Сіз алдыңыз» анимациясы: марапаттар баланс есептегіштеріне ұшады.
• Тегін тауар күтіп тұрғанда дүкен қойындысындағы белгі.

Дүкен қалай құрылған

Дүкен - ағаш: витрина → бөлімдер → слоттар → тауар.

• Тауар - не сатылады: баға, марапаттар, шектер, белгілер («тиімді», «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 сервері береді.