装备与物品
检查背包物品
检查当前角色背包中是否拥有指定物品，以及是否达到指定数量，适用于入场校验、兑换消耗和任务道具判断。
命令用途
CheckItem 用于检查当前角色背包中是否有指定物品。
它通常用于兑换 NPC、地图进入条件、任务交付前置判断和功能开启校验，用来确认玩家是否持有某种道具，以及数量是否满足要求。
命令名
CheckItem 支持英雄 H.
调用格式
CheckItem <物品名称> [数量]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
物品名称 | 是 | 要检查的物品名称，应与物品数据中的实际名称一致。 |
数量 | 否 | 需要满足的数量。省略时通常用于判断是否至少拥有该物品。 |
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 当背包中的目标物品达到指定数量时，
#IF条件成立。 - 当背包中没有该物品，或数量不足时，条件不成立。
- 该命令只负责检查，不会自动扣除物品；真正扣除通常由
Take一类命令完成。
示例
基础用法
#IF
CheckItem 裁决之杖 2
#SAY
你的背包里有 2 把裁决之杖。
#ELSESAY
你的背包里没有 2 把裁决之杖。
这段写法用于检查当前背包里是否已经拥有指定数量的目标物品，适合做地图进入、兑换资格或任务交付前置判断。
常见变体
#IF
CheckItem 金币凭证 1
#ACT
Take 金币凭证 1
GameGold + 10
SendMsg 5 "成功提交 1 张金币凭证。"
#ELSESAY
你背包里没有足够的金币凭证。
这类写法用于先检查道具是否足够，再执行扣除和发奖流程。CheckItem 负责判断，Take 负责实际扣物。
注意事项
CheckItem检查的是背包持有情况，不是指定装备位是否穿戴了某件装备。- 如果你要判断装备位、耐久或附加属性，应分别考虑
CheckItemW、CheckDura、CheckItemDuraCount、CheckItemAddValue这类命令。 - 物品名写错、别名不一致或包含不同后缀时，判断结果会直接失败，因此应尽量使用物品表中的实际名称。
- 在“检查后立刻扣物”的场景里，建议把
CheckItem和Take放在同一流程里连续处理，避免前后状态不一致。