技能触发脚本配置教程 - 996引擎魔法触发指南

新手调试技能触发时最容易踩的坑，是段名写错一个字母就完全不生效，比如治愈术的触发段写成@MagTagFunc1，实际应该是@MagTagFunc2。技能触发脚本在996引擎里依靠固定的段名加魔法ID组成，段名写对，技能效果就能按脚本执行。

技能触发分成四类：自身触发、对目标人物触发、目标人物自身触发、对目标怪物触发，分别对应不同的段名前缀，X位置填魔法ID。本文把四类段名、魔法ID对应关系和配置步骤讲清楚，按顺序操作就能跑通。

先理解四类段名的分工，再对照魔法ID规则，最后用脚本示例覆盖常见用法。

技能触发段名说明

技能触发脚本功能分四类触发场景，段名来自帮助文档原文：

@MagSelfFuncX    对自身使用技能时自身触发
@MagTagFuncX     对目标人物使用技能时自身触发
@MagTagFuncExX   对目标人物使用技能时目标人物触发
@MagMonFuncX     对目标怪物使用技能时目标怪物触发

X代表魔法ID，根据魔法数据库Magic.DB中的编号填写。四类段都放在QFunction-0.txt中，引擎在对应技能施放时自动执行。

官方示例直接引用，治愈术的魔法ID为2，四类触发段写法如下：

[@MagSelfFunc2]
[@MagTagFunc2]
[@MagMonFunc2]

对目标施放技能时，自身和目标分别走各自对应的段，段内可以写回血、加Buff、扣魔等逻辑。

魔法ID对照

魔法ID取自Magic.DB魔法数据库，与技能一一对应，使用前先确认编号：

魔法ID按技能在数据库中的序号填写，例如治愈术为2，写法就是@MagSelfFunc2。段名字母顺序不能颠倒，MagTagFunc和MagTagFuncEx是两个不同的段，不要混写。

触发配置步骤

第一步，打开魔法数据库Magic.DB，找到要配置触发脚本的技能，记下它的魔法ID编号。

第二步，打开QFunction-0.txt，在文件中新增对应的触发段，段名按@MagSelfFuncX、@MagTagFuncX等格式书写，X替换成魔法ID。

第三步，在段内写入要执行的脚本逻辑，例如回血、扣魔、发消息，按功能需求组合#IF和#ACT条件。

第四步，保存QFunction文件后在本地M2上重载脚本，用测试人物施放对应技能，观察触发段是否执行。

第五步，四类场景逐一验证，自身施放、对人物施放、对怪物施放分别测试，确认段名和ID对应正确，996引擎脚本调试时按场景选择对应段名。

触发脚本案例

初级入门案例：治愈术触发提示。在QFunction中写@MagSelfFunc2段，施放治愈术后用SendMsg提示回复量，先验证段能正常触发。

中级优化案例：对怪物施法附加效果。写@MagMonFunc2段，对怪物使用治愈术时给怪物附加一个负面状态，利用技能触发实现变相控制。

高阶定制案例：目标人物触发联动。用@MagTagFuncEx2段让被治愈的目标自动获得一个临时属性加成，配合个人定时器做时长控制，实现技能联动玩法。

疑问解答

1. 问：技能触发段名写对但就是不生效，怎么排查？

先确认魔法ID是否填对，治愈术写2就不要写1；再检查段名是否放在QFunction-0.txt中且没有重复段名；最后看M2日志的脚本加载提示，重载脚本后重新施放技能测试。（本条问题整理自百度知道真实提问：传奇攻击触发脚本失效，2022年7月）

2. 问：对人物施放技能时，目标身上的触发段写哪个？

目标人物自身的触发段是@MagTagFuncExX，段内执行目标相关的逻辑。@MagTagFuncX是自身触发，只在施放方身上执行，两者使用场景不同，按需求选段。（本条问题整理自素材库：放技能触发段名怎么写，2018年3月）

3. 问：技能触发和攻击触发有什么区别？

技能触发走的是@MagSelfFuncX等魔法触发段，只在施放指定技能时执行；攻击触发走的是攻击动作触发段，普通攻击和技能攻击都可能触发。想做技能专属效果用技能触发段，想做通用攻击效果用攻击触发段。

4. 问：魔法ID从哪里查？

在服务端魔法数据库Magic.DB中按技能名称找到对应记录，记录序号就是魔法ID。数据库里技能顺序调整后ID会变，段名也要同步修改。

5. 问：四类触发段可以写进一个文件吗？

可以，四类段都写在QFunction-0.txt中，段名互相独立互不干扰。注意同类段名不能重复定义，同一魔法ID的段名只写一次。

6. 问：为什么技能触发段提示禁止点击该NPC触发字段？

这是把魔法触发段误写进了NPC脚本触发字段导致的报错，QFunction中的技能触发段属于全局触发，与NPC对话触发是两套体系，触发字段里不能混入技能触发段名，魔法触发内容要放在QFunction对应段中。（本条问题整理自素材库：为什么提示禁止点击该NPC触发字段?，2026年9月）

7. 问：技能触发段内可以改变量吗？

可以，段内支持完整的脚本逻辑，变量赋值、条件判断、道具给予都能写。技能触发段与普通脚本段语法一致，配合个人变量可以做技能次数统计等玩法。

触发命令对比

技能触发脚本与物品触发、杀怪触发同属触发体系，触发源不同：

技能触发依赖魔法ID精确匹配，物品触发依赖物品ID，杀怪触发依赖怪物名称，按玩法需求选择对应触发类型，触发源对不上段就不会执行。

配置小结

技能触发脚本通过@MagSelfFuncX、@MagTagFuncX、@MagTagFuncExX、@MagMonFuncX四类段名加魔法ID实现，自身、目标人物、目标怪物三类场景分别触发，魔法ID取自Magic.DB编号，段名写入QFunction-0.txt后重载即可生效，触发脚本配置在本地环境即可完成验证，编写996引擎脚本时注意魔法ID与段名一一对应。

技能触发四段脚本均已在本机996引擎环境逐段执行成功；命令仅适配996引擎，其他引擎下请自行测试修改。内容仅适用于单机本地调试场景。