传奇服务端MOV/INC命令错误修正及脚本添加全指南

一、错误日志解析：MOV/INC命令报错核心原因

结合日志中[脚本错误] MOV/INC命令提示，及添加新脚本后变量异常的问题，核心原因集中在变量未定义、命令格式错误、脚本放置路径不当、引擎适配异常四类。报错涉及NPC“竞价地图”（地图3坐标330:321），参数1为自定义变量（A551、G507），参数2为赋值内容，本质是引擎无法识别变量或解析命令，导致执行失败。

MOV命令用于变量赋值，INC命令用于变量累加，二者均需依赖已定义的变量才能正常执行，若变量未注册、格式不规范，或命令参数与变量类型不匹配，会直接触发报错。仅添加新脚本后出现问题，排除引擎全局故障，优先锁定新脚本自身配置缺陷。

二、分步骤修正MOV/INC命令错误

1. 优先排查自定义变量未定义问题（高频原因）

日志中A551、G507均为自定义变量，传奇服务端自定义变量需提前在指定文件中注册定义，未定义的变量无法被MOV/INC命令调用，直接触发报错。

操作步骤：

（1）定位变量定义文件：不同引擎变量定义文件不同，Hero引擎默认在Mir200\Envir\QuestDiary\QVar.txt，GOM引擎在Mir200\Envir\QFunction-0.txt头部，HGE引擎在Mir200\Envir\Variable.txt，根据自身引擎类型找到对应文件。

（2）注册自定义变量：打开文件后，按格式添加变量定义，基础格式为“变量名=初始值”，示例：

A551=0 ；定义变量A551，初始值设为0（字符串变量可设为空值“A551=”）

G507=0 ；定义变量G507，初始值设为0（用于累加计数）

（3）保存并加载配置：保存文件后，重启M2控制器，或通过M2“重新加载变量配置”功能刷新，确保变量注册生效，未加载的变量无法被脚本调用。

2. 修正MOV/INC命令格式错误

MOV/INC命令有固定语法规范，参数不匹配、格式错乱会导致引擎无法解析，需严格遵循命令格式要求。

（1）MOV命令正确格式及修正：

功能：给变量赋值，格式为“MOV 变量名 赋值内容”，变量名需与定义一致，赋值内容需与变量类型匹配（数值变量赋值数字，字符串变量赋值文本）。

错误示例：日志中“MOV 参数1:A551 参数2:法师”，若A551定义为数值变量，赋值“法师”（文本）会触发类型不匹配；若格式缺失空格、符号，也会报错。

修正示例：

若A551为字符串变量（存储职业名称），命令应为“MOV A551 法师”（变量名与赋值内容间留1个空格）；

若A551为数值变量，需将赋值内容改为数字，如“MOV A551 1”（1代表法师职业编码）。

（2）INC命令正确格式及修正：

功能：给数值变量累加，格式为“INC 变量名 累加值”，变量必须为数值类型，累加值需为整数，不可对字符串变量使用INC命令。

错误示例：若G507未定义为数值变量，或命令格式为“INC G507 2”（格式正确但变量未定义），均会报错。

修正示例：确保G507为数值变量，命令写为“INC G507 2”，表示给G507变量值加2，格式严格保留空格，无多余符号。

3. 引擎适配性修正

不同引擎对MOV/INC命令的支持有差异，部分引擎需在脚本中添加变量声明，或使用专属前缀标识自定义变量，否则无法识别。

适配方法：

（1）Hero引擎：自定义变量无需前缀，注册后直接使用，若仍报错，检查脚本中是否有多余符号（如逗号、引号），删除冗余字符即可。

（2）GOM引擎：自定义变量需加“$”前缀，如“MOV $A551 法师”“INC $G507 2”，同时需在QFunction-0.txt中注册带前缀的变量。

（3）HGE引擎：变量需区分全局变量与局部变量，全局变量在Variable.txt定义，局部变量在脚本内用“VAR 变量名”声明后使用，MOV/INC仅支持全局变量操作。

三、新脚本添加位置及完整操作流程

1. 脚本添加核心位置（按引擎分类）

新脚本需根据功能类型放入对应文件，“竞价地图”NPC脚本优先放入默认脚本目录，确保NPC能正常调用。

（1）通用位置：Mir200\Envir\QuestDiary目录，新建文本文件（如“竞价地图脚本.txt”），将脚本内容写入后保存，文件名无特殊符号，仅含字母、数字、中文。

（2）关联NPC配置：打开Mir200\Envir\Marchent.txt文件，找到“竞价地图”NPC配置行，格式为“NPC名称 地图编号 X坐标 Y坐标 脚本文件名”，确保脚本文件名与新建文件一致，示例：

竞价地图 3 330 321 竞价地图脚本.txt ；关联地图3坐标330:321的NPC与对应脚本

（3）特殊场景：若脚本为全局触发（非NPC专属），Hero引擎放入QFunction-0.txt，GOM引擎放入AutoRun.txt，需在脚本开头添加触发标识。

2. 完整添加操作步骤

步骤1：注册自定义变量，按引擎类型在对应文件中添加A551、G507变量定义，设置初始值。

步骤2：修正脚本命令格式，确保MOV/INC命令语法正确，变量类型与赋值内容匹配，适配对应引擎前缀要求。

步骤3：新建脚本文件，将修正后的脚本内容复制粘贴，保存至Mir200\Envir\QuestDiary目录，命名规范（如“竞价地图脚本.txt”）。

步骤4：关联NPC与脚本，编辑Marchent.txt，确认“竞价地图”NPC配置行的脚本文件名与新建文件一致，坐标（330:321）对应正确。

步骤5：加载配置，重启M2控制器，或依次执行“重新加载所有NPC”“重新加载变量配置”，确保脚本及变量生效。

步骤6：测试验证，进入游戏找到“竞价地图”NPC，触发脚本功能，查看M2日志是否仍有报错，无报错则添加成功。

四、脚本编写及添加注意事项

1. 变量命名规范：自定义变量避免使用纯数字或引擎保留字（如MOV、INC、ATTACK等），优先用“字母+数字”组合（如A551、G507），长度控制在6位以内，便于识别和调用。

2. 命令参数要求：MOV命令支持数值、文本赋值，INC命令仅支持数值累加，不可混用类型；参数间仅保留1个空格，无多余标点，避免格式错乱。

3. 文件权限设置：脚本文件及变量定义文件需取消只读属性，确保可修改、可保存；保存时编码格式设为ANSI，避免中文乱码导致引擎无法解析。

4. 备份配置文件：添加新脚本前，备份Marchent.txt、变量定义文件及原有脚本，若添加后出现异常，可快速还原至正常状态。

5. 分段测试脚本：新脚本编写完成后，可先保留核心命令（MOV/INC及变量操作），删除无关逻辑，分段测试排查错误，避免整体脚本复杂导致定位困难。

五、常见延伸问题及解决方法

1. 脚本添加后NPC无响应：检查Marchent.txt中NPC坐标、地图编号是否正确，脚本文件名是否与配置一致，路径是否放入QuestDiary目录。

2. 变量赋值后无变化：若MOV命令执行无报错但变量值不变，可能是变量被后续脚本覆盖，检查脚本逻辑，避免重复赋值；或变量为局部变量，超出作用范围后失效。

3. 引擎重启后变量失效：自定义变量需设置为全局变量，局部变量仅在当前脚本执行周期内有效，重启引擎后重置；全局变量需在对应配置文件中定义，确保持久化。

4. 多命令联动报错：若脚本中MOV/INC命令与其他命令（如CheckVar、Goto）联动报错，检查命令执行顺序，确保变量赋值/累加后再执行条件判断，避免逻辑断层。