传奇脚本错误排查步骤与各类型报错修复方案

脚本错误出现时M2Server面板会输出红色错误信息，游戏内表现为NPC对话框空白、点击无反应、任务无法交付、怪物不掉落物品或角色登录即卡死。脚本错误不能通过重启服务端解决，必须根据报错内容逐级排查。

**一、定位报错文件与行号的正确方法**

M2面板的报错信息包含文件路径和行号。例如“脚本错误: [Envir\Market_Def\盟重土城-3.txt] 第28行 参数不正确”，直接打开该文件跳转到28行。文本编辑器显示行号功能必须开启，多数编辑器底部状态栏显示当前行号。若编辑器不支持行号跳转，使用Notepad++或Sublime打开，按Ctrl+G输入行号快速定位。

报错信息没有明确行号时，搜索文件名后的冒号或括号内数字。部分引擎输出格式为“LoadScript Fail: 盟重土城-3.txt @Main”，表示该文件内的[@Main]段加载失败，检查该段落的括号闭合和命令拼写。

**二、检查文本编码与不可见字符**

复制外部脚本或从网页粘贴代码时，文件编码经常变为UTF-8 BOM。引擎只识别ANSI编码，BOM头被解析为脚本内容导致首行报错。用编辑器打开脚本文件，观察右下角编码标识。若显示UTF-8或带有BOM，点击另存为，编码下拉选择ANSI，覆盖原文件。同时注意换行符格式，Windows系统必须使用CRLF，LF格式会导致引擎将多行识别为一行，产生参数超长报错。

不可见字符包括全角空格、制表符混用和行尾回车符残留。开启编辑器“显示所有符号”功能，全角空格显示为较宽的点，制表符显示为→箭头，正常半角空格显示为细点。将所有制表符替换为半角空格，并将全角空格替换为空。行尾若出现红色方块，删除后重新敲入回车。

**三、命令拼写与参数数量核对**

引擎命令大全中每个指令都有固定拼写和参数个数。常见拼写错误包括：GIVE误为GIVE1或GIV、TAKE误为TAK、CHECKLEVELEX误为CHECKLEVEL、MAPMOVE误为MAPMOV。对照引擎说明书逐字母比对报错行的命令词。

参数数量错误分为“参数不足”和“参数过多”。例如“GIVE 屠龙”缺少数量参数，应补为“GIVE 屠龙 1”。“GIVE 屠龙 1 1”多出第三个参数，需删除多余部分。每个命令的参数用半角空格分隔，不可使用逗号或中文标点。检查参数之间是否有两个连续空格，会被解析为空参数导致参数错位。

**四、变量声明与操作范围问题**

自定义变量报错“未定义的变量”时，该变量未在QManage.txt的[@Login]段声明。格式为“VAR Integer Human 变量名”或“VAR String Human 变量名”。声明后需在QFunction-0.txt的[@Login]段进行初始化赋值，否则运行时报空值错误。

系统变量P、D、G、M、S、N无需声明但各有取值范围。P变量和D变量只能存储0到999的整数，赋值超出范围报溢出错误。G变量存储0到65535，S变量存储字符串但长度限制在100字符以内。N变量为数值型全局变量，支持更大范围但需引擎版本支持。报错“变量类型不匹配”时检查赋值符号两边的数据类型，数值型变量不能接收文本内容。

**五、段标签与跳转指令的循环检测**

段标签以[@XXX]格式定义，同一文件内不能存在两个完全相同的段名。重复段名导致跳转指令跳转到错误位置或报段不存在。在文件中搜索“[@”定位所有段名，用查找功能逐一确认无重复。若存在重复，保留一个段内容，另一个改名后同步修改所有跳转引用。

GOTO指令构成死循环时M2报“脚本循环超过上限”并终止该段执行。检查GOTO @XXX与段名@XXX之间是否形成闭环，例如A段跳转到B段，B段又跳转回A段。在循环体内增加条件判断或计次变量，达到设定次数后执行BREAK跳出。也可用DELAYGOTO替代GOTO，延迟跳转不触发循环检测机制。

**六、地图编号与物品名引用错误**

脚本中出现的物品名称必须在数据库StdItems.DB内存在精确匹配的名称。检查报错行中的物品名是否多了空格或字母大小写差异，数据库不区分大小写但不可有多余空格。地图编号必须存在于MapInfo.txt中，引用的地图若被删除或重命名，执行MAPMOVE或CHECKMAP命令时报错。

NPC引用错误常见于脚本内调用“@Label”段但该段不存在。调用外部文件需使用#CALL命令，检查#CALL后的文件路径是否正确，文件名是否加扩展名。引用文件所在目录层级每级文件夹名称都不能有中文或特殊字符。

**七、商城、交易与交易行脚本的特殊报错**

商城脚本报错通常因商品价格表中设置了超出范围的数值或商品数量为负数。打开Envir\Shop\目录下的商品配置文件，检查每个商品的价格、数量、绑定属性字段是否完整。数量字段填0会报无效商品错误。

交易行摆摊脚本报错集中在Envir\Market_Def\的摆摊NPC文件。检查#IF条件段的检测指令是否返回预期值，例如检测金币数用CHECKGAMEGOLD，检测等级用CHECKLEVELEX。检测项过多导致脚本超时也会触发错误，简化#IF段的条件数量，将非关键条件移至#ACT段内判断。

**八、QMission与QFunction触发脚本的加载顺序**

QMission-0.txt在引擎启动时最先加载，该文件内的语法错误会导致整个服务端脚本系统无法初始化。该文件只能包含[@Login]、[@Startup]等系统触发段，不要写入自定义功能段。自定义功能应放在QuestDiary目录下，通过CALL指令在QMission中调用。

QFunction-0.txt内的触发段在特定动作时被动调用，报错出现在玩家执行对应动作时。例如拾取触发[@PickUpItem]、攻击触发[@Attack]。报错时打开QFunction-0.txt搜索对应的[@段名]，检查该段内的所有指令是否正确。若段内调用了QuestDiary下的文件，先独立测试被调用文件是否单独运行无误。