setSide: Difference between revisions

Latest revision as of 20:02, 12 June 2023

1.08

Hover & click on the images for description

Description

Description:: Sets a location's side. The default side is Unknown.
⚠
To change a unit's side, see Notes.
Groups:: Sides Locations

Syntax

Syntax:: location setSide side
Parameters:: location: Location
: side: Side
Return Value:: Nothing

Examples

Example 1:: _myLocation setSide resistance;

Additional Information

See also:: Side side west east resistance civilian sideUnknown sideFriendly sideEnemy playerSide Side Relations independent

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

Ondřejkuzel - c: Posted on Dec 03, 2013 - 16:00 (UTC)
: For units, vehicles you can use: _unitsArray joinSilent createGroup _side, e.g. in init: [this] joinSilent createGroup EAST; described in the note below

Jtgibson - c: Posted on Aug 06, 2009 - 19:05 (UTC)
: This is a frequent question on OFPEC, but produced here because it was difficult to find an answer to. setSide does not work for men, vehicles, etc.: it is intended for locations (i.e., territory). If you want to switch a unit's (e.g., the player's) side in the middle of a battle, make the unit joinSilent a group on the given side instead. If you want the unit to become the group leader after joining, use selectLeader. I have not tested the idea of spawning a temporary unit of that side, assigning the player to that unit, setting the player as the leader, then deleting the original unit, but I don't see why it wouldn't work. (It begs the question why we don't have a setSide object function, though.)

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| arma1
+|game1= arma1
+|version1= 1.08
-|1.08
+|game2= arma2
+|version2= 1.00
+|game3= arma2oa
+|version3= 1.50
+|game4= tkoh
+|version4= 1.00
+|game5= arma3
+|version5= 0.50
 |gr1= Sides
@@ Line 9: / Line 20: @@
 |gr2= Locations
-| Sets a location's [[Side|side]]. The default side is Unknown.
+|descr= Sets a location's [[Side|side]]. The default side is Unknown.
+{{Feature|important|To change a ''unit''<nowiki/>'s side, see {{Link|#Notes}}.}}
-| location '''setSide''' side
+|s1= location [[setSide]] side
 |p1= location: [[Location]]
 |p2= side: [[Side]]
-| [[Nothing]]
+|r1= [[Nothing]]
-|x1= <code>myLocation [[setSide]] [[resistance]]</code>
+|x1= <sqf>_myLocation setSide resistance;</sqf>
-|seealso= [[Side]], [[side]], [[west]], [[east]], [[resistance]], [[civilian]], [[sideUnknown]], [[sideFriendly]], [[sideEnemy]], [[playerSide]], [[side location]], [[Side relations]], [[independent]]
+|seealso= [[Side]] [[side]] [[west]] [[east]] [[resistance]] [[civilian]] [[sideUnknown]] [[sideFriendly]] [[sideEnemy]] [[playerSide]] [[Side Relations]] [[independent]]
 }}
-<dl class="command_description">
+{{Note
-<dt></dt>
+|user= Ondřejkuzel
-<dd class="notedate">Posted on 16:00, 3 December 2013 (CEST)</dd>
+|timestamp= 201312031600
-<dt class="note">[[User:Ondřejkuzel|Ondřejkuzel]]</dt>
+|text= For units, vehicles you can use: <sqf inline>_unitsArray joinSilent createGroup _side</sqf>, e.g. in init: <sqf inline>[this] joinSilent createGroup EAST;</sqf> ''described in the note below''
-<dd class="note">For units, vehicles you can use: "'''[[Array|array]] [[joinSilent]] [[createGroup]] [[Side]]'''", e.g. in init: "[this] joinSilent createGroup EAST;"  ''described in the note below''
+}}
-<dd class="notedate">Posted on 19:05, 6 August 2009 (CEST)</dd>
-<dt class="note">[[User:Jtgibson|Jtgibson]]</dt>
-<dd class="note">This is a frequent question on OFPEC, but produced here because it was difficult to find an answer to.  '''setSide''' does not work for men, vehicles, etc.: it is intended for locations (''i.e.'', territory).  If you want to switch a unit's (''e.g.'', the player's) side in the middle of a battle, make the unit '''[[joinSilent]]''' a group on the given side instead.  If you want the unit to become the group leader after joining, use '''[[selectLeader]]'''.  I have not tested the idea of spawning a temporary unit of that side, assigning the player to that unit, setting the player as the leader, then deleting the original unit, but I don't see why it wouldn't work.  (It begs the question why we don't have a setSide object function, though.)
-</dl>
+{{Note
-{{GameCategory|arma1|Scripting Commands}}
+|user= Jtgibson
-{{GameCategory|arma2|Scripting Commands}}
+|timestamp= 20090806190500
-{{GameCategory|arma3|Scripting Commands}}
+|text= This is a frequent question on OFPEC, but produced here because it was difficult to find an answer to. '''setSide''' does not work for men, vehicles, etc.: it is intended for locations (''i.e.'', territory).  If you want to switch a unit's (''e.g.'', the player's) side in the middle of a battle, make the unit '''[[joinSilent]]''' a group on the given side instead.  If you want the unit to become the group leader after joining, use '''[[selectLeader]]'''.  I have not tested the idea of spawning a temporary unit of that side, assigning the player to that unit, setting the player as the leader, then deleting the original unit, but I don't see why it wouldn't work.  (It begs the question why we don't have a setSide object function, though.)
-{{GameCategory|tkoh|Scripting Commands}}
+}}