{"name":"player","title":"player","type":"command","url":"https://community.bistudio.com/wiki/player","revid":363907,"updated":"2024-04-24T21:56:05Z","groups":["Object Manipulation"],"status":"ok","games":{"ofp":"1.00","ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofp 1.00","arma3_since":"0.50","description":"A person object controlled by user. In Intros and Outros this isn't set by default and must be assigned.","syntaxes":[{"syntax":"player","params":[],"returns":{"type":"Object","type_expr":"Object"},"form":"nullary"}],"examples":[{"code":["player addRating 500;"]}],"multiplayer":"In MP player is different on each computer and on dedicated server it is objNull by default ([unless scripted](https://www.youtube.com/watch?v=JzgJe9sXAiU)).\nWhen user is joining a dedicated server mission, at the moment of onPlayerConnected the player object is remote to the joining client, as the player unit is created on the server, but once control of the unit is passed to the user moments later, the player objects becomes and remains local to the client.\n\nSee Multiplayer Scripting's player topic for additional helpful information.","problems":"In multiplayer, the command is not initialised in functions called by initline or init eventhandlers.","see_also":["Multiplayer Scripting","isPlayer","playableUnits","selectPlayer"],"notes":[{"user":"Galzohar","date":"2010-06-20T03:11:00Z","text":"Before you use the **player** object in init scripts, to avoid JIP issues all you need is to run:\n\n```sqf\nwaitUntil { not isNull player };\n```\n\nAnything else you see in other scripts is equivalent and/or redundant. (but you may need to add other conditions too, such as checking hasInterface before initiating that loop)\nOf course JIP players may need more than just the player to point at the actual JIP player unit, but that's script/mission-specific."},{"user":"Killzone_Kid","date":"2014-06-26T18:49:00Z","text":"player can actually be REMOTE object on player's PC: "}]}