This event is used when calculating an actor's magic effect resistance, and allows Lua scripts to override the behavior of magic effect resistance by changing the
resistedPercent value. This can be used to enable willpower-based resistance checks, provide specific resistances to specific spells, spells that heal instead of harm, and a variety of new mechanics.
--- @param e spellResistEventData local function spellResistCallback(e) end event.register(tes3.event.spellResist, spellResistCallback)
This event can be filtered based on the
source event data.
An event can be claimed by setting
true, or by returning
false from the callback. Claiming the event prevents any lower priority callbacks from being called.
caster(tes3reference): Read-only. The caster of the spell.
effect(tes3effect): Read-only. The specific effect that triggered the event. This is equal to accessing
e.source.effects[effectIndex]. This field may not always be available.
effectIndex(number): Read-only. The index of the effect in source's effects list.
effectInstance(tes3magicEffectInstance): Read-only. The unique instance data of the magic effect.
resistAttribute(number): Read-only. The attribute resisted. This is an index into a
tes3mobileActor.effectAttributes. Note that the index here is 0-based, while Lua is 1-based.
resistedPercent(number): The percent of the spell that has been resisted. This can be modified, but a value outside the range of 0 to 100 does not have consistent effects. For fire damage, for example, a value over 100 causes the spell to heal the target instead of harming them.
source(tes3alchemy, tes3enchantment, tes3spell): Read-only. The magic source.
sourceInstance(tes3magicSourceInstance): Read-only. The unique instance data of the magic source.
spellCastChance(number): Read-only. The cast chance of the magic source. This is only available if the
sourceis a spell or an enchantment.
target(tes3reference): Read-only. The target of the spell. For self-targeted spells, this matches caster.