装备与物品
将 ItemBox 装备返还背包
将指定 ItemBox 槽位中的装备退回角色背包，适用于 ItemBox 流程中的取消、回退和收尾处理。
命令用途
RetBoxItem 用于把指定 ItemBox 槽位中的装备返还到角色背包。
它只对应 ItemBox 流程，常见于 <ItemBox=0~9,... LABEL=@ItemBox0 ...> 这类配置中，当脚本需要把指定槽位里的装备退回时使用。
命令名
RetBoxItem
调用格式
RetBoxItem <物品框序号>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
物品框序号 | 是 | 要返还的 ItemBox 槽位编号。常见范围是 0~9，对应 <ItemBox=0~9,...> 里的槽位序号。 |
常用编号
| 编号 | 位置 |
|---|---|
0 | BoxItem0 |
1 | BoxItem1 |
2 | BoxItem2 |
3 | BoxItem3 |
4 | BoxItem4 |
如果当前系统使用更多 ItemBox 槽位，应以实际 <ItemBox=...> 配置为准。
返回或影响
- 这是执行型命令，会把目标
ItemBox中的装备退回角色背包。 - 如果对应
ItemBox里没有装备，通常不会产生你期望的返还结果。 - 该命令只处理
ItemBox槽位里的装备回退，不参与QueryItemDlg这套普通物品框提交流程。
示例
基础用法
#ACT
RetBoxItem 0
MessageBox "已将 ItemBox 中的装备返还到背包。"
这段写法用于把指定 ItemBox 槽位中的装备直接退回背包，适合最基础的取消或关闭流程。
常见变体
#ACT
GetEquipProps 20004 @OnGetEquipProps
#ELSEACT
RetBoxItem 4
MessageBox "当前放入的装备不符合要求，已退回背包。"
Break
这类写法适合在读取或校验 ItemBox 槽位装备失败后，立即把装备退回并中断后续流程。
注意事项
RetBoxItem只负责退回ItemBox中的装备，不会替你关闭流程或清理提示信息。物品框序号必须和当前<ItemBox=...>配置中的槽位序号对应，写错槽位时可能退回不到预期装备。- 如果脚本里先做过
GetEquipProps 20000~20019一类扩展读取，返还时通常要保持编号对应关系一致。