| Warning | ||
|---|---|---|
| ||
It's not certain whether this function will change or be deprecated in future releases, so use with care. |
Overview
| Excerpt |
|---|
Register a function to be called when a game object gets destroyed |
...
This is incredibly useful because you can use it on objects owned by other players, and even destroyable features like trees.
...
. |
To detect when your own objects are destroyed, it's easier to use eventDestroyed() because it avoids having to bind to individual objects.
Availability
3.1 Beta 1 and above.
Syntax
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
bind(functionName, gameObject); |
Parameters
| 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 |
Return value
| 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 |
Example
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
function certainDeath(gameObject) { // do stuff } bind("certainDeath", someObject); // where someObject |
...
...
...
See also
...