传奇服务端的脚本系统是整个游戏逻辑的核心载体，涵盖了NPC对话、任务流程、物品掉落及活动触发等关键环节。脚本出现异常往往导致游戏卡死、NPC无反应或功能失效。排查脚本问题不能仅靠猜测，必须建立从日志分析到语法校验，再到逻辑断点的系统性排查思维。以下针对服务端脚本最常见的几类故障进行深度剖析与修复指导。
脚本加载失败与文件路径排查
当服务端启动时报错“cannot load such file”或游戏内NPC点击无反应，通常是脚本文件未被正确加载。传奇引擎（如GOM、GEE）对文件路径和命名规范有严格要求。
首先检查文件存放位置。绝大多数引擎规定，自定义脚本必须存放在Mir200EnvirMarket_Def（NPC脚本）或Mir200EnvirQuest（任务脚本）目录下。如果将.lua或.txt脚本误放入Config或Data目录，引擎会直接忽略，导致功能静默失效。
其次，核对文件编码格式。Windows系统下的记事本默认可能保存为ANSI编码，而现代引擎多要求UTF-8无BOM格式。编码不匹配会导致脚本中的中文字符变成乱码，进而引发解析错误。建议使用专业的文本编辑器（如Notepad++或VS Code）将脚本统一转换为UTF-8无BOM格式。
最后，检查!List.txt或Merchant.txt配置文件。引擎是通过这些索引文件来读取NPC脚本的。如果索引文件中的路径写法与实际文件夹层级不一致，或者文件名包含特殊符号，引擎将无法定位脚本。确保索引文件中的路径使用正确的斜杠（/或），且文件名后缀完整。
语法错误与逻辑死循环
脚本语法错误是导致M2Server崩溃或卡顿的元凶。常见的语法问题包括括号不匹配、缺少结束标签（如[@Main]后未接break或close）、变量名拼写错误等。
在排查时，重点关注M2Server控制台的红色报错信息。引擎通常会提示具体的行号，例如“Syntax error at line 45”。此时应直接打开对应脚本的第45行，检查是否有未闭合的引号或错误的命令参数。
逻辑死循环则是另一种隐蔽的故障。例如在while循环中，如果控制变量未在循环体内正确递增，或者状态机跳转条件设计有误（如状态A跳到B，B又无条件跳回A），会导致服务端CPU占用率瞬间飙升，甚至卡死主线程。
解决方法是在循环结构中强制加入“最大执行次数”限制，或在状态跳转逻辑中加入互斥判断。对于复杂的脚本，可以通过在关键节点插入SendMsg或Break命令来测试脚本执行到了哪一步，从而定位卡死的具体位置。
权限配置与命令执行异常
如果你在游戏中使用GM命令（如@make、@mob）无反应，或者脚本中的特定功能无法触发，通常是权限配置文件出现了问题。
检查Mir200EnvirGMLevel.cfg或类似的权限配置文件。该文件定义了不同等级GM可使用的命令。如果配置文件中存在重复定义，或者命令名称拼写错误，会导致权限校验函数返回false，从而拦截指令。
此外，脚本中的变量作用域也是常见误区。全局变量（如G0-G999）在所有脚本中通用，而局部变量（如D0-D999）仅在当前脚本段有效。如果在跨脚本调用（如使用#Call）时错误地依赖局部变量，会导致数据传递失败。务必理清变量的生命周期，确保在跨脚本交互时使用全局变量或正确的参数传递方式。
引擎版本与脚本命令兼容性
不同版本的引擎对脚本命令的支持程度不同。老旧的引擎（如0325版本）可能不支持新的合击技能命令或UI界面指令，而新版引擎可能废弃了旧的命令格式。
当脚本提示“Unknown Command”或功能表现异常时，需核对引擎版本与脚本来源是否匹配。例如，某些特定引擎特有的#IF判断条件在其他引擎中可能无效。
解决方案是查阅当前引擎的官方命令字典，替换不兼容的命令。如果必须使用旧版脚本，可以尝试在M2Server的“脚本设置”中开启“兼容模式”，或者手动修改脚本，将旧命令替换为当前引擎支持的新命令格式。同时，检查登录器插件是否齐全，部分高级脚本功能（如网页弹窗、充值接口）依赖特定的.dll插件支持，缺失插件会导致脚本调用失败。
