{"name":"setRank","operator":null,"title":"setRank","type":"command","url":"https://community.bistudio.com/wiki/setRank","revid":340311,"updated":"2023-04-29T17:00:34Z","groups":["Unit Identity"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"local","effect":"global","server_exec":false},"exec":null,"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","since":null,"effect":null,"exec":null,"params":[{"name":"unitName","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unitName: Object"},{"name":"rank","type":"String","optional":false,"default":null,"description":"one of:\n- `\"PRIVATE\"`\n- `\"CORPORAL\"`\n- `\"SERGEANT\"`\n- `\"LIEUTENANT\"`\n- `\"CAPTAIN\"`\n- `\"MAJOR\"`\n- `\"COLONEL\"`","types":["String"],"since":null,"text":"rank: String - one of:\n- `\"PRIVATE\"`\n- `\"CORPORAL\"`\n- `\"SERGEANT\"`\n- `\"LIEUTENANT\"`\n- `\"CAPTAIN\"`\n- `\"MAJOR\"`\n- `\"COLONEL\"`"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"unitName","types":["Object"]},"right":{"text":"rank","types":["String"]}}],"examples":[{"text":"```sqf\nplayer setRank \"COLONEL\";\n```","code":["player setRank \"COLONEL\";"]}],"multiplayer":null,"problems":null,"aliases":[],"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)"}],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Unit Identity","Introduced with Armed Assault version 1.00","Scripting Commands","Scripting Commands: Global Effect","Take On Helicopters: Scripting Commands"]}