{"name":"getUserInfo","operator":null,"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","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.06"}],"since":{"game":"arma3","name":"Arma 3","version":"2.06"},"arma3_since":"2.06","branch":null,"locality":{"argument":null,"effect":null,"server_exec":true},"exec":null,"description":"Returns extended information about given server user.","syntaxes":[{"syntax":"getUserInfo playerID","since":null,"effect":null,"exec":null,"params":[{"name":"playerID","type":"String","optional":false,"default":null,"description":"user DirectPlay ID (see getPlayerID, PlayerConnected)","types":["String"],"since":null,"text":"playerID: String - user DirectPlay ID (see getPlayerID, PlayerConnected)"}],"returns":{"type":"Array with [playerID, owner, playerUID, soldierName, displayName, steamProfileName, clientStateNumber, isHeadless, adminState, networkInfo, playerObject]","types":["Array"],"description":"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- 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","operator":null,"left":null,"right":{"text":"playerID","types":["String"]}},{"syntax":"playerID getUserInfo infoIndex","since":"Arma3 2.18","effect":null,"exec":null,"params":[{"name":"playerID","type":"String","optional":false,"default":null,"description":"user DirectPlay ID (see getPlayerID, PlayerConnected)","types":["String"],"since":null,"text":"playerID: String - user DirectPlay ID (see getPlayerID, PlayerConnected)"},{"name":"infoIndex","type":"Number","optional":false,"default":null,"description":"the index of the data in the return array (see main syntax)","types":["Number"],"since":null,"text":"infoIndex: Number - the index of the data in the return array (see main syntax)"}],"returns":{"type":"Anything","types":["Anything"],"description":"depends on the requested index (see main syntax) or Nothing","text":"Anything - depends on the requested index (see main syntax) or Nothing"},"form":"binary","operator":null,"left":{"text":"playerID","types":["String"]},"right":{"text":"infoIndex","types":["Number"]}}],"examples":[{"text":"```sqf\nprivate _randomUserInfo = getUserInfo selectRandom allUsers;\n```","code":["private _randomUserInfo = getUserInfo selectRandom allUsers;"]},{"text":"```sqf\n_userInfo params [\"_playerID\", \"_ownerId\", \"_playerUID\", \"_profileName\", \"_displayName\", \"_steamName\", \"_clientState\", \"_isHC\", \"_adminState\", \"_networkInfo\", \"_unit\"];\n_networkInfo params [\"_avgPing\", \"_avgBandwidth\", \"_desync\"];\n```","code":["_userInfo params [\"_playerID\", \"_ownerId\", \"_playerUID\", \"_profileName\", \"_displayName\", \"_steamName\", \"_clientState\", \"_isHC\", \"_adminState\", \"_networkInfo\", \"_unit\"];\n_networkInfo params [\"_avgPing\", \"_avgBandwidth\", \"_desync\"];"]},{"text":"```sqf\nprivate _myInfo = getUserInfo getPlayerID player; // this particular example only works if player is server host\n```","code":["private _myInfo = getUserInfo getPlayerID player; // this particular example only works if player is server host"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["allUsers","getPlayerID","getUnitFreefallInfo"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Multiplayer","Command Group: Object Detection","Introduced with Arma 3 version 2.06","Scripting Commands","Scripting Commands: Server Execution"]}