一、核心实现逻辑两类限制脚本核心原理
Hero引擎实现元宝领取限制，核心依赖“脚本标记”“IP记录”两大机制：指定人物单次领取用“脚本标记+人物名称校验”，IP限制领取用“IP记录变量+IP重复校验”，均通过QFunction脚本文件编写，无需额外插件，直接写入即可生效。
两类脚本可单独使用，也可组合实现“指定人物+IP双重限制”，以下为具体脚本代码、配置步骤及异常排查，脚本语法严格遵循Hero规范，无冗余内容，可直接复制修改使用。
二、第一类：指定人物领取一次元宝限制脚本（常用场景）
核心需求：指定人物（如“新手指导员”“测试账号1”）领取一次元宝后，再次触发领取指令时提示无法领取，通过“人物名称校验+脚本标记”实现，步骤如下：
1.脚本编写（写入QFunction-0.txt）
脚本核心：先校验是否为指定人物→再校验是否已领取（脚本标记）→未领取则发放元宝并添加标记→已领取则提示限制，代码如下：
[@领取元宝]
#IF
CheckName新手指导员;校验是否为指定人物，替换为实际角色名称
CheckScriptFlag1000;校验标记100是否为0（0=未领取，1=已领取）
#ACT
GiveGold1000;发放1000元宝（GiveGold为元宝发放命令，数值可修改）
SetScriptFlag1001;设置标记100为1，标记已领取
SendMsg7元宝领取成功！本次领取仅可一次，不可重复领取！;游戏内提示
#ELSEACT
SendMsg7你已领取过元宝，本次活动仅可领取一次！;重复领取提示
备注：1.标记100可自定义（建议100-999区间，避免与其他脚本冲突）；2.可新增多个指定人物，在#IF下添加多个CheckName语句（如CheckName测试账号1）；3.元宝数值可按需修改（如GiveGold5000发放5000元宝）。
2.多指定人物适配脚本（扩展）
若需多个指定人物分别领取一次，可通过“标记区分”实现，避免相互影响，代码如下：
[@领取元宝]
#IF
CheckName新手指导员
CheckScriptFlag1000
#ACT
GiveGold1000
SetScriptFlag1001
SendMsg7新手指导员元宝领取成功，仅可领取一次！
#ELSEIF
CheckName测试账号1
CheckScriptFlag1010;用标记101区分，避免与上一人物冲突
#ACT
GiveGold1000
SetScriptFlag1011
SendMsg7测试账号1元宝领取成功，仅可领取一次！
#ELSEACT
SendMsg7你已领取过元宝或非指定领取人物！
3.脚本配置与生效步骤
1.脚本写入：打开Mirserver\Envir\Market_Def\QFunction-0.txt，将上述脚本复制到文件末尾，保存文件；
2.编码设置：确保文件编码为ANSI，避免中文乱码导致脚本失效；
3.动态加载：打开M2Server界面，点击“脚本”→“动态加载脚本”，选择QFunction-0.txt加载，无需重启引擎，脚本立即生效。
三、第二类：IP限制领取元宝单次领取脚本（防多开领取）
核心需求：同一IP仅可领取一次元宝，无论登录多少账号，均限制单次领取，通过“IP变量记录+重复校验”实现，步骤如下：
1.脚本编写（写入QFunction-0.txt）
脚本核心：获取当前玩家IP→校验该IP是否已领取→未领取则发放元宝并记录IP→已领取则提示限制，代码如下：
[@领取元宝]
#IF
CheckIPRecord200;校验IP是否已记录（200为IP记录标识，可自定义）
#ACT
SendMsg7该IP已领取过元宝，同一IP仅可领取一次！;重复IP提示
#ELSEACT
GiveGold1000;发放1000元宝，数值可修改
RecordIP200;记录当前IP，标识200与上述校验一致
SendMsg7元宝领取成功！同一IP仅可领取一次，请勿多开尝试！;领取成功提示
备注：1.IP记录标识200可自定义（建议200-999区间）；2.若需限制IP领取次数（如3次），可修改CheckIPRecord为CheckIPRecord2003（3代表最大领取次数）；3.记录的IP数据会随引擎重启清除，若需永久限制，需搭配数据库存储IP（下文进阶脚本）。
2.进阶：IP永久限制领取脚本（适配长期活动）
若需长期限制IP领取（引擎重启后不清除记录），需将IP存入数据库，通过“数据库校验”实现，代码如下：
[@领取元宝]
#IF
CheckDBStr元宝领取IP表IP＜$IP＞;校验当前IP是否存在于数据库表中
#ACT
SendMsg7该IP已领取过元宝，长期限制领取！
#ELSEACT
GiveGold1000
AddDBStr元宝领取IP表IP＜$IP＞;将当前IP写入数据库表
SendMsg7元宝领取成功！该IP长期限制，不可重复领取！
备注：1.需提前通过DBC2000新建数据库表“元宝领取IP表”，新增“IP”字段（文本型）；2.＜$IP＞为Hero引擎IP变量，自动获取当前玩家IP，无需修改；3.需清除限制时，直接删除数据库表中对应IP即可。
3.脚本生效与IP限制测试
1.配置步骤：同指定人物脚本，写入QFunction-0.txt后动态加载；
2.测试方法：同一IP登录多个账号，首次领取可成功，后续账号领取提示限制；更换IP后可重新领取，确认限制生效。
四、第三类：指定人物+IP双重限制脚本（组合场景）
核心需求：指定人物仅可领取一次，且同一IP下仅可领取一次（双重防刷），脚本代码如下：
[@领取元宝]
#IF
CheckName新手指导员;指定人物校验
CheckScriptFlag1000;人物领取标记校验
CheckIPRecord200;IP领取记录校验
#ACT
GiveGold1000
SetScriptFlag1001;标记人物已领取
RecordIP200;记录IP已领取
SendMsg7元宝领取成功！指定人物+同一IP仅可领取一次！
#ELSEACT
SendMsg7你已领取过元宝，或该IP/人物已被限制领取！
备注：双重限制可有效防刷，适合重要活动元宝发放，可按需调整元宝数值与限制条件。
五、脚本触发方式3种常用触发设置
编写好的领取脚本，可通过以下3种方式触发，适配不同游戏场景：
1.NPC对话触发（最常用）
在NPC脚本中添加领取选项，玩家与NPC对话即可触发，示例：
[@新手指导员对话]
::ShowMsg("我是元宝发放NPC，点击可领取一次元宝！");
::ShowOption({80});;80为领取选项ID
[@Option80]
Goto领取元宝;触发元宝领取脚本
2.命令触发（测试/GM使用）
玩家在游戏内输入指定命令即可触发，需先在引擎中开启命令权限：
1.打开M2Server→“选项”→“命令设置”，添加命令“领取元宝”，权限设为0（所有玩家可使用）；
2.玩家在游戏内输入“@领取元宝”，即可触发脚本。
3.物品触发（道具领取）
玩家使用指定物品（如“元宝领取券”）触发领取，示例：
[@UseItem10001];10001为“元宝领取券”物品ID
Goto领取元宝;使用物品后触发领取脚本
六、异常排查常见问题快速解决
1.触发脚本无响应无任何提示
解决方案：1.核对脚本语法，确保无遗漏#IF、#ACT、#ELSEACT标识，语句结尾无多余符号；2.检查QFunction-0.txt编码是否为ANSI，乱码会导致脚本失效；3.重新动态加载脚本，确认引擎已识别脚本。
2.领取后未发放元宝提示成功但无元宝
解决方案：1.确认元宝发放命令正确，Hero引擎默认用GiveGold发放元宝，部分版本用GiveYuanBao，可替换命令测试；2.检查玩家背包元宝上限，若超过上限则无法发放，需调整上限或减少发放数值；3.核对引擎配置，确保“元宝功能”已开启（!Setup.txt中设置GoldEnable=1）。
3.IP限制失效同一IP可多次领取
解决方案：1.核对IP记录标识（如200）是否一致，CheckIPRecord与RecordIP标识需相同；2.若为临时限制，引擎重启后IP记录会清除，需使用数据库存储IP实现永久限制；3.检查玩家是否使用代理IP，代理IP会导致IP识别异常，可限制代理IP领取。
4.指定人物领取提示“非指定人物”
解决方案：1.核对CheckName后的角色名称，需与游戏内角色名称完全一致（区分大小写、空格）；2.若角色名称含特殊符号，需在脚本中完整填写，避免遗漏；3.新增多个指定人物时，需用#ELSEIF衔接，不可直接叠加CheckName语句。
七、总结：领取限制脚本核心要点避坑指南
核心要点：1.指定人物限制依赖“名称校验+脚本标记”，标记需唯一，避免冲突；2.IP限制依赖“IP记录/数据库存储”，临时限制用RecordIP，长期限制用数据库；3.脚本触发方式可按需选择，NPC触发最适配玩家场景。
避坑指南：1.脚本编码必须为ANSI，否则会出现乱码或无响应；2.元宝发放命令需适配Hero引擎版本，避免命令错误导致发放失败；3.长期限制需搭配数据库，避免引擎重启后记录丢失；4.测试时需覆盖多场景（重复领取、多IP、多账号），确保限制生效。
按上述脚本编写与配置，即可快速实现元宝领取限制，适配新手福利、活动发放等各类场景，无需复杂配置，直接复用修改即可生效。
Hero引擎实现元宝领取限制，核心依赖“脚本标记”“IP记录”两大机制：指定人物单次领取用“脚本标记+人物名称校验”，IP限制领取用“IP记录变量+IP重复校验”，均通过QFunction脚本文件编写，无需额外插件，直接写入即可生效。
两类脚本可单独使用，也可组合实现“指定人物+IP双重限制”，以下为具体脚本代码、配置步骤及异常排查，脚本语法严格遵循Hero规范，无冗余内容，可直接复制修改使用。
二、第一类：指定人物领取一次元宝限制脚本（常用场景）
核心需求：指定人物（如“新手指导员”“测试账号1”）领取一次元宝后，再次触发领取指令时提示无法领取，通过“人物名称校验+脚本标记”实现，步骤如下：
1.脚本编写（写入QFunction-0.txt）
脚本核心：先校验是否为指定人物→再校验是否已领取（脚本标记）→未领取则发放元宝并添加标记→已领取则提示限制，代码如下：
[@领取元宝]
#IF
CheckName新手指导员;校验是否为指定人物，替换为实际角色名称
CheckScriptFlag1000;校验标记100是否为0（0=未领取，1=已领取）
#ACT
GiveGold1000;发放1000元宝（GiveGold为元宝发放命令，数值可修改）
SetScriptFlag1001;设置标记100为1，标记已领取
SendMsg7元宝领取成功！本次领取仅可一次，不可重复领取！;游戏内提示
#ELSEACT
SendMsg7你已领取过元宝，本次活动仅可领取一次！;重复领取提示
备注：1.标记100可自定义（建议100-999区间，避免与其他脚本冲突）；2.可新增多个指定人物，在#IF下添加多个CheckName语句（如CheckName测试账号1）；3.元宝数值可按需修改（如GiveGold5000发放5000元宝）。
2.多指定人物适配脚本（扩展）
若需多个指定人物分别领取一次，可通过“标记区分”实现，避免相互影响，代码如下：
[@领取元宝]
#IF
CheckName新手指导员
CheckScriptFlag1000
#ACT
GiveGold1000
SetScriptFlag1001
SendMsg7新手指导员元宝领取成功，仅可领取一次！
#ELSEIF
CheckName测试账号1
CheckScriptFlag1010;用标记101区分，避免与上一人物冲突
#ACT
GiveGold1000
SetScriptFlag1011
SendMsg7测试账号1元宝领取成功，仅可领取一次！
#ELSEACT
SendMsg7你已领取过元宝或非指定领取人物！
3.脚本配置与生效步骤
1.脚本写入：打开Mirserver\Envir\Market_Def\QFunction-0.txt，将上述脚本复制到文件末尾，保存文件；
2.编码设置：确保文件编码为ANSI，避免中文乱码导致脚本失效；
3.动态加载：打开M2Server界面，点击“脚本”→“动态加载脚本”，选择QFunction-0.txt加载，无需重启引擎，脚本立即生效。
三、第二类：IP限制领取元宝单次领取脚本（防多开领取）
核心需求：同一IP仅可领取一次元宝，无论登录多少账号，均限制单次领取，通过“IP变量记录+重复校验”实现，步骤如下：
1.脚本编写（写入QFunction-0.txt）
脚本核心：获取当前玩家IP→校验该IP是否已领取→未领取则发放元宝并记录IP→已领取则提示限制，代码如下：
[@领取元宝]
#IF
CheckIPRecord200;校验IP是否已记录（200为IP记录标识，可自定义）
#ACT
SendMsg7该IP已领取过元宝，同一IP仅可领取一次！;重复IP提示
#ELSEACT
GiveGold1000;发放1000元宝，数值可修改
RecordIP200;记录当前IP，标识200与上述校验一致
SendMsg7元宝领取成功！同一IP仅可领取一次，请勿多开尝试！;领取成功提示
备注：1.IP记录标识200可自定义（建议200-999区间）；2.若需限制IP领取次数（如3次），可修改CheckIPRecord为CheckIPRecord2003（3代表最大领取次数）；3.记录的IP数据会随引擎重启清除，若需永久限制，需搭配数据库存储IP（下文进阶脚本）。
2.进阶：IP永久限制领取脚本（适配长期活动）
若需长期限制IP领取（引擎重启后不清除记录），需将IP存入数据库，通过“数据库校验”实现，代码如下：
[@领取元宝]
#IF
CheckDBStr元宝领取IP表IP＜$IP＞;校验当前IP是否存在于数据库表中
#ACT
SendMsg7该IP已领取过元宝，长期限制领取！
#ELSEACT
GiveGold1000
AddDBStr元宝领取IP表IP＜$IP＞;将当前IP写入数据库表
SendMsg7元宝领取成功！该IP长期限制，不可重复领取！
备注：1.需提前通过DBC2000新建数据库表“元宝领取IP表”，新增“IP”字段（文本型）；2.＜$IP＞为Hero引擎IP变量，自动获取当前玩家IP，无需修改；3.需清除限制时，直接删除数据库表中对应IP即可。
3.脚本生效与IP限制测试
1.配置步骤：同指定人物脚本，写入QFunction-0.txt后动态加载；
2.测试方法：同一IP登录多个账号，首次领取可成功，后续账号领取提示限制；更换IP后可重新领取，确认限制生效。
四、第三类：指定人物+IP双重限制脚本（组合场景）
核心需求：指定人物仅可领取一次，且同一IP下仅可领取一次（双重防刷），脚本代码如下：
[@领取元宝]
#IF
CheckName新手指导员;指定人物校验
CheckScriptFlag1000;人物领取标记校验
CheckIPRecord200;IP领取记录校验
#ACT
GiveGold1000
SetScriptFlag1001;标记人物已领取
RecordIP200;记录IP已领取
SendMsg7元宝领取成功！指定人物+同一IP仅可领取一次！
#ELSEACT
SendMsg7你已领取过元宝，或该IP/人物已被限制领取！
备注：双重限制可有效防刷，适合重要活动元宝发放，可按需调整元宝数值与限制条件。
五、脚本触发方式3种常用触发设置
编写好的领取脚本，可通过以下3种方式触发，适配不同游戏场景：
1.NPC对话触发（最常用）
在NPC脚本中添加领取选项，玩家与NPC对话即可触发，示例：
[@新手指导员对话]
::ShowMsg("我是元宝发放NPC，点击可领取一次元宝！");
::ShowOption({80});;80为领取选项ID
[@Option80]
Goto领取元宝;触发元宝领取脚本
2.命令触发（测试/GM使用）
玩家在游戏内输入指定命令即可触发，需先在引擎中开启命令权限：
1.打开M2Server→“选项”→“命令设置”，添加命令“领取元宝”，权限设为0（所有玩家可使用）；
2.玩家在游戏内输入“@领取元宝”，即可触发脚本。
3.物品触发（道具领取）
玩家使用指定物品（如“元宝领取券”）触发领取，示例：
[@UseItem10001];10001为“元宝领取券”物品ID
Goto领取元宝;使用物品后触发领取脚本
六、异常排查常见问题快速解决
1.触发脚本无响应无任何提示
解决方案：1.核对脚本语法，确保无遗漏#IF、#ACT、#ELSEACT标识，语句结尾无多余符号；2.检查QFunction-0.txt编码是否为ANSI，乱码会导致脚本失效；3.重新动态加载脚本，确认引擎已识别脚本。
2.领取后未发放元宝提示成功但无元宝
解决方案：1.确认元宝发放命令正确，Hero引擎默认用GiveGold发放元宝，部分版本用GiveYuanBao，可替换命令测试；2.检查玩家背包元宝上限，若超过上限则无法发放，需调整上限或减少发放数值；3.核对引擎配置，确保“元宝功能”已开启（!Setup.txt中设置GoldEnable=1）。
3.IP限制失效同一IP可多次领取
解决方案：1.核对IP记录标识（如200）是否一致，CheckIPRecord与RecordIP标识需相同；2.若为临时限制，引擎重启后IP记录会清除，需使用数据库存储IP实现永久限制；3.检查玩家是否使用代理IP，代理IP会导致IP识别异常，可限制代理IP领取。
4.指定人物领取提示“非指定人物”
解决方案：1.核对CheckName后的角色名称，需与游戏内角色名称完全一致（区分大小写、空格）；2.若角色名称含特殊符号，需在脚本中完整填写，避免遗漏；3.新增多个指定人物时，需用#ELSEIF衔接，不可直接叠加CheckName语句。
七、总结：领取限制脚本核心要点避坑指南
核心要点：1.指定人物限制依赖“名称校验+脚本标记”，标记需唯一，避免冲突；2.IP限制依赖“IP记录/数据库存储”，临时限制用RecordIP，长期限制用数据库；3.脚本触发方式可按需选择，NPC触发最适配玩家场景。
避坑指南：1.脚本编码必须为ANSI，否则会出现乱码或无响应；2.元宝发放命令需适配Hero引擎版本，避免命令错误导致发放失败；3.长期限制需搭配数据库，避免引擎重启后记录丢失；4.测试时需覆盖多场景（重复领取、多IP、多账号），确保限制生效。
按上述脚本编写与配置，即可快速实现元宝领取限制，适配新手福利、活动发放等各类场景，无需复杂配置，直接复用修改即可生效。