在基于 Legend HERO 引擎 的传奇游戏服务器中，会员系统是吸引玩家、增加收入的重要手段。作为服务器管理员或脚本开发者，经常需要在各种NPC对话、功能触发点、地图进入条件等地方检查玩家是否为会员。HERO引擎提供了一个非常核心且常用的变量 HumInfo.CheckItemValue 来检测玩家身上的特定状态，其中就包括会员等级。本文将深入浅出地讲解如何使用这个命令来实现会员检测。
核心目标： 我们需要一种方法，在脚本中询问：“当前和我对话/触发事件的玩家，你是什么会员级别？” 然后根据这个级别执行不同的操作（比如允许进入地图、发送福利、提供特殊服务等）。
一、HERO引擎会员检测的核心命令
HERO引擎检测玩家状态值的主要变量是：
• HumInfo.CheckItemValue
• 关键参数： HumInfo.CheckItemValue 需要接收一个参数，这个参数指明你想查询哪种状态值。
• 会员状态值类型： 对于会员等级检测，这个参数是 -100。
二、脚本格式与基本语法
当你需要在脚本中检测当前玩家的会员级别时，通常这样使用：
#IF
EQUAL HumInfo.CheckItemValue(-100) <期望的会员等级值>
#ACT
(满足会员等级条件后，需要执行的操作。例如：传送、发送物品、提示信息等)
#ELSEACT
(不满足会员等级条件时，需要执行的操作。例如：提示权限不足、关闭对话框、发送普通玩家信息等)
三、命令详解
1. HumInfo.CheckItemValue(-100): 这是检测的核心。它表示询问系统：“当前玩家的-100类型的状态值是多少？”在HERO引擎的默认设置中，-100 对应的就是玩家的会员等级。
2. EQUAL: 这是一个常用的条件判断指令，意思是“等于”。
3. <期望的会员等级值>: 你需要用具体的数字替换这里。这个数字代表你希望玩家具备的会员等级。
◦ 通常，0 表示 非会员 (普通玩家)。
◦ 从 1 开始，数值越大，会员级别通常越高（比如 1 表示青铜会员，2 表示白银会员，3 表示黄金会员，等等）。具体等级数值定义由你在 !Setup.txt 或 脚本 中配置会员系统时决定。
四、脚本实例演示
场景1：会员专属地图传送员
假设：
• 非会员 (级别=0) 不能进入。
• 青铜会员 (级别=1) 可以免费进入地图 M001。
• 黄金会员 (级别=3) 可以免费进入更高级的地图 M003，并有特殊提示。
[@Main]
大家好，我是VIP专属传送员！\ \
请选择服务：\ \
<★进入青铜会员专属地图/@GoBronze> \
<★进入黄金会员专属地图/@GoGold> \ \
<离开/@Exit>
[@GoBronze]
#IF
EQUAL HumInfo.CheckItemValue(-100) 1 ; // 检测是否是青铜会员 (级别=1)
#ACT
MAPMOVE M001 10 10 ; // 免费传送到青铜会员专属地图
SENDMSG 6 "尊贵的青铜会员，欢迎进入专属地图！祝您游戏愉快！"
#ELSEACT
MESSAGEBOX "抱歉，您不是青铜会员或会员等级不足，无法使用此服务！"
GOTO @Main
[@GoGold]
#IF
EQUAL HumInfo.CheckItemValue(-100) 3 ; // 检测是否是黄金会员 (级别=3)
#ACT
MAPMOVE M003 15 15 ; // 免费传送到黄金会员专属地图
SENDMSG 6 "超级尊贵的黄金会员大人驾临！专属服务为您开启！"
#ELSEACT
MESSAGEBOX "抱歉，您不是黄金会员或会员等级不足，无法使用此服务！"
GOTO @Main
场景2：会员每日福利领取员
[@Main]
每日福利发放点！\ \
<★领取会员福利/@GetVIPBonus> \ \
<离开/@Exit>
[@GetVIPBonus]
#IF
SMALL HumInfo.CheckItemValue(-100) 1 ; // 检测会员等级是否小于1 (即非会员或等级低于1，非会员=0)
#ACT
MESSAGEBOX "很抱歉，只有正式会员才能领取每日福利哦！"
GOTO @Main
#IF
LARGE HumInfo.CheckItemValue(-100) 2 ; // 检测会员等级是否大于2 (即白银会员以上级别)
#ACT
GIVE 金币 1000000 ; // 送大量金币
GIVE VIP专属宝石 1 ; // 送专属物品1
GIVE VIP专属药水 5 ; // 送专属物品2
SENDMSG 6 "尊贵的VIP达人，这是您今日的丰厚福利，请查收！"
BREAK
#IF
EQUAL HumInfo.CheckItemValue(-100) 1 ; // 检测是否是青铜会员 (级别=1)
#ACT
GIVE 金币 500000 ; // 送普通数量金币
GIVE VIP专属药水 2 ; // 送少量专属物品
SENDMSG 6 "青铜会员您好，您的每日福利已发放，请查收！"
BREAK
#IF
EQUAL HumInfo.CheckItemValue(-100) 2 ; // 检测是否是白银会员 (级别=2)
#ACT
GIVE 金币 750000 ; // 送中等数量金币
GIVE VIP专属宝石 1 ; // 送专属物品1
GIVE VIP专属药水 3 ; // 送专属物品2
SENDMSG 6 "尊贵的白银会员，您的专属福利已送达！"
BREAK
#ELSEACT
MESSAGEBOX "获取您的会员信息失败，请联系管理员！"
五、关键点总结与常见问题解答
1. 核心命令： 记住 EQUAL HumInfo.CheckItemValue(-100) X 是关键，X 是你设置的会员等级数字。
2. 等级数值： 0 通常是非会员。1, 2, 3, ... 代表逐级提升的会员级别（由你自己定义）。
3. 灵活运用条件判断： 除了 EQUAL (等于)，还可以结合：
◦ LARGE (大于)
◦ SMALL (小于)
◦ LARGEOREQUAL (大于等于)
◦ SMALLOREQUAL (小于等于)
来实现更复杂的会员权限判断（如场景2中的青铜以上会员，白银以上会员）。
4. 调用位置： 这个检测命令可以用在：
◦ 几乎所有类型的NPC脚本（点击触发、对话选项触发）
◦ 登录脚本（玩家登录时检查会员状态，发放奖励）
◦ 地图事件触发器（进入地图时检查）
◦ 函数脚本中调用
5. 常见错误：
◦ 变量名错误： 必须确保是 HumInfo.CheckItemValue，注意大小写和拼写。
◦ 参数错误： -100 必须放在括号里。
◦ 混淆等级与数组索引： -100 是查询类型（会员等级），返回的数字才是等级值（1, 2, 3等），不要混淆这两个概念。
◦ 返回值处理： HumInfo.CheckItemValue(-100) 返回的是一个整数值，你需要用条件判断去比较这个返回值，而不是直接使用它来传送或给物品（除非结合其他命令进行动态赋值）。
六、进阶应用
• 检查过期会员： 可以将玩家当前的会员级别（通过 HumInfo.CheckItemValue(-100)获取）与数据库中记录的有效期进行对比判断。
• 多条件组合： 使用 CHECK 指令组合多个条件。例如，检测既是会员 (HumInfo.CheckItemValue(-100) > 0) 且等级达到要求 (EQUAL HumInfo.CheckItemValue(-100) >= 3) 并且携带特定物品 (CHECKITEM 会员令牌 1) 才能完成某个任务。
• 登录触发福利： 在 QManage.txt 中写脚本，玩家登录时检测 HumInfo.CheckItemValue(-100) > 0，然后根据等级发放每日登录奖励。
