传奇服务端脚本死循环报错解决 针对QFunction GOTO @宗派经验

传奇服务端一直提示脚本死循环，具体报错为[脚本死循环] NPC:QFunction 位置:0(0:0) 命令:GOTO @宗派经验 1秒1次，结合用户提供的脚本代码，核心原因是@GetExp触发后多GOTO命令冲突、@宗派经验脚本变量异常或循环次数超限，无需复杂操作，按以下步骤逐一排查修复，全程直奔主题，每一步均对应报错场景，实操可落地，新手也能跟着操作。
先明确报错核心关联点：用户提供的脚本中，@GetExp触发后，#act下连续执行3个goto命令（@宗派经验、@烽火001、@冲级赛），且@宗派经验脚本中使用GetRandomName变量赋值，未做边界判断，同时服务端默认循环次数限制较低，多重因素叠加导致死循环，1秒1次重复执行GOTO @宗派经验命令，进而触发报错，优先从脚本代码本身修复，再调整服务端参数，即可彻底解决。
第一步，优先修复@GetExp脚本（最核心原因），报错提示GOTO @宗派经验触发死循环，根源是@GetExp触发后，#act下连续使用多个goto命令，脚本执行时无法正常跳转终止，导致反复调用@宗派经验，这是传奇脚本死循环最常见的编码疏漏之一。
操作步骤：找到对应脚本文件，修改@GetExp触发脚本，调整goto命令使用规范，具体如下，全程用记事本即可操作，无需专业工具。
1. 找到脚本文件：打开传奇服务端根目录，依次进入Mir200\Envir\QuestDiary文件夹，找到触发@GetExp的脚本文件（通常为QFunction-0.txt或对应功能脚本，若不确定，可搜索“@GetExp”关键词，快速定位文件），右键用记事本打开该脚本。
2. 查看并修改@GetExp脚本：找到用户提供的@GetExp代码段，原代码如下：
;-------------------【GetExp触发】------------------------
[@GetExp]
#act
goto @宗派经验
goto @烽火001
goto @冲级赛
break
核心问题：传奇脚本中，一个#act下只能执行1个goto命令，多个goto命令叠加会导致脚本执行混乱，无法正常跳转，进而触发死循环，break命令无法生效，这是脚本编写的基础规范，多goto叠加极易引发循环报错。
3. 修改方案（二选一，优先方案一，适配性更强）：
方案一：将多个goto命令改为依次跳转，避免叠加，修改后代码如下，确保每个goto跳转后能正常终止或继续执行，不形成闭环：
;-------------------【GetExp触发】------------------------
[@GetExp]
#act
goto @宗派经验
break
[@宗派经验_后续]
#act
goto @烽火001
break
[@烽火001_后续]
#act
goto @冲级赛
break
同时，修改原[@宗派经验]脚本的结尾，添加跳转命令，衔接后续脚本，修改后[@宗派经验]结尾如下：
#ACT
GetRandomName ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt S28
mov d21 <$STR(S28)>
MOV d22 <$GETEXP>
INC d21 <$STR(d22)>
MOV S27 <$STR(d21)>
DelTextList <$STR(S28)> ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt
AddTextList <$STR(S27)> ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt
goto @宗派经验_后续
break
方案二：若无需三个跳转同时执行，删除多余goto命令，保留核心功能，修改后代码如下（适合仅需执行@宗派经验功能的场景）：
;-------------------【GetExp触发】------------------------
[@GetExp]
#act
goto @宗派经验
break
4. 保存脚本：修改完成后，按Ctrl+S保存脚本文件，关闭记事本，无需重启服务端，先记录修改内容，后续统一重启生效。
第二步，修复@宗派经验脚本变量异常（次要原因），用户提供的[@宗派经验]脚本中，使用GetRandomName命令读取文件赋值给S28变量，未添加变量为空的判断，若该文件为空或读取失败，S28变量会继承上次的值，导致脚本反复执行相同操作，触发死循环，这也是变量赋值常见的循环诱因。
操作步骤：继续编辑[@宗派经验]脚本，添加变量判断，避免变量异常导致循环，具体如下：
1. 打开包含[@宗派经验]的脚本文件（与@GetExp脚本同文件或对应功能文件），找到原[@宗派经验]代码段。
2. 在#if判断后、#ACT前，添加变量空值判断，同时在#ACT中添加变量清空命令，修改后代码如下，重点添加标注部分：
[@宗派经验]
#if
CHECKNAMELIST ..\QuestDiary\宗师系统\宗主名单.txt
NOTEQUAL S28 "" ; 判断S28变量不为空，避免空值导致循环
#ACT
mov S28 "" ; 先清空S28变量，避免继承上次值
GetRandomName ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt S28
mov d21 <$STR(S28)>
MOV d22 <$GETEXP>
INC d21 <$STR(d22)>
MOV S27 <$STR(d21)>
DelTextList <$STR(S28)> ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt
AddTextList <$STR(S27)> ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt
break
3. 补充说明：CHECKNAMELIST命令用于检测当前人物角色名是否在指定的宗主名单.txt中，若不在该名单，脚本不会执行#ACT下的内容，添加NOTEQUAL S28 ""判断，可避免文件读取失败时，变量空值导致的循环；mov S28 ""命令可清空变量残留值，从根源避免变量继承引发的死循环。
4. 保存修改：按Ctrl+S保存脚本，关闭记事本，确保两个脚本的修改均已保存，避免遗漏。
第三步，调整服务端循环次数限制（辅助修复），部分情况下，脚本本身无明显错误，但服务端默认的goto循环次数限制过低（默认通常为10次），当脚本执行次数超过限制，会触发死循环报错，尤其@GetExp触发频率较高时，更容易达到次数上限。
操作步骤：修改服务端Setup.txt文件中的循环次数参数，具体如下，无需修改脚本，仅调整系统参数：
1. 找到Setup.txt文件：打开传奇服务端根目录，进入Mir200文件夹，找到!Setup.txt文件（注意前缀有感叹号），右键用记事本打开。
2. 查找并修改循环次数参数：在文件中搜索“ScriptGotoCountLimit”关键词，找到对应的参数行，默认参数通常为“ScriptGotoCountLimit=10”，将其修改为“ScriptGotoCountLimit=50000”（数值控制在50000以内即可，过高可能占用过多资源）。
3. 保存参数：修改完成后，按Ctrl+S保存文件，关闭记事本，该参数修改后，需重启服务端才能生效，暂时不重启，完成后续步骤后统一操作。
4. 补充说明：该参数用于控制脚本中goto命令的最大循环次数，修改后可避免因触发频率过高、脚本执行次数超限导致的死循环报错，若第一步、第二步修复后仍报错，该步骤可彻底解决问题。
第四步，检查脚本文件路径与权限（排查隐藏问题），若上述步骤修复后仍报错，大概率是脚本中涉及的文件路径错误、文件缺失或权限不足，导致脚本无法正常读取文件，进而反复执行，触发死循环，重点检查以下两点：
操作步骤：逐一排查路径和权限，确保脚本能正常读取所需文件：
1. 检查文件路径：打开[@宗派经验]脚本，查看两个文件路径是否正确：
（1）CHECKNAMELIST ..\QuestDiary\宗师系统\宗主名单.txt：进入服务端Mir200\Envir\QuestDiary\宗师系统文件夹，确认存在“宗主名单.txt”文件，若缺失，新建文本文档，命名为“宗主名单.txt”（无后缀），无需填写内容，确保脚本能正常检测。
（2）GetRandomName ..\QuestDiary\宗师系统\经验\<$USERNAME>.txt S28：进入Mir200\Envir\QuestDiary\宗师系统文件夹，确认存在“经验”子文件夹，若缺失，新建文件夹并命名为“经验”；同时，当玩家触发@GetExp时，会自动生成以玩家用户名命名的txt文件，无需手动创建，确保“经验”文件夹有读写权限。
2. 检查文件权限：右键点击“宗师系统”文件夹，选择“属性-安全”，确保当前系统用户有“完全控制”“读取”“写入”权限，若权限不足，点击“编辑”，勾选对应权限，应用后确定，避免因权限不足导致脚本无法读取、写入文件，进而触发循环。
3. 排查文件格式：确保“宗主名单.txt”“经验”文件夹下的txt文件，均为ANSI编码格式，若为UTF-8编码，脚本可能无法正常读取，导致变量赋值失败，触发死循环。操作方法：右键点击txt文件，选择“打开方式-记事本”，点击“文件-另存为”，编码选择“ANSI”，保存并覆盖原文件。
第五步，重启服务端并测试（验证修复效果），所有修改完成后，必须重启传奇服务端，确保脚本修改和参数调整生效，测试是否仍有死循环报错，具体步骤如下：
1. 关闭服务端所有进程：按顺序关闭M2Server（引擎服务）、LoginSrv（登录服务）、DBServer（数据库服务），确保所有传奇相关进程均已关闭，可通过任务管理器检查，结束残留进程。
2. 重启服务端：按正确顺序启动服务端，先启动DBServer，再启动LoginSrv，最后启动M2Server，观察引擎控制台日志，若不再出现“[脚本死循环] NPC:QFunction 位置:0(0:0) 命令:GOTO @宗派经验”报错，说明修复成功。
3. 模拟触发测试：登录游戏，进行触发@GetExp的操作（如获取经验、完成对应任务），连续操作多次，观察引擎日志，确保无死循环报错，同时检查@宗派经验功能是否正常（如经验统计、文件写入是否正常），避免修复脚本后导致功能失效。
4. 持续观察：启动服务端后，观察10-15分钟，确保无1秒1次的死循环报错，同时检查服务端运行状态，无卡顿、无崩溃，说明修复彻底，可正常运行。
第六步，常见特殊情况排查（针对性解决），若重启服务端后仍有报错，或修复后功能异常，对照以下特殊情况，逐一排查，无需重新修改所有脚本，快速定位问题：
特殊情况1：修改@GetExp脚本后，死循环报错消失，但@烽火001、@冲级赛功能无法触发。解决方法：检查方案一的跳转脚本是否正确，确保[@宗派经验_后续]、[@烽火001_后续]标签无拼写错误（区分大小写），同时确认@烽火001、@冲级赛脚本本身无错误，可单独触发测试，若脚本本身有问题，需单独修复对应脚本。
特殊情况2：修改循环次数后，报错仍存在。解决方法：重新检查@GetExp脚本，确认已删除多余goto命令，或已改为依次跳转；同时检查[@宗派经验]脚本的变量判断是否添加正确，变量清空命令是否生效，若仍无效，将ScriptGotoCountLimit参数调整为100000，重启服务端测试。
特殊情况3：脚本修改后，出现“文件无法读取”报错。解决方法：重新核对脚本中的文件路径，确保路径中的文件夹和文件均存在，路径中的“..\”代表上一级目录，不可遗漏；同时检查文件编码和权限，确保脚本能正常读取和写入文件。
特殊情况4：仅部分玩家触发时出现死循环报错。解决方法：排查该玩家对应的经验txt文件（..\QuestDiary\宗师系统\经验\<玩家用户名>.txt），若文件损坏或为空，删除该文件，让玩家重新触发@GetExp，自动生成新的txt文件；同时检查该玩家是否在宗主名单.txt中，若不在，添加该玩家角色名到名单中，避免脚本判断异常。
第七步，补充实操技巧（避免后续再次出现），针对本次死循环报错，总结几点实操技巧，帮助避免后续脚本编写或服务端运行中，再次出现同类问题，简单易操作，无需专业维护：
1. 编写脚本时，一个#act下仅使用1个goto命令，避免多个goto叠加，若需多个跳转，采用依次跳转的方式，确保脚本执行流程清晰，不形成闭环，这是避免脚本死循环的核心规范。
2. 使用GetRandomName、GetRandomText等变量赋值命令时，必须添加变量空值判断，同时在赋值前清空变量，避免变量继承上次值，导致脚本反复执行，引发死循环。
3. 定期检查服务端!Setup.txt文件中的ScriptGotoCountLimit参数，根据服务端触发频率，适当调整数值，建议控制在50000-100000之间，既避免循环报错，也不会占用过多服务端资源。
4. 脚本中涉及文件路径时，优先使用相对路径（如..\QuestDiary\...），同时定期检查对应文件夹和文件是否存在，确保文件编码为ANSI，权限充足，避免因文件问题导致脚本执行异常。
5. 修改脚本后，先保存文件，再重启服务端，避免脚本修改未生效，同时测试对应功能，确保修复报错的同时，不影响原有功能正常运行。
终极解决方法：若按以上所有步骤操作后，仍出现脚本死循环报错，可备份当前脚本文件，删除@GetExp和@宗派经验相关脚本代码，重新编写，优先使用简单脚本逻辑，避免复杂跳转和变量赋值，编写完成后，先单独测试脚本，再整合到服务端，通常可彻底解决问题；若仍无效，可检查服务端引擎版本，确保引擎与脚本兼容，必要时更换稳定版本的引擎。
总结来说，传奇服务端提示[脚本死循环] NPC:QFunction 位置:0(0:0) 命令:GOTO @宗派经验，核心解决思路为：先修复@GetExp脚本的多goto冲突，再解决@宗派经验脚本的变量异常，调整服务端循环次数限制，最后排查文件路径和权限，重启服务端测试，按步骤实操，无论是新手还是有一定基础的架设者，都能快速解决报错，确保服务端正常运行，全程无冗余、无修饰，直奔问题核心和实操步骤，完全对应用户提供的脚本代码和报错场景。