一、指定人物领取一次元宝限制脚本（单次永久限制）
1.1核心逻辑
通过给指定人物绑定专属变量，领取元宝时检测变量状态，未触发则执行领取操作并修改变量值，已触发则拒绝领取，变量随人物数据永久保存，实现单次领取限制。
1.2脚本编写（NPC触发模式）
脚本放置于NPC对话脚本文件中，以“新手福利NPC”为例，指定人物以“传奇勇士”为例，领取元宝数量设为1000，具体代码如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│专属元宝福利│/SCOLOR=254>\
<│指定人物可领取1000元宝（终身一次）│/SCOLOR=254>\
<│<立即领取/@getyuanbao>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@getyuanbao)
#IF
CHECKNAME传奇勇士//检测是否为指定人物
#AND
CHECKVARHUMAN1001=0//检测人物变量1001是否为0（未领取）
#ACT
GAMEGOLD+1000//发放1000元宝
SETVARHUMAN10011//将人物变量1001设为1（标记已领取）
SAVEVARHUMAN//保存人物变量
MESSAGEBOX元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你已领取过该元宝福利，不可重复领取！
#ENDIF
1.3关键参数说明
-CHECKNAME传奇勇士：核心检测命令，精准匹配指定人物名称，名称需与游戏内人物角色名完全一致，区分大小写。
-CHECKVARHUMAN1001=0：HUMAN代表人物专属变量，1001为变量编号（可自定义1-9999范围内数字），0为初始未领取状态。
-GAMEGOLD+1000：发放元宝命令，“+1000”可修改为任意所需元宝数量，负数为扣除元宝。
-SAVEVARHUMAN：强制保存人物变量，确保服务器重启后变量状态不丢失，避免重复领取漏洞。
1.4多指定人物扩展写法
若需支持多个指定人物领取，可通过叠加CHECKNAME命令实现，示例如下：
(@getyuanbao)
#IF
(CHECKNAME传奇勇士)OR(CHECKNAME龙城守护者)OR(CHECKNAME沙巴克先锋)
#AND
CHECKVARHUMAN1001=0
#ACT
GAMEGOLD+1000
SETVARHUMAN10011
SAVEVARHUMAN
MESSAGEBOX元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
(NOTCHECKNAME传奇勇士)AND(NOTCHECKNAME龙城守护者)AND(NOTCHECKNAME沙巴克先锋)
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你已领取过该元宝福利，不可重复领取！
#ENDIF
二、指定人物领取一次元宝限制脚本（周期性限制）
2.1核心逻辑
结合时间变量与人物变量，设置领取周期（如每日/每周一次），周期结束后自动重置变量，允许再次领取，兼顾限制与周期性福利需求。
2.2每日一次领取脚本示例
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│每日专属元宝福利│/SCOLOR=254>\
<│指定人物每日可领取500元宝│/SCOLOR=254>\
<│<立即领取/@dailymb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@dailymb)
#IF
CHECKNAME传奇勇士
#AND
CHECKVARHUMAN1002=0//当日未领取标记
#ACT
GAMEGOLD+500
SETVARHUMAN10021
SAVEVARHUMAN
SETTIMERVARHUMAN1002864000//86400秒（24小时）后重置变量为0
MESSAGEBOX每日元宝领取成功！明日可再次领取。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你今日已领取过该福利，明日再来吧！
#ENDIF
2.3周期重置关键命令
SETTIMERVARHUMAN1002864000：定时器变量命令，HUMAN为人物变量范围，1002为变量编号，86400为倒计时秒数，0为倒计时结束后变量重置值，可根据需求修改秒数（如每周设为604800秒）。
三、IP限制元宝领取脚本（单次/周期性限制）
3.1核心逻辑
利用Hero引擎获取玩家IP地址功能，将IP信息存储至全局变量或IP专属变量中，领取时检测当前IP是否已存在于变量内，存在则拒绝领取，实现单IP领取限制。
3.2单IP终身一次领取脚本（全服通用）
脚本通过全局变量存储已领取IP，适用于全服玩家单IP终身一次领取场景，示例如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│IP专属元宝福利│/SCOLOR=254>\
<│单个IP终身可领取800元宝│/SCOLOR=254>\
<│<立即领取/@iplimitmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@iplimitmb)
#IF
NOTCHECKVARGLOBALIP_YUANBAO=<$IP>//检测当前IP是否已存储
#ACT
GAMEGOLD+800
SETVARGLOBALIP_YUANBAO<$IP>//存储当前IP至全局变量
SAVEVARGLOBAL//保存全局变量
MESSAGEBOX元宝领取成功！该IP终身仅可领取一次。
#ELSEACT
MESSAGEBOX该IP已领取过福利，不可重复领取！
3.3单IP每日一次领取脚本（全服通用）
结合定时器变量实现IP每日领取限制，当日领取后锁定，次日自动解锁，示例如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│IP每日元宝福利│/SCOLOR=254>\
<│单个IP每日可领取300元宝│/SCOLOR=254>\
<│<立即领取/@dailyipmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@dailyipmb)
#IF
NOTCHECKVARGLOBALIP_DAILY_<$IP>=1//检测当前IP当日是否已领取
#ACT
GAMEGOLD+300
SETVARGLOBALIP_DAILY_<$IP>1//标记当前IP当日已领取
SAVEVARGLOBAL
SETTIMERVARGLOBALIP_DAILY_<$IP>864000//24小时后重置标记
MESSAGEBOX每日IP元宝领取成功！明日可再次领取。
#ELSEACT
MESSAGEBOX该IP今日已领取过福利，明日再来吧！
3.4关键参数说明
-<$IP>：Hero引擎内置IP获取变量，自动读取当前玩家登录IP地址，无需手动配置。
-GLOBAL：全局变量标识，存储的IP信息全服可见，所有玩家领取时均会检测该变量。
-IP_DAILY_<$IP>：动态变量命名，将IP作为变量后缀，确保每个IP对应独立变量，避免相互干扰。
四、指定人物+IP双重限制脚本（高阶防刷）
4.1核心逻辑
同时检测指定人物身份、人物领取变量、IP领取变量，三重校验确保福利仅能由指定人物在指定IP下领取一次，最大化防止刷取漏洞。
4.2双重限制脚本示例
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│专属IP元宝福利│/SCOLOR=254>\
<│指定人物+指定IP终身一次领取1000元宝│/SCOLOR=254>\
<│<立即领取/@doublelimitmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@doublelimitmb)
#IF
CHECKNAME传奇勇士//校验指定人物
#AND
CHECKVARHUMAN1003=0//校验人物未领取
#AND
NOTCHECKVARGLOBALIP_SPEC_<$IP>=1//校验IP未领取
#AND
CHECKIP192.168.1.0-192.168.1.255//限定IP段（可改为具体IP）
#ACT
GAMEGOLD+1000
SETVARHUMAN10031
SETVARGLOBALIP_SPEC_<$IP>1
SAVEVARHUMAN
SAVEVARGLOBAL
MESSAGEBOX专属IP元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSEIF
CHECKVARHUMAN1003=1
MESSAGEBOX你已领取过该福利，不可重复领取！
#ELSEIF
CHECKVARGLOBALIP_SPEC_<$IP>=1
MESSAGEBOX该IP已领取过福利，不可重复领取！
#ELSE
MESSAGEBOX你不在指定IP范围内，无法领取！
#ENDIF
4.3限定IP段/单个IP说明
CHECKIP192.168.1.0-192.168.1.255：限定IP段领取，若需限定单个IP，可改为CHECKIP192.168.1.100（替换为目标IP），支持多IP段叠加，格式为CHECKIP192.168.1.100-192.168.1.200ANDCHECKIP192.168.2.50-192.168.2.150。
五、脚本部署与测试要点
5.1部署步骤
1.打开传奇服务端目录，找到NPC脚本文件夹（通常为Envir/NPCs），选择目标NPC脚本文件（如新手村NPC.txt）。
2.将编写好的脚本复制粘贴至NPC脚本文件末尾，确保脚本格式与原有内容一致，避免语法错误。
3.保存文件后，登录服务端后台，执行“重新加载NPC脚本”命令，无需重启服务器即可生效。
5.2测试要点
-指定人物测试：使用指定名称人物登录，领取元宝后再次尝试领取，确认提示“已领取”，且元宝数量正确增加。
-IP限制测试：更换不同IP登录账号领取，确认未领取IP可正常领取，已领取IP提示“已领取”。
-变量保存测试：领取元宝后重启服务器，再次登录查看变量状态，确认未重置，无法重复领取。
-边界测试：使用非指定人物、非限定IP登录，确认提示信息准确，无领取漏洞。
5.3常见问题排查
-脚本不生效：检查脚本命令是否拼写错误（如GAMEGOLD误写为GAMELGOLD），变量编号是否重复，重启服务器后重新加载脚本。
-可重复领取：确认是否添加SAVEVAR命令，全局变量需添加SAVEVARGLOBAL，人物变量需添加SAVEVARHUMAN。
-IP检测失效：检查<$IP>变量是否正确使用，确保服务器网络设置正常，可通过MESSAGEBOX<$IP>命令调试，查看IP是否正常获取。
-提示信息错误：检查ELSEACT分支逻辑，确保每个校验条件对应的提示信息准确，避免分支嵌套错误。
六、脚本优化与扩展建议
6.1优化方向
1.变量命名规范：采用“用途+类型+编号”命名，如HUMAN_指定人物元宝_1001，便于后续维护与排查。
2.批量领取限制：若需支持批量指定人物，可将人物名称写入配置文件，通过读取配置文件实现批量校验，减少脚本冗余。
3.领取记录留存：添加日志记录命令，领取成功后记录人物名称、IP、领取时间，便于后续查询与追溯，命令示例：WRITELog元宝领取记录<$USERNAME><$IP><$TIME>领取1000元宝。
6.2扩展场景
1.多档位领取限制：设置不同指定人物对应不同元宝数量，通过多分支CHECKNAME命令实现，示例：CHECKNAME传奇勇士则发放1000元宝，CHECKNAME龙城守护者则发放1500元宝。
2.组合福利领取：领取元宝时同步发放道具，添加GIVE命令即可，示例：GIVE疗伤药10（发放10个疗伤药）。
3.等级关联领取：在原有限制基础上添加等级校验，示例：CHECKLEVELEX>=50（需等级50以上方可领取）。
以上脚本均适配Hero引擎全系列版本，编写时严格遵循Hero引擎脚本语法规范，无需额外安装插件，部署后即可正常使用。根据实际运营需求，可灵活调整元宝数量、领取周期、IP范围及指定人物，兼顾福利发放与防刷取需求。
1.1核心逻辑
通过给指定人物绑定专属变量，领取元宝时检测变量状态，未触发则执行领取操作并修改变量值，已触发则拒绝领取，变量随人物数据永久保存，实现单次领取限制。
1.2脚本编写（NPC触发模式）
脚本放置于NPC对话脚本文件中，以“新手福利NPC”为例，指定人物以“传奇勇士”为例，领取元宝数量设为1000，具体代码如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│专属元宝福利│/SCOLOR=254>\
<│指定人物可领取1000元宝（终身一次）│/SCOLOR=254>\
<│<立即领取/@getyuanbao>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@getyuanbao)
#IF
CHECKNAME传奇勇士//检测是否为指定人物
#AND
CHECKVARHUMAN1001=0//检测人物变量1001是否为0（未领取）
#ACT
GAMEGOLD+1000//发放1000元宝
SETVARHUMAN10011//将人物变量1001设为1（标记已领取）
SAVEVARHUMAN//保存人物变量
MESSAGEBOX元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你已领取过该元宝福利，不可重复领取！
#ENDIF
1.3关键参数说明
-CHECKNAME传奇勇士：核心检测命令，精准匹配指定人物名称，名称需与游戏内人物角色名完全一致，区分大小写。
-CHECKVARHUMAN1001=0：HUMAN代表人物专属变量，1001为变量编号（可自定义1-9999范围内数字），0为初始未领取状态。
-GAMEGOLD+1000：发放元宝命令，“+1000”可修改为任意所需元宝数量，负数为扣除元宝。
-SAVEVARHUMAN：强制保存人物变量，确保服务器重启后变量状态不丢失，避免重复领取漏洞。
1.4多指定人物扩展写法
若需支持多个指定人物领取，可通过叠加CHECKNAME命令实现，示例如下：
(@getyuanbao)
#IF
(CHECKNAME传奇勇士)OR(CHECKNAME龙城守护者)OR(CHECKNAME沙巴克先锋)
#AND
CHECKVARHUMAN1001=0
#ACT
GAMEGOLD+1000
SETVARHUMAN10011
SAVEVARHUMAN
MESSAGEBOX元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
(NOTCHECKNAME传奇勇士)AND(NOTCHECKNAME龙城守护者)AND(NOTCHECKNAME沙巴克先锋)
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你已领取过该元宝福利，不可重复领取！
#ENDIF
二、指定人物领取一次元宝限制脚本（周期性限制）
2.1核心逻辑
结合时间变量与人物变量，设置领取周期（如每日/每周一次），周期结束后自动重置变量，允许再次领取，兼顾限制与周期性福利需求。
2.2每日一次领取脚本示例
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│每日专属元宝福利│/SCOLOR=254>\
<│指定人物每日可领取500元宝│/SCOLOR=254>\
<│<立即领取/@dailymb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@dailymb)
#IF
CHECKNAME传奇勇士
#AND
CHECKVARHUMAN1002=0//当日未领取标记
#ACT
GAMEGOLD+500
SETVARHUMAN10021
SAVEVARHUMAN
SETTIMERVARHUMAN1002864000//86400秒（24小时）后重置变量为0
MESSAGEBOX每日元宝领取成功！明日可再次领取。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSE
MESSAGEBOX你今日已领取过该福利，明日再来吧！
#ENDIF
2.3周期重置关键命令
SETTIMERVARHUMAN1002864000：定时器变量命令，HUMAN为人物变量范围，1002为变量编号，86400为倒计时秒数，0为倒计时结束后变量重置值，可根据需求修改秒数（如每周设为604800秒）。
三、IP限制元宝领取脚本（单次/周期性限制）
3.1核心逻辑
利用Hero引擎获取玩家IP地址功能，将IP信息存储至全局变量或IP专属变量中，领取时检测当前IP是否已存在于变量内，存在则拒绝领取，实现单IP领取限制。
3.2单IP终身一次领取脚本（全服通用）
脚本通过全局变量存储已领取IP，适用于全服玩家单IP终身一次领取场景，示例如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│IP专属元宝福利│/SCOLOR=254>\
<│单个IP终身可领取800元宝│/SCOLOR=254>\
<│<立即领取/@iplimitmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@iplimitmb)
#IF
NOTCHECKVARGLOBALIP_YUANBAO=<$IP>//检测当前IP是否已存储
#ACT
GAMEGOLD+800
SETVARGLOBALIP_YUANBAO<$IP>//存储当前IP至全局变量
SAVEVARGLOBAL//保存全局变量
MESSAGEBOX元宝领取成功！该IP终身仅可领取一次。
#ELSEACT
MESSAGEBOX该IP已领取过福利，不可重复领取！
3.3单IP每日一次领取脚本（全服通用）
结合定时器变量实现IP每日领取限制，当日领取后锁定，次日自动解锁，示例如下：
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│IP每日元宝福利│/SCOLOR=254>\
<│单个IP每日可领取300元宝│/SCOLOR=254>\
<│<立即领取/@dailyipmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@dailyipmb)
#IF
NOTCHECKVARGLOBALIP_DAILY_<$IP>=1//检测当前IP当日是否已领取
#ACT
GAMEGOLD+300
SETVARGLOBALIP_DAILY_<$IP>1//标记当前IP当日已领取
SAVEVARGLOBAL
SETTIMERVARGLOBALIP_DAILY_<$IP>864000//24小时后重置标记
MESSAGEBOX每日IP元宝领取成功！明日可再次领取。
#ELSEACT
MESSAGEBOX该IP今日已领取过福利，明日再来吧！
3.4关键参数说明
-<$IP>：Hero引擎内置IP获取变量，自动读取当前玩家登录IP地址，无需手动配置。
-GLOBAL：全局变量标识，存储的IP信息全服可见，所有玩家领取时均会检测该变量。
-IP_DAILY_<$IP>：动态变量命名，将IP作为变量后缀，确保每个IP对应独立变量，避免相互干扰。
四、指定人物+IP双重限制脚本（高阶防刷）
4.1核心逻辑
同时检测指定人物身份、人物领取变量、IP领取变量，三重校验确保福利仅能由指定人物在指定IP下领取一次，最大化防止刷取漏洞。
4.2双重限制脚本示例
(@main)
#IF
#SAY
<╔───────────────────────────╗/SCOLOR=254>\
<│专属IP元宝福利│/SCOLOR=254>\
<│指定人物+指定IP终身一次领取1000元宝│/SCOLOR=254>\
<│<立即领取/@doublelimitmb>│/SCOLOR=254>\
<╚───────────────────────────╝/SCOLOR=254>\
(@doublelimitmb)
#IF
CHECKNAME传奇勇士//校验指定人物
#AND
CHECKVARHUMAN1003=0//校验人物未领取
#AND
NOTCHECKVARGLOBALIP_SPEC_<$IP>=1//校验IP未领取
#AND
CHECKIP192.168.1.0-192.168.1.255//限定IP段（可改为具体IP）
#ACT
GAMEGOLD+1000
SETVARHUMAN10031
SETVARGLOBALIP_SPEC_<$IP>1
SAVEVARHUMAN
SAVEVARGLOBAL
MESSAGEBOX专属IP元宝领取成功！终身仅可领取一次。
#ELSEACT
#IF
NOTCHECKNAME传奇勇士
MESSAGEBOX你不是指定领取人物，无法领取！
#ELSEIF
CHECKVARHUMAN1003=1
MESSAGEBOX你已领取过该福利，不可重复领取！
#ELSEIF
CHECKVARGLOBALIP_SPEC_<$IP>=1
MESSAGEBOX该IP已领取过福利，不可重复领取！
#ELSE
MESSAGEBOX你不在指定IP范围内，无法领取！
#ENDIF
4.3限定IP段/单个IP说明
CHECKIP192.168.1.0-192.168.1.255：限定IP段领取，若需限定单个IP，可改为CHECKIP192.168.1.100（替换为目标IP），支持多IP段叠加，格式为CHECKIP192.168.1.100-192.168.1.200ANDCHECKIP192.168.2.50-192.168.2.150。
五、脚本部署与测试要点
5.1部署步骤
1.打开传奇服务端目录，找到NPC脚本文件夹（通常为Envir/NPCs），选择目标NPC脚本文件（如新手村NPC.txt）。
2.将编写好的脚本复制粘贴至NPC脚本文件末尾，确保脚本格式与原有内容一致，避免语法错误。
3.保存文件后，登录服务端后台，执行“重新加载NPC脚本”命令，无需重启服务器即可生效。
5.2测试要点
-指定人物测试：使用指定名称人物登录，领取元宝后再次尝试领取，确认提示“已领取”，且元宝数量正确增加。
-IP限制测试：更换不同IP登录账号领取，确认未领取IP可正常领取，已领取IP提示“已领取”。
-变量保存测试：领取元宝后重启服务器，再次登录查看变量状态，确认未重置，无法重复领取。
-边界测试：使用非指定人物、非限定IP登录，确认提示信息准确，无领取漏洞。
5.3常见问题排查
-脚本不生效：检查脚本命令是否拼写错误（如GAMEGOLD误写为GAMELGOLD），变量编号是否重复，重启服务器后重新加载脚本。
-可重复领取：确认是否添加SAVEVAR命令，全局变量需添加SAVEVARGLOBAL，人物变量需添加SAVEVARHUMAN。
-IP检测失效：检查<$IP>变量是否正确使用，确保服务器网络设置正常，可通过MESSAGEBOX<$IP>命令调试，查看IP是否正常获取。
-提示信息错误：检查ELSEACT分支逻辑，确保每个校验条件对应的提示信息准确，避免分支嵌套错误。
六、脚本优化与扩展建议
6.1优化方向
1.变量命名规范：采用“用途+类型+编号”命名，如HUMAN_指定人物元宝_1001，便于后续维护与排查。
2.批量领取限制：若需支持批量指定人物，可将人物名称写入配置文件，通过读取配置文件实现批量校验，减少脚本冗余。
3.领取记录留存：添加日志记录命令，领取成功后记录人物名称、IP、领取时间，便于后续查询与追溯，命令示例：WRITELog元宝领取记录<$USERNAME><$IP><$TIME>领取1000元宝。
6.2扩展场景
1.多档位领取限制：设置不同指定人物对应不同元宝数量，通过多分支CHECKNAME命令实现，示例：CHECKNAME传奇勇士则发放1000元宝，CHECKNAME龙城守护者则发放1500元宝。
2.组合福利领取：领取元宝时同步发放道具，添加GIVE命令即可，示例：GIVE疗伤药10（发放10个疗伤药）。
3.等级关联领取：在原有限制基础上添加等级校验，示例：CHECKLEVELEX>=50（需等级50以上方可领取）。
以上脚本均适配Hero引擎全系列版本，编写时严格遵循Hero引擎脚本语法规范，无需额外安装插件，部署后即可正常使用。根据实际运营需求，可灵活调整元宝数量、领取周期、IP范围及指定人物，兼顾福利发放与防刷取需求。