switchableUnits: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "Category:Command Group: Team Switch" to "")
m (Text replacement - "<code>_([a-zA-Z0-9_]+) = \[\[([a-zA-Z0-9]+)\]\];?<\/code>" to "<sqf>_$1 = $2;</sqf>")
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma |Game name=
|game1= arma1
|version1= 1.00


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


|eff= local |Multiplayer Effects=
|game3= arma2oa
|version3= 1.50


|gr1= Multiplayer |GROUP1=
|game4= tkoh
|version4= 1.00


|gr2= Team Switch |GROUP2=
|game5= arma3
|version5= 0.50


|gr3= Object Detection |GROUP3=
|eff= local
____________________________________________________________________________________________


| Returns a list of playable units available for switching to.
|gr1= Multiplayer
Command is relative to the client on which it is executed and will only show playable units for the same [[side]] as [[player]]'s [[group]] + [[player]] himself,
unless in singleplayer where playable units from all sides will be accessible via this command.<br>
Dead and player-controlled units are automatically removed from the resulting array.<br><br>
{{Informative | In Multiplayer, [[switchableUnits]] are only available when [[description.ext#respawn|respawn]] type is set to SIDE or GROUP, the mission contains units marked playable and [[player]] is able to switch to any of those units. }}<br>
In order to get all ''playable'' units regardless of their [[side]], see the [[playableUnits]] command. |DESCRIPTION=
____________________________________________________________________________________________


| [[switchableUnits]] |SYNTAX=
|gr2= Team Switch


| [[Array]] |RETURNVALUE=
|gr3= Object Detection


|x1= _availableUnits = [[switchableUnits]]; |Example 1=
|descr= Returns a list of playable units available for switching to
____________________________________________________________________________________________
* Command is relative to the client on which it is executed and will only show playable units for the same [[side]] as [[player]]'s [[group]] + [[player]] himself
* In singleplayer where playable units from all sides will be accessible via this command
* Dead and player-controlled units are automatically removed from the resulting array
* In order to get all ''playable'' units regardless of their [[side]], see the [[playableUnits]] command


| [[allPlayers]], [[units]], [[allCurators]], [[allGroups]], [[allDead]], [[playableUnits]], [[vehicles]], [[allUnitsUAV]], [[allDeadMen]], [[teamSwitch]], [[Team_Switch]] |SEEALSO=
|mp= In Multiplayer, [[switchableUnits]] are only available when [[Description.ext#respawn|respawn]] type is set to SIDE or GROUP, the mission contains units marked playable and [[player]] is able to switch to any of those units. On dedicated servers, this command returns an empty array,.
}}
 
|s1= [[switchableUnits]]
 
|r1= [[Array]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>_availableUnits = switchableUnits;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on July 06, 2011 - 13:32
<dt class="note">[[User:Messiah2|Messiah2]]
<dd class="note">On dedicated server this command returns empty array.
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[Team Switch]] [[playableUnits]] [[allPlayers]] [[teamSwitch]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands Armed Assault|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]

Latest revision as of 22:21, 7 May 2022

Hover & click on the images for description

Description

Description:
Returns a list of playable units available for switching to
  • Command is relative to the client on which it is executed and will only show playable units for the same side as player's group + player himself
  • In singleplayer where playable units from all sides will be accessible via this command
  • Dead and player-controlled units are automatically removed from the resulting array
  • In order to get all playable units regardless of their side, see the playableUnits command
Multiplayer:
In Multiplayer, switchableUnits are only available when respawn type is set to SIDE or GROUP, the mission contains units marked playable and player is able to switch to any of those units. On dedicated servers, this command returns an empty array,.
Groups:
MultiplayerTeam SwitchObject Detection

Syntax

Syntax:
switchableUnits
Return Value:
Array

Examples

Example 1:
_availableUnits = switchableUnits;

Additional Information

See also:
Team Switch playableUnits allPlayers teamSwitch

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