货币与经济
搜寻摆摊物品
按物品名与出售类型查询摆摊中的最低价物品，并把结果自动以消息形式发给玩家。
命令名
SearchOnSaleItem
命令用途
SearchOnSaleItem 用于按物品名与出售类型查询摆摊中的物品，并把查询结果自动以 SENDMSG 形式发送给玩家，写在 #IF 段中使用。
调用格式
SearchOnSaleItem <物品名> <出售类型> <返回最高个数>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
物品名 | 是 | 要查询的物品名称，例如 开天。 |
出售类型 | 是 | 元宝 或 金币。 |
返回最高个数 | 是 | 返回结果的最大条数，范围 1~10。 |
返回或影响
- 这是条件型命令，写在
#IF段；查询结果自动以sendmsg形式发送给玩家，不需要脚本再拼文本。 - 找到符合条件的摆摊物品时条件成立，可进入
#ACT段处理后续扣费等逻辑。 - 找不到时走
#ELSEACT分支。
示例
基础用法
#IF
CHECKGAMEGOLD ~ 1
SearchOnSaleItem 开天 元宝 3
#ACT
GAMEGOLD - 1
#ELSEACT
SENDMSG 5 找不到指定的物品
这段写法会先检查元宝是否足够（CHECKGAMEGOLD ~ 1 等同于 CHECKGAMEGOLD ? 1，~ 表示大于等于检测），再查询摆摊中出售的「开天」；查询成功时扣除 1 点元宝作为查询费用，失败时提示找不到物品。
注意事项
- 该命令必须写在
#IF段；当成#ACT执行命令使用会静默失败。 - 查询结果由引擎直接以消息发送给玩家，脚本不要再重复发送一次结果。
- 查询费用类扣款建议放在
#ACT段，避免查询失败也扣费。