传奇服务端QQ礼包脚本错误排查与修复方法

运行传奇服务端时出现QQ礼包相关脚本错误，通常表现为控制台报错“脚本执行失败”、“找不到指定函数”或礼包无法正常发放。该问题源于QFunction-0.txt、QManage.txt等NPC脚本文件中调用逻辑不完整、变量未定义或路径配置异常，需按以下步骤逐项检查。

第一，确认脚本文件编码格式。所有QFunction系列文件必须保存为ANSI编码（非UTF-8或带BOM格式）。使用记事本或Notepad++打开QFunction-0.txt，点击“另存为”，在编码选项中选择“ANSI”。若使用UTF-8，服务端读取中文字符或特殊符号时会解析错位，导致后续指令失效。

第二，检查礼包触发条件语法。常见错误写法如：
IF
CHECKITEM 金币 100
ACT
GIVE 火龙圣剑 1
正确格式应使用标准物品名与数量参数：
IF
CHECKITEM 金条 1
ACT
GIVE 物品 688 1
其中“金条”需与StdItems.dbc中Name字段完全一致，“688”为物品Idx。若直接写中文名而服务端未启用名称匹配模式，将返回脚本错误。

第三，验证礼包物品是否存在。脚本中GIVE指令引用的物品编号（如688）必须在EnvirMarket_defStdItems.dbc中存在且数据完整。若该物品被删除或Idx冲突，服务端加载脚本时会跳过整段逻辑。通过DBEditor打开StdItems.dbc，搜索对应Idx，确认Name、StdMode、Dura等字段无空值。

第四，核对NPC对话文件关联。QQ礼包通常由特定NPC触发，需确保Npc_def目录下对应NPC文件（如QQLibao.txt）已正确引用QFunction标签。例如：
[@main]
欢迎领取QQ礼包！
IF
ACT
goto @qqlibao
而@qqlibao标签必须在QFunction-0.txt中明确定义。若标签名拼写错误（如@qqlibao写成@qqlibao1），则跳转失败，控制台报“未找到子程序”。

第五，检查是否缺失配套文件。部分QQ礼包系统依赖自定义功能，如CheckUserLevel、CheckOnlineTime等扩展指令，需服务端支持HeroX或M2引擎插件。若使用标准Mir200内核却调用了非原生函数，会直接报错。此时需替换为兼容指令，例如用CHECKLEVELEX代替自定义等级检测。

第六，清理脚本缓存并重启。修改脚本后必须完全关闭LoginSrv、DBServer、GameServer三个进程，再重新启动。部分服务端会缓存脚本内容，热更新无效。可编写批处理脚本强制结束进程：
taskkill /f /im LoginSrv.exe
taskkill /f /im DBServer.exe
taskkill /f /im GameServer.exe
之后再启动服务端，确保加载最新脚本。

若仍报错，启用日志追踪。在!Setup.txt中开启ScriptLog=1，运行后查看LogScriptLog.txt，定位具体出错行号。常见错误包括括号未闭合、#IF/#ACT层级错乱、使用了未注册的变量（如但A未赋值）。逐行比对官方示例脚本，修正语法结构即可恢复礼包功能。