OnUnAcquireItem
The script attached to this event fires when an item is removed from a PC or NPC creatures inventory. It can be useful to stop the Balor you have chasing the rogue when he drops the Vorpal Longsword +3 he just found or place the item in a common location (such as the Divining Pool in the Halls of Justice) if it is a Plot item.
Trigger
Whenever an item is removed from a creatures inventory (dropped, traded, sold etc.). They can be a PC or NPC - it would be recommended to use GetIsPC at the top of the script and exit early if you don't care that NPCs are getting items.
Function(s)
- GetModuleItemLostBy() returns the former owner of the item that was lost.
- GetModuleItemLost - The item that was lost, noting the bugs below for stacks that are used up.
Known Bugs
This event does not fire when an item that is stacked in inventory is lost (i.e. a potion that is stacked is used) or when gold is spent or taken. when a potion is used OnUnAcquireItem is fired. GetModuleItemLost() returns OBJECT_INVALID so no tag, name or object of this specific potion can be scripted without some serious workarounds. This will also occur if the potion resides in a stack. The current version (as of 1.30) says that the event won't fire if potions are stacked - this is not true. When a thrown object is thrown (i.e. in combat) OnUnacquire is fired - ONLY IF THE OBJECT IS THE LAST IN A STACK. This event is fired by a valid object that has no tag (GetTag( GetModuleItemLost() ) == "" but GetIsObjectValid( GetModuleItemLost() ) == TRUE).
See Also
| functions: |
