UnequipItem

Syntax:

UnequipItem ObjectID NoEquipFlag

Example:

UnequipItem FavoriteCuirass
player.UnequipItem AmuletOfKings 1

Forces the actor to unequip the object. If NoEquipFlag = 1, actor (including the player) will be unable to equip the object.

Notes

• Generic Unequip:

UnequipItem requires that the base object be specified. For a single script that works for different items, see Generic Unequip.

• Message Spam:

By default, using this function on the player will display a message informing the player that the item in question has been unequipped. player. 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.UnequipItem "item ID"

• This seems to shortcircuit the message display and will prevent any other messages from being queued or displayed for a couple of seconds. Here are some alternative methods that don't disrupt other messages.
• OBSE 0015 provides UnequipItemNS which works exactly the same as UnequipItem but without displaying any messages.

See Also

• UnequipItemNS
• EquipItem
• Preventing messages