{"name":"setRank","title":"setRank","type":"command","url":"https://community.bistudio.com/wiki/setRank","revid":340311,"updated":"2023-04-29T17:00:34Z","groups":["Unit Identity"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","locality":{"argument":"local","effect":"global"},"description":"Sets rank of given unit.\n\n> [!NOTE]\n> **Arma 3:** Before Arma 3 v1.68 and in previous titles, this command was Global argument Local effect.","syntaxes":[{"syntax":"unitName setRank rank","params":[{"name":"unitName","type":"Object","type_expr":"Object"},{"name":"rank","type":"String","description":"one of:\n\n- `\"PRIVATE\"`\n- `\"CORPORAL\"`\n- `\"SERGEANT\"`\n- `\"LIEUTENANT\"`\n- `\"CAPTAIN\"`\n- `\"MAJOR\"`\n- `\"COLONEL\"`","type_expr":"String"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"unitName"},"right":{"text":"rank"}}],"examples":[{"code":["player setRank \"COLONEL\";"]}],"see_also":["rank","setUnitRank"],"notes":[{"user":"Wolfrug","date":"2009-03-26T19:24:00Z","text":"Changing a unit's rank using either setUnitRank or setRank will also REPLACE their current rating dependent on their new rank (colonels have a rating of 7500 etc).\nThat is to say REPLACE, not add to: the unit's old rating will disappear with the rank change."},{"user":"Waffle SS.","date":"2014-04-12T20:39:00Z","text":"Behavior when used on players in multiplayer seems unpredictable. (Arma 3 1.00)"}]}