setUnitRank: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<h3 style="display:none">Bottom Section</h3> " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|MP[Aa]rg|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma1 |Game name=
| arma1


|1.00|Game version=
|1.00


|arg= global |Multiplayer Arguments=
|arg= global


|eff= local |Multiplayer Effects=
|eff= local


|gr1= Unit Identity |GROUP1=
|gr1= Unit Identity


| Sets rank of given unit.
| Sets rank of given unit.
Line 34: Line 34:
{{!}}}
{{!}}}


{{Feature|arma3| Since {{arma3}} v1.67 this command is {{EffArg|cmd|arg|glob}} {{EffArg|cmd|eff|glob}}}} |DESCRIPTION=
{{Feature|arma3| Since {{arma3}} v1.67 this command is {{EffArg|cmd|arg|glob}} {{EffArg|cmd|eff|glob}}}}


| unitName [[setUnitRank]] rank |SYNTAX=
| unitName [[setUnitRank]] rank


|p1= unitName: [[Object]] |PARAMETER1=
|p1= unitName: [[Object]]


|p2= rank: [[String]] - as above |PARAMETER2=
|p2= rank: [[String]] - as above


| [[Nothing]] |RETURNVALUE=
| [[Nothing]]
   
   
|x1= <code>[[player]] [[setUnitRank]] "COLONEL";</code> |EXAMPLE1=
|x1= <code>[[player]] [[setUnitRank]] "COLONEL";</code>


| [[ArmA: Rating Values|Rating Values]], [[rating]], [[addRating]], [[rank]], [[setRank]] |SEEALSO=
| [[ArmA: Rating Values|Rating Values]], [[rating]], [[addRating]], [[rank]], [[setRank]]
}}
}}



Revision as of 12:09, 18 January 2021

Hover & click on the images for description

Description

Description:
Sets rank of given unit. Possible rank values, and the associated rating that is automatically given:
Rank Ratings
ArmA 1 Arma 2 Arma 3
PRIVATE 0 ? 0
CORPORAL 500 ? 0
SERGEANT 1500 ? 0
LIEUTENANT 2500 ? 0
CAPTAIN 3500 ? 0
MAJOR 5000 ? 0
COLONEL 7500 ? 0
Arma 3
Since Arma 3 v1.67 this command is Template:EffArg Template:EffArg
Groups:
Unit Identity

Syntax

Syntax:
unitName setUnitRank rank
Parameters:
unitName: Object
rank: String - as above
Return Value:
Nothing

Examples

Example 1:
player setUnitRank "COLONEL";

Additional Information

See also:
Rating ValuesratingaddRatingranksetRank

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

Notes

Posted on Mar 26, 2009 - 19:24
Wolfrug
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.
Posted on December 24, 2015 - 21:10 (UTC)
Wyattwic
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.
Posted on September 14, 2019 - 21:37 (UTC)
Lou Montana
In Arma 3 (v1.94), unit's rating is reset to zero. Also, all ranks start with a rating of zero.