Background for Skyrim SE
Member of the Actor script
voidfunctionEquipItemEx(Formitem, intequipSlot=0, boolpreventUnequip=false, boolequipSound=true)Native

Description

Wiki Description

Forces this actor to equip the first item in the specified form's extralist to the specified slot.

Documentation Comment

equips item at the given slot


Caveats

CK Wiki - Notes

  • The first item in the extralist will be the last item added. For example, if the player has two steel swords and they enchant one, then poison the other, the poisoned sword will be equipped. Alternatively, if they poison one sword, then enchant the other, the enchanted sword will be equipped.
  • See Actor.EquipItemById(...) for adding an item without an extralist.

Parameters

Formitem

intequipSlot=0

boolpreventUnequip=false

boolequipSound=true


Examples

;Force the player to equip swordProperty to the Default slot
Game.GetPlayer().EquipItemEx(swordProperty)
; Force Ralof to equip a Dagger to his Left hand and do not suppress the sound.
Ralof.EquipItemEx(DaggerProperty, 2, false, false )

Auto-Generated Example

Form myForm__item
int myInt__equipSlot
bool myBool__preventUnequip
bool myBool__equipSound

myActor__toCallFunctionOn.EquipItemEx(myForm__item, myInt__equipSlot, myBool__preventUnequip, myBool__equipSound)

Related Pages


Additional References

View this function’s page on the Skyrim Creation Kit Wiki

Some data provided by the Skyrim Creation Kit Wiki. Licensed under the Creative Commons Attribution-ShareAlike license.