TrinityCore 法术 Proc 机制深度解析:从事件掩码、PPM 到 AuraScript 与递归防护 原创
概率不是入口:先画出一条 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 才重新成为一个简单的数值,而不是掩盖所有问题的旋钮。