传奇架设过程中遇到脚本错误，通常M2控制台或启动日志会提示"脚本加载失败""第XX行语法错误""命令未定义"等信息。绝大多数情况源于语法不规范、路径不对、编码错误、引擎版本不兼容或物品数据库不匹配。按以下步骤逐一排查即可解决。
一、先看日志锁定出错文件和行号
M2启动后在控制台（M2Server）查看红色报错信息，或打开日志文件：
•Hero/GOM引擎：MirServer\Mir200\Log\ScriptError.log或直接看M2控制台日志面板
-GEE引擎：MirServer\GeeLog\Script.log
日志会写明是哪个脚本文件第几行出错，例如"Market_Def\屠龙商人-3.txt第18行语法错误"。记住这个路径和行号，用Notepad++打开对应文件直接跳转到该行开始查。
二、最常见的语法格式错误及修复
脚本命令必须用英文半角符号，中文逗号、中文括号、中文引号都会导致解析失败。检查报错行及上下3-5行：
•符号全角问题：把所有中文，。（）""''改为英文.()"'，传奇脚本严格要求半角。
-括号或引号未闭合：如#SAY<$USERNAME你好少了右尖括号，字符串缺结束引号也会报错。
•命令关键字拼错：#IF写成#lf或#FI，GIVE写成GIV，TAKE写成TAK，对照引擎自带的脚本命令手册（CHM帮助文档）核实。
•命令参数数量不足：GIVE屠龙少了数量参数会报参数不足，必须写成GIVE屠龙1；CHECKLEVELEX>50条件也不能少比较符和数值。
•结构不完整：#IF后面必须跟条件判断，然后是#ACT（条件满足执行）或#ELSEACT/#ELSESAY（不满足时），不能#IF后直接又是#IF或空行，引擎无法识别。
三、脚本文件编码与隐藏字符问题
GOM、GEE、Hero引擎的TXT脚本只认ANSI编码（GBK），如果用记事本另存为UTF-8或UTF-8withBOM，引擎可能读成乱码或直接加载失败。
修复方法：用记事本打开脚本→文件→另存为→编码选"ANSI"→覆盖保存。另外用Notepad++开启"视图→显示符号→显示所有字符"，检查行首行尾是否有不可见的全角空格或复制来的特殊控制字符，删掉重打。
四、跳转标签、变量与物品数据库关联错误
•标签不存在：脚本写了GOTO@买药或#CALL[...]\任务.txt@奖励但文件内没有[@买药]或[@奖励]这个标签，会报标签未找到。补上对应标签或修正GOTO目标名。
•变量未初始化：人型变量（HUMAN）和全局变量（GLOBAL）需先赋值再用，如在QManage.txt登录触发段用MOVG5070初始化后再INCG5071，未定义直接用会功能失效或报错。
•物品名与DB不一致：GIVE裁决1但StdItems.DB（物品数据库）里标准名称是"裁决之杖"，引擎找不到"裁决"会报物品不存在。打开DB查看准确名字复制过来。
五、文件路径错误与NPC配置文件核对
NPC脚本默认放在MirServer\Mir200\Envir\Market_Def\，任务脚本放Envir\QuestDiary\子目录\脚本名.txt。若M2提示"找不到文件"但文件明明在：
•检查服务端整体安装路径不能含中文或空格（推荐D:\MirServer），含中文易导致加载异常。
•打开Envir\Merchant.txt（NPC列表文件），核对NPC绑定的脚本文件名和路径是否和实际文件完全一致。格式示例：3武器店老板330320武器商人0武器店老板-3，表示地图3坐标330320处加载Market_Def下"武器店老板-3.txt"，文件名多写.txt后缀或少写地图编号都会加载失败。
•任务脚本若在QuestDiary子目录，QFunction-0.txt或QManage.txt中用#CALLQuestDiary\任务\主线.txt@Label调用时路径必须匹配。
六、引擎版本不兼容与缺少插件
不同引擎（Hero、Blue、GOM、GEE、翎风）支持的脚本命令集不同。老版本脚本用到新引擎专有命令（或反之）会提示"不是内部或外部命令"或"未知命令"。
•查看你引擎版本配套的脚本命令说明书（通常安装目录有CHM帮助文件），将不支持的命令替换为等价兼容命令，或删除该功能段。
•部分功能如自动回收、泡点、特殊检测需要对应.dll插件放入Mir200\PlugIns\并在M2"插件管理"中勾选加载，缺插件调用相关命令也会报错。
七、修改后不生效或仍报错的处理
•修改脚本保存后，在M2控制台点"控制→重新加载→NPC脚本"（或重新加载QFunction），无需每次重启整个服务端。
•若改完M2直接闪退无法启动，把之前备份的原脚本文件覆盖回去，或进Mir200\Envir\把刚改的文件换回备份版。
•确保脚本文件没有被Windows设为"只读"（右键属性取消只读），引擎无写入权限时部分记录型脚本会异常。
•复杂脚本可用分号;注释掉一半内容逐步取消注释来二分定位出错行。
养成修改前先备份脚本文件、用Notepad++编辑、每次启动看M2日志的习惯，基本可以秒定位并修好绝大多数传奇架设时的脚本错误。
一、先看日志锁定出错文件和行号
M2启动后在控制台（M2Server）查看红色报错信息，或打开日志文件：
•Hero/GOM引擎：MirServer\Mir200\Log\ScriptError.log或直接看M2控制台日志面板
-GEE引擎：MirServer\GeeLog\Script.log
日志会写明是哪个脚本文件第几行出错，例如"Market_Def\屠龙商人-3.txt第18行语法错误"。记住这个路径和行号，用Notepad++打开对应文件直接跳转到该行开始查。
二、最常见的语法格式错误及修复
脚本命令必须用英文半角符号，中文逗号、中文括号、中文引号都会导致解析失败。检查报错行及上下3-5行：
•符号全角问题：把所有中文，。（）""''改为英文.()"'，传奇脚本严格要求半角。
-括号或引号未闭合：如#SAY<$USERNAME你好少了右尖括号，字符串缺结束引号也会报错。
•命令关键字拼错：#IF写成#lf或#FI，GIVE写成GIV，TAKE写成TAK，对照引擎自带的脚本命令手册（CHM帮助文档）核实。
•命令参数数量不足：GIVE屠龙少了数量参数会报参数不足，必须写成GIVE屠龙1；CHECKLEVELEX>50条件也不能少比较符和数值。
•结构不完整：#IF后面必须跟条件判断，然后是#ACT（条件满足执行）或#ELSEACT/#ELSESAY（不满足时），不能#IF后直接又是#IF或空行，引擎无法识别。
三、脚本文件编码与隐藏字符问题
GOM、GEE、Hero引擎的TXT脚本只认ANSI编码（GBK），如果用记事本另存为UTF-8或UTF-8withBOM，引擎可能读成乱码或直接加载失败。
修复方法：用记事本打开脚本→文件→另存为→编码选"ANSI"→覆盖保存。另外用Notepad++开启"视图→显示符号→显示所有字符"，检查行首行尾是否有不可见的全角空格或复制来的特殊控制字符，删掉重打。
四、跳转标签、变量与物品数据库关联错误
•标签不存在：脚本写了GOTO@买药或#CALL[...]\任务.txt@奖励但文件内没有[@买药]或[@奖励]这个标签，会报标签未找到。补上对应标签或修正GOTO目标名。
•变量未初始化：人型变量（HUMAN）和全局变量（GLOBAL）需先赋值再用，如在QManage.txt登录触发段用MOVG5070初始化后再INCG5071，未定义直接用会功能失效或报错。
•物品名与DB不一致：GIVE裁决1但StdItems.DB（物品数据库）里标准名称是"裁决之杖"，引擎找不到"裁决"会报物品不存在。打开DB查看准确名字复制过来。
五、文件路径错误与NPC配置文件核对
NPC脚本默认放在MirServer\Mir200\Envir\Market_Def\，任务脚本放Envir\QuestDiary\子目录\脚本名.txt。若M2提示"找不到文件"但文件明明在：
•检查服务端整体安装路径不能含中文或空格（推荐D:\MirServer），含中文易导致加载异常。
•打开Envir\Merchant.txt（NPC列表文件），核对NPC绑定的脚本文件名和路径是否和实际文件完全一致。格式示例：3武器店老板330320武器商人0武器店老板-3，表示地图3坐标330320处加载Market_Def下"武器店老板-3.txt"，文件名多写.txt后缀或少写地图编号都会加载失败。
•任务脚本若在QuestDiary子目录，QFunction-0.txt或QManage.txt中用#CALLQuestDiary\任务\主线.txt@Label调用时路径必须匹配。
六、引擎版本不兼容与缺少插件
不同引擎（Hero、Blue、GOM、GEE、翎风）支持的脚本命令集不同。老版本脚本用到新引擎专有命令（或反之）会提示"不是内部或外部命令"或"未知命令"。
•查看你引擎版本配套的脚本命令说明书（通常安装目录有CHM帮助文件），将不支持的命令替换为等价兼容命令，或删除该功能段。
•部分功能如自动回收、泡点、特殊检测需要对应.dll插件放入Mir200\PlugIns\并在M2"插件管理"中勾选加载，缺插件调用相关命令也会报错。
七、修改后不生效或仍报错的处理
•修改脚本保存后，在M2控制台点"控制→重新加载→NPC脚本"（或重新加载QFunction），无需每次重启整个服务端。
•若改完M2直接闪退无法启动，把之前备份的原脚本文件覆盖回去，或进Mir200\Envir\把刚改的文件换回备份版。
•确保脚本文件没有被Windows设为"只读"（右键属性取消只读），引擎无写入权限时部分记录型脚本会异常。
•复杂脚本可用分号;注释掉一半内容逐步取消注释来二分定位出错行。
养成修改前先备份脚本文件、用Notepad++编辑、每次启动看M2日志的习惯，基本可以秒定位并修好绝大多数传奇架设时的脚本错误。