传奇 QFunction-0 文件脚本没错误，怎么触发还是失效？

在传奇私人服务器里，QFunction-0.txt 是负责物品触发、NPC 对话等基础功能的核心脚本文件。有时候明明脚本命令没写错，却出现 “点回城卷不回城”“用金条不加金币” 的情况，这多半不是脚本本身的问题，而是和文件调用、M2 引擎设置或系统关联有关。下面就从几个常见原因入手，说说怎么排查这类问题。
先确认脚本是否被正确 “调用”
QFunction-0.txt 里的脚本需要通过特定 “标签” 被游戏系统调用，比如回城卷的触发标签是 [@UseItem 回城卷]，金条是 [@UseItem 金条]。如果这些标签写错了，或者和物品名称对不上，就算命令没错，也不会触发效果。
比如你在脚本里写的是 [@UseItem 回城卷]，但服务端里物品实际叫 “传送卷轴”（可能是自定义名称），就会出现 “点了消失却不回城” 的情况。这时候要做的是：打开服务端的物品数据库（通常是 Mir200\Envir\Item.txt），找到回城卷对应的 “物品名称”，确保脚本里的 [@UseItemXXX] 和数据库里的名称完全一致（包括空格、符号）。
另外，QFunction-0.txt 里的脚本需要用正确的格式开头。比如物品触发必须以 [@UseItem 物品名] 开头，NPC 对话以 [@StdModeXXX] 开头，少了这些固定标签，系统就不知道该什么时候执行脚本。检查一下你的回城卷脚本是不是写成了：
[@UseItem 回城卷]
#ACT
MapMove 3 330 260 ；盟重城坐标
Take 回城卷 1 ；扣除 1 个回城卷
如果格式对但还是失效，再看看是否漏了 “#ACT” 命令 —— 很多新手会写成 “#Act”（小写），虽然部分引擎能兼容，但严格来说这属于格式错误，可能导致整个脚本块不执行。
M2 引擎设置可能 “屏蔽” 了触发功能
QFunction-0.txt 的脚本能否生效，和 M2 引擎（游戏控制器）的设置直接相关。很多时候触发失效，就是 M2 里的某个开关没打开。
先检查 M2 的 “选项→功能设置→脚本功能”：看看 “允许物品触发脚本”“允许使用 QFunction 系列文件” 这两个选项是否勾选。如果没勾，系统会直接跳过 QFunction-0.txt 里的物品触发脚本，导致 “物品消失但不执行功能”（因为扣除物品是游戏默认行为，而后续功能需要脚本触发）。
再看看 “M2→查看→日志” 里的提示。当你点击回城卷时，日志里如果出现 “找不到脚本标签 [@UseItem 回城卷]”，说明 M2 确实没读取到对应的脚本；如果显示 “脚本执行错误：未知命令”，可能是你用了该版本 M2 不支持的命令（比如某些引擎不支持 MapMoveEx 这类扩展命令，换成基础的 MapMove 就好）。
还有一种情况是 M2 的 “脚本加密” 功能被误开。如果 QFunction-0.txt 没加密，但 M2 里勾选了 “强制验证脚本加密”，系统会拒绝执行未加密的脚本。在 “M2→选项→安全设置” 里，把 “脚本加密验证” 关掉，再重新加载脚本试试。
文件路径和关联是否出了问题
QFunction-0.txt 必须放在正确的位置才能被读取。标准路径是 “MirServer\Mir200\Envir\QuestDiary\QFunction-0.txt”，如果被误放到了其他文件夹（比如 QFunction 文件夹里），M2 会找不到这个文件，自然无法触发脚本。
另外，服务端里的 “主脚本” 需要正确关联 QFunction-0.txt。打开 “Mir200\Envir\QuestDiary\Main.txt”，看看里面有没有 “#INCLUDE QFunction-0.txt” 这句命令。如果没有，说明主脚本没包含 QFunction-0.txt，需要手动加上（注意文件名要写对，比如不能写成 QFunction-0.TXT 或 qfunction-0.txt，部分系统对大小写敏感）。
有时候文件本身的 “属性” 也会导致问题。如果 QFunction-0.txt 被设置为 “只读”，M2 可能无法加载最新修改；或者文件编码不对（比如用 UTF-8 编码保存，而引擎只支持 ANSI），会导致脚本里的中文标签乱码，系统无法识别。右键文件→属性，去掉 “只读” 勾选，再用记事本打开，选择 “另存为”，编码选 “ANSI”，覆盖原文件试试。
其他容易忽略的细节
物品 “使用类型” 没设置对：在物品数据库（Item.txt）里，回城卷的 “使用类型”（StdMode）需要设为 “2”（可使用物品），金条设为 “18”（可兑换物品）。如果 StdMode 设成了 “0”（不可使用），点击时只会触发 “扣除物品” 的默认行为，不会执行脚本功能。
脚本被其他文件覆盖：有些服务端会有 QFunction-1.txt、QFunction-2.txt 等扩展文件，按照引擎规则，数字越小的文件优先级越高。但如果其他文件里有同名标签（比如 QFunction-1.txt 里也有 [@UseItem 回城卷]），可能会覆盖 QFunction-0.txt 里的设置。检查其他 QFunction 文件，删掉重复的标签试试。
M2 版本和脚本不兼容：不同引擎（比如 Hero、GOM、Blue）对 QFunction 脚本的支持有差异。比如 GOM 引擎的回城命令是 “MapMoveEx”，而 Hero 引擎用 “MapMove”，如果脚本命令和引擎版本不匹配，就会失效。确认你的引擎类型，用对应版本的命令重新写脚本。
排查时可以按这个步骤来：先看 M2 日志有没有错误提示→检查物品名称和标签是否一致→确认 M2 里的脚本功能是否开启→验证文件路径和编码是否正确。大部分情况下，问题都出在这些基础设置上，和脚本命令本身无关。
如果以上方法都试过还是不行，可以换一个简单的脚本测试，比如在 QFunction-0.txt 里加一段：
[@UseItem 测试物品]
#ACT
SendMsg 6 测试物品触发成功！
Take 测试物品 1
然后在物品数据库里添加一个叫 “测试物品” 的道具，进游戏点击使用。如果能看到提示文字，说明文件关联和 M2 设置没问题，之前的问题可能是特定命令不兼容；如果还是没反应，那大概率是 M2 引擎的核心设置或文件路径出了问题，这时候可以尝试替换一个正常运行的同款引擎 M2，对比设置差异，往往能找到症结。