Editing AddSpell - Actor

[[Category:Scripting]]
[[Category:Papyrus]]
'''Member of:''' [[Actor Script]]

Adds the specified [[Spell Script|spell]] to this actor.

== Syntax ==
<syntaxhighlight lang="papyrus">
bool Function AddSpell(Spell akSpell, bool abVerbose = true) native
</syntaxhighlight>

== Parameters ==
*akSpell: The [[Spell Script|spell]] to add to this actor.
*abVerbose: Pass false to suppress UI messages for spells added to the player. Spells added to NPCs never result in a UI message.
**'''Default''': True

== Return Value ==
True on success.

== Examples ==
<syntaxhighlight lang="papyrus">
; Adds the sheep spell to the player
if (Game.GetPlayer().AddSpell(SheepSpellProperty))
  Debug.Trace("Sheep spell added to the player")
endIf
</syntaxhighlight>
<br>
<syntaxhighlight lang="papyrus">
; Adds the sheep spell to the player, silently
if (Game.GetPlayer().AddSpell(SheepSpellProperty, false))
  Debug.Trace("Sheep spell added to the player (like a ninja!)")
endIf
</syntaxhighlight>

== Notes ==
* Adding a Spell marked as an Ability to the Player without at least one [[Effect Item]] set in the Spell's Effects List will result in a crash to desktop when the Player attempts to view their Active Effects in the menu.
** You can get away with an Effect-less Ability by applying the AbBlank Effect to an Ability. This will prevent crashing, but keep the Ability from appearing in Active Effects.
* This function was confirmed to be one of the culprits associated with the dual casting bug where the bool returned by isDualCasting is not correct. This has been addressed by the following mod here: [https://www.nexusmods.com/skyrimspecialedition/mods/92454 Po3's Dual Casting Fix]

== See Also ==
*[[Actor Script]]
*[[RemoveSpell - Actor]]