インベントリ：プレイヤーのアイテムと通貨

プレイヤーに見えるもの

• カテゴリーのタブ：装備、消耗品、その他。
• アイテムごとのレア度の枠、個数、レベル。
• 説明付きのアイテムカード。
• 受け渡し：装備はヒーローの画面を、宝箱や鍵は宝箱を開きます。

仕組み

• インベントリは SDK のキャッシュを読み、自分ではリクエストを送りません。
• 重ねられるアイテムは個数として、固有のもの（装備）は自分のレベルを持つインスタンスとして保存されます。
• アイテムを付与したり使ったりするシステムはすべて、サーバー上の同じインベントリを変更します。

開発者向け

アイテムと通貨は @idosgames/core の client.item と client.currency で動き、状態は SDK のキャッシュにあります。

// ログイン後、インベントリはすでに SDK のキャッシュにあり、追加のリクエストは不要
const inv = client.data.user.state?.Inventory
inv?.VirtualCurrencies?.['GOLD'] // 通貨の残高
inv?.Items?.['potion']?.TotalAmount // 重ねられるアイテム
Object.values(inv?.UnstackableItems ?? {}) // レベル付きの装備のインスタンス

• キャッシュから描画します。購入、報酬、クラフトのたびに自動で更新されます。
• アイテムはシステム（報酬、ストア、宝箱）経由でだけ付与します。クライアントがアイテムを追加することはありません。

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