传奇架设脚本错误排查修复实操：M2报错QF路径编码GOTO闭环逐项解决

传奇架设里脚本错误不是重装能解决的，M2弹红字、NPC点不开、进图没触发、技能不放、爆率不生效，全落在 Envri 脚本链上。引擎类型（GOM / GEE / BLUE / HERO / 翎风）命令差异很大，但排查顺序通用，按下面走。

一、先读报错信息，锁定文件与行号
M2启动窗口红字或 Mir200\Log\M2Server-日期.log、ScriptError.log 里会写清三件事：
• 出错文件：如 Market_Def\福利使者-0.txt、QuestDiary\转生\主线.txt、QFunction-0.txt、QManage.txt、RobotManage.txt

- 行号：Line 56、第 15 行格式不对
• 错误类型：Unknown command / Script load fail / 段错误 / GOTO标签不存在 / 变量未定义

用 Notepad++ 打开对应文件，Ctrl+G 跳行，别凭肉眼翻。

二、语法与结构错误（占比最高）
1. 命令拼错：#ACT 写成 #act，@Give 写成 @give，CheckLevel 写成 ChecLevel，引擎区分大小写
2. 段头不闭合：#IF 必须配 #ACT，条件块结束要有 #ENDIF；#SAY / #ACT / #IF 各自独立成行，参数间仅一个英文空格
3. 中文标点混用：逗号、引号、括号用了全角“，” “” （），全部替换成英文半角；开启 Notepad++ “显示所有字符”查隐藏空格与制表符
4. GOTO 死循环：一个 #ACT 里写多个 GOTO，或 GOTO @XXX 但全文无 [@XXX] 标签；Setup.txt 里 ScriptGotoCountLimit 默认 10，跳转多改 5000，但优先修逻辑，用 CALL 替代多层跳
5. 注释与结束符：; 开头为注释，END 结束语句，漏写或多了多余 END 都会加载失败

三、编码与文件格式错误
老引擎（GOM/BLUE/HERO）只认 ANSI，UTF-8 或 Unicode 保存必乱码或报 Script Error。
记事本 / Notepad++ 打开 → 文件 → 另存为 → 编码选 ANSI → 覆盖保存；批量脚本用 Notepad++ “批量转换编码”一次性转完。
文件名也不能乱改：QFunction-0.txt 不能改成 QFunction.txt，QManage.txt 不能加数字后缀，Market_Def 下 NPC 脚本按“名字-编号.txt”命名。

四、路径与目录放错
核心脚本目录（Mir200\Envir 下）：
• QuestDiary\ → 任务/触发/转生/登录脚本（QManage.txt、QFunction-0.txt 也在其结构内）

- Market_Def\ → NPC 对话脚本
• MapQuest_def\ → 地图进入触发

• RobotManage.txt → 机器人定时脚本

• MonItems\ → 爆率文件

• !Setup.txt / MapInfo.txt / Monster.txt / StdItems.db → 基础配置

常见错：把任务脚本塞进 Market_Def；GOM 脚本里 .\ 单点路径改成 ..\ 双点；路径带中文、空格、特殊符（D:\传奇服务端 错，D:\Mirserver 对）；#CALL [..\QuestDiary\充值.txt] 目标文件不存在。

五、数据库与资源引用缺失
脚本里 GiveItem 裁决之杖、Give 金币、MobPlace 10086 神兽，对应库里必须有：
• StdItems.db（DBC2000）有“裁决之杖”标准名，多空格都不匹配

- Monster.db 有对应怪物 ID，ID 错写提示“怪物ID无效”
• MonItems\ 下有对应 TXT 爆率表

• 技能库 Skill.bin / 技能数据库 里 ScriptID 与脚本调用一致（GEE 尤甚）

缺啥补啥，别只改脚本不补库。

六、引擎不兼容（跨端搬运必踩）
HERO 不支持 HP-Rate / MP-Rate，CheckNewItemValue 要换 CheckItemValue，颜色只认 SCOLOR；GOM 用 ChangeModeEx 做无敌，SKY 用 SetHumAbilityStatus；翎风/新 GEE 部分命令老 BLUE 不认。
做法二选一：换配套引擎版本（连 M2Server.exe + LoginGate + SelGate 一起换），或删掉不兼容命令改成当前引擎支持写法，别混用引擎程序。

七、插件与 PAK 连带报错
QFunction-0.txt 里调 AddhpPer、PGStartAutoPickItem、OpenBigDialogBox 等，需在 PlugList.txt 挂对应 dll（如 945Engine.dll），没挂直接报 Unknown command；PAK 密码错导致补丁读不到，点 NPC 也像脚本坏，用 PAK 查看器核对 pak.txt 密码，把 NewopUI.Pak 放进客户端。

八、权限与缓存
服务端目录右键 → 属性 → 安全 → 当前用户完全控制；M2Server.exe 勾“以管理员身份运行”；启动前删 Mir200\Log 旧日志、清 Envir 下临时缓存文件；微端路径 data_dir 用正斜杠 d:/mir2/data/ 不用反斜杠。

九、实战最短排查顺序
1. 抄下 M2 红字：文件名 + 行号 + 错误词
2. Notepad++ 跳行 → 看命令拼写、闭合、标点、GOTO 标签
3. 确认编码 ANSI、路径存在、文件名未改、库里有引用对象
4. 屏蔽新增脚本（移出 Envir 重启），逐份加回定位冲突段
5. 仍报错换配套引擎或修不兼容命令
多数“script error load fail”到第三步就消了。