setRank: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
 
m (Some wiki formatting)
 
(71 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|SETRANK]]
{{RV|type=command
[[Category:Scripting Commands OFP 1.96|SETRANK]]
[[Category:Scripting Commands ArmA|SETRANK]]


|game1= arma1
|version1= 1.00


<h2 style="color:#000066">'''''unit'' setRank ''rank'''''</h2>
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


'''Operand types:'''
|game4= tkoh
|version4= 1.00


'''unit:''' [[Object]]
|game5= arma3
|version5= 0.50


'''rank:''' [[String]]
|arg= local
|eff= global


'''Type of returned value:'''
|gr1= Unit Identity


[[Nothing]]
|descr= Sets rank of given unit.


'''Compatibility:'''
{{Feature|arma3|Before {{arma3}} v1.68 and in previous titles, this command was {{Icon|globalArgument|32}} {{Icon|localEffect|32}}.}}


Version 2.92 required.
|s1= unitName [[setRank]] rank


'''Description:'''
|p1= unitName: [[Object]]


Sets rank of given unit. Possible values: PRIVATE, CORPORAL, SERGEANT, LIEUTENANT, CAPTAIN, MAJOR or COLONEL.
|p2= rank: [[String]] - one of:
{{Columns|4|
* {{hl|"PRIVATE"}}
* {{hl|"CORPORAL"}}
* {{hl|"SERGEANT"}}
* {{hl|"LIEUTENANT"}}
* {{hl|"CAPTAIN"}}
* {{hl|"MAJOR"}}
* {{hl|"COLONEL"}}
}}


|r1= [[Nothing]]


'''Example:'''
|x1= <sqf>player setRank "COLONEL";</sqf>


player '''setRank''' "COLONEL"
|seealso= [[rank]] [[setUnitRank]]
}}
 
{{Note
|user= Wolfrug
|timestamp= 20090326192400
|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).
That is to say REPLACE, not add to: the unit's old rating will disappear with the rank change.
}}
 
{{Note
|user= Waffle SS.
|timestamp= 20140412203900
|text= Behavior when used on players in multiplayer seems unpredictable. ({{arma3}} 1.00)
}}

Latest revision as of 18:00, 29 April 2023

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
Sets rank of given unit.
Arma 3
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)
Retrieved from "https://community.bistudio.com/wiki?title=setRank&oldid=340311"