| Excerpt |
|---|
A global event triggered when a player is defeated. |
Syntax
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
function eventPlayerDefeated(playerIDplayer) { // code to run when player dies } |
Parameters
| Parameter | Type | Mandatory | Notes | API Version |
|---|---|---|---|---|
| playerIDplayer | NumberPlayers Object |  | The ID of players object associated with the player that has just been was defeated. | 1.0 |
Return value
The return value is not currently processed.
Notes
The event is not triggered for players identified as spectators or vacant slots.
After the player is defeated, the event may lag behind a little - it's only triggered the next time a script tries to determine if the player is alive (and even then only when the cache invalidatesany caches invalidate). If you want to force a periodical check, set a timer as follows:
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
function checkDefeatcheckPlayerStates() { void Players.livingalive; // will cause applicable events to be triggered } setTimer("checkDefeatcheckPlayerStates", 10002000); // check every 2 secondseconds |
Example
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
function eventPlayerDefeated(playerIDplayer) { console(""+Players[playerID]player+" has been defeated"); // maybe now would be a good time to claim their oil? ; // or mop up any remaining buildings they have (eg. research labs) } |
| Div | ||||||
|---|---|---|---|---|---|---|
| ||||||
Availability
Requires:
|
| Div | ||||
|---|---|---|---|---|
| ||||
ContentsJump to:
|
| Div | ||
|---|---|---|
| ||
See alsoRelated articles:
|
| Div | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Players APITopics:
|