RemoveSpell

Removes the specified spell from the caller's spell list. This function returns 1 if the spell is successfully removed from the caller, and 0 if the spell cannot be removed (e.g. if they don't have the spell in their spell list in the first place)

Syntax:

RemoveSpell SpellID

Examples:

RemoveSpell DisTickleBritch

If Removespell WeirdAbility == 0  ; Toggle Ability on/off
  Addspell WeirdAbility
Endif

Notes

• Using RemoveSpell to remove a spell to the player's repertoire will give a message informing the player of this. In many situations, this is very annoying, but you can use a pair of blank Message calls to prevent it from happening, like so:

Message " "
Message " "
player.RemoveSpell "spell ID"

• This seems to shortcircuit the message display and will prevent any other messages from being queued or displayed for a couple of seconds, so please use it only if you are sure no other messages will be disrupted, or you would create a lot of message spam otherwise.
• OBSE 0015 provides RemoveSpellNS which works exactly the same as RemoveSpell but without displaying any messages.

See Also

• RemoveSpellNS
• AddSpell
• Preventing messages