OnAdd

Syntax:

 begin OnAdd ContainerRefID

Example:

begin OnAdd 
begin OnAdd player 

This block will be run once when the scripted object is added to the Container's inventory. If no parameter is used, the block will be run whenever the object is added to anything's inventory.

When the target container isn't in the current cell (or within the 5x5 exterior-cell square), the OnAdd block doesn't run until you enter the cell with the container. However, the onAdd block won't run if you've saved and reloaded before entering the remote cell.

If you add an item to a container and then remove it later in the same block of code, the OnAdd block will not run. The item must remain in the new container for at least one frame after it is added in order for the block to trigger.