传奇服务端架设过程中，脚本错误是常见问题，主要表现为NPC无法对话、任务不触发、物品无法领取、地图传送失效等。这些问题通常源于脚本语法错误、路径配置不当、变量缺失或引擎兼容性问题。以下为系统性排查与修复步骤。
第一步：确认错误类型与位置
启动登录器后若NPC点击无反应，首先检查客户端提示。若显示“脚本出错”或“找不到指定脚本”，说明服务端未正确加载脚本文件。进入服务端日志目录（通常为Log或DebugLog），查看最新日志文件，搜索“Error”“Fail”“Script”等关键词，定位具体报错行号和文件名。
第二步：检查脚本文件路径与命名
所有NPC脚本必须放在EnvirMarket_def目录下，且文件名需与Npc_def或MapQuest_def中调用的名称完全一致（区分大小写）。例如，若Npc_def中写的是Call Market_defHealer.txt，则Healer.txt必须存在于Market_def文件夹内。若使用QFunction调用[@Login]等事件，需确保QFunction.txt位于Envir根目录。
第三步：验证脚本语法格式
常见语法错误包括：
标签缺少@符号，如[main]应为[@main]；
条件指令#IF与动作指令#ACT未配对；
变量未定义直接使用，如MOV N0 S9但S9未赋值；
字符串未闭合，如#SAY 后文本含未转义的反斜杠；
指令拼写错误，如CHECKBAGITEM写成CHECKBAGITME。
建议使用文本编辑器（如Notepad++）开启行号显示，逐行核对。特别注意中文标点混入，所有符号必须为英文半角。
第四步：检查物品与地图编号有效性
脚本中涉及的物品编号（如GIVE 380）、地图编号（如MAP 3）必须在StdItems.txt和MapInfo.txt中存在。若引用不存在的编号，脚本执行到该行会中断。可通过MirServer工具查看StdItems列表，确认物品索引是否匹配。
第五步：处理QFunction事件冲突
若多个功能同时修改QFunction.txt（如自动拾取、上线奖励、防挂机检测），可能出现标签重复。例如两个模块都定义了[@Login]，后加载的会覆盖前者。解决方法是合并逻辑，或使用唯一标签名并通过GOTO跳转。
第六步：验证引擎版本兼容性
部分脚本指令仅适用于特定引擎。例如HEROM2支持，而早期Mir200不支持。若从网络下载脚本，需确认其适配的服务端版本。可尝试替换高级指令为基础指令，如用SENDMSG代替ANNOUNCE。
第七步：测试最小化脚本
新建一个最简NPC脚本用于测试：
[@main]
SAY
测试成功。
保存为Test.txt放入Market_def，放置NPC后对话。若仍无效，说明服务端未读取脚本目录，需检查MirServer.ini中是否禁用脚本加载。
第八步：重启服务端并清缓存
修改脚本后必须完全关闭LoginSrv、GameSrv、RunGate等进程，再重新启动。部分服务端会缓存脚本内容，热更新无效。Windows任务管理器中结束所有Mir相关进程后再启动。
典型错误示例与修复：
错误：“GIVEWEAR 4 鞋子 50” 报错 → 修复：物品名需与StdItems.txt完全一致，应写为“GIVEWEAR 4 布鞋 50”；
错误：“CALLSHOPITEM 380 100” 无效 → 修复：CALLSHOPITEM需对应NPC商店有该商品，否则改用GIVE 380 100；
错误：定时器不触发 → 修复：确认SETTIMER编号未重复，且QManage.txt中存在[@Timer_X]标签。
通过以上步骤，90%以上的脚本错误可被定位并修复。核心原则：从日志入手，逐项排除路径、语法、数据、兼容性四类问题。
