Магазин в игре: витрины, товары и цены

Что видит игрок

• Витрины вкладками. Первая секция витрины - карусель, остальные - сетки карточек.
• Бесплатный подарок дня, который подсвечивается, пока его не забрали.
• Таймеры на карточках: «обновится через», «откроется через», «распродано».
• Окно подтверждения покупки (на телефоне выезжает снизу).
• Анимацию «Получено»: награды летят к счётчикам балансов.
• Значок на вкладке магазина, когда игрока ждёт бесплатный товар.

Как устроен магазин

Магазин - это дерево: витрина → секции → слоты → товар.

• Товар - что продаётся: цена, награды, лимиты, метки («выгодно», «x2»). Товары лежат в общем каталоге.
• Слот - место на полке витрины. Только через слот товар можно купить: товар, который не стоит ни в одном слоте, не продаётся вовсе.
• Ротация: слот может показывать товар из набора и менять его по расписанию, как в ежедневном магазине. Ротацию считает сервер, поэтому у игрока на всех устройствах один и тот же магазин.

Цены

Можно показать зачёркнутую «старую» цену, процент скидки сервер посчитает сам. У одного товара может быть несколько вариантов цены: например, за монеты или за кристаллы.

Лимиты покупок

• За всё время - например, стартовый набор один раз.
• В сутки - сбрасывается в полночь по UTC.
• Перезарядка - следующая покупка через заданное время.
• На одно окно ротации - лимит слота, пока на полке стоит этот товар.

Метку «первая покупка», «распродано» и таймеры сервер считает для каждого игрока сам.

Для разработчиков

Магазин работает через client.store из @idosgames/core. Экран рисуйте из 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, его отдаёт MCP-сервер SDK.