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

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

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

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

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

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

Цены

Aspis: валюта всей платформы, игрок пополняет её один раз и тратит в любой игре. Чтобы продавать товар за Aspis, выберите Aspis в цене товара. Та же цена в Aspis работает везде, где продаёте вы: лутбоксы, наборы коллекций, крафт, офферы, бусты, VIP, прокачка предметов и персонажей, скины, спины совместных ивентов, спецрежим поля, взнос за публикацию в Мастерской и ИИ-генерации. Она не работает в ценах между игроками (рынок, PvP) и никогда не бывает наградой. Каждую покупку игрок подтверждает на idosgames.com - сама игра тратить Aspis не может. Каждая продажа приносит вам доход заработанными Aspis на аккаунт. Заработанными Aspis можно платить и за ИИ, сборки и другие сервисы платформы - после ИИ-кредитов тарифа и купленных Aspis. В DEV-копии игры покупка за Aspis - бесплатная проверка. В приложении iDos Games на Android игрок пополняет Aspis через Google Play и тратит их в играх так же; на iPhone покупок за Aspis в приложении нет.

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

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

• За всё время - например, стартовый набор один раз.
• В сутки - сбрасывается в полночь по 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.