触发器与执行顺序

本文面向需要了解不同情境下触发器调用顺序的模组开发者。
所提供的信息技术性较强且较为枯燥，默认读者已理解《邪恶冥刻》的代码运作机制。

触发器按调用顺序列出，首项为最先触发的触发器，末项为最后触发的触发器。

自定义触发器以字母I开头并通过接口实现，其余为原版（Vanilla）触发器。

卡牌伤害

由PlayableCard.TakeDamage、ShieldManager.TriggerBreakShield和ShieldManager.BreakShield处理。

带护盾的卡牌仅调用前四个列出的触发器。

触发器	附加说明
`IModifyDamageTaken`	将伤害值设置为返回值
`IPreTakeDamage`	在护盾检查前调用
`IShieldPreventedDamage`	仅当卡牌有护盾时调用
`IShieldPreventedDamageInHand`	仅当卡牌有护盾时调用作用于玩家手牌中的卡牌
`OnTakeDamage`	作用于无护盾卡牌
`OtherCardDealtDamage`	在 `PlayableCard.Die` 后调用
`IOnOtherCardDealtDamageInHand`	作用于玩家手牌中的卡牌

卡牌死亡

由PlayableCard.Die处理。

触发器	附加说明
`OnPreDeathAnimation`
`OnOtherCardPreDeath`
`IOnOtherCardPreDeathInHand`	作用于玩家手牌中的卡牌
`OnOtherCardDie`
`IOnOtherCardDieInHand`	作用于玩家手牌中的卡牌

抽卡

由PlayerHand.AddCardToHand处理。

触发器	附加说明
`OnDrawn`	在卡牌加入`cardsInHand`前调用
`OnOtherCardDrawn`	在卡牌加入`cardsInHand`前调用
`IOnAddedToHand`	在卡牌加入`cardsInHand`后调用
`IOtherCardAddedToHand`	在卡牌加入`cardsInHand`后调用

出牌

由BoardManager.TransitionAndResolveCreatedCard、BoardManager.ResolveCardOnBoard和BoardManager.AssignCardToSlot处理。

触发器	附加说明
`OnOtherCardAssignedToSlot`
`IOnCardAssignedToSlotContext`	提供新旧卡槽信息
`IOnOtherCardAssignedToSlotInHand`	作用于玩家手牌中的卡牌
`IOnCardAssignedToSlotNoResolve`	仅当分配卡牌已结算时调用
`OnResolveOnBoard`	当卡牌从手牌或队列打出时调用
`OnOtherCardResolve`	当卡牌从手牌或队列打出时调用
`IOnOtherCardResolveInHand`	作用于玩家手牌中的卡牌当卡牌从手牌或队列打出时调用

战斗阶段

由CombatPhaseManager.DoCombatPhase、CombatPhaseManager.SlotAttackSequence和CombatPhaseManager.SlotAttackSlot处理。

每张攻击卡牌会调用SlotAttackSequence，随后每次攻击行为调用SlotAttackSlot。

触发器	附加说明
`IOnBellRun`	在`DoCombatPhase`前调用
`IOnPreSlotAttackSequence`	在`SlotAttackSequence`前调用
`IGetAttackingSlots`	将返回值加入当前攻击卡槽列表，可在方法内修改当前列表
`ISetupAttackSequence`	用返回值替换当前目标卡槽列表优先级为`ReplacesDefaultOpposingSlot`
`IGetOpposingSlots`	将返回值加入当前目标卡槽列表，可在方法内修改当前列表
`ISetupAttackSequence`	用返回值替换当前目标卡槽列表优先级为`Normal`
`ISetupAttackSequence`	用返回值替换当前目标卡槽列表优先级为`BringsBackOpposingSlot`
`ISetupAttackSequence`	用返回值替换当前目标卡槽列表优先级为`PostAdditionModification`
`OnSlotTargetedForAttack`
`IModifyDirectDamage`	仅当造成直接伤害时调用将伤害值设置为返回值
`OnDealDamageDirectly`
`IOnCardDealtDamageDirectly`	作用于场上所有卡牌
`OnCardGettingAttacked`	仅当卡牌被攻击时调用
`IPostCardGettingAttacked`
`IOnPostSingularSlotAttackSlot`	在`SlotAttackSlot`后调用
`OnAttackEnded`	在所有卡牌完成攻击后调用
`IOnPostSlotAttackSequence`	在`SlotAttackSequence`后调用

消耗品

由ConsumableItemSlot.ConsumeItem和各消耗品的ActivateSequence处理。

触发器	附加说明
`IItemCanBeUsed`	可阻止物品使用
`IOnItemPreventedFromUse`	当`IItemCanBeUsed`阻止物品使用时调用
`IOnPreItemUsed`	在`ConsumeItem`和`ActivateSequence`前调用
`IOnPostItemUsed`	在 `ConsumeItem`和`ActivateSequence`后调用

被动属性增益

由PlayableCard.GetPassiveAttackBuffs和PlayableCard.GetPassiveHealthBuffs处理。

这些补丁每帧都会调用。

触发器	附加说明
`IOnCardPassiveAttackBuffs`	将攻击增益设置为返回值
`IPassiveAttackBuffs`	将返回值累加到攻击增益

触发器	附加说明
`IOnCardPassiveHealthBuffs`	将生命增益设置为返回值
`IPassiveHealthBuffs`	将返回值累加到生命增益

天平伤害

由LifeManager.ShowDamageSequence处理。

触发器	附加说明
`IOnPreScalesChangedRef`	修改即将造成的伤害值与实体天平上的砝码
`IOnPreScalesChanged`	在`ShowDamageSequence`前调用
`IOnPostScalesChanged`	在`ShowDamageSequence`后调用

回合流程

由TurnManager.GameSequence、TurnManager.PlayerTurn、TurnManager.OpponentTurn和TurnManager.DoUpkeepPhase处理。

若对手回合被跳过，则不会调用其对应的触发器。

触发器	附加说明
`OnUpkeep`
`IOnUpkeepInHand`	作用于玩家手牌中的卡牌
`OnTurnEnd`	在`DoCombatPhase`后调用
`IOnTurnEndInQueue`	作用于对手队列中的卡牌
`IOnTurnEndInHand`	作用于玩家手牌中的卡牌

Get the Thunderstore App

135 - API文档汉化 - 触发器与执行顺序