一、QQ礼包脚本报错核心排查点
QQ礼包脚本通常位于 QuestDiary\QQ礼包\ 或 QuestDiary\充值礼包\ 目录下，报错多由路径与编码问题引发。
1. 路径引用错误
脚本中调用外部文件时路径错误。例如脚本中写 #CALL [\QQ礼包\领取.txt] @main，但实际文件存放在 QuestDiary\QQ礼包\领取.txt。修正方法：检查脚本中的 #CALL 指令，确保路径与磁盘实际路径完全一致，注意大小写及是否多级目录。
2. 文件编码与格式
礼包脚本含中文，若保存为 UTF-8 格式，部分老版本引擎会解析乱码导致报错。修正方法：用记事本或 Notepad++ 打开脚本文件，点击“文件”→“另存为”，将编码改为 ANSI 后覆盖保存。
3. 触发条件冲突
礼包领取脚本通常绑定 QFunction-0.txt 中的 [@Login]（登录触发）或物品使用触发。若变量初始化失败（如检测 $HUM(QQ礼包) 但未定义），会导致逻辑中断。修正方法：在脚本开头或 QManage.txt 中初始化相关变量。
二、服务端脚本错误通用修复流程
第一步：精准定位错误源
启动 M2Server，点击菜单栏“查看”→“日志信息”或“脚本错误日志”。当报错发生时，日志会明确提示错误文件及行号（如 QFunction-0.txt Line 153）。若日志无提示，进入 MirServer\Mir200\Log\ 目录查看 ScriptError.log。
第二步：语法与结构修正
根据日志定位的行号，使用 Notepad++（开启显示行号）打开对应脚本文件，检查该行及上下行是否存在以下问题：
• 指令拼写错误：如 #ACT 写成 #ATC，SENDMSG 写成 SENDMS。
• 结构不闭合：#IF 后缺少对应的 #ACT 或 #ELSE；WHILE 循环缺少 ENDWHILE。
• 参数越界：MAPMOVE 传送坐标超出地图大小，或地图编号不存在。
第三步：外部调用验证
若错误涉及 #CALL 或 #INCLUDE 引用外部文件，检查被调用文件是否存在、路径是否正确（严禁使用中文路径），以及被调用文件内部是否也存在语法错误。
三、常见典型错误与修复案例
案例1：变量未定义（礼包重复领取判断失效）
• 报错现象：领取礼包后再次领取不提示“已领取”，或直接报脚本错误。
• 排查：检查检测代码。例如脚本使用 #IF CHECK [100] 1 检测标志，但从未使用 SET [100] 1 进行设置。
• 修复：在领取逻辑中补充设置标志的指令：#ACT SET [100] 1。
案例2：QFunction-0.txt 全局脚本死循环
• 报错现象：M2 频繁报错甚至卡死，提示 QFunction 脚本异常。
• 排查：检查 [@Login] 或 [@StdModeFuncX] 标签内是否存在 GOTO @Login 这类无退出条件的跳转。
• 修复：在跳转前增加条件判断（如检测上线次数），或改用 #CALL 调用独立文件。
案例3：数据库与脚本不匹配
• 报错现象：使用礼包物品提示“脚本错误”，但脚本语法无误。
• 排查：StdItems.DB 数据库中该物品的 Stdmode 字段与脚本中的 @StdModeFuncX 编号不匹配。
• 修复：修改数据库字段或修改脚本标签，确保 X 的值一致。
四、脚本修改注意事项
1. 备份原则：修改任何脚本前，备份整个 Envir 文件夹。
2. 编码统一：所有 .txt 脚本文件建议统一使用 ANSI 编码，避免混用 UTF-8 导致中文乱码。
3. 符号规范：所有标点符号必须为英文半角（如括号 ()、逗号 ,），严禁使用中文全角符号。
4. 注释排查：若某行代码看似无误却报错，检查该行末尾或上一行末尾是否存在未闭合的注释符 ;。
若以上排查后仍无法解决，建议暂时屏蔽礼包脚本（重命名文件或注释调用代码），确认是否为该脚本导致的连锁错误。
