{"name":"allPlayers","title":"allPlayers","type":"command","url":"https://community.bistudio.com/wiki/allPlayers","revid":370218,"updated":"2024-11-10T14:50:49Z","groups":["Multiplayer","Object Detection"],"status":"ok","games":{"arma3":"1.48"},"since":"arma3 1.48","arma3_since":"1.48","description":"Returns a list of all units controlled by connected clients. This includes:\n\n- Normal human players (including dead players)\n- Virtual Entities (see *Systems* → *Logic Entities* → *Virtual Entities* in the Eden Editor)\n  - Headless Clients (`HeadlessClient_F`)\n  - Virtual Curators (`VirtualCurator_F`, `*_VirtualCurator_F`)\n  - Virtual Spectators (`VirtualSpectator_F`)\n\nUse BIS_fnc_listPlayers or see Example 1 to only get human players.","syntaxes":[{"syntax":"allPlayers","params":[],"returns":{"type":"Array of Objects","type_expr":"Array<Object>"},"form":"nullary"}],"examples":[{"text":"Get human players (i.e. all players excluding Headless Clients):\n\n```sqf\nprivate _players = allPlayers - entities \"HeadlessClient_F\";\n```","code":["private _players = allPlayers - entities \"HeadlessClient_F\";"]},{"text":"Get non-virtual players (i.e. all players excluding Virtual Entities):\n\n```sqf\nprivate _players = allPlayers select {!(_x isKindOf \"VirtualMan_F\")};\n```","code":["private _players = allPlayers select {!(_x isKindOf \"VirtualMan_F\")};"]},{"text":"```sqf\n{\n    systemChat format [\n        \"Player %1 is %2\",\n        name _x,\n        [\"dead\", \"alive\"] select alive _x\n    ];\n} forEach allPlayers;\n```","code":["{\n\tsystemChat format [\n\t\t\"Player %1 is %2\", \n\t\tname _x, \n\t\t[\"dead\", \"alive\"] select alive _x\n\t];\n} forEach allPlayers;"]},{"code":["private _bluforPlayers = blufor countSide allPlayers;"]}],"multiplayer":"- The complete array of allPlayers may get delayed on mission start in multiplayer. Use BIS_fnc_listPlayers to obtain it earlier.\n- The order of the returned array may differ from server to clients.","see_also":["allCurators","allGroups","allDead","allUnits","switchableUnits","playableUnits","vehicles","allUnitsUAV","allDeadMen","isPlayer","playersNumber","allUsers","getUserInfo"]}