assignTeam: Difference between revisions

Latest revision as of 18:04, 28 April 2023

1.00

Hover & click on the images for description

Description

Description:

Team	Value
White	"MAIN"
Red	"RED"
Green	"GREEN"
Blue	"BLUE"
Yellow	"YELLOW"

Assigns the unit (in case of a vehicle, its commander) to the given team. Team is an option in group control (unit management) menu that allows to split player group in teams and then give bulk order to separate teams. In order to operate properly, the command requires specific conditions:

the command requires player to be fully initialised
the unit getting assigned must be either player himself or a unit in player's group

The colour of the assigned team for a unit is seen on the group management UI as well as squad radar.

⚠

In older versions of the game (Arma 2?) the effect of this command is local LELocal.

Groups:

Groups

Syntax

Syntax:: unit assignTeam team
Parameters:: unit: Object
: team: String
Return Value:: Nothing

Examples

Example 1:: _soldier2 assignTeam "RED";
Example 2:: In a unit's init script in the editor spawn should be used, otherwise a race condition may be experienced:
this spawn { _this assignTeam "RED" };

Additional Information

See also:: assignedTeam dissolveTeam unassignTeam

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: @@
-[[Category:Scripting Commands|A]]
+{{RV|type=command
-[[Category:Scripting Commands ArmA|A]]
-<new command not populated>
+|game1= ofpe
+|version1= 1.00
+|game2= arma1
+|version2= 1.00
-<h2 style="color:#000066">''''' assignTeam '''''</h2>
+|game3= arma2
+|version3= 1.00
+|game4= arma2oa
+|version4= 1.50
-'''Operand types:'''
+|game5= tkoh
+|version5= 1.00
-'''Type of returned value:'''
+|game6= arma3
+|version6= 0.50
-'''Compatibility:'''
+|gr1= Groups
-'''Description:'''
+|arg= global
+|eff= global
-'''Example:'''
+|descr= {{{!}} class="wikitable float-right align-center"
+! Team
+! Value
+{{!}}-
+{{!}} White
+{{!}} "MAIN"
+{{!}}-
+{{!}} Red
+{{!}} "RED"
+{{!}}-
+{{!}} Green
+{{!}} "GREEN"
+{{!}}-
+{{!}} Blue
+{{!}} "BLUE"
+{{!}}-
+{{!}} Yellow
+{{!}} "YELLOW"
+{{!}}}
+Assigns the unit (in case of a vehicle, its commander) to the given team. Team is an option in group control (unit management) menu that allows to split player group in teams and then give bulk order to separate teams.
+In order to operate properly, the command requires specific conditions:
+* the command requires [[player]] to be fully initialised
+* the unit getting assigned must be either player himself or a unit in player's group
+The colour of the assigned team for a unit is seen on the group management UI as well as squad radar.
+{{Feature|important|In older versions of the game ({{arma2}}?) the effect of this command is '''local''' {{Icon|localEffect|32}}.}}
+|s1= unit [[assignTeam]] team
+|p1= unit: [[Object]]
+|p2= team: [[String]]
+|r1= [[Nothing]]
+|x1= <sqf>_soldier2 assignTeam "RED";</sqf>
+|x2= In a unit's init script in the editor [[spawn]] should be used, otherwise a {{Link|https://en.wikipedia.org/wiki/Race_condition|race condition}} may be experienced:
+<sqf>this spawn { _this assignTeam "RED" };</sqf>
+|seealso= [[assignedTeam]] [[dissolveTeam]] [[unassignTeam]]
+}}