传奇MAX引擎卡密脚本输入无反应故障排查与修复

输入卡密后既不提示成功也不报错，脚本完全没动静，这在MAX引擎上通常不是逻辑写错，而是脚本根本没被执行或者执行被静默截断了。核心排查方向放在：脚本入口是否被触发、变量是否被引擎识别、文件路径权限是否到位、以及脚本是否真的被加载进了内存。

### 先确认NPC对话框的跳转指向是否准确

脚本无反应，优先检查NPC对话里的触发命令和脚本段名是不是对得上。如果点击输入框后没有任何反馈，先排查这段：

**检查[@main]入口是否写对了跳转**
NPC脚本的主入口必须是[@main]，玩家点开NPC对话时首先加载这一段。如果在[@main]里用“<输入卡密/@输入卡密>”这样的写法，脚本里必须有对应的[@输入卡密]段。常见错误是把段名写成了[@卡密输入]或者[@keyin]，但对话里的跳转写的是<输入卡密/@输入卡密>，这种不匹配会导致点击后完全没反应。

**检查#SAY和#ACT的分段是否完整**
在MAX引擎中，#SAY后面跟的是显示内容，#ACT后面跟的是执行命令。如果脚本里缺少#ACT段，或者#ACT写到了#SAY前面，引擎解析时可能跳过执行部分。正确格式参考：

```
[@输入卡密]
#IF
CHECKCARD <$STR(S1)>
#ACT
GIVE 金币 10000
#SAY
卡密验证通过，获得金币
#ELSEACT
MESSAGEBOX 卡密无效或已使用
CLOSE
```

缺少#ELSEACT分支时，输入错误卡密不会有任何提示，玩家就会看到点确认后什么都没发生。

### 变量声明与存储路径是MAX引擎的重灾区

MAX引擎对自定义变量的处理比较严格，必须在QManage.txt里提前声明才能用。如果脚本里直接用了HUMAN类型变量但没在登录段初始化，引擎会静默跳过，不报错也不执行。

**在QManage.txt的[@Login]段声明变量**
打开Mir200\Envir\MapQuest_def\QManage.txt，找到[@Login]段，在最后面加上：

```
VAR INTEGER HUMAN 卡密状态
LOADVAR HUMAN 卡密状态 ..\QuestDiary\卡密系统\卡密记录.txt
```

这段代码必须在角色登录时执行，声明变量类型并绑定存储文件。如果QManage.txt里没有这段，或者路径写错了，脚本里任何对“卡密状态”的读取都会失败，且不产生明确错误提示。

**确认存储文件存在且路径正确**
上面的LOADVAR指向的是QuestDiary\卡密系统\卡密记录.txt，这个文件必须实际存在。检查Mir200\Envir\QuestDiary\文件夹下面有没有“卡密系统”这个子文件夹，里面有没有“卡密记录.txt”这个文件。如果文件缺失，引擎在加载变量时会失败，后续所有依赖该变量的操作都会卡住。

**检查文件写入权限**
MAX引擎运行过程中需要向QuestDiary目录下的文本文件写入数据。如果Mir200文件夹所在的磁盘分区权限不足，或者QuestDiary文件夹被设置了只读属性，引擎无法写入卡密记录，脚本执行到保存变量的步骤就会中断。右键点击QuestDiary文件夹，查看属性，取消只读勾选。

### 卡密库文件格式和命令拼写

卡密校验命令本身的问题也会导致无反应。

**检查CHECKCARD命令的参数格式**
MAX引擎的CHECKCARD命令后面跟的卡密参数需要用变量传递，常见写法是：

```
CHECKCARD <$STR(S1)>
```

如果写成CHECKCARD S1或者CHECKCARD <$S1>，引擎可能无法正确解析，导致判定失败但没有报错。另外，部分MAX版本要求字符串匹配时加通配符：

```
CHECKCARD <$STR(S1)> *
```

这个星号代表强制按字符串匹配，不加的话如果卡密是纯数字可能会被当成数值比较。

**卡密库文件每行一个卡密**
卡密库文件（通常叫卡密列表.txt或类似名字）必须每行只放一个卡密，不要有空格、制表符或者空行。用Notepad++打开该文件，开启“显示所有字符”功能（视图→显示符号→显示所有字符），检查每行末尾有没有多余的空白符号。如果卡密文件里有空行或不可见字符，CHECKCARD命令比对时会匹配不上，表现就是输入正确卡密也没反应。

### 脚本未重载是排查时容易漏掉的一步

修改完脚本后，如果只是保存文件但没有让引擎重新加载，实际上运行的还是旧脚本，你改的内容根本没生效。

**在M2控制台执行重载命令**
打开M2Server控制台，在命令行输入`@ReloadNpc`重载所有NPC脚本，或者`@ReloadManage`重载QManage.txt。如果MAX引擎版本较老，这些命令可能没效果，那就需要直接在控制台点“重新加载”按钮，或者干脆重启整个服务端。

**确认脚本文件编码是ANSI**
MAX引擎读取脚本文件时默认使用ANSI编码，如果脚本文件保存成了UTF-8（尤其是带BOM的UTF-8），引擎解析时会在文件开头读到不可见字符，导致整段脚本解析失败。用Notepad++打开脚本文件，看右下角状态栏显示的编码格式，如果不是ANSI就转换过来再保存。

### 借助M2日志定位静默失败点

脚本无反应但没报错时，M2Server的日志文件是唯一能帮你定位问题的手段。

**查看Log文件夹下的错误日志**
打开Mir200\Log\文件夹，找到ScriptError.txt或者ErrorLog.txt，用记事本打开，看里面有没有记录到脚本错误。即使游戏里没弹窗，引擎后台经常会记录错误信息，比如“变量未定义”“文件不存在”“第X行命令错误”等。

**在脚本里插入调试输出**
在卡密验证脚本的关键位置插入调试命令，帮助确认脚本执行到了哪一步：

```
[@输入卡密]
#IF
#ACT
SENDMSG 6 已进入卡密验证流程，当前输入卡密为：<$STR(S1)>
#IF
CHECKCARD <$STR(S1)>
#ACT
SENDMSG 6 卡密校验通过
GIVE 金币 10000
#ELSEACT
SENDMSG 6 卡密校验失败
MESSAGEBOX 卡密无效
CLOSE
```

SENDMSG 6会把信息显示在游戏聊天框里，能看到哪条消息出现、哪条没出现，就知道脚本在哪一步卡住了。如果连“已进入卡密验证流程”都没显示，说明问题在入口跳转上；如果显示了但后面没动静，就是CHECKCARD或变量的问题。