期間限定イベント：賞品トラックのあるお祭り

プレイヤーに見えるもの

• 名前とタイマー付きの、タブになった開催中のすべてのイベント。
• 次の賞品までのトークンのバーとマイルストーントラック。
• マイルストーンのVIP の2つ目の賞品。あとから買ったパスは、受け取り済みのマイルストーンの分も補います。
• **「すべて受け取る」**と、トークンの集め方と1日の上限がわかるポップアップ。

仕組み

• トークンはイベントに設定した出どころから来ます。ゲーム内の行動、購入、クエストなど。
• 1回のプレイはゲームが知らせる独自の行動です。最小のテンプレートは、それを一覧に入れたすべてのイベントに知らせます。
• 「VIP になる」は、VIP が入っていればその画面を開きます。

開発者向け

期間限定イベントは @idosgames/core の client.timedEvent で動きます。

// 1回プレイした：開催中のすべてのイベントの 'play_round' の行動にトークンを付与
const res = await client.timedEvent.getActiveEvents()
for (const e of res.ok ? (res.data.ActiveEvents ?? []) : [])
  if (e.CanEarn !== false && e.Type && e.TimedEventID)
    await client.timedEvent.grantTokens(e.Type, e.TimedEventID, 'CustomAction', undefined, undefined, {
      ActionName: 'play_round',
    })
// すべてのイベントの待っているマイルストーンを1回の呼び出しで受け取る
await client.timedEvent.claimAllMilestones()

• ゲームがトークンを付与できるのは、イベントに設定した出どころ経由だけです。上限はサーバーが適用します。
• トラックは getActiveEvents() から読みます。受け取ったマイルストーンはそこに残ります。

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