背包显示玩家拥有的一切：按分类和稀有度排列的物品，以及数量和等级。 它是每个新项目的一部分，始终显示在大厅中；物品和货币本身只需在后台设置一次，所有其他系统都会使用。
玩家看到什么
背包
12 450
320
装备
消耗品
其他
剑Lv 5
盾Lv 2
药水x12
钥匙x3
宝箱x1
斧Lv 1
星星x40
红宝石x7
宝箱
用钥匙开启。内含任意稀有度的装备。
前往宝箱
1分类标签页；背包在大厅中始终显示。
2带稀有度边框、数量和等级的物品。
3物品卡片；装备给英雄，宝箱和钥匙去宝箱界面。
如何运作
- 背包读取 SDK 缓存：它自己不发送请求。
- 可堆叠物品以数量保存，唯一物品（装备）以带自身等级的实例保存。
- 每个发放或消耗物品的系统都会在服务器上修改同一个背包。
步骤 01把系统加入项目
不需要添加：背包是每个新项目的一部分，即使游戏还没有物品，它的标签页也会显示。
步骤 02在后台中设置
打开后台，选择你的项目，进入 实时运营 → v2 → 物品。
- 在物品中创建物品：名称、分类、稀有度、可堆叠还是唯一，以及它的作用。
- 在货币中创建货币：游戏的软货币和硬货币。
页面上的 AI 按钮会打开助手：描述你的需求，它会提出修改，你检查后点击保存。
步骤 03测试并发布
在应用的测试版中检查系统。设置通过单独的操作发送到正式应用，请看发布与链接。
开发者须知
物品和货币通过 @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 ?? {}) // 带等级的装备实例- 从缓存渲染：每次购买、奖励和合成后它都会自动更新。
- 只通过系统发放物品（奖励、商店、宝箱）：客户端永远不直接添加物品。
每个字段都在技能 item-system 中有说明，由 SDK 的 MCP 服务器提供。
常见问题
需要添加背包吗？
不需要。它是每个新项目的一部分，并且始终显示在大厅中。
货币在哪里设置？
在后台的货币分区中。物品在物品分区中。