特別オファー：スターターパックと期間限定のお得な取引

プレイヤーに見えるもの

• 新しいオファーは1回だけ自動で表示され、表示回数が記録されます。
• 開催中のすべてのオファーとタイマーがある**「オファー」画面**。
• 3つの形：大きなオファー1つ、段階の連なり、1つ選ぶカード。
• 無料の段階、通貨の価格、専用の報酬があるマイルストーンバー。

仕組み

• オファーは段階のグラフです。購入のたびに、どの段階を開くかサーバーが決めます。
• 段階は無料、通貨、またはアプリストアでの支払いにできます。
• オファーにはタイマーと、誰に見せるかの条件があります。

開発者向け

特別オファーは @idosgames/core の client.dealOffer で動きます。

// プレイヤーの開催中のオファーを取り、オファーの1段階を実行する
const deals = await client.dealOffer.getActiveDeals()
await client.dealOffer.recordShow(slotID) // オファーが表示された：表示回数を記録します
const res = await client.dealOffer.executeNode(slotID, nodeID)

• 表示回数が正しくなるよう、オファーが実際に表示されたときに recordShow を呼びます。
• 段階の状態はサーバーのものです。executeNode のあとはオファーを読み直し、クライアントで段階を開けないでください。

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