ゲーム内ストア：棚、商品、価格

プレイヤーに見えるもの

• タブになった棚。 棚の最初のセクションはカルーセル、残りはカードのグリッドです。
• 受け取るまで光る無料の本日のギフト。
• カードのタイマー：「更新まで」「開始まで」「売り切れ」。
• 購入確認のポップアップ（スマホでは下から出るシート）。
• 「獲得」のアニメーション：報酬が残高のカウンターへ飛んでいきます。
• 無料商品が待っているときのストアのタブのバッジ。

ストアの構造

ストアはツリーです：棚 → セクション → スロット → 商品。

• 商品：売るもの。価格、報酬、上限、リボン（「お得」「x2」）。商品は1つのカタログにあります。
• スロット：棚の上の場所。商品はスロットを通してしか買えず、どのスロットにもない商品はまったく売られません。
• 入れ替え：スロットはプールから商品を表示し、スケジュールで入れ替えられます。本日のショップのように。 入れ替えはサーバーが計算するので、プレイヤーはどの端末でも同じストアを見ます。

価格

取り消し線の「元の」価格を表示でき、割引率はサーバーが計算します。1つの商品に複数の価格オプションを付けることも できます。たとえばコインかジェム。

購入上限

• 通算：たとえばスターターパックは1回。
• 1日ごと：UTC の午前0時にリセット。
• クールダウン：決まった時間が過ぎると次の購入。
• 入れ替え期間ごと：この商品が棚にある間のスロットの上限。

「初回購入」「売り切れ」の表示とタイマーは、プレイヤーごとにサーバーが計算します。

開発者向け

ストアは @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 の呼び出し1回が1回の購入です。
• タイマーは端末の時計ではなく、応答の ServerTimeUtc から数えます。
• 残りの上限が null なら「上限なし」、0 なら「売り切れ」です。

すべてのフィールドは、SDK の MCP サーバーが配るスキル store-system に説明があります。