Hero引擎实现指定人物单次领取元宝、IP限制领取元宝，核心是通过脚本命令记录领取状态，搭配条件判断拦截重复领取。两种需求可单独实现，也可组合使用，以下是完整脚本写法及注意事项。
先明确核心控制命令，这是脚本生效的基础。指定人物单次领取依赖“CHECKMEMBERTAG”（检测角色标签）和“SETMEMBERTAG”（设置角色标签）命令，通过给领取过的角色添加专属标签，后续检测到标签则拒绝领取；IP限制领取依赖“CHECKIPTAG”（检测IP标签）和“SETIPTAG”（设置IP标签）命令，原理与角色标签一致，同时需用“GETIP”命令获取当前玩家IP地址。另外，发放元宝使用“GIVEBINDYUANBAO”（绑定元宝）或“GIVEYUANBAO”（非绑定元宝）命令，按需选择即可。
指定人物领取一次元宝脚本写法，分三步实现：第一步定义触发方式，常用NPC对话触发，以“福利NPC”为例，在QFunction-0.txt或自定义NPC脚本中添加对话触发入口；第二步添加角色判断条件，精准指定可领取人物（支持单个或多个角色名），同时检测该角色是否已领取过（通过标签判断）；第三步执行领取逻辑，发放元宝后给角色添加专属标签，避免重复领取。
完整脚本示例（NPC对话触发）：#ACT //触发领取操作 CHECKNAME 张三 李四 王五 //指定可领取人物为张三、李四、王五，多个名字用空格分隔 IFNOT SENDMSG 0 你不是指定领取人员，无法领取！ //非指定人物提示 EXIT //退出脚本 ENDIF CHECKMEMBERTAG 1001 //检测角色是否有1001号标签（1001为自定义标签编号，可任意未使用编号） IF SENDMSG 0 你已领取过该元宝福利，无法重复领取！ EXIT ENDIF GIVEYUANBAO 500 //发放500非绑定元宝，如需绑定元宝替换为GIVEBINDYUANBAO 500 SETMEMBERTAG 1001 //给角色添加1001号标签，标记已领取 SENDMSG 0 元宝领取成功，请注意查收！ //领取成功提示
脚本关键说明：“CHECKNAME”后可添加任意数量角色名，支持全服指定多个人物；标签编号（如1001）需选择未被其他脚本使用的编号，避免标签冲突；若需重置领取权限（如重新开放领取），可通过“CLEARMEMBERTAG 角色名 1001”命令清除指定角色的标签，或在M2服务器“角色管理”中手动清除。
IP限制领取元宝脚本写法，核心是通过IP标签控制，支持单IP单次领取或单IP固定周期内领取一次，以下是单IP单次领取完整脚本（同样以NPC触发为例）：#ACT GETIP //获取当前玩家IP地址 CHECKIPTAG 2001 //检测该IP是否有2001号标签（自定义未使用编号） IF SENDMSG 0 该IP已领取过元宝福利，请勿重复提交！ EXIT ENDIF GIVEBINDYUANBAO 300 //发放300绑定元宝 SETIPTAG 2001 //给当前IP添加2001号标签 SENDMSG 0 绑定元宝领取成功，每个IP仅可领取一次！
若需设置单IP每日可领取一次（周期限制），需添加时间判断命令，修改后的核心脚本片段：#ACT GETIP CHECKIPTAG 2001 //检测IP是否已领取 IF SENDMSG 0 该IP今日已领取，明日可再次领取！ EXIT ENDIF GIVEBINDYUANBAO 300 SETIPTAG 2001 SETIPTAGEXPIRE 2001 1440 //设置2001号IP标签1440分钟（24小时）后失效 SENDMSG 0 每日绑定元宝领取成功，明日同一时间可再次领取！
指定人物+IP双重限制脚本写法，适合严格控制福利发放场景，将两种条件叠加即可，完整示例：#ACT CHECKNAME 赵六 孙七 //指定可领取人物 GETIP CHECKMEMBERTAG 3001 //检测角色是否已领取 IF SENDMSG 0 你已领取过福利，无法重复参与！ EXIT ENDIF CHECKIPTAG 3002 //检测IP是否已领取 IF SENDMSG 0 该IP已领取过福利，请勿更换账号尝试！ EXIT ENDIF GIVEYUANBAO 800 //发放800非绑定元宝 SETMEMBERTAG 3001 //标记角色已领取 SETIPTAG 3002 //标记IP已领取 SENDMSG 0 双重验证通过，元宝已到账！
脚本调试常见问题及解决方法：一是角色领取后仍可重复领取，检查“SETMEMBERTAG”命令是否遗漏，或标签编号被其他脚本覆盖，更换新的标签编号即可；二是IP限制失效，确认是否使用“GETIP”命令获取IP，部分内网环境需在M2服务器“网络设置”中开启“获取真实IP”功能；三是指定人物判断失效，检查“CHECKNAME”后角色名是否准确（区分大小写），多个角色名需用空格分隔；四是脚本无响应，查看脚本是否存在语法错误（如缺少“#ACT”“EXIT”等关键命令），可在M2服务器“脚本管理”中校验脚本语法。
补充实用技巧：一是标签编号管理，建议按功能分类设置（如角色福利标签用1000-1999段，IP限制标签用2000-2999段），避免混乱；二是批量清除领取状态，若需全服重置领取权限，可在M2服务器“命令执行”中输入“CLEARMEMBERTAGALL 标签编号”（清除所有角色标签）、“CLEARIPTAGALL 标签编号”（清除所有IP标签）；三是领取记录查询，通过“QUERYMEMBERTAG 角色名 标签编号”命令查询指定角色是否领取，“QUERYIPTAG IP地址 标签编号”查询指定IP领取状态。
脚本部署步骤：第一步打开Hero引擎脚本编辑器，或用记事本打开目标脚本文件（如QFunction-0.txt、NPC脚本文件）；第二步复制对应需求的脚本代码，粘贴到合适位置（NPC对话触发需粘贴到NPC对话脚本段）；第三步修改角色名、元宝数量、标签编号等参数，按需调整；第四步保存脚本文件，在M2服务器中重载脚本（“脚本管理→重载所有脚本”），即可生效。
总结来说，Hero引擎限制元宝领取的核心是“标签标记+条件判断”，指定人物依赖角色标签，IP限制依赖IP标签，两种需求可灵活组合。按上述脚本写法配置，配合调试技巧，即可实现精准的福利发放控制，避免重复领取问题。
