Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Excerpt

Returns an array of players objects for living allied players.

 

Syntax

Code Block
themeRDark
languagejavascript
linenumberstrue
var allies = Players.allies; // array of allies players objects

Return value

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

If you want a similar array that includes me, use Players.alliesAndMe[] 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

Code Block
themeRDark
languagejavascript
titleIterating through allies
linenumberstrue
Players.allies.forEach(function(ally) {
  // ally = players object for current ally
  // ally.id = id of allied player
});
Code Block
themeRDark
languagejavascript
titleCheck if specific player is an ally
linenumberstrue
// 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;

 

 

Div
classbox
Availability
Status
colourGreen
titleStable

Requires:

Div
classbox
Contents

Jump to:

Table of Contents
maxLevel5

Div
classbox

See also

Related articles:

Div
classbox

Players API

Topics:

Child pages (Children Display)
alltrue
depthall
pagePlayers API
excerpttrue