OnContainerChanged - ObjectReference

Revision as of 17:25, 17 November 2015 by imported>Plplecuyer (→‎Notes)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Member of: ObjectReference Script

Event called when the object reference enters/leaves/moves between containers.

Syntax

Event OnContainerChanged(ObjectReference akNewContainer, ObjectReference akOldContainer)

Parameters

  • akNewContainer: The container this object is entering. If this is None, the object was dropped.
  • akOldContainer: The container this object just left. If this is None, the object was picked up.

Examples

Event OnContainerChanged(ObjectReference akNewContainer, ObjectReference akOldContainer)
  if akOldContainer && !akNewContainer
    Debug.Trace("We have been dropped!")
  elseif akNewContainer && !akOldContainer
    Debug.Trace("We have been picked up!")
  else
    Debug.Trace("We have switched containers!")
  endIf
endEvent


Event OnContainerChanged(ObjectReference akNewContainer, ObjectReference akOldContainer)
  if akNewContainer == Game.GetPlayer()
    Debug.Trace("I just got put in the player's inventory!")
  endIf
endEvent

Notes

  • Once an object has been added to a container it ceases to exist in most cases. Most functions (except those that are inventory-safe) will fail to run with an error.
  • Reminder: If you call RemoveItem() on an object and don't give it a destination container it is destroyed... such destroyed objects won't run an OnContainerChanged event.

See Also