setRank: Difference between revisions

Latest revision as of 18:00, 29 April 2023

1.00

Hover & click on the images for description

Description

Description:: Sets rank of given unit.
Before Arma 3 v1.68 and in previous titles, this command was GAGlobal LELocal.
Groups:: Unit Identity

Syntax

Syntax:

unitName setRank rank

Parameters:

unitName: Object

rank: String - one of:

"PRIVATE"
"CORPORAL"
"SERGEANT"
"LIEUTENANT"
"CAPTAIN"
"MAJOR"
"COLONEL"

Return Value:

Nothing

Examples

Example 1:: player setRank "COLONEL";

Additional Information

See also:: rank setUnitRank

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

Wolfrug - c: Posted on Mar 26, 2009 - 19:24 (UTC)
: 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.

Waffle SS. - c: Posted on Apr 12, 2014 - 20:39 (UTC)
: Behavior when used on players in multiplayer seems unpredictable. (Arma 3 1.00)

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma |= Game name
+|game1= arma1
+|version1= 1.00
-|1.00|= Game version
+|game2= arma2
-____________________________________________________________________________________________
+|version2= 1.00
-| Sets rank of given unit.
+|game3= arma2oa
+|version3= 1.50
-Possible values: PRIVATE, CORPORAL, SERGEANT, LIEUTENANT, CAPTAIN, MAJOR or COLONEL. |= Description
+|game4= tkoh
-____________________________________________________________________________________________
+|version4= 1.00
-| unitName '''setRank''' rank |= Syntax
+|game5= arma3
+|version5= 0.50
-|p1= unitName: [[Object]] |= Parameter 1
+|arg= local
+|eff= global
-|p2= rank: [[String]] |= Parameter 2
+|gr1= Unit Identity
-| [[Nothing]] |= Return value
+|descr= Sets rank of given unit.
-____________________________________________________________________________________________
-|x1= <pre>player setRank "COLONEL"</pre> |= Example 1
-____________________________________________________________________________________________
-|  |= See also
+{{Feature|arma3|Before {{arma3}} v1.68 and in previous titles, this command was {{Icon|globalArgument|32}} {{Icon|localEffect|32}}.}}
+|s1= unitName [[setRank]] rank
+|p1= unitName: [[Object]]
+|p2= rank: [[String]] - one of:
+{{Columns|4|
+* {{hl|"PRIVATE"}}
+* {{hl|"CORPORAL"}}
+* {{hl|"SERGEANT"}}
+* {{hl|"LIEUTENANT"}}
+* {{hl|"CAPTAIN"}}
+* {{hl|"MAJOR"}}
+* {{hl|"COLONEL"}}
+}}
+|r1= [[Nothing]]
+|x1= <sqf>player setRank "COLONEL";</sqf>
+|seealso= [[rank]] [[setUnitRank]]
 }}
-<h3 style="display:none">Notes</h3>
+{{Note
-<dl class="command_description">
+|user= Wolfrug
-<!-- Note Section BEGIN -->
+|timestamp= 20090326192400
-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.--[[User:Wolfrug|Wolfrug]] 19:42, 26 March 2009 (CET)
+|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).
-<!-- Note Section END -->
+That is to say REPLACE, not add to: the unit's old rating will disappear with the rank change.
-</dl>
+}}
-<h3 style="display:none">Bottom Section</h3>
+{{Note
-[[Category:Scripting Commands|SETRANK]]
+|user= Waffle SS.
-[[Category:Scripting Commands ArmA|SETRANK]]
+|timestamp= 20140412203900
+|text= Behavior when used on players in multiplayer seems unpredictable. ({{arma3}} 1.00)
+}}