{"name":"allPlayers","operator":null,"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","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.48"}],"since":{"game":"arma3","name":"Arma 3","version":"1.48"},"arma3_since":"1.48","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Returns a list of all units controlled by connected clients. This includes:\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","since":null,"effect":null,"exec":null,"params":[],"returns":{"type":"Array of Objects","types":["Array","Object"],"description":null,"text":"Array of Objects"},"form":"nullary","operator":null,"left":null,"right":null}],"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;"]},{"text":"```sqf\nprivate _bluforPlayers = blufor countSide allPlayers;\n```","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.","problems":null,"aliases":[],"see_also":["allCurators","allGroups","allDead","allUnits","switchableUnits","playableUnits","vehicles","allUnitsUAV","allDeadMen","isPlayer","playersNumber","allUsers","getUserInfo"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Multiplayer","Command Group: Object Detection","Introduced with Arma 3 version 1.48","Scripting Commands"]}