bind()

Register a function to be called when a game object gets destroyed.

Syntax

bind(functionName, gameObject);

Parameter	Type	Mandatory	Description	Game version
functionName	String		The name of the function that should be called immediately before the gameObject is destroyed.	3.1 Beta 1
gameObject	Game objects		Any game object, such as a droid, structure or feature.	3.1 Beta 1

Value	Type	Description	Game version
`undefined`	Undefined	Indicates the bind was successful.	3.1 Beta 1
<error>	Error	Indicates there was a problem (did you remember to specify functionName as as a string?)	3.1 Beta 1

Do something when someObject is destroyed

function certainDeath(gameObject) {
  // do stuff
}
 
bind("certainDeath", someObject); // where someObject is any Game Object

This function is incredibly useful because you can use it on objects owned by other players, and even destroyable features like trees.

Your function will be triggered immediately before the game object is removed from the map.

To detect when your own objects are destroyed, it's easier to use eventDestroyed() because it avoids having to bind to individual objects.

It's not certain whether this function will change or be deprecated in future releases, so use with care.

Requires: