{"name":"getUserInfo","title":"getUserInfo","type":"command","url":"https://community.bistudio.com/wiki/getUserInfo","revid":378191,"updated":"2026-03-10T18:34:18Z","groups":["Multiplayer","Object Detection"],"status":"ok","games":{"arma3":"2.06"},"since":"arma3 2.06","arma3_since":"2.06","locality":{"server_exec":true},"description":"Returns extended information about given server user.","syntaxes":[{"syntax":"getUserInfo playerID","params":[{"name":"playerID","type":"String","description":"user DirectPlay ID (see getPlayerID, PlayerConnected)","type_expr":"String"}],"returns":{"type":"Array","type_expr":"Array","description":"with [playerID, owner, playerUID, soldierName, displayName, steamProfileName, clientStateNumber, isHeadless, adminState, networkInfo, playerObject]\n- 0 - playerID: String - user DirectPlay ID (see getPlayerID, PlayerConnected) - 1 - owner: Number - user owner (see owner) - 2 - playerUID: String - player UID (see getPlayerUID) - 3 - soldierName: String - player name (see profileName) - 4 - displayName: String - player name including squad (see name, squadParams) - 5 - steamProfileName: String - returns the current machine's Steam profile name (see profileNameSteam), not the targeted player's Steam profile name - 6 - clientStateNumber: String user client state (see getClientStateNumber) - 7 - isHeadless: Boolean - whether or not this is a headless client (see hasInterface, isServer) - 8 - adminState: Number - admin status of the user (see admin) - 9 - networkInfo: Array of Numbers - format [ping, bandwidth, desync] - 10 - playerObject: Object - user player entity (see player, selectPlayer) > [!NOTE] > Returns an empty array if said player is not found.","text":"Array with [playerID, owner, playerUID, soldierName, displayName, steamProfileName, clientStateNumber, isHeadless, adminState, networkInfo, playerObject]\n\n- 0 - playerID: String - user DirectPlay ID (see getPlayerID, PlayerConnected)\n- 1 - owner: Number - user owner (see owner)\n- 2 - playerUID: String - player UID (see getPlayerUID)\n- 3 - soldierName: String - player name (see profileName)\n- 4 - displayName: String - player name including squad (see name, squadParams)\n- 5 - steamProfileName: String - returns the *current machine's* Steam profile name (see profileNameSteam), **not** the targeted player's Steam profile name\n- 6 - clientStateNumber: String user client state (see getClientStateNumber)\n- 7 - isHeadless: Boolean - whether or not this is a headless client (see hasInterface, isServer)\n- 8 - adminState: Number - admin status of the user (see admin)\n- 9 - networkInfo: Array of Numbers - format [ping, bandwidth, desync]\n- 10 - playerObject: Object - user player entity (see player, selectPlayer)\n\n> [!NOTE]\n> Returns an empty array if said player is not found."},"form":"unary","right":{"text":"playerID"}},{"syntax":"playerID getUserInfo infoIndex","since":"arma3 2.18","params":[{"name":"playerID","type":"String","description":"user DirectPlay ID (see getPlayerID, PlayerConnected)","type_expr":"String"},{"name":"infoIndex","type":"Number","description":"the index of the data in the return array (see main syntax)","type_expr":"Number"}],"returns":{"type":"Anything","type_expr":"Anything","description":"depends on the requested index (see main syntax) or Nothing"},"form":"binary","left":{"text":"playerID"},"right":{"text":"infoIndex"}}],"examples":[{"code":["private _randomUserInfo = getUserInfo selectRandom allUsers;"]},{"code":["_userInfo params [\"_playerID\", \"_ownerId\", \"_playerUID\", \"_profileName\", \"_displayName\", \"_steamName\", \"_clientState\", \"_isHC\", \"_adminState\", \"_networkInfo\", \"_unit\"];\n_networkInfo params [\"_avgPing\", \"_avgBandwidth\", \"_desync\"];"]},{"code":["private _myInfo = getUserInfo getPlayerID player; // this particular example only works if player is server host"]}],"see_also":["allUsers","getPlayerID","getUnitFreefallInfo"]}