战利品箱是一个现成的宝箱系统：玩家用货币、宝箱物品或钥匙打开宝箱，掉落什么由服务器决定。 结果无法在游戏中伪造，每次开启都会显示奖励从箱子里飞出来。
玩家看到什么
- 宝箱的每种开启方式一张卡片：货币、宝箱物品、钥匙。
- 在宝箱上限和余额允许时，“打开”和“开启 x10”。
- 开启动画：服务器决定结果时箱子会摇晃，然后炸开，奖励飞出。
- 显示玩家用手中物品可以打开多少宝箱的徽标。
宝箱
12 450
320
黄金宝箱
100
英雄宝箱
钥匙
2开启 x10
一次十个，以宝箱上限和你的余额为准。
900
史诗之剑
x1金币
+2 5001每种开启方式一张卡片：货币、宝箱物品或钥匙；徽标显示可开启的宝箱数。
2上限和余额允许时可用“开启 x10”。
3由服务器决定结果；奖励从箱子里飞出来。
如何运作
步骤 01把系统加入项目
告诉 AI 编程助手：“加入宝箱”。它会安装现成的系统；设置好宝箱后，标签页才会显示。
步骤 02在后台中设置
打开后台，选择你的项目，进入 实时运营 → v2 → 战利品箱。
- 创建战利品箱：可能掉落什么，以及各自的权重。
- 添加开启方式：货币价格、宝箱物品或钥匙，以及单次开启的上限。
页面上的 AI 按钮会打开助手：描述你的需求，它会提出修改，你检查后点击保存。
步骤 03测试并发布
在应用的测试版中检查系统。设置通过单独的操作发送到正式应用，请看发布与链接。
开发者须知
战利品箱通过 @idosgames/core 中的 client.lootbox 工作。
// 用选定的价格选项把宝箱开十次
const res = await client.lootbox.open('gold_chest', 10, 'gems')
if (!res.ok) return showError(res.error)
// 掉落的内容已经应用到 SDK 缓存中的余额和背包- 永远不要在客户端决定结果：结果只来自服务器响应。
- 请求进行中时禁用按钮：每次调用都是一次单独的开启。
每个字段都在技能 lootbox-system 中有说明，由 SDK 的 MCP 服务器提供。
常见问题
可以显示概率吗？
可以。宝箱的内容和权重都在游戏设置中，所以游戏可以把它们显示在宝箱旁边。
宝箱可以用背包里的钥匙打开吗？
可以。宝箱或钥匙物品会打开这个界面，并选中对应的宝箱。