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