ゲームのルートボックスと宝箱

プレイヤーに見えるもの

• 宝箱の開け方ごとのカード：通貨、宝箱アイテム、鍵。
• 宝箱の上限と残高が許すなら**「開ける」と「10個開ける」**。
• 開封のアニメーション：サーバーが結果を決める間は箱が揺れ、はじけて、報酬が飛び出します。
• 持っているアイテムで開けられる宝箱の数を示すバッジ。

仕組み

• 宝箱の中身と確率はダッシュボードで設定し、開けるたびにサーバーが結果を決めます。
• インベントリの宝箱や鍵は、対応する宝箱を選んだ状態でこの画面を開きます。
• 放置 RPG テンプレートは、ルートボックスを装備召喚として使っています。

開発者向け

ルートボックスは @idosgames/core の client.lootbox で動きます。

// 選んだ価格のオプションで宝箱を10回開ける
const res = await client.lootbox.open('gold_chest', 10, 'gems')
if (!res.ok) return showError(res.error)
// 出たものは SDK のキャッシュの残高とインベントリにすでに反映されています

• 結果をクライアントで決めないでください。結果はサーバーの応答からだけ来ます。
• リクエスト中はボタンを無効にします。呼び出し1回が1回の開封です。

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