setUnitRank: Difference between revisions

Revision as of 04:09, 30 October 2021

1.00

Hover & click on the images for description

Description

Description:

Sets rank of given unit. Possible rank values, and the associated rating that is set (not added, the value replaces previous rating) with it:

Ranks		CORPORAL	SERGEANT	LIEUTENANT	CAPTAIN	MAJOR	COLONEL
Ratings	ArmA Arma 2 Arma 2:OA	500	1500	2500	3500	5000	7500
	Arma 3 (ca 2015)	50	150	250	350	500	750
	Arma 3	0	0	0	0	0	0

Since

1.68 this command is GAGlobal GEGlobal

Groups:

Unit Identity

Syntax

Syntax:: unitName setUnitRank rank
Parameters:: unitName: Object
: rank: String - see above. If a wrong string is provided, the command errors and reverts to using "PRIVATE"
Return Value:: Nothing

Examples

Example 1:: player setUnitRank "COLONEL";

Additional Information

See also:: Rating Values rating addRating rank setRank

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

@@ Line 27: / Line 27: @@
 |descr= Sets rank of given unit.
-Possible rank values, and the associated [[rating]] that is automatically given:
+Possible rank values, and the associated [[rating]] that is '''set''' (not added, the value replaces previous rating) with it:
-{{{!}} class{{=}}"wikitable"
-! rowspan{{=}}"2" {{!}} Rank !! colspan{{=}}"3" {{!}} Ratings
+{{{!}} class{{=}}"wikitable" style{{=}}"text-align: center"
-{{!}}-
+! colspan{{=}}"2" {{!}} Ranks
-! ArmA 1 !! {{arma2}} !! {{arma3}}
+! PRIVATE
-{{!}}-
+! CORPORAL
-{{!}} PRIVATE {{!}}{{!}} 0 {{!}}{{!}} ? {{!}}{{!}} 0
+! SERGEANT
-{{!}}-
+! LIEUTENANT
-{{!}} CORPORAL {{!}}{{!}} 500 {{!}}{{!}} ? {{!}}{{!}} 0
+! CAPTAIN
-{{!}}-
+! MAJOR
-{{!}} SERGEANT {{!}}{{!}} 1500 {{!}}{{!}} ? {{!}}{{!}} 0
+! COLONEL
-{{!}}-
-{{!}} LIEUTENANT {{!}}{{!}} 2500 {{!}}{{!}} ? {{!}}{{!}} 0
 {{!}}-
-{{!}} CAPTAIN {{!}}{{!}} 3500 {{!}}{{!}} ? {{!}}{{!}} 0
+! rowspan{{=}}"3" {{!}} Ratings
+!
+{{Name|arma1|short}}<br>
+{{Name|arma2|short}}<br>
+{{Name|arma2oa|short}}<!--<br>
+{{Name|tkoh|short}}-->
+{{!}} 0
+{{!}} 500
+{{!}} 1500
+{{!}} 2500
+{{!}} 3500
+{{!}} 5000
+{{!}} 7500
 {{!}}-
-{{!}} MAJOR {{!}}{{!}} 5000 {{!}}{{!}} ? {{!}}{{!}} 0
+! {{Name|arma3|short}} (ca 2015)
+{{!}} 0
+{{!}} 50
+{{!}} 150
+{{!}} 250
+{{!}} 350
+{{!}} 500
+{{!}} 750
 {{!}}-
-{{!}} COLONEL {{!}}{{!}} 7500 {{!}}{{!}} ? {{!}}{{!}} 0
+! {{Name|arma3|short}}
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
 {{!}}}
-{{Feature|arma3| Since {{arma3}} v1.67 this command is {{Icon|globalArgument|32}} {{Icon|globalEffect|32}}}}
+{{Feature|arma3|Since {{GVI|arma3|1.68}} this command is {{Icon|globalArgument|32}} {{Icon|globalEffect|32}}}}
 |s1= unitName [[setUnitRank]] rank
@@ Line 54: / Line 78: @@
 |p1= unitName: [[Object]]
-|p2= rank: [[String]] - as above
+|p2= rank: [[String]] - see above. If a wrong string is provided, the command errors and reverts to using "PRIVATE"
 |r1= [[Nothing]]
@@ Line 60: / Line 84: @@
 |x1= <code>[[player]] [[setUnitRank]] "COLONEL";</code>
-|seealso= [[ArmA: Rating Values|Rating Values]], [[rating]], [[addRating]], [[rank]], [[setRank]]
+|seealso= [[ArmA: Armed Assault: Rating Values|Rating Values]], [[rating]], [[addRating]], [[rank]], [[setRank]]
 }}
-<dl class="command_description">
-<dt><dt>
-<dd class="notedate">Posted on Mar 26, 2009 - 19:24</dd>
-<dt class="note">[[User:Wolfrug|Wolfrug]]</dt>
-<dd class="note">
-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). That is to say REPLACE, not add to: the unit's old rating will disappear with the rank change.
-<dt><dt>
-<dd class="notedate">Posted on December 24, 2015 - 21:10 (UTC)</dd>
-<dt class="note">[[User:Wyattwic|Wyattwic]]</dt>
-<dd class="note">
-In Arma 3, if the rank is not spelled correctly or the string is empty, it will default to Private.   This command is not case sensitive. For Arma 3 the rating set by this command is as follows.
-    (PRIVATE: 0)
-    (CORPORAL: 50)
-    (SERGEANT: 150)
-    (LIEUTENANT: 250)
-    (CAPTAIN: 350)
-    (MAJOR: 500)
-    (COLONEL: 750)   The rating listed here will be present on base type respawn.
-</dd>
-<dt><dt>
-<dd class="notedate">Posted on September 14, 2019 - 21:37 (UTC)</dd>
-<dt class="note">[[User:Lou Montana|Lou Montana]]</dt>
-<dd class="note">
-In {{arma3}} (v1.94), unit's rating is reset to '''zero'''. Also, all ranks start with a rating of '''zero'''.
-</dd>
-</dl>