传奇电脑脚本错误排查：服务端NPC报错与客户端挂机脚本失败处理

传奇里出现脚本错误，先分清是服务端报错还是客户端脚本失败。服务端报错通常出现在M2Server控制台，表现为红色提示、NPC点击无反应、功能不生效；客户端脚本失败多表现为点开始后闪退、无反应、无法识别游戏窗口、自动操作中断。

先做基础检查。关闭杀毒软件、防火墙和实时防护，把游戏目录、脚本目录、服务端目录加入白名单；用管理员身份运行程序；确认路径不含中文、特殊符号和过长目录；检查文件是否被误删；重启电脑后再试。

服务端NPC脚本报错排查

启动服务端时M2Server弹出错误，或玩家点击NPC后没有反应，优先看M2Server控制台日志。日志通常会显示脚本文件路径、行号、标签名和错误原因，例如某NPC在Market_Def目录下第几行命令参数错误。

常见原因和处理方法：

脚本语法错误
检查报错行及上下行的括号、引号、分号是否成对，命令是否使用英文半角，关键字是否拼错。传奇脚本对大小写通常不敏感，但拼写必须一致。

命令不被当前引擎支持
GOM、GEE、HERO、Blue、翎风、V8等引擎的命令不完全通用。同一个CHECKITEM、GIVE、MAPMOVE、DELAYGOTO在不同引擎里可能写法不同，需要对照当前引擎说明。

标签跳转错误
点击NPC没反应，常见于GOTO指向的标签不存在，或标签名写错。比如按钮跳转到[@高价回收]，但脚本里没有这个段落，就会无响应。

条件判断不成立
如果#IF条件不满足，又缺少ELSESAY或ELSEACT，玩家点击后可能没有任何提示。需要检查CHECKITEM、CHECKLEVEL、CHECKGOLD等条件是否符合当前角色状态。

脚本文件缺失或路径错误
M2启动时提示找不到脚本文件，通常是Market_Def、QuestDiary、Robot_def等目录下缺少对应txt文件，或NPC包含文件里引用了不存在的路径。

资源文件缺失
脚本里如果引用了Pak、Img、Map、Wil、Wix等资源，但客户端或服务端没有对应文件，也会报错。需要确认补丁、地图、图片资源是否齐全。

修改后未重载
脚本改完后必须在M2Server里重载NPC、重载QManage、重载QFunction或重启服务端，否则修改不会生效。

服务端脚本排查顺序：先看控制台报错，定位文件和行号；再用Notepad++或VSCode打开脚本，跳转到对应行；确认命令、标签、条件、路径都正确；修改后重载脚本；复杂脚本可用分号注释掉可疑行做隔离测试。

客户端挂机脚本失败排查

如果问题不是服务端报错，而是挂机脚本点开始后闪退、无法识别游戏窗口、无法自动操作，通常属于客户端脚本问题。

常见原因和处理方法：

版本不匹配
挂机脚本通常只适配特定引擎、特定分辨率、特定登录器。金币版、微变、中变、超变、毁灭、精品版界面不同，脚本很难通用。版本更换后，原有脚本可能失效。

游戏窗口分辨率改变
很多脚本依赖固定坐标、颜色或图像识别。窗口大小、缩放比例、全屏模式变化后，识别点会偏移，导致无法点击或误判。

权限不足
脚本需要读取窗口、模拟鼠标键盘或注入进程，权限不足会直接退出。需要用管理员身份运行，并检查是否被安全软件拦截。

登录器更新导致失效
登录器更新后，窗口标题、进程名、内存结构、界面布局可能变化。原本能用的脚本更新后可能完全失效。

脚本文件损坏
下载不完整或被杀毒软件误删，也会导致启动失败。需要重新下载，并校验文件完整性。

系统兼容性
部分老旧脚本或引擎对高版本Windows支持较差，可能出现无法启动、无法注入、无法识别窗口等问题。

客户端脚本排查顺序：先确认脚本是否适配当前版本和引擎；再检查游戏窗口分辨率、缩放、全屏设置；关闭安全软件后重试；用管理员身份运行；重新下载完整脚本；最后确认登录器是否更新导致失效。

常见报错对照

M2启动提示找不到脚本文件：检查Market_Def、QuestDiary等目录是否缺少对应txt文件。
控制台提示第X行命令参数错误：检查该行命令是否拼错、参数是否缺少、引擎是否支持。
点击NPC无反应：检查GOTO标签是否存在，条件是否满足，ELSESAY是否缺失。
脚本修改后无效：需要在M2Server里重载脚本或重启服务端。
挂机脚本点开始就消失：多为安全软件拦截、权限不足、版本不匹配。
挂机脚本无法识别界面：多为分辨率、缩放、登录器更新导致。
提示缺少dll或运行库：需要安装VC运行库、DirectX、.NET等组件。
M2提示端口占用：检查端口设置，更改端口后重启。
M2提示地图文件缺失：在Mir200Map目录下添加对应map文件或删除引用。
M2提示数据库异常：检查DBC2000或引擎数据库配置是否正确。

服务端脚本问题优先看M2Server报错日志，定位到具体文件和行号后再改；客户端脚本问题优先看版本匹配、窗口分辨率和安全软件拦截。两者不能混着排查，否则容易走错方向。