装备与物品
刷新包裹物品
刷新角色当前包裹的物品显示，适用于发奖、回收、自动整理或脚本批量改包后立即同步客户端界面。
命令用途
QueryBagItems 用于刷新角色当前包裹中的物品显示。
它更适合放在脚本已经发放、扣除、穿戴、回收或调整包裹物品之后，让客户端立刻看到最新结果，而不是继续等待默认刷新周期。
命令名
QueryBagItems
调用格式
QueryBagItems [刷新间隔时间]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
刷新间隔时间 | 否 | 包裹刷新间隔，单位为秒。不写时默认按 10 秒处理。 |
返回或影响
- 这是执行型命令，会刷新当前角色的包裹物品显示。
- 常用于脚本批量处理物品后，立即把最新包裹状态同步给客户端。
- 它不负责发放物品、扣除物品或打开普通物品框，只负责刷新包裹显示与同步结果。
示例
基础用法
#ACT
Give 祝福油 1
QueryBagItems
这段写法适合在发放物品后立刻刷新包裹，让玩家不用等默认周期就能看到新增物品。
常见变体
#ACT
Take 回城卷 1
Give 传送石 1
QueryBagItems 3
这类写法适合在一段脚本里连续调整包裹内容后，把刷新间隔改得更短，减少界面不同步的体感。
注意事项
QueryBagItems刷新的是包裹显示，不是QueryItemDlg这种普通物品框流程。- 如果脚本里刚做了多次
Give、Take、TakeOn或其它包裹相关操作，通常可以在最后统一补一次QueryBagItems，不用每一步都单独刷新。 - 刷新过于频繁没有必要，常规流程保持默认间隔通常就够用。
- 这条命令更适合角色背包同步场景；如果你的流程是 NPC 提交装备、检查物品框或处理 ItemBox，自然应使用对应命令链。