TrinityCore 法术 Proc 机制深度解析:从事件掩码、PPM 到 AuraScript 与递归防护 原创

温馨提示:
本文最后更新于 2026-11-22,已超过 0 天没有更新。 若文章内的图片失效(无法正常加载),请留言反馈或直接 联系我。

概率不是入口:先画出一条 Proc 事件链

TrinityCore 里“近战攻击有 30% 概率触发额外伤害”不是一个简单的随机数判断。一次攻击先产生攻击者与受击者两侧的事件掩码,再经过法术阶段、命中结果、法术族、装备、Aura、条件表、脚本、概率等筛选,最后才执行效果。把 Chance 改成 100 仍不触发,通常说明事件在前面某一关就被过滤了。

本文以 TrinityCore 3.3.5 分支、提交 bc47ca8fe5b4a8f20272bbc0847217653cc95dc9 为参照,讨论的是服务器端 Proc,不是客户端动画。相关实现集中在 Unit.cpp、SpellMgr.cpp、SpellAuras.cpp 与 SpellAuraEffects.cpp。版本演进后符号可能变化,调试时应在自己的分支重新定位调用点。

一、从攻击事件到 ProcEventInfo

近战白字、副手攻击、远程攻击、直接法术和周期效果并不等价。核心会给它们生成不同的 ProcFlags,并把攻击者、目标、法术、伤害或治疗数据、阶段与命中结果封装成 ProcEventInfo。入口是 Unit::ProcSkillsAndAuras,随后通过 TriggerAurasProcOnEvent 分别处理行动者和目标身上的 Aura。

攻击/法术/治疗/死亡
        |
        v
typeMaskActor + typeMaskActionTarget
spellTypeMask + spellPhaseMask + hitMask
        |
        v
Unit::ProcSkillsAndAuras(...)
        |
        v
ProcEventInfo(actor, actionTarget, spell, damageInfo, healInfo)
        |
        +---- 行动者 Aura
        +---- 目标 Aura

这里最容易混淆的是视角。DONE_* 描述“我造成了什么”,TAKEN_* 描述“我承受了什么”。同一个 ProcFlags 位在不同函数参数里有不同职责,不能只凭位的名字猜调用关系。死亡、击杀、白字、法术命中还可能走不同分支,不要用白字测试推断所有法术的行为。

二、ProcFlags 只是第一层:四组掩码缺一不可

真正筛选发生在 SpellMgr::CanSpellTriggerProcOnEvent。它依次检查事件类型、经验或荣誉要求、法力消耗、法术学派、法术族、效果类型、施法阶段和命中结果。

数据 回答的问题 常见错误
ProcFlags 白字、技能、治疗、周期、击杀等哪类事件可进入? 把“近战技能”与“近战白字”混为一谈
SpellTypeMask 伤害、治疗、无伤害治疗类型是否匹配? 给纯白字 Proc 配了不会参与对应筛选的类型
SpellPhaseMask CAST、HIT、FINISH 哪个阶段触发? 要求 HIT 却在 CAST 阶段观察一次
HitMask 普通、暴击、躲闪、招架、吸收等结果是否允许? 想要“暴击触发”,实际普通命中也触发
SpellFamilyName/Mask 是否只允许指定法术族及具体法术? 只填 family name,未核对三位 family mask

HitMask=0 不是“任何命中结果都通过”。源码为零值提供默认语义:受击侧通常允许普通与暴击;造成伤害一侧通常允许普通、暴击与吸收。这意味着想精确限定暴击时,必须显式写 PROC_HIT_CRITICAL,不能依赖零值。

下面这组数值来自该分支的枚举,仅用于解释位运算;实际 SQL 应从自己版本的定义生成,而不是跨版本复制十六进制常量:

PROC_FLAG_DONE_SPELL_MAGIC_DMG_CLASS_NEG = 0x00010000
PROC_SPELL_TYPE_DAMAGE                   = 0x00000001
PROC_SPELL_PHASE_HIT                     = 0x00000002
PROC_HIT_CRITICAL                        = 0x00000002

-- 概念:负面魔法伤害技能,在 HIT 阶段,且暴击时才进入候选集。
-- 仍需 SpellFamily、Conditions、CheckProc、Effect 与概率检查。

三、spell_proc 不是完整覆盖表

SpellMgr::LoadSpellProcs 从 world 数据库的 spell_proc 装载规则。ProcFlags、Chance、Charges 等部分字段为零时,会从 DBC 的 SpellInfo 继承默认值;因此数据库里看到 0,不等于运行时一定是 0。负的 SpellId 用于表示该等级链的全部等级,且有“必须是首级且确实有等级链”的校验。

加载器也会拒绝或报告矛盾配置。例如某些事件类型要求 SpellPhaseMask,DisableEffectsMask 只能禁用一个 Aura 效果,PROC_ATTR_REQ_SPELLMOD 要求 Aura 确实存在对应 modifier。启动日志里的这些错误比盲目增加概率更能指向根因。

查询现有配置时,先查规则、条件和脚本注册,不要只 SELECT 一行就下结论:

SELECT * FROM spell_proc WHERE ABS(SpellId) = 你的AuraSpellId;

SELECT SourceTypeOrReferenceId, SourceGroup, SourceEntry,
       ConditionTypeOrReference, ConditionTarget,
       ConditionValue1, ConditionValue2, ConditionValue3,
       NegativeCondition, ErrorType, ErrorTextId, Comment
FROM conditions
WHERE SourceTypeOrReferenceId = 16 -- 该分支的 SPELL_PROC 条件源
  AND SourceGroup = 你的AuraSpellId;

条件源的数值必须跟随当前分支的 ConditionSourceType,不能把 16 当成跨版本永久协议。SQL 注释也应写清条件用途,方便回滚。

四、Aura 过滤的顺序决定了“耗层但不生效”

Aura::GetProcEffectMask 负责把候选 Aura 变成真正可触发的效果集合。它会检查是否由自身派生法术触发、触发法术是否允许再次 Proc、剩余充能、冷却、数据库掩码、Conditions、CheckProc 脚本、每个效果自身的 CheckEffectProc 以及装备要求,最后才计算概率。

一旦获得非零效果掩码,GetProcAurasTriggeredOnEvent 就调用 PrepareProcToTrigger。这个阶段会执行 DoPrepareProc,并按规则扣除一层充能、设置整个 Aura 的 Proc 冷却;随后才进入 OnProc 与效果处理。因此冷却和充能不是“伤害成功结算之后”才附加的尾部逻辑。调试时要把“进入候选”“准备触发”“效果执行”分开记录。

GetProcEffectMask
  -> 自身派生 / triggered spell / charges / cooldown
  -> spell_proc + conditions + CheckProc + CheckEffectProc
  -> 装备要求
  -> Chance 或 PPM
        |
        v
PrepareProcToTrigger
  -> DoPrepareProc(可阻止准备)
  -> 扣 charges,设置 cooldown
        |
        v
TriggerProcOnEvent
  -> OnProc(PreventDefault 可阻止默认效果)
  -> AuraEffect::HandleProc
  -> AfterProc
  -> 最后一层耗尽时移除 Aura

五、Chance、PPM、Cooldown 是三种不同约束

固定概率 Chance 表示每次满足全部前置条件的候选事件有多大概率通过。PPM 则在该分支针对带伤害事件的武器攻击速度换算:chance = PPM × weapon speed / 60,随后还可能受 SPELLMOD_CHANCE_OF_SUCCESS 修正。它并不保证每分钟恰好触发 N 次,也不是把法术急速简单代入就能得到准确触发率。

Cooldown 是 Aura 级节流,不是随机概率;Charges 是可用次数,也不是冷却。一个效果“触发太少”,要分别检查候选事件数量、概率、冷却吞掉的窗口和充能消耗,而不是一次把 Chance 改为 100。

六、默认 PROC_TRIGGER_SPELL 与 AuraScript 如何选

标准 SPELL_AURA_PROC_TRIGGER_SPELL 会从效果的 TriggerSpell 取得目标法术,并根据行动者与目标关系选择施法方向,再调用 CastSpell(..., this)。保留 AuraEffect 作为触发来源很重要:核心可据此识别“这个法术是否由本 Aura 派生”,阻止直接的自我递归。

如果需要读取本次伤害、额外检查目标状态、修改动态数值或聚合多次事件,再使用 AuraScript。以下是与 DoCheckProc、OnProc、AfterProc 对齐的结构示例,不是可直接套用的完整物品实现;类名、注册宏和效果索引需按你的脚本规范补齐:

class aura_custom_proc : public AuraScript
{
    PrepareAuraScript(aura_custom_proc);

    bool CheckProc(ProcEventInfo& eventInfo)
    {
        DamageInfo const* damage = eventInfo.GetDamageInfo();
        return damage && damage->GetDamage() > 0;
    }

    void HandleProc(ProcEventInfo& eventInfo)
    {
        Unit* actor = eventInfo.GetActor();
        Unit* target = eventInfo.GetActionTarget();
        if (!actor || !target)
            return;

        // 自定义逻辑;不要在这里重新实现核心已经完成的通用掩码检查。
        // PreventDefault() 会跳过默认 AuraEffect 和 AfterProc。
    }

    void Register() override
    {
        DoCheckProc += AuraCheckProcFn(aura_custom_proc::CheckProc);
        OnProc += AuraProcFn(aura_custom_proc::HandleProc);
    }
};

若默认效果本身已经施放触发法术,又在 OnProc 重复 CastSpell,就会双发。此时应选择“保留默认效果、脚本只做观察”,或明确 PreventDefault() 后完全接管,并同步考虑 AfterProc 是否仍应执行。

七、递归、双发与重复触发:先找事件源

核心已阻止 Aura 被自己直接派生的 Spell 再次触发,但 A→B→A 的间接链、多个 Aura、额外脚本 CastSpell、多个 Effect 同时通过仍可能产生意外结果。不要靠无限缩短 Cooldown 或随意取消 TRIGGERED 标志来“修复”;那会改变原本的事件语义。

排查顺序应是:记录源 SpellId、是否 triggered、来源 Aura、actor/target、阶段、hitMask、通过的 effectMask、冷却和 charges,再确定是“不应进入候选”还是“默认效果和脚本都执行”。能用 SpellFamilyMask、AttributesMask、条件或具体法术排除表达的规则,不要复制一整套施法逻辑。

八、用受控实验代替打木桩十分钟

在本地测试服使用固定武器速度、关闭无关天赋与装备 Proc、准备只含目标法术的配置,逐层验证。测试概率时用大量独立候选事件,并记录“候选数”而非只记录战斗时长。

实验 预期 异常指向
Chance=100、Cooldown=0,限定单一合法事件 每个候选均进入准备与执行 掩码、Aura、条件、装备或脚本过滤
仅普通命中与暴击分别测试 符合显式或默认 HitMask 把 HitMask=0 当作全匹配
固定攻击速度,比较两组 PPM 换算概率随攻速按源码变化 把 PPM 当固定次数或固定 Chance
设置明显 Cooldown,连续产生合法事件 窗口内事件被过滤 把节流误判为概率异常
同时启用默认 TriggerSpell 与脚本观察日志 一次 Proc 只有一次预期效果 脚本重复施法或多 Effect 双发
A 触发 B,观察 B 是否再触发 A 直接自派生被阻止,间接链按设计受控 递归来源与 triggered 属性不清

生产变更应保留 SQL 回滚、修改前后规则快照和启动日志。不要在线上把概率、掩码、脚本同时改动,否则即使恢复触发,也无法知道真正根因。

结论:把 Proc 当成类型化事件管线

稳定的 Proc 开发方式不是背一个 spell_proc 示例,而是建立一条可观察的因果链:事件是否产生 → 掩码是否匹配 → Aura 与效果是否允许 → 概率是否通过 → 准备阶段消耗了什么 → 默认效果和脚本各做了什么。当每一层都有证据,Chance 才重新成为一个简单的数值,而不是掩盖所有问题的旋钮。