【引擎触发】magselffunc(X)：技能自定义触发

实战应用：用在哪里

每个技能都可以有自己的剧本：施放冰咆哮时附加一次普攻的冷兵器伤害、施放施毒术时给道士回一点蓝——magselffunc(X) 按技能 ID 挂独立的触发钩，技能的个性化不必挤在 beginmagic 的总闸里。

技能钩的注册

---magselffunc(X): 自身使用技能触发 X=技能ID
---以冰咆哮（技能 ID 42）为例
function magselffunc42(self)
    local player = class(self)
    if not player then return end
    -- 冰咆哮施放后追加一次寒冰护体
    local shield = tonumber(getplayvar(self, 2, "IceShield")) or 0
    if shield < 500 then
        setplayvar(self, "HUMAN", "IceShield",
            math.min(shield + 100, 500), 1)
        sendmsg(self, 1, "寒冰护体吸收值 +" ..
            math.min(100, 500 - shield))
    end
end

magselffunc 按技能 ID 分函数：技能 42 的钩子叫 magselffunc42，每个技能一个独立的剧本——技能的个性化逻辑按 ID 归档，查找与维护的粒度到单个技能。函数名即注册表：写对名字钩子自动生效，拼错的钩子静默失效，触发名的正确性靠命名规范的纪律。施放冰咆哮攒护盾的设计是技能联动的示范：攻击技能的施放喂出防御的资源，技能之间的化学反应让战斗的循环有玩法。

触发的优先级

---与 beginmagic 的分工
function beginmagic(self, maigicID, maigicName,
    targetObject, x, y)
    -- 总闸：通用校验（蓝耗、冷却、距离）
    if not Skill.commonCheck(self, maigicID, x, y) then
        return false
    end
end

---技能专属逻辑放在 magselffunc
function magselffunc13(self)
    local player = class(self)
    if not player then return end
    -- 施毒术专属：施毒后自身移速小幅提升
    setplayvar(self, "HUMAN", "PoisonBoost", os.time() + 10, 1)
    sendmsg(self, 1, "毒术精通：移速提升 10 秒")
end

两类触发的分工：beginmagic 是所有技能的总闸（通用的校验与拦截），magselffunc(X) 是单个技能的专属剧本——通用的归总闸、个性的归专属，两层不互相挤占。文档的优先级说明：magselffunc 的触发先于 beginmagic，总闸的阻止不影响专属钩的记录——顺序的语义在两个钩子里各管一段。技能 ID 的对照表进配置文档，ID 与技能名的映射是写钩子的字典。钩子的轻量纪律与 beginmagic 相同：禁慢查询、禁大循环，技能的施放频率撑不起重的逻辑。

验证与监控

钩子的注册清单自检：技能表里的每个可触发技能对照钩子的存在性，漏写的技能进检查报告；钩子的执行耗时按技能 ID 归档，重钩子的定位到函数。

踩坑记录

钩子的函数名曾经拼错一位，施毒术的专属逻辑永远不触发，排查两天靠触发注册表的自检抓出。钩子曾经做了改伤害的操作，与 attackdamage 的修正叠加让伤害翻倍，修正的归属按触发链的位置划分。技能 ID 的硬编码曾经散落各处，技能表改 ID 后钩子集体失联，ID 的常量字典统一。

上线要点

技能钩的清单与技能表联动生成，新技能上线先问一句要不要专属钩。钩子的模板进框架库：护体型、联动型、资源型的三套样板。钩子的禁令与 beginmagic 一致：只做轻逻辑，重的走异步。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。