setSide: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)\]\]" to "{{GameCategory|arma3|Scripting Commands}}")
m (Text replacement - "Side relations" to "Side Relations")
 
(45 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma1 |Game name=
|game1= arma1
|version1= 1.08


|1.08|Game version=
|game2= arma2
|version2= 1.00


|arg= |Multiplayer Arguments=
|game3= arma2oa
|version3= 1.50


|eff= |Multiplayer Effects=
|game4= tkoh
|version4= 1.00


|gr1= Sides |GROUP1=
|game5= arma3
|version5= 0.50


|gr2= Locations |GROUP2=
|gr1= Sides
____________________________________________________________________________________________


| Sets a location's [[Side|side]]. The default side is Unknown.|DESCRIPTION=
|gr2= Locations
____________________________________________________________________________________________


| location '''setSide''' side |SYNTAX=
|descr= Sets a location's [[Side|side]]. The default side is Unknown.
{{Feature|important|To change a ''unit''<nowiki/>'s side, see {{Link|#Notes}}.}}


|p1= location: [[Location]] |PARAMETER1=
|s1= location [[setSide]] side
|p2= side: [[Side]] |PARAMETER2=


| [[Nothing]] |RETURNVALUE=
|p1= location: [[Location]]
____________________________________________________________________________________________
 
|x1= <code>myLocation [[setSide]] [[resistance]]</code> |EXAMPLE1=
____________________________________________________________________________________________


| [[Side]], [[side]], [[west]], [[east]], [[resistance]], [[civilian]], [[sideUnknown]], [[sideFriendly]], [[sideEnemy]], [[playerSide]], [[side location]], [[Side relations]], [[independent]] |SEEALSO=
|p2= side: [[Side]]


}}
|r1= [[Nothing]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>_myLocation setSide resistance;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 16:00, 3 December 2013 (CEST)
<dt class="note">[[User:Ondřejkuzel|Ondřejkuzel]]
<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''
<!-- Note Section END -->
<dd class="notedate">Posted on 19:05, 6 August 2009 (CEST)
<dt class="note">[[User:Jtgibson|Jtgibson]]
<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 haven't 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.)
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[Side]] [[side]] [[west]] [[east]] [[resistance]] [[civilian]] [[sideUnknown]] [[sideFriendly]] [[sideEnemy]] [[playerSide]] [[Side Relations]] [[independent]]
}}


{{Note
|user= Ondřejkuzel
|timestamp= 201312031600
|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''
}}


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{Note
{{GameCategory|arma1|Scripting Commands}}
|user= Jtgibson
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
|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.)
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 20:02, 12 June 2023

Logo A1 black.png1.08Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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:
SidesLocations

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.)
Retrieved from "https://community.bistudio.com/wiki?title=setSide&oldid=341632"