获取寄售数量

命令用途

GetConsignmentCount 用于获取当前寄售中的物品数量。

它通常放在寄售 NPC、交易入口或功能按钮流程里，用来统计当前角色或指定角色的寄售数量，并通过回调标签把结果返回给后续脚本处理。

命令名

GetConsignmentCount

调用格式

GetConsignmentCount <回调标签> [角色名]

参数说明

返回或影响

• 该命令会发起一次寄售数量查询。
• 查询完成后会跳转到指定回调标签。
• 回调中的 <$PARAM(0)> 表示当前寄售物品数量。
• 统计结果包含过期和已售的寄售记录，不仅限于当前仍在售的商品。

示例

基础用法

#ACT
GetConsignmentCount ~GetConsignmentCallback

[~GetConsignmentCallback]
#ACT
SendMsg 5 "当前寄售物品数量：<$PARAM(0)>"

这段写法会查询当前角色的寄售数量，并在回调标签里把数量显示到聊天栏。

常见变体

#ACT
GetConsignmentCount ~CheckOtherConsignCount <$USERNAME>

[~CheckOtherConsignCount]
#IF
LARGE <$PARAM(0)> 0
#SAY
该角色当前存在寄售记录。

这类写法用于先查询指定角色是否存在寄售记录，再决定后续是否允许改名、转服或执行其它寄售相关操作。

注意事项

• 这是回调式命令，结果不在当前行直接返回，必须到指定标签里读取 <$PARAM(0)>。
• 返回数量包含过期和已售记录，因此不适合直接当作“当前上架中数量”使用。
• 如果脚本逻辑依赖更精确的寄售状态，应先确认你的业务是统计全部记录，还是只关心可结算、可取回或在售中的商品。
• 该命令用于统计寄售数量，不负责打开寄售界面；界面开关应使用 OpenConsignStore。

相关命令

• 打开或关闭寄售界面
• 修正寄售角色名