isPlayer

1.001.001.501.000.50

GAGlobal

Hover & click on the images for description

Description

Description:

Checks if given person is a player. Returns true for headless clients as well.

⚠

In some cases, the identity of certain player units might fail to propagate to other clients and the server, which causes isPlayer and getPlayerUID to incorrectly return false and "", respectively, where the affected units are not local. Therefore, beware of false negatives.

ⓘ

Since Arma v2.05.147834 dead players could be queried with alt syntax version of the command. While identity still exists on the dead body of a player this command will return true.

Groups:

Multiplayer

Syntax

Syntax:

isPlayer unit

Parameters:

unit: Object

Return Value:

Boolean

Alternative Syntax

Syntax:

isPlayer [person]        (Since Arma v2.05.147834)

Parameters:

[person]: Array

person: Object - dead or alive player

Return Value:

Boolean - true if is/was player

Examples

Example 1:

if (isPlayer _Soldier1) then { _Soldier1 setDamage 1; };

Example 2:

_playerCount = {isPlayer _x} count playableUnits;

Additional Information

See also:

playerplayableSlotsNumberplayableUnitsplayersNumber

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Posted on 1 August, 2006

Kronzky

This is not the same as testing object == player, because in MP it tests for any player, not only for the local one. If object is a vehicle, the test is done for the vehicle commander.