onTeamSwitch: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(parameter)
m (Text replacement - "\{\{Feature *\| *Informative *\| ([^↵]+) *\}\}" to "{{Feature|informative|$1}}")
 
(52 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2 |= Game name
|game1= arma2
|version1= 1.00


|1.00|= Game version
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| Defines an action performed when the team switch is finished. Command receives: _from object previous unit, _to object current unit. |= Description
|game3= tkoh
____________________________________________________________________________________________
|version3= 1.00


| '''onTeamSwitch''' command |= Syntax
|game4= arma3
|version4= 0.50


|p1= command:  [[String]] or [[Code]]  |= PARAMETER1
|gr1= Team Switch


|p2= |= PARAMETER2
|gr2= Event Handlers


|p3= |= PARAMETER3
|descr= Defines an action performed when the team switch is finished.
Commandset receives the following special variables: ''_from'' object previous unit, ''_to'' object current unit.
Consecutive use of onTeamSwitch command will overwrite previously set commandset.
{{Feature|important| This command is deprecated. Since '''Arma 3''' ''v1.57'' a stackable version of this EH is available: [[Arma 3: Mission Event Handlers#TeamSwitch|TeamSwitch]]}}
<br>
{{Feature|informative|When player switches and leaves behind AI unit, you need to enable "TeamSwitch" AI on it (with&nbsp;<sqf inline>onTeamSwitch { _from enableAI "TeamSwitch" };</sqf>) so that the unit continues with [[waypoints]].}}


| [[Nothing]] |= RETURNVALUE
|s1= [[onTeamSwitch]] commandset


|p1= commandset:  [[String]] or [[Code]]


|x1= <code>onTeamSwitch {[_from, _to] execVM "myTeamSwitchScript.sqf";}</code>|= EXAMPLE1
|r1= [[Nothing]]


____________________________________________________________________________________________
|x1= <sqf>onTeamSwitch { [_from, _to] execVM "myTeamSwitchScript.sqf"; };</sqf>


| [[Team_Switch]], [[enableTeamSwitch]], [[onBriefingTeamSwitch]], [[teamSwitch]], [[teamSwitchEnabled]] |= SEEALSO
|seealso= [[Team Switch]] [[enableTeamSwitch]] [[onBriefingTeamSwitch]] [[teamSwitch]] [[teamSwitchEnabled]]
 
|  |= MPBEHAVIOUR
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
There can only be one instance of onTeamSwitch used per mission.  If multiple instances are used then the last one loaded into memory will override previous instance(s). This includes use of onTeamSwitch in installed addons as well. --[[User:Loyalguard|Loyalguard]] 04:53, 28 October 2011 (CEST)
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 18:11, 15 March 2024

Hover & click on the images for description

Description

Description:
Defines an action performed when the team switch is finished. Commandset receives the following special variables: _from object previous unit, _to object current unit. Consecutive use of onTeamSwitch command will overwrite previously set commandset.
This command is deprecated. Since Arma 3 v1.57 a stackable version of this EH is available: TeamSwitch


When player switches and leaves behind AI unit, you need to enable "TeamSwitch" AI on it (with onTeamSwitch { _from enableAI "TeamSwitch" };) so that the unit continues with waypoints.
Groups:
Team SwitchEvent Handlers

Syntax

Syntax:
onTeamSwitch commandset
Parameters:
commandset: String or Code
Return Value:
Nothing

Examples

Example 1:
onTeamSwitch { [_from, _to] execVM "myTeamSwitchScript.sqf"; };

Additional Information

See also:
Team Switch enableTeamSwitch onBriefingTeamSwitch teamSwitch teamSwitchEnabled

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