GetEquippedItemRefForItem

From GECK
Jump to: navigation, search


A function added by the ShowOff NVSE Plugin version 1.30.

Description

If the calling actor has the specified item BaseForm currently equipped, then it returns that equipped item as an Inventory Reference. Otherwise, returns 0.

FormList Support (New in 1.51)

If a FormList of items is passed instead, and at least one of those items is equipped, will return the first item in the list which is equipped as an Inventory Reference. Otherwise, returns 0.

This function can only be used in a script, not as a Condition.

Syntax

[help]
(itemRef:ref) actorReference.GetEquippedItemRefForItem itemOrFormlist:BaseForm 

Notes

  • This is effectively a shortcut for looping through an array returned by GetInvRefsForItem and breaking when the iterated itemRef is equipped (IsEquipped).

See Also