Players.alliesAndMe[]

Returns an array of players objects for living allied players, including me.

Syntax

var alliesAndMe = Players.alliesAndMe; // array of my + allies players objects

Return value

An array of allied Players Objects, including me, spectators and vacant slots.

If you want a similar array that excludes me, use Players.allies[] instead.

Notes

The indexes in the array are sequential and not based on player IDs.

Uses caching to boost performance. The cache is automatically invalidated every game tick. See Cache API for details.

Example

Iterating through allies

Players.alliesAndMe.forEach(function(ally) {
  // ally = players object for current ally
  // ally.id = id of allied player
});

Check if specific player is an ally

// you could do this:
var isAlly = allianceExistsBetween(me, playerID);
 
// but it won't filter out spectators or vacant slots
 
// this, on the other hand, does filter them out:
var isAlly = Players[playerID].isAlly;
 
// if you want to know if they are living ally:
var isLivingAlly = Players[playerID].isAlly && Players[playerID].isAlive;