{"name":"setUnitRank","title":"setUnitRank","type":"command","url":"https://community.bistudio.com/wiki/setUnitRank","revid":340312,"updated":"2023-04-29T17:03:09Z","groups":["Unit Identity"],"status":"ok","games":{"ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofpe 1.00","arma3_since":"0.50","locality":{"argument":"global","effect":"global"},"description":"Sets rank of given unit.\n\nPossible rank values, and the associated rating that is **set** (not added, the value replaces previous rating) with it:\n\n| Ranks |  | PRIVATE | CORPORAL | SERGEANT | LIEUTENANT | CAPTAIN | MAJOR | COLONEL |\n|---|---|---|---|---|---|---|---|---|\n| Ratings | ArmA<br>Arma 2<br>Arma 2:OA<br>TKOH | 0 | 500 | 1500 | 2500 | 3500 | 5000 | 7500 |\n| Ratings | Arma 3 (ca 2015) | 0 | 50 | 150 | 250 | 350 | 500 | 750 |\n| Ratings | Arma 3 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |\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 setUnitRank rank","params":[{"name":"unitName","type":"Object","type_expr":"Object"},{"name":"rank","type":"String","description":"see above. If a wrong string is provided, the command errors and reverts to using \"PRIVATE\"","type_expr":"String"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"unitName"},"right":{"text":"rank"}}],"examples":[{"code":["player setUnitRank \"COLONEL\";"]}],"see_also":["ArmA: Armed Assault: Rating Values","rating","addRating","rank","setRank"]}