setUnitRank: Difference between revisions

Latest revision as of 19:03, 29 April 2023

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 TKOH	500	1500	2500	3500	5000	7500
	Arma 3 (ca 2015)	50	150	250	350	500	750
	Arma 3	0	0	0	0	0	0

Before Arma 3 v1.68 and in previous titles, this command was GAGlobal LELocal.

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 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma |= Game name
+|game1= ofpe
+|version1= 1.00
-|1.00|= Game version
+|game2= arma1
+|version2= 1.00
-|arg= global |= Effects in MP
+|game3= arma2
-|eff= local |= Effects in MP
+|version3= 1.00
-____________________________________________________________________________________________
+|game4= arma2oa
+|version4= 1.50
-| Sets rank of given unit.
+|game5= tkoh
+|version5= 1.00
-Possible rank values, and the associated [[rating]] that is automatically given:
+|game6= arma3
-* PRIVATE: 0
+|version6= 0.50
-* CORPORAL: 500
-* SERGEANT: 1500
-* LIEUTENANT: 2500
-* CAPTAIN: 3500
-* MAJOR: 5000
-* COLONEL: 7500<br><br>
-{{Feature arma3| Since Arma 3 v1.67 this command is {{EffArg|cmd|arg|glob}} {{EffArg|cmd|eff|glob}}}}|= Description
+|arg= global
-____________________________________________________________________________________________
-| unitName '''setUnitRank''' rank |= Syntax
+|eff= global
-|p1= unitName: [[Object]] |= Parameter 1
+|gr1= Unit Identity
-|p2= rank: [[String]] As above|= Parameter 2
+|descr= Sets rank of given unit.
-| [[Nothing]] |= Return value
+Possible rank values, and the associated [[rating]] that is '''set''' (not added, the value replaces previous rating) with it:
-____________________________________________________________________________________________
-|x1= <pre>player setUnitRank "COLONEL"</pre> |= Example 1
-____________________________________________________________________________________________
-| [[ArmA: Rating Values|Rating Values]], [[rating]], [[addRating]], [[rank]], [[setRank]] |= See also
+{{{!}} class="wikitable" style="text-align: center"
+! colspan="2" {{!}} Ranks
+! PRIVATE
+! CORPORAL
+! SERGEANT
+! LIEUTENANT
+! CAPTAIN
+! MAJOR
+! COLONEL
+{{!}}-
+! 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
+{{!}}-
+! {{Name|arma3|short}} (ca 2015)
+{{!}} 0
+{{!}} 50
+{{!}} 150
+{{!}} 250
+{{!}} 350
+{{!}} 500
+{{!}} 750
+{{!}}-
+! {{Name|arma3|short}}
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}} 0
+{{!}}}
-}}
+{{Feature|arma3|Before {{arma3}} v1.68 and in previous titles, this command was {{Icon|globalArgument|32}} {{Icon|localEffect|32}}.}}
+|s1= unitName [[setUnitRank]] rank
+|p1= unitName: [[Object]]
-<h3 style="display:none">Notes</h3>
+|p2= rank: [[String]] - see above. If a wrong string is provided, the command errors and reverts to using "PRIVATE"
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<dd class="notedate">Posted on Mar 26, 2009 - 19:24
-<dt class="note">'''[[User:Wolfrug|Wolfrug]]'''<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.
-<!-- Note Section END -->
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|r1= [[Nothing]]
-[[Category:Scripting Commands|SETUNITRANK]]
+|x1= <sqf>player setUnitRank "COLONEL";</sqf>
-[[Category:Scripting Commands OFP Elite |SETUNITRANK]]
-[[Category:Scripting Commands ArmA|SETUNITRANK]]
-[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
-[[Category:Command_Group:_Object_Manipulation|{{uc:{{PAGENAME}}}}]]
-<!-- CONTINUE Notes -->
+|seealso= [[ArmA: Armed Assault: Rating Values|Rating Values]] [[rating]] [[addRating]] [[rank]] [[setRank]]
-<dl class="command_description">
+}}
-<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>
-</dl>
-<!-- DISCONTINUE Notes -->