传奇M2Server脚本错误提示的常见类型与手动修复

M2Server控制台刷出一片红色报错，后面跟着脚本文件名和行号，这种画面每个架设过传奇的人都见过。脚本错误不像配置问题那样直接卡死引擎，但会导致功能失效或者整个游戏无法正常运转。错误类型虽然五花八门，但实际跑起来就那么几类。

**脚本变量未声明或类型不匹配**

引擎读取脚本时遇到一个没有定义过的变量，会直接报错并中断该段脚本的执行。比如在登陆脚本里写了MOV P1 100，但前面没有用VAR来声明P1这个变量，M2就会提示变量不存在。解决办法是去脚本开头加上声明，或者检查变量名是不是打错了字母。更隐蔽的情况是变量类型用错，P系列变量和G系列变量的存储范围不同，把字符串赋给了整数型变量也会触发类似报错。

**脚本命令参数数量或格式不正确**

每个脚本命令都有固定的参数格式，多一个少一个逗号都会报错。例如GIVE命令的正确写法是GIVE 金币 1000，如果写成了GIVE 金币 1000 1，多了一个参数，引擎就会提示命令参数错误。这类错误很好定位，M2报错会精确指出脚本文件第几行，打开对应的文本文件找到那一行对照命令手册修改就行。常见出错命令集中在CHECKLEVELEX、MAPMOVE、ADDSKILL这几个高频指令上。

**NPC对话脚本跳转标签缺失**

NPC脚本里用到GOTO或者CALL命令跳转到某个标签段，但目标标签在文件里根本不存在，引擎读到这里就会报错并停止该NPC的功能。例如有一个GOTO @领取奖励，但整个脚本里没有[@领取奖励]这个段，点击NPC就毫无反应。修复方法是在脚本里补上对应的标签段，或者把跳转目标改到存在的标签上。标签必须写成[@领取奖励]这样的格式，前后不能有空格。

**循环嵌套过深导致引擎溢出**

IF语句里面套CALL，CALL里面又套了GOTO，这种多层循环脚本在运行时会消耗大量引擎资源。如果嵌套层级超过引擎设定的上限，M2Server会直接报出脚本循环过深的错误并终止脚本执行。这种问题在大型版本里比较常见，特别是游戏活动脚本和装备回收脚本。处理方式是把深层嵌套拆分成多段独立的脚本，或者改用CHECK命令配合DELAYGOTO来规避循环深度问题。

**怪物爆率文件中的格式错误**

爆率文件通常放在MonItems文件夹下，格式是1/100 屠龙。如果漏掉了斜杠，或者把道具名写成了数据库里没有的ID，M2在加载爆率时就会报错。这类错误不会在引擎启动时报出来，往往是怪物死亡时才触发，然后M2控制台弹出一条临时错误。检查最近添加过爆率的怪物文件，确认每一行格式都符合要求。

**QuestDiary文件引用路径错误**

脚本里使用#CALL命令引用QuestDiary文件夹下的子文件时，路径写法非常严格。写成#CALL [游戏功能/装备回收.txt] @回收，就必须确保QuestDiary目录下存在“游戏功能”文件夹，且该文件夹下有“装备回收.txt”文件。路径写错或者文件不存在，引擎会提示文件打开失败。检查时要区分斜杠方向，Windows系统使用正斜杠还是反斜杠取决于引擎版本，按报错信息调整。

**报错信息的分级处理策略**

M2Server的报错有严重等级之分。红色的ERROR提示必须处理，否则对应功能完全失效。黄色的WARNING提示可以暂时忽略，不影响整体运行，但时间允许时建议修复。处理时先看报错指向的脚本文件名，再根据行号定位，大多数错误五到十分钟就能修完。