Difference between revisions of "Arma 3: Actions"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (TurnIn / TurnOut exception)
m (Some wiki formatting)
 
(68 intermediate revisions by 11 users not shown)
Line 1: Line 1:
= Introduction =
+
{{TOC|side|0.9}}
 +
{{Feature|informative|
 +
* See [[ArmA: Armed Assault: Actions]] for an introduction to Actions
 +
* Not to be confused with [[playAction]]}}
  
See [[ArmA:_Actions#Introduction|ArmA Actions - Introduction]].
+
= General Syntax =
 +
 
 +
'''''unit'' [[action]] [''"actionType"'', ''parameter(s)'']'''
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
| ''unit'':
 +
| [[Object#Unit|Object]]. Can be any occupied [[Object#Vehicle|vehicle]] or [[Object#Person|person]] that is not in a vehicle or also a [[Game Logic]].
 +
|- style="vertical-align: top"
 +
| ''"actionType"'':
 +
| [[String]]. Name of the action, found in the CfgActions class. Not case sensitive.
 +
|- style="vertical-align: top"
 +
| ''parameter(s)'':
 +
| Various [[Data_Types|data types]], dependant on the action used. The number of required parameters depends on the action type.
 +
|}
  
  
= General Syntax =
+
= Actions =
 +
 
 +
 
 +
== ActiveSensorsOn ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Activates the vehicle's active sensor (radar).
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["ActiveSensorsOn", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["ActiveSensorsOn", vehicle player];</sqf>
 +
|}
 +
 
  
'''''unit'' [[action]] [''"actionType"'', ''parameter(s)'']'''
+
== ActiveSensorsOff ==
  
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|''unit'':                      ||[[Object#Unit|Object]]. Can be any occupied [[Object#Vehicle|vehicle]] or [[Object#Person|person]] that is not in a vehicle or also a [[Game Logic]].
+
! Description
|-valign=top
+
| style="width: 99%" | Deactivates the vehicle's active sensor (radar).
|''"actionType"'':              ||[[String]]. Not case sensitive.
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|''parameter(s)'':              ||Various [[Data_Types|data types]], dependant on the action used. The number of required parameters depends on the action type.
+
| ''unit'' action ["ActiveSensorsOff", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["ActiveSensorsOff", vehicle player];</sqf>
 
|}
 
|}
  
= Actions =
 
  
 
== AddBag ==
 
== AddBag ==
:{|style="background:transparent"
 
|-valign=top
 
|'''Description''':          || Causes a unit to take backpack from another unit/vehicle or weaponholder.
 
|-valign=top
 
|'''Syntax''':              ||''targetUnit'' action ["AddBag", ''sourceUnit'', ''"backpackName"'']
 
|-valign=top
 
|                            ||Where ''targetUnit'' is the person to recieve a backpack (the action animation will be performed), ''sourceUnit'' is either another unit/vehicle or weaponholder containing the backpack. ''"backpackName"'' is the classname (string) of the backpack to be picked up.
 
|-valign=top
 
|'''Note''':                ||Bags can be picked up at any distance. To drop bag use "DropBag" action. If several backpacks of the same class name exist in the container, the oldest will be added first.
 
|-valign=top
 
|'''Examples''':
 
|<code>soldierOne [[action]] ["AddBag", soldierTwo, [[backpack]] soldierTwo];</code>
 
  
<code>[[player]] [[action]] ["AddBag", car, [[typeOf]] [[firstBackpack]] car];</code>
+
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Causes a unit to take backpack from another unit/vehicle or weaponholder.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''targetUnit'' action ["AddBag", ''sourceUnit'', ''"backpackName"'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''targetUnit'' is the person to recieve a backpack (the action animation will be performed), ''sourceUnit'' is either another unit/vehicle or weaponholder containing the backpack. ''"backpackName"'' is the classname (string) of the backpack to be picked up.
 +
|- style="vertical-align: top"
 +
! Note
 +
| Bags can be picked up at any distance. To drop bag use "DropBag" action. If several backpacks of the same class name exist in the container, the oldest will be added first.
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>soldierOne action ["AddBag", soldierTwo, backpack soldierTwo];</sqf>
 +
 
 +
<sqf>player action ["AddBag", car, typeOf firstBackpack car];</sqf>
 +
Swap player bag with parachute: <sqf>player action ["DropBag", _plane, backpack player];
 +
player action ["AddBag", _plane, "B_Parachute"];</sqf>
 
|
 
|
 
|}
 
|}
Line 40: Line 88:
 
== ArtilleryComputer ==
 
== ArtilleryComputer ==
  
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         ||Opens up Artillery Computer display just like the one in action menu for a mortar. Unit has to be in gunner position or display will immediately close.
+
! Description
|-valign=top
+
| style="width: 99%" | Opens up Artillery Computer display just like the one in action menu for a mortar. Unit has to be in gunner position or display will immediately close.
|'''Syntax''':              ||''unit'' action ["ArtilleryComputer", ''artillery'']
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                           ||Where ''unit'' is any unit, and ''artillery'' is the artillery weapon
+
| ''unit'' action ["ArtilleryComputer", ''artillery'']
|-valign=top
+
|- style="vertical-align: top"
|'''Example''':
+
|
|<code>soldierOne [[action]] ["ArtilleryComputer", mortarOne];</code>
+
| Where ''unit'' is any unit, and ''artillery'' is the artillery weapon
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["ArtilleryComputer", mortarOne];</sqf>
 
|
 
|
 
|}
 
|}
Line 55: Line 106:
  
 
== AutoHover ==
 
== AutoHover ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Toggles auto-hovering on. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["autoHover", ''targetVehicle'']
+
| style="width: 99%" | Toggles auto-hovering on. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["autoHover", ''targetVehicle'']
|'''Example''':              ||<code>chopperOne [[action]] ["autoHover", chopperOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>chopperOne action ["autoHover", chopperOne];</sqf>
 
|}
 
|}
  
  
 
== AutoHoverCancel ==
 
== AutoHoverCancel ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Toggles auto-hovering off. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["autoHover", ''targetVehicle'']
+
| style="width: 99%" | Toggles auto-hovering off. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["autoHoverCancel", ''targetVehicle'']
|'''Example''':              ||<code>chopperOne [[action]] ["autoHover", chopperOne]</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>chopperOne action ["autoHoverCancel", chopperOne];</sqf>
 
|}
 
|}
  
  
 
== BackFromUAV ==
 
== BackFromUAV ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Moves player control back from driver/gunner position of connected UAV. Does what "Release UAV controls" UI action does.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''uav'' action ["BackFromUAV", ''unit'']
+
| style="width: 99%" | Moves player control back from driver/gunner position of connected UAV. Does what "Release UAV controls" UI action does.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''uav'' is the connected UAV and ''unit'' is the player controlling it.
+
! Syntax
|-valign=top
+
| ''uav'' action ["BackFromUAV", ''unit'']
|'''Example''':              ||<code>[[getConnectedUAV]] [[player]] [[action]] ["BackFromUAV", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''uav'' is the connected UAV and ''unit'' is the player controlling it.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>getConnectedUAV player action ["BackFromUAV", player];</sqf>
 
|}
 
|}
  
  
 
== CancelAction ==
 
== CancelAction ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Cancels an action in progress. The target unit will complete it's current animation, although the action itself will not be performed.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["cancelAction", ''targetUnit'']'''
+
| style="width: 99%" | Cancels an action in progress. The target unit will complete it is current animation, although the action itself will not be performed.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetUnit'' is any unit that is in the process of performing an action.
+
! Syntax
|-valign=top
+
| ''unit'' action ["cancelAction", ''targetUnit'']'''
|'''Example''':              ||<code>soldierOne [[action]] ["CancelAction", soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetUnit'' is any unit that is in the process of performing an action.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["CancelAction", soldierOne];</sqf>
 
|}
 
|}
  
  
 
== CancelLand ==
 
== CancelLand ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Cancels autopilot landing for an aircraft, including AI controlled aircraft.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["cancelLand", ''targetVehicle'']'''
+
| style="width: 99%" | Cancels autopilot landing for an aircraft, including AI controlled aircraft.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is currently performing an autopilot landing.
+
! Syntax
|-valign=top
+
| ''unit'' action ["cancelLand", ''targetVehicle'']'''
|'''Example''':              ||<code>planeOne [[action]] ["cancelLand", planeOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is currently performing an autopilot landing.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>planeOne action ["cancelLand", planeOne];</sqf>
 
|}
 
|}
  
  
 
== CancelTakeFlag ==
 
== CancelTakeFlag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Cancels taking of a flag. The unit will complete the taking/action animation, but the flag will remain attached to it's current object. This action needs to be executed while the flag is being taken (which happens after the unit completes the taking/action animation) to prevent a unit taking the flag. For example, if a person is taking a flag from a flagpole, then the cancelTakeFlag action should be executed while the flag is descending the flagpole.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["cancelTakeFlag", ''targetFlag'']
+
| style="width: 99%" | Cancels taking of a flag. The unit will complete the taking/action animation, but the flag will remain attached to it is current object. This action needs to be executed while the flag is being taken (which happens after the unit completes the taking/action animation) to prevent a unit taking the flag. For example, if a person is taking a flag from a flagpole, then the cancelTakeFlag action should be executed while the flag is descending the flagpole.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit that is currently taking a flag (no action animation is performed) and ''targetFlag''' is a flag object.
+
! Syntax
|-valign=top
+
| ''unit'' action ["cancelTakeFlag", ''targetFlag'']
|'''Example''':              ||<code>westSoldierOne [[action]] ["cancelTakeFlag", eastFlag];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit that is currently taking a flag (no action animation is performed) and ''targetFlag''' is a flag object.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>westSoldierOne action ["cancelTakeFlag", eastFlag];</sqf>
 
|}
 
|}
  
  
 +
== CollisionLightOff ==
  
== CollisionLightOff ==
+
:{|
:{|style="background:transparent"
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Description''':         ||Turns off the collision lights of an air vehicle.
+
| style="width: 99%" | Turns off the collision lights of an air vehicle.
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unit'' action ["CollisionLightOff", ''targetVehicle'']'''
+
! Syntax
|-valign=top
+
| ''unit'' action ["CollisionLightOff", ''targetVehicle'']'''
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>[[player]] [[action]] ["CollisionLightOff", [[vehicle]] [[player]]];</code>
+
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["CollisionLightOff", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== CollisionLightOn ==
 
== CollisionLightOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Turns on the collision lights of an air vehicle.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["CollisionLightOn", ''targetVehicle'']'''
+
| style="width: 99%" | Turns on the collision lights of an air vehicle.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
+
! Syntax
|-valign=top
+
| ''unit'' action ["CollisionLightOn", ''targetVehicle'']'''
|'''Example''':              ||<code>[[player]] [[action]] ["CollisionLightOn", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["CollisionLightOn", vehicle player];</sqf>
 
|}
 
|}
 +
  
 
== Deactivate ==
 
== Deactivate ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a unit to deactivate and take a active satchel charge placed by any unit. This action can be performed upon a satchel object from any distance.  
+
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Causes a unit to deactivate and take a active satchel charge placed by any unit. This action can be performed upon a satchel object from any distance.
  
 
This action also works for landmines created with [[createVehicle]] command:
 
This action also works for landmines created with [[createVehicle]] command:
<code>mine = "ATMine_Range_Ammo" [[createVehicle]] [[position]] [[player]]; //create
+
<sqf>
[[player]] [[action]] ["Deactivate", [[player]], mine]; //deactivate </code>
+
mine = "ATMine_Range_Ammo" createVehicle getPosATL player; // create
|-valign=top
+
player action ["Deactivate", player, mine]; // deactivate
|'''Syntax''':              ||''unit'' action ["deactivate", ''targetUnit'', ''targetObject'']
+
</sqf>
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (they will perform the action animation as if deactivating a satchel charge). ''targetUnit'' will have the deactivated satchel charge added to it's inventory. ''targetObject'' is the armed satchel object to be deactivated (class "pipeBomb" or "timeBomb").
+
! Syntax
|-valign=top
+
| ''unit'' action ["deactivate", ''targetUnit'', ''targetObject'']
|'''Examples''':            ||<code>soldierOne [[action]] ["deactivate", soldierOne, mySatchelCharge];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|                           ||<code>soldierOne [[action]] ["deactivate", soldierOne, [[nearestObject]] [soldierOne, "pipeBomb"]];</code>
+
| Where ''unit'' is any unit (they will perform the action animation as if deactivating a satchel charge). ''targetUnit'' will have the deactivated satchel charge added to it is inventory. ''targetObject'' is the armed satchel object to be deactivated (class "pipeBomb" or "timeBomb").
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>soldierOne action ["deactivate", soldierOne, mySatchelCharge];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>soldierOne action ["deactivate", soldierOne, nearestObject [soldierOne, "pipeBomb"]];</sqf>
 
|}
 
|}
  
  
 
== DeactivateMine ==
 
== DeactivateMine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a unit to deactivate any armed landmine that is within about two meters of a unit. Neither unit requires the ability to disable landmines.
+
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Causes a unit to deactivate any armed landmine that is within about two meters of a unit. Neither unit requires the ability to disable landmines.
  
 
NOTE: This action works only with mines that have been spotted by player (marked with triangle). Use "Deactivate" if you need to deactivate any mine.
 
NOTE: This action works only with mines that have been spotted by player (marked with triangle). Use "Deactivate" if you need to deactivate any mine.
  
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unit'' action ["deactivateMine", ''targetUnit'']
+
! Syntax
|-valign=top
+
| ''unit'' action ["deactivateMine", ''targetUnit'']
|                           ||Where ''unit'' is any unit, who will perform the action animation. The closest landmine to ''targetUnit'' will be deactivated.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>soldierOne [[action]] ["deactivateMine", soldierOne];</code>
+
| Where ''unit'' is any unit, who will perform the action animation. The closest landmine to ''targetUnit'' will be deactivated.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["deactivateMine", soldierOne];</sqf>
 
|}
 
|}
  
  
 
== Diary ==
 
== Diary ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["diary", ''<target>'']
+
| style="width: 99%" | Use and effects unknown.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["diary", ''<target>'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
Line 208: Line 317:
 
== Disassemble ==
 
== Disassemble ==
  
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         ||Takes assembled weapon to parts (carry bags). Assembled weapon object reference may need to be kept for assembly.
+
! Description
|-valign=top
+
| style="width: 99%" | Takes assembled weapon to parts (carry bags). Assembled weapon object reference may need to be kept for assembly. See also: [[enableWeaponDisassembly]]
|'''Syntax''':              ||''unit'' action ["Disassemble", ''weapon'']'''
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                           ||Where ''unit'' is any unit and ''weapon'' is assembled weapon
+
| ''unit'' action ["Disassemble", ''weapon'']'''
|-valign=top
+
|- style="vertical-align: top"
|'''Example''':              ||<code>soldierOne [[action]] ["Disassemble", mortarOne];</code>
+
|
 +
| Where ''unit'' is any unit and ''weapon'' is assembled weapon
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["Disassemble", mortarOne];</sqf>
 
|}
 
|}
 +
  
 
== DropBag ==
 
== DropBag ==
:{|style="background:transparent"
 
|-valign=top
 
|'''Description''':          || Causes a unit to drop a backpack into another unit/vehicle. To drop backpack on the ground, a weaponholder object needs to be created first.
 
|-valign=top
 
|'''Syntax''':              ||''sourceUnit'' action ["DropBag", ''targetUnit'', ''"backpackName"'']
 
|-valign=top
 
|                            ||Where ''sourceUnit'' is the person to drop a backpack (the action animation will be performed), ''targetUnit'' is either another unit/vehicle into which the backpack will be dropped or a weaponholder. ''"backpackName"'' is the classname (string) of the backpack to be dropped.
 
|-valign=top
 
|'''Note''':                ||Bags can be dropped into other units at any distance. If targetUnit already has a backpack, sourceUnit's backpack will drop to the ground at targetUnit's feet, and be unavailable (for picking up/using).
 
|-valign=top
 
|'''Examples''':
 
|<code>soldierOne [[action]] ["DropBag", soldierTwo, [[backpack]] soldierOne];</code>
 
  
<code>_gwh = "GroundWeaponHolder" [[createVehicle]] [[position]] [[player]];
+
:{|
[[player]] [[action]] ["DropBag", _gwh, [[typeOf]] [[unitBackpack]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Causes a unit to drop a backpack into another unit/vehicle. To drop backpack on the ground, a weaponholder object needs to be created first.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''sourceUnit'' action ["DropBag", ''targetUnit'', ''"backpackName"'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''sourceUnit'' is the person to drop a backpack (the action animation will be performed), ''targetUnit'' is either another unit/vehicle into which the backpack will be dropped or a weaponholder. ''"backpackName"'' is the classname (string) of the backpack to be dropped.
 +
|- style="vertical-align: top"
 +
! Note
 +
| Bags can be dropped into other units at any distance. If targetUnit already has a backpack, sourceUnit's backpack will drop to the ground at targetUnit's feet, and be unavailable (for picking up/using).
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>soldierOne action ["DropBag", soldierTwo, backpack soldierOne];</sqf>
  
<code>([[unitBackpack]] [[player]]) [[setVariable]] ["backpackOwner", [[name]] [[player]], true];
+
<sqf>
[[player]] [[action]] ["DropBag", car, [[typeOf]] [[unitBackpack]] [[player]]];
+
_gwh = "Weapon_Empty" createVehicle getPosATL player;
[[hint]] (([[firstBackpack]] car) [[getVariable]] "backpackOwner");</code>
+
player action ["DropBag", _gwh, typeOf unitBackpack player];
 +
// the reason "Weapon_Empty" type of weaponholder is used in this case is because
 +
// unlike other weaponholders it is not autodeleted when empty and will not disappear before the action is complete.
 +
// you should take care of deleting it after yourself. Alternatively use "PutBag" action.
 +
</sqf>
 +
 
 +
<sqf>
 +
(unitBackpack player) setVariable ["backpackOwner", name player, true];
 +
player action ["DropBag", car, typeOf unitBackpack player];
 +
hint ((firstBackpack car) getVariable "backpackOwner");
 +
</sqf>
 +
 
 +
Swap player bag with parachute:
 +
<sqf>
 +
player action ["DropBag", _plane, backpack player];
 +
player action ["AddBag", _plane, "B_Parachute"];
 +
</sqf>
 +
 
 +
Transfer player's backpack to bob
 +
<sqf>player action ["DropBag", bob];</sqf>
 
|
 
|
 
|}
 
|}
Line 244: Line 379:
  
 
== DropMagazine ==
 
== DropMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Causes a person to drop a magazine either into another unit (both persons and vehicles), or onto the ground (creating a new WeaponHolder object). Magazines can be dropped into other units at any distance.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["dropMagazine", ''targetUnit'', ''"magazineName"'']
+
| style="width: 99%" | Causes a person to drop a magazine either into another unit (both persons and vehicles), or onto the ground (creating a new WeaponHolder object). Magazines can be dropped into other units at any distance.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to drop a magazine (the action animation will be performed), ''targetUnit'' is either another unit into which the magazine will be dropped, or the same unit that is dropping the magazine. ''"magazineName"'' is the classname (string) of the magazine to be dropped (see the [[ArmA:_Weapons|ArmA weapons list]] for magazine classnames).
+
! Syntax
|-valign=top
+
| ''unit'' action ["dropMagazine", ''targetUnit'', ''"magazineName"'']
|'''Examples''':            ||<code>soldierOne [[action]] ["dropMagazine", soldierOne, "30Rnd_545x39_AK"];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|                           ||<code>soldierOne [[action]] ["dropMagazine", ammoCrateOne, "30Rnd_545x39_AK"];</code>
+
| Where ''unit'' is the person to drop a magazine (the action animation will be performed), ''targetUnit'' is either another unit into which the magazine will be dropped, or the same unit that is dropping the magazine. ''"magazineName"'' is the classname (string) of the magazine to be dropped (see the [[ArmA:_Weapons|ArmA weapons list]] for magazine classnames).
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>soldierOne action ["dropMagazine", soldierOne, "30Rnd_545x39_AK"];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>soldierOne action ["dropMagazine", ammoCrateOne, "30Rnd_545x39_AK"];</sqf>
 
|}
 
|}
  
  
 
== DropWeapon ==
 
== DropWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to drop a weapon and all associated magazines either into specified vehicle or weaponholder. Weapons can be dropped at any distance.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["dropWeapon", ''targetHolder'', ''"weaponName"'']
+
| style="width: 99%" | Causes a person to drop a weapon and all associated magazines either into specified vehicle or weaponholder. Weapons can be dropped at any distance.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to drop a weapon (the action animation will be performed), ''targetHolder'' is either a vehicle or weaponholder. ''"weaponName"'' is the classname (string) of the CfgWeapons class.
+
! Syntax
|-valign=top
+
| ''unit'' action ["dropWeapon", ''targetHolder'', ''"weaponName"'']
|'''Examples''':            ||
+
|- style="vertical-align: top"
<code>soldierOne [[action]] ["DropWeapon", [[unitBackpack]] soldierTwo, [[currentWeapon]] soldierOne];</code>
+
|
|-valign=top
+
| Where ''unit'' is the person to drop a weapon (the action animation will be performed), ''targetHolder'' is either a vehicle or weaponholder. ''"weaponName"'' is the classname (string) of the CfgWeapons class.
|                            ||
+
|- style="vertical-align: top"
<code>[[player]] [[action]] ["DropWeapon", tank, "arifle_MX_ACO_pointer_F"];</code>
+
! Examples
|-valign=top
+
| <sqf>
|                           ||
+
private _weaponHolder = "GroundWeaponHolder_Scripted" createVehicle getPosATL player;
<code>[[player]] [[action]] [
+
player action ["DropWeapon", _weaponHolder, currentWeapon player];
"DropWeapon",
+
</sqf>
"GroundWeaponHolder" [[createVehicle]] [[position]] [[player]],
+
<sqf>soldierOne action ["DropWeapon", unitBackpack soldierTwo, currentWeapon soldierOne];</sqf>
[[handgunWeapon]] [[player]]
+
<sqf>player action ["DropWeapon", tank, "arifle_MX_ACO_pointer_F"];</sqf>
];</code>
+
|- style="vertical-align: top"
 +
|
 
|}
 
|}
 +
  
 
== Eject ==
 
== Eject ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to eject out of the vehicle they are currently inside. If the unit was the driver of the vehicle, the vehicle will retain it's steering control input and it's engine will remain on. This action has a global effect when used on a local unit in multiplayer. If the vehicle parameter used is an moving aircraft, the ejecting person will use a parachute (and likewise if it is not an moving aircraft, no parachute will be used).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["eject", ''vehicle'']
+
| style="width: 99%" | Causes a person to eject out of the vehicle they are currently inside. If the unit was the driver of the vehicle, the vehicle will retain it is steering control input and it is engine will remain on. This action has a global effect when used on a local unit in multiplayer. If the vehicle parameter used is an moving aircraft, the ejecting person will use a parachute (and likewise if it is not an moving aircraft, no parachute will be used).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to eject from their current vehicle, and ''vehicle'' is any vehicle (generally the vehicle ''unit'' is within).
+
! Syntax
|-valign=top
+
| ''unit'' action ["eject", ''vehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["Eject", vehicle soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to eject from their current vehicle, and ''vehicle'' is any vehicle (generally the vehicle ''unit'' is within).
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["Eject", vehicle soldierOne];</sqf>
 
|}
 
|}
  
  
 
== EngineOn ==
 
== EngineOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Turns a vehicle's engine on. This command will not override an AI driver's desires.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["engineOn", ''targetVehicle'']
+
| style="width: 99%" | Turns a vehicle's engine on. This command will not override an AI driver's desires.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to start it's engine.
+
! Syntax
|-valign=top
+
| ''unit'' action ["engineOn", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["engineOn", vehicle soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to start it is engine.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["engineOn", vehicle soldierOne];</sqf>
 
|}
 
|}
  
  
 
== EngineOff ==
 
== EngineOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Turns a vehicle's engine off. This command will not override an AI driver's desires.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["engineOff", ''targetVehicle'']
+
| style="width: 99%" | Turns a vehicle's engine off. This command will not override an AI driver's desires.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to have it's engine turned off.
+
! Syntax
|-valign=top
+
| ''unit'' action ["engineOff", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["engineOff", vehicle soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to have it is engine turned off.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["engineOff", vehicle soldierOne];</sqf>
 
|}
 
|}
  
  
== FireInFlame ==
+
== FireInflame ==
<!-- Hmmm, hard to known how to correctly camelize this "Czechlish" :) -->
+
 
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         || Ignites a fireplace object (from any distance).
+
! Description
|-valign=top
+
| style="width: 99%" | Ignites a fireplace object (from any distance).
|'''Syntax''':              ||''unit'' action ["fireInFlame", ''targetObject'']
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                           ||Where ''unit'' is any unit(the action animation will be performed), and ''targetObject'' is the fireplace to be ignited.
+
| ''unit'' action ["FireInflame", ''targetObject'']
|-valign=top
+
|- style="vertical-align: top"
|'''Example''':              ||<code>soldierOne [[action]] ["fireInFlame", firePlaceOne];</code>
+
|
 +
| Where ''unit'' is any unit(the action animation will be performed), and ''targetObject'' is the fireplace to be ignited.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["FireInflame", firePlaceOne];</sqf>
 
|}
 
|}
  
  
 
== FirePutDown ==
 
== FirePutDown ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Extinguishes a fireplace object (from any distance).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["firePutDown", ''targetObject'']
+
| style="width: 99%" | Extinguishes a fireplace object (from any distance).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (the action animation will be performed), and ''targetObject'' is the fireplace to be extinguished.
+
! Syntax
|-valign=top
+
| ''unit'' action ["FirePutDown", ''targetObject'']
|'''Example''':              ||<code>soldierOne [[action]] ["firePutDown", firePlaceOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (the action animation will be performed), and ''targetObject'' is the fireplace to be extinguished.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["FirePutDown", firePlaceOne];</sqf>
 
|}
 
|}
  
  
 
== FlapsUp ==
 
== FlapsUp ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Adjusts an aircraft's flaps upwards one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["flapsUp", ''targetVehicle'']
+
| style="width: 99%" | Adjusts an aircraft's flaps upwards one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it's flaps adjusted.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["flapsUp", ''targetVehicle'']
|'''Example''':              ||<code>harrierOne [[action]] ["flapsUp", harrierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>harrierOne action ["flapsUp", harrierOne];</sqf>
 
|}
 
|}
  
  
 
== FlapsDown ==
 
== FlapsDown ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Adjusts an aircraft's flaps down one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["flapsDown", ''targetVehicle'']
+
| style="width: 99%" | Adjusts an aircraft's flaps down one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it's flaps adjusted.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["flapsDown", ''targetVehicle'']
|'''Example''':              ||<code>harrierOne [[action]] ["flapsDown", harrierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>harrierOne action ["flapsDown", harrierOne];</sqf>
 
|}
 
|}
  
  
 
== Gear ==
 
== Gear ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Opens inventory dialog for the player and plays the appropriate animation. The left part of the inventory dialog gets populated with the inventory of the target unit. Player has to be in range of inventory operations with the targetUnit (~ <5m).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["Gear", ''targetUnit'']
+
| style="width: 99%" | Opens inventory dialog for the player and plays the appropriate animation. The left part of the inventory dialog gets populated with the inventory of the target unit. Player has to be in range of inventory operations with the targetUnit (~ <5m).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a player, and ''targetUnit'' is another player, vehicle or container.
+
! Syntax
|-valign=top
+
| ''unit'' action ["Gear", ''targetUnit'']
|'''Examples''':              ||<code>[[player]] [[action]] ["Gear","GroundWeaponHolder" [[createVehicle]] [[position]] [[player]]];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|
+
| Where ''unit'' is a player, and ''targetUnit'' is another player, vehicle or container.
||<code>[[player]] [[action]] ["Gear", [[objNull]]];</code>
+
|- style="vertical-align: top"
|-valign=top
+
! Examples
|
+
| <sqf>player action ["Gear","GroundWeaponHolder" createVehicle position player];</sqf>
||<code>[[player]] [[action]] ["Gear", soldier1];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|
+
| |<sqf>player action ["Gear", objNull];</sqf>
||<code>[[player]] [[action]] ["Gear", [[cursorTarget]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| |<sqf>player action ["Gear", soldier1];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| |<sqf>player action ["Gear", cursorTarget];</sqf>
 
|}
 
|}
  
  
 
== GetInCargo ==
 
== GetInCargo ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Instantly moves a person to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as cargo, in a specific cargo position if given as an optional parameter, otherwise in the first available cargo position. If the specific position is already occupied, the person will board in the first available cargo position. If the all cargo positions are already occupied by living persons, or no cargo position exists, the boarding will fail.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInCargo", ''targetVehicle'']
+
| style="width: 99%" | Instantly moves a person to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as cargo, in a specific cargo position if given as an optional parameter, otherwise in the first available cargo position. If the specific position is already occupied, the person will board in the first available cargo position. If the all cargo positions are already occupied by living persons, or no cargo position exists, the boarding will fail. This action works only with cargo positions that have no person turret, i.e. if player cannot shoot his rifle from them. If position is cargo but also person turret, it will be ignored. Use {{hl|[[fullCrew]] [_veh, "cargo", [[true]]]}} to determine which positions are compatible cargo. Alternatively, use [[moveInCargo]] command instead, which has no such limitation.
|-valign=top
+
|- style="vertical-align: top"
|                           ||''unit'' action ["getInCargo", ''targetVehicle'', ''positionNumber'']
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInCargo", ''targetVehicle'']
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded. ''positionNumber is a specific cargo position index number.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Examples''':            ||<code>soldierOne [[action]] ["getInCargo", truckOne];</code>
+
| ''unit'' action ["getInCargo", ''targetVehicle'', ''positionNumber'']
|-valign=top
+
|- style="vertical-align: top"
|                           ||<code>soldierOne [[action]] ["getInCargo", truckOne, 0];</code>
+
|
 +
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded. ''positionNumber is a specific cargo position index number.
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>soldierOne action ["getInCargo", truckOne];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>soldierOne action ["getInCargo", truckOne, 0];</sqf>
 
|}
 
|}
  
  
 
== GetInCommander ==
 
== GetInCommander ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, they then attempt to board the vehicle as the commander. The boarding will fail if the position is already occupied or does not exist.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInCommander", ''targetVehicle'']
+
| style="width: 99%" | Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, they then attempt to board the vehicle as the commander. The boarding will fail if the position is already occupied or does not exist.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInCommander", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["getInCommander", tankOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["getInCommander", tankOne];</sqf>
 
|}
 
|}
  
  
 
== GetInDriver ==
 
== GetInDriver ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInDriver", ''targetVehicle'']
+
| style="width: 99%" | Instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInDriver", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["getInDriver", carOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["getInDriver", carOne];</sqf>
 
|}
 
|}
  
  
 
== GetInGunner ==
 
== GetInGunner ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the primary gunner. If the gunner position is already occupied by another living person or it does not exist, the boarding will fail. Also see [[#GetInTurret|getInTurret]].
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInGunner", ''targetVehicle'']
+
| style="width: 99%" | Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the primary gunner. If the gunner position is already occupied by another living person or it does not exist, the boarding will fail. Also see [[#GetInTurret|getInTurret]].
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInGunner", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["getInGunner", mySpotlight];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["getInGunner", mySpotlight];</sqf>
 
|}
 
|}
  
  
 
== GetInPilot ==
 
== GetInPilot ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || This action is identical to [[#GetInDriver|getInDriver]]. It instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInPilot", ''targetVehicle'']
+
| style="width: 99%" | This action is identical to [[#GetInDriver|getInDriver]]. It instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInPilot", ''targetVehicle'']
|'''Example''':              ||<code>pilotOne [[action]] ["getInPilot", chopperOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>pilotOne action ["getInPilot", chopperOne];</sqf>
 
|}
 
|}
  
  
 
== GetInTurret ==
 
== GetInTurret ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the specified turret user. If the turret position is already occupied by another living person the boarding will fail. If the turret position does not exist, ArmA may crash. See also [[#GetInGunner|getInGunner]].
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getInTurret", ''targetVehicle'', ''turretArray'']
+
| style="width: 99%" | Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the specified turret user. If the turret position is already occupied by another living person the boarding will fail. If the turret position does not exist, ArmA may crash. See also [[#GetInGunner|getInGunner]].
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded, and ''turretArray'' is an array defining the turret. For example, ''[1]'' would be a vehicle's second turret, and ''[0, 2, 1]'' is the second turret of the third turret of the first turret. A vehicle's turret order is defined in it's class CfgVehicles of the Config.
+
! Syntax
|-valign=top
+
| ''unit'' action ["getInTurret", ''targetVehicle'', ''turretArray'']
|'''Examples''':            ||<code>gunnerTwo [[action]] ["getInTurret", myUH60MG, [1]];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|                           ||<code>tankCommanderOne [[action]] ["getInTurret", myT72, [0,1]];</code>
+
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded, and ''turretArray'' is an array defining the turret. For example, ''[1]'' would be a vehicle's second turret, and ''[0, 2, 1]'' is the second turret of the third turret of the first turret. A vehicle's turret order is defined in it is class CfgVehicles of the Config.
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>gunnerTwo action ["getInTurret", myUH60MG, [1]];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>tankCommanderOne action ["getInTurret", myT72, [0,1]];</sqf>
 
|}
 
|}
  
  
 
== GetOut ==
 
== GetOut ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to disembark from a vehicle, without a parachute in the case of aircraft. See also [[#Eject|eject]].
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["getOut", ''targetVehicle'']
+
| style="width: 99%" | Causes a person to disembark from a vehicle, without a parachute in the case of aircraft. See also [[#Eject|eject]].
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the person to disembark, and ''targetVehicle'' is the vehicle to disembark from.
+
! Syntax
|-valign=top
+
| ''unit'' action ["getOut", ''targetVehicle'']
|'''Example''':              ||<code>soldierOne [[action]] ["getOut", carOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the person to disembark, and ''targetVehicle'' is the vehicle to disembark from.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["getOut", carOne];</sqf>
 
|}
 
|}
  
  
 
== HandGunOn ==
 
== HandGunOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to ready their hand gun (if equiped). This action may not work if the unit does not have a primary rifle.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["handGunOn", ''targetUnit'']
+
| style="width: 99%" | Causes a person to ready their hand gun (if equiped). This action may not work if the unit does not have a primary rifle.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the unit who will ready their pistol.
+
! Syntax
|-valign=top
+
| ''unit'' action ["handGunOn", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["handGunOn", soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the unit who will ready their pistol.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["handGunOn", soldierOne];</sqf>
 
|}
 
|}
  
  
 
== HandGunOff ==
 
== HandGunOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to return a readied pistol to it's holster, then switch to the primary rifle. This action may not work if the unit does not have a primary rifle.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["handGunOff", ''targetUnit'']
+
| style="width: 99%" | Causes a person to return a readied pistol to it is holster, then switch to the primary rifle. This action may not work if the unit does not have a primary rifle.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the person to holster it's pistol.
+
! Syntax
|-valign=top
+
| ''unit'' action ["handGunOff", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["handGunOff", soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the person to holster it is pistol.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["handGunOff", soldierOne];</sqf>
 
|}
 
|}
  
  
 
== Heal ==
 
== Heal ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Instantly teleports a person unit to the target medic. The target medic then heals the unit. If the target unit is not a medic, the animations will still be played, but no healing occurs. If the medic is within a vehicle, no teleporting will occur and the wounded unit will only be healed if they are already within healing range (a few meters).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["heal", ''targetUnit'']
+
| style="width: 99%" | Instantly teleports a person unit to the target medic. The target medic then heals the unit. If the target unit is not a medic, the animations will still be played, but no healing occurs. If the medic is within a vehicle, no teleporting will occur and the wounded unit will only be healed if they are already within healing range (a few meters).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a wounded person, and ''targetUnit'' is the medic to do the healing.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["heal", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["heal", medicOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a wounded person, and ''targetUnit'' is the medic to do the healing.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["heal", medicOne];</sqf>
 
|}
 
|}
 +
  
 
== HealSoldier ==
 
== HealSoldier ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Performs one soldier healing of another soldier. Needs to have MedKit or FAK (first aid kit) in the inventory, which gets used.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["HealSoldier", ''targetUnit'']
+
| style="width: 99%" | Performs one soldier healing of another soldier. Needs to have MedKit or FAK (first aid kit) in the inventory, which gets used.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the unit to perform treatment, and ''targetUnit'' is the unit to recieve treatment.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["HealSoldier", ''targetUnit'']
|'''Example''':              ||<code>player [[action]] ["HealSoldier", soldier1];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the unit to perform treatment, and ''targetUnit'' is the unit to recieve treatment.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["HealSoldier", soldier1];</sqf>
 
|}
 
|}
 +
  
 
== HealSoldierSelf ==
 
== HealSoldierSelf ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Performs one soldier healing of another soldier. In case the target is the same unit, the soldier performs treatment on himself. Needs to have FAK (first aid kit) in the inventory, which gets used.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["HealSoldierSelf", ''targetUnit'']
+
| style="width: 99%" | Performs one soldier healing of another soldier. In case the target is the same unit, the soldier performs treatment on himself. Needs to have FAK (first aid kit) in the inventory, which gets used.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the unit to perform treatment, and ''targetUnit'' is the unit to recieve treatment.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["HealSoldierSelf", ''targetUnit'']
|'''Example''':              ||<code>player [[action]] ["HealSoldierSelf", soldier1];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the unit to perform treatment, and ''targetUnit'' is the unit to recieve treatment.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["HealSoldierSelf", soldier1];</sqf>
 
|}
 
|}
  
  
 
== HideBody ==
 
== HideBody ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to bend down and hide (bury) a body in the ground. The body is automatically deleted within a few seconds. The person performing the action does not require the ability to hide bodies, and may be any distance from the body.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["hideBody", ''targetUnit'']
+
| style="width: 99%" | Causes a person to bend down and hide (bury) a body in the ground. The body is automatically deleted within a few seconds. The person performing the action does not require the ability to hide bodies, and may be any distance from the body.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a person, and ''targetUnit'' is a dead person.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["hideBody", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["hideBody", soldierTwo];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a person, and ''targetUnit'' is a dead person.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["hideBody", soldierTwo];</sqf>
 
|}
 
|}
  
  
 
== InGameMenu ==
 
== InGameMenu ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["inGameMenu", ''<target>'']
+
| style="width: 99%" | Use and effects unknown.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["inGameMenu", ''<target>'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== LadderDown ==
 
== LadderDown ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to play an animation as if mounting the top of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the [[#ladderOff|ladderOff]] action is executed upon them. It may also crash ArmA (pre 1.09).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["ladderDown", ''targetObject'']
+
| style="width: 99%" | Causes a person to play an animation as if mounting the top of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the [[#ladderOff|ladderOff]] action is executed upon them. It may also crash ArmA (pre 1.09).
|-valign=top
+
|- style="vertical-align: top"
|                           ||''unit'' action ["ladderDown", ''targetObject'', ''ladderNumber'', ''positionNumber'']
+
! Syntax
|-valign=top
+
| ''unit'' action ["ladderDown", ''targetObject'']
|                           ||Where ''unit'' is any person unit, ''targetObject'' is an object with a ladder, ''ladderNumber'' is a number defining the desired ladder, and ''positionNumber'' is a number defining the desired position.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>soldierOne [[action]] ["ladderDown", (position soldierOne nearestObject 452221), 0, 1];</code>
+
| ''unit'' action ["ladderDown", ''targetObject'', ''ladderNumber'', ''positionNumber'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any person unit, ''targetObject'' is an object with a ladder, ''ladderNumber'' is a number defining the desired ladder, and ''positionNumber'' is a number defining the desired position.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["ladderDown", (position soldierOne nearestObject 452221), 0, 1];</sqf>
 
|}
 
|}
  
  
 
== LadderUp ==
 
== LadderUp ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to play an animation as if mounting the bottom of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the [[#ladderOff|ladderOff]] action is executed upon them. It may also crash ArmA (pre 1.09).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["ladderUp", ''targetObject''] '''!!!Warning!!! This syntax causes Arma 3 to freeze'''
+
| style="width: 99%" | Causes a person to play an animation as if mounting the bottom of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the [[#ladderOff|ladderOff]] action is executed upon them. It may also crash ArmA (pre 1.09).
|-valign=top
+
|- style="vertical-align: top"
|                           ||''unit'' action ["ladderUp", ''targetObject'', ''ladderNumber'', ''positionNumber'']
+
! Syntax
|-valign=top
+
| ''unit'' action ["ladderUp", ''targetObject''] '''!!!Warning!!! This syntax causes Arma 3 to freeze'''
|                           ||Where ''unit'' is any person unit, ''targetObject'' is an object with a ladder, ''ladderNumber'' is a number defining the desired ladder, and ''positionNumber'' is a number defining the desired position (0 - bottom, 1 - top). All numbers in between get rounded towards 1 or 0.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>soldierOne [[action]] ["ladderUp", (position soldierOne nearestObject 452221), 0, 0];</code>
+
| ''unit'' action ["ladderUp", ''targetObject'', ''ladderNumber'', ''positionNumber'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any person unit, ''targetObject'' is an object with a ladder, ''ladderNumber'' is a number defining the desired ladder, and ''positionNumber'' is a number defining the desired position (0 - bottom, 1 - top). All numbers in between get rounded towards 1 or 0.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["ladderUp", (position soldierOne nearestObject 452221), 0, 0];</sqf>
 
|}
 
|}
 +
  
 
== LadderOff ==
 
== LadderOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to dismount from any ladder of the specified object they may be happen to be on. The alternative 3 parameter syntax expects a number, the use of which is not known.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["ladderOff", ''targetObject'']
+
| style="width: 99%" | Causes a person to dismount from any ladder of the specified object they may be happen to be on. The alternative 3 parameter syntax expects a number, the use of which is not known.
|-valign=top
+
|- style="vertical-align: top"
|                           ||''unit'' action ["ladderOff", ''targetObject'', ''unknownNumber'']
+
! Syntax
|-valign=top
+
| ''unit'' action ["ladderOff", ''targetObject'']
|                           ||Where ''unit'' is any person unit, ''targetObject'' is the object with a ladder that the person is currently upon, ''unknownNumber'' is a number.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>soldierOne [[action]] ["ladderOff", (position soldierOne nearestObject 452221)];</code>
+
| ''unit'' action ["ladderOff", ''targetObject'', ''unknownNumber'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any person unit, ''targetObject'' is the object with a ladder that the person is currently upon, ''unknownNumber'' is a number.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["ladderOff", (position soldierOne nearestObject 452221)];</sqf>
 
|}
 
|}
 +
  
 
== LadderOnDown ==
 
== LadderOnDown ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         This action appears to be identical to [[#LadderDown|LadderDown]].
+
|- style="vertical-align: top"
 +
| '''Description''': This action appears to be identical to [[#LadderDown|LadderDown]].
 
|}
 
|}
  
  
 
== LadderOnUp ==
 
== LadderOnUp ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         This action appears to be identical to [[#LadderUp|LadderUp]].
+
|- style="vertical-align: top"
 +
| '''Description''': This action appears to be identical to [[#LadderUp|LadderUp]].
 
|}
 
|}
  
  
 
== Land ==
 
== Land ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Turns on autopilot landing for an aircraft, including AI controlled aircraft. The aircraft will land at the closest airfield.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["Land", ''targetVehicle'']'''
+
| style="width: 99%" | Turns on autopilot landing for an aircraft, including AI controlled aircraft. The aircraft will land at the closest airfield.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
+
! Syntax
|-valign=top
+
| ''unit'' action ["Land", ''targetVehicle'']'''
|'''Example''':              ||<code>planeOne [[action]] ["Land", planeOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>planeOne action ["Land", planeOne];</sqf>
 
|}
 
|}
  
  
 
== LandGear ==
 
== LandGear ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Lowers the landing gear of an aircraft. Only works on player controlled aircraft.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["LandGear", ''targetVehicle'']'''
+
| style="width: 99%" | Lowers the landing gear of an aircraft. In the case of AI-controlled aircraft, it has to be used in an each-frame loop to to override the AI behavior (otherwise they'll raise the landing gear when they take off).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
+
! Syntax
|-valign=top
+
| ''unit'' action ["LandGear", ''targetVehicle'']'''
|'''Example''':              ||<code>planeOne [[action]] ["LandGear", planeOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>planeOne action ["LandGear", planeOne];</sqf>
 
|}
 
|}
  
 +
== LandGearUp ==
  
== LandGearUp ==
+
:{|
:{|style="background:transparent"
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Description''':         ||Raises the landing gear of an aircraft. Only works on player controlled aircraft.
+
| style="width: 99%" | Raises the landing gear of an aircraft. In the case of AI-controlled aircraft, it has to be used in an each-frame loop to override the AI behavior (otherwise they'll lower the landing gear when they're close to the ground).
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unit'' action ["LandGearUp", ''targetVehicle'']'''
+
! Syntax
|-valign=top
+
| ''unit'' action ["LandGearUp", ''targetVehicle'']'''
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>planeOne [[action]] ["LandGearUp", planeOne];</code>
+
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>planeOne action ["LandGearUp", planeOne];</sqf>
 
|}
 
|}
  
  
 
== LightOff ==
 
== LightOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Turns off the headlights of an empty vehicle. If the vehicle is AI-controlled (either as the lone driver, or as the commander/gunner) then the light status depends on the AI's [[behaviour]] mode ("combat" or "stealth" = lights off, any other mode = lights on).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["lightOff", ''targetVehicle'']'''
+
| style="width: 99%" | Turns off the headlights of an empty vehicle. If the vehicle is AI-controlled (either as the lone driver, or as the commander/gunner) then the light status depends on the AI's [[behaviour]] mode ("combat" or "stealth" = lights off, any other mode = lights on).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
+
! Syntax
|-valign=top
+
| ''unit'' action ["lightOff", ''targetVehicle'']'''
|'''Example''':              ||<code>[[player]] [[action]] ["lightOff", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["lightOff", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== LightOn ==
 
== LightOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Turns on the headlights of an empty vehicle. If vehicle is AI-controlled, see notes under the [[ArmA:_Actions#LightOff|LightOff]] action.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["lightOn", ''targetVehicle'']'''
+
| style="width: 99%" | Turns on the headlights of an empty vehicle. If vehicle is AI-controlled, see notes under the [[ArmA:_Actions#LightOff|LightOff]] action.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
+
! Syntax
|-valign=top
+
| ''unit'' action ["lightOn", ''targetVehicle'']'''
|'''Example''':              ||<code>[[player]] [[action]] ["lightOn", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["lightOn", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== LoadMagazine ==
 
== LoadMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||Unknown, something like - ''unit'' action ["loadMagazine", <target>, <magazine creator>, <number>, <number> ,<weapon name>, <muzzle name>]
+
| style="width: 99%" | Plays a reload weapon animation.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Expects a 7 element array. ArmA crashes when given incompatible syntax or data with this action, making it hard to test.
+
! Syntax
|-valign=top
+
| ''unit'' action ["loadMagazine", target, magazineCreator, ''number1'', ''number2'', weaponName, muzzleName]
|'''Example''':             ||<code>[[player]] [[action]] ["loadmagazine", [[player]], [[player]], 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Expects a 7 element array:
 +
|- style="vertical-align: top"
 +
|
 +
| target: [[Object]] - unit to perform the reload action.
 +
|- style="vertical-align: top"
 +
|
 +
| magazineCreator: [[Object]] - unknown. Can be objNull.
 +
|- style="vertical-align: top"
 +
|
 +
| ''number1'': [[Number]] - cr - see [[magazinesDetail]]. For characters it is mainly 0
 +
|- style="vertical-align: top"
 +
|
 +
| ''number2'': [[Number]] - id - magazine ID - can be obtained via [[magazinesDetail]]. With 0, it only plays the reload animation. With values from 1 up, it actually reloads the magazine. If the number becomes too high (meaning of the upper limit is also unknown), the action will no longer be performed.
 +
|- style="vertical-align: top"
 +
|
 +
| weaponName: [[String]] - weapon to reload. Must not be selected, but may cause weapon not to reload to the full amount.
 +
|- style="vertical-align: top"
 +
|
 +
| muzzleName: [[String]] - weapon's muzzle to reload.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["loadmagazine", player, player, 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"];</sqf>
 
|}
 
|}
  
  
 
== LockVehicleControl ==
 
== LockVehicleControl ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Locks co-pilot controls, removes [[Arma_3:_Actions#TakeVehicleControl|Take Control]] action. [[enableCopilot]] must be set true to function.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["LockVehicleControl", ''vehicle'']
+
| style="width: 99%" | Locks co-pilot controls, removes [[Arma_3:_Actions#TakeVehicleControl|Take Control]] action. [[enableCopilot]] must be set true to function.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
+
! Syntax
|-valign=top
+
| ''unit'' action ["LockVehicleControl", ''vehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["LockVehicleControl", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["LockVehicleControl", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== ManualFire ==
 
== ManualFire ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Enables manual fire mode for a player unit that is driver or commander of a vehicle. This action toggled manual fire mode in old versions of ArmA.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["manualFire", ''targetVehicle'']'''
+
| style="width: 99%" | Enables manual fire mode for a player unit that is driver or commander of a vehicle. This action toggled manual fire mode in old versions of ArmA. (See also [[isManualFire]])
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be enabled.
+
! Syntax
|-valign=top
+
| ''unit'' action ["manualFire", ''targetVehicle'']'''
|'''Example''':              ||<code>[[player]] [[action]] ["ManualFire", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be enabled.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["ManualFire", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== ManualFireCancel ==
 
== ManualFireCancel ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Disables manual fire mode for a player unit that is driver or commander of a vehicle.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["manualFireCancel", ''targetVehicle'']'''
+
| style="width: 99%" | Disables manual fire mode for a player unit that is driver or commander of a vehicle. (See also [[isManualFire]])
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be disabled.
+
! Syntax
|-valign=top
+
| ''unit'' action ["manualFireCancel", ''targetVehicle'']'''
|'''Example''':              ||<code>[[player]] [[action]] ["manualFireCancel", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be disabled.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["manualFireCancel", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== MarkEntity ==
 
== MarkEntity ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["markEntity", <target>]
+
| style="width: 99%" | Use and effects unknown. Same as [[Arma_3_Actions#MarkWeapon]] action.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["markEntity", <target>]
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== MoveToCargo ==
 
== MoveToCargo ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Move a unit to the chosen cargo position within a vehicle. If another unit is already in that position, the units will swap positions. (possibly alternate syntax to place unit in first empty cargo position?)
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["moveToCargo", ''targetVehicle'', ''cargoPosition'']
+
| style="width: 99%" | Move a unit to the chosen cargo position within a vehicle. If another unit is already in that position, the units will swap positions. This works only with cargo positions that have no person turret, i.e. if player cannot shoot his rifle from them. If position is cargo but also person turret, it will be ignored. Use {{hl|[[fullCrew]] [_veh, "cargo", [[true]]]}} to determine which positions are compatible cargo.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a unit within ''targetVehicle'', and ''cargoPosition'' is the number of the desired cargo position (0 being the first).
+
! Syntax
|-valign=top
+
| ''unit'' action ["moveToCargo", ''targetVehicle'', ''cargoPosition'']
|'''Example''':              ||<code>[[player]] [[action]] ["moveToCargo", [[vehicle]] [[player]], 2];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a unit within ''targetVehicle'', and ''cargoPosition'' is the number of the desired cargo position (0 being the first).
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["moveToCargo", vehicle player, 2];</sqf>
 
|}
 
|}
  
  
 
== MoveToCommander ==
 
== MoveToCommander ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Move a unit to the commander's position within a vehicle. If another unit is already in that position, the units will swap positions.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["moveToCommander", ''targetVehicle'']
+
| style="width: 99%" | Move a unit to the commander's position within a vehicle. If another unit is already in that position, the units will swap positions.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
+
! Syntax
|-valign=top
+
| ''unit'' action ["moveToCommander", ''targetVehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["moveToCommander", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a unit within ''targetVehicle''.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["moveToCommander", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== MoveToDriver ==
 
== MoveToDriver ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Move a unit to the driver's position within a vehicle. If another unit is already in that position, the units will generally swap positions, although in some scenarios this action may not work (although having the existing driver move always works).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["moveToDriver", ''targetVehicle'']
+
| style="width: 99%" | Move a unit to the driver's position within a vehicle. If another unit is already in that position, the units will generally swap positions, although in some scenarios this action may not work (although having the existing driver move always works).
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
+
! Syntax
|-valign=top
+
| ''unit'' action ["moveToDriver", ''targetVehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["moveToDriver", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a unit within ''targetVehicle''.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["moveToDriver", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== MoveToGunner ==
 
== MoveToGunner ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Move a unit to the primary gunner's position within a vehicle. If another unit is already in that position, the units will swap positions. See also [[#MoveToTurret|moveToTurret]].
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["moveToGunner", ''targetVehicle'']
+
| style="width: 99%" | Move a unit to the primary gunner's position within a vehicle. If another unit is already in that position, the units will swap positions. See also [[#MoveToTurret|moveToTurret]].
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
+
! Syntax
|-valign=top
+
| ''unit'' action ["moveToGunner", ''targetVehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["moveToGunner", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a unit within ''targetVehicle''.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["moveToGunner", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== MoveToPilot ==
 
== MoveToPilot ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         Identical to [[#MoveToDriver|moveToDriver]].
+
|- style="vertical-align: top"
 +
| '''Description''': Identical to [[#MoveToDriver|moveToDriver]].
 
|}
 
|}
  
  
 
== MoveToTurret ==
 
== MoveToTurret ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Move a unit to the chosen turret position within a vehicle. If another unit is already in that position, the units will swap positions.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["moveToTurret", ''targetVehicle'', ''turretArray'']
+
| style="width: 99%" | Move a unit to the chosen turret position within a vehicle. If another unit is already in that position, the units will swap positions.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a unit within ''targetVehicle'', and ''turret Array'' is an array referring to the desired turret (for example, [0,1,2] refers to the third turret of the second turret of the first turret of the vehicle).
+
! Syntax
|-valign=top
+
| ''unit'' action ["moveToTurret", ''targetVehicle'', ''turretArray'']
|'''Examples''':            ||<code>[[player]] [[action]] ["moveToTurret", [[vehicle]] [[player]], [0]];</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|                           ||<code>[[player]] [[action]] ["moveToTurret", [[vehicle]] [[player]], [0,1]];</code>
+
| Where ''unit'' is a unit within ''targetVehicle'', and ''turret Array'' is an array referring to the desired turret (for example, [0,1,2] refers to the third turret of the second turret of the first turret of the vehicle).
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>player action ["moveToTurret", vehicle player, [0]];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>player action ["moveToTurret", vehicle player, [0,1]];</sqf>
 
|}
 
|}
  
  
 
== None ==
 
== None ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["none", ''<target>'']
+
| style="width: 99%" | Use and effects unknown.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["none", ''<target>'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== NVGoggles ==
 
== NVGoggles ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a unit to put on it's night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["nvGoggles", ''<anything>'']
+
| style="width: 99%" | Causes a unit to put on it is night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the unit to put on NVGoggles, and ''<anything>'' can be anything (it seems to not be used at all, but the action parameter array must contain at least two elements).
+
! Syntax
|-valign=top
+
| ''unit'' action ["nvGoggles", ''<anything>'']
|'''Example''':              ||<code>[[player]] [[action]] ["nvGoggles", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the unit to put on NVGoggles, and ''<anything>'' can be anything (it seems to not be used at all, but the action parameter array must contain at least two elements).
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["nvGoggles", player];</sqf>
 
|}
 
|}
  
  
 
== NVGogglesOff ==
 
== NVGogglesOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a unit to take off it's night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["nvGogglesOff", ''<anything>'']
+
| style="width: 99%" | Causes a unit to take off it is night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the unit to put on goggles, and ''<anything>'' can be anything (it seems not to be used at all, but the action parameter array must contain at least two elements).
+
! Syntax
|-valign=top
+
| ''unit'' action ["nvGogglesOff", ''<anything>'']
|'''Example''':              ||<code>[[player]] [[action]] ["nvGogglesOff", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the unit to put on goggles, and ''<anything>'' can be anything (it seems not to be used at all, but the action parameter array must contain at least two elements).
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["nvGogglesOff", player];</sqf>
 
|}
 
|}
  
  
 
== OpenParachute ==
 
== OpenParachute ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||Opens unit's parachute. Unit must have parachute backpack.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':               ||''unit'' action ["OpenParachute", ''unit'']
+
| style="width: 99%" | Opens unit's parachute. Unit must have parachute backpack.
|-valign=top
+
|- style="vertical-align: top"
|                            ||Where ''unit'' is the unit with parachute backpack.
+
! Syntax
|-valign=top
+
| ''unit'' action ["OpenParachute", ''unit'']
|'''Example''':              ||<code>[[player]] [[action]] ["OpenParachute", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is the unit with parachute backpack.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["OpenParachute", player];</sqf>
 
|}
 
|}
  
  
 
== PutBag ==
 
== PutBag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          || Causes a unit to bend over and put current backpack on the ground.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''sourceUnit'' action ["PutBag"]
+
| style="width: 99%" | Causes ''sourceUnit'' to bend over and put target backpack on the ground. If the ''targetUnit'' param is omitted or it is the same as ''sourceUnit'', the ''sourceUnit'' will drop own backpack. If ''targetUnit'' is another unit, ''sourceUnit'' will bend over but ''targetUnit'' will drop its backpack at its feet.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''sourceUnit'' is the person to drop a backpack.
+
! Syntax
|-valign=top
+
| ''sourceUnit'' action ["PutBag", ''targetUnit'']
|'''Note''':                || To pick the backpack from the ground use "AddBag" action.
+
|- style="vertical-align: top"
|-valign=top  
+
|
|'''Examples''':
+
| ''targetUnit'' is optional
|<code>[[player]] [[action]] ["PutBag"];</code>
+
|- style="vertical-align: top"
 +
! Note
 +
| To pick the backpack from the ground use "AddBag" action.
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>
 +
player action ["PutBag"];
 +
unit1 action ["PutBag", unit2];
 +
</sqf>
 
|
 
|
 
|}
 
|}
Line 912: Line 1,313:
  
 
== Rearm ==
 
== Rearm ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes an occupied vehicle or person to rearm from any object with some ammoCargo (generally an ammo truck) in the case of vehicles, or some magazines in it's cargo in the case of a rearming person. The rearming vehicle/person can be any distance from the rearming object. Rearming vehicles takes some time and will be interrupted if the vehicle starts to move. A rearming person will bend down as if picking up something.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["rearm", ''reamingObject'']
+
| style="width: 99%" | Causes an occupied vehicle or person to rearm from any object with some ammoCargo (generally an ammo truck) in the case of vehicles, or some magazines in it is cargo in the case of a rearming person. The rearming vehicle/person can be any distance from the rearming object. Rearming vehicles takes some time and will be interrupted if the vehicle starts to move. A rearming person will bend down as if picking up something.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is the occupied vehicle or person to be rearmed, and ''rearmingObject'' is the object from which to rearm.
+
! Syntax
|-valign=top
+
| ''unit'' action ["rearm", ''reamingObject'']
|'''Examples''':            ||<code>tankOne [[action]] ["rearm", ammoTruckOne]</code>
+
|- style="vertical-align: top"
|-valign=top
+
|
|                           ||<code>soldierOne [[action]] ["rearm", ammoTruckOne];</code>
+
| Where ''unit'' is the occupied vehicle or person to be rearmed, and ''rearmingObject'' is the object from which to rearm.
 +
|- style="vertical-align: top"
 +
! Examples
 +
| <sqf>tankOne action ["rearm", ammoTruckOne];</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>soldierOne action ["rearm", ammoTruckOne];</sqf>
 
|}
 
|}
  
  
 
== Refuel ==
 
== Refuel ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes an occupied vehicle to refuel from any object with some fuelCargo (generally an refueling truck). The refueling object can be any distance from the vehicle. Refueling takes some time and will be interrupted if the vehicle starts to move.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''vehicle'' action ["refuel", ''refuelingObject'']
+
| style="width: 99%" | Causes an occupied vehicle to refuel from any object with some fuelCargo (generally an refueling truck). The refueling object can be any distance from the vehicle. Refueling takes some time and will be interrupted if the vehicle starts to move.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''vehicle'' is the occupied vehicle to be refueled, and ''refuelingObject'' is the object from which to refuel.
+
! Syntax
|-valign=top
+
| ''vehicle'' action ["refuel", ''refuelingObject'']
|'''Example''':              ||<code>tankOne [[action]] ["refuel", refuelTruckOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''vehicle'' is the occupied vehicle to be refueled, and ''refuelingObject'' is the object from which to refuel.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>tankOne action ["refuel", refuelTruckOne];</sqf>
 
|}
 
|}
  
  
 
== Repair ==
 
== Repair ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes an occupied vehicle to repair from any object with some repairCargo (generally an repair truck). The repair object can be any distance from the vehicle. Repairing takes some time and will be interrupted if the vehicle starts to move.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''vehicle'' action ["repair", ''repairingObject'']
+
| style="width: 99%" | Causes an occupied vehicle to repair from any object with some repairCargo (generally an repair truck). The repair object can be any distance from the vehicle. Repairing takes some time and will be interrupted if the vehicle starts to move.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''vehicle'' is the occupied vehicle to be repaired, and ''repairingObject'' is the object from which to repair.
+
! Syntax
|-valign=top
+
| ''vehicle'' action ["repair", ''repairingObject'']
|'''Example''':              ||<code>tankOne [[action]] ["refuel", repairTruckOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''vehicle'' is the occupied vehicle to be repaired, and ''repairingObject'' is the object from which to repair.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>tankOne action ["repair", repairTruckOne];</sqf>
 
|}
 
|}
  
  
 
== ReturnFlag ==
 
== ReturnFlag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to return a flag from a nearby dead person back to it's flagpole. As of ArmA v1.12 this action is bugged and can not be used upon flags attached to destroyed vehicles.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["returnFlag", ''targetObject'']
+
| style="width: 99%" | Causes a person to return a flag from a nearby dead person back to it is flagpole. As of ArmA v1.12 this action is bugged and can not be used upon flags attached to destroyed vehicles.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any person, and ''targetObject'' is the dead person with a flag to be returned.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["returnFlag", ''targetObject'']
|'''Example''':              ||<code>soldierOne [[action]] ["returnFlag", westFlag];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any person, and ''targetObject'' is the dead person with a flag to be returned.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["returnFlag", westFlag];</sqf>
 
|}
 
|}
  
Line 967: Line 1,389:
 
== RepairVehicle ==
 
== RepairVehicle ==
  
'''OA only. Required version 1.54.'''
+
:{|
 
+
|- style="vertical-align: top"
:{|style="background:transparent"
+
! Description
|-valign=top
+
| style="width: 99%" | Causes an Engineer unit to repair an object using their Engineer Repair ability (from v1.54). The Engineer can be any distance from the vehicle. Repairing takes some time. If ''unit'' is not the Engineer class no repairs are made but the animation will still play.
|'''Description''':         ||Causes an Engineer unit to repair an object using their Engineer Repair ability (from v1.54). The Engineer can be any distance from the vehicle. Repairing takes some time. If ''unit'' is not the Engineer class no repairs are made but the animation will still play.
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|'''Syntax''':              ||''unit'' action ["repairVehicle", ''vehicle'']
+
| ''unit'' action ["repairVehicle", ''vehicle'']
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is an Engineer unit, and ''vehicle'' is the object to repair.
+
|
|-valign=top
+
| Where ''unit'' is an Engineer unit, and ''vehicle'' is the object to repair.
|'''Example''':              ||<code>engineerOne [[action]] ["repairVehicle", truckOne];</code>
+
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>engineerOne action ["repairVehicle", truckOne];</sqf>
 
|}
 
|}
  
  
 
== Salute ==
 
== Salute ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to salute. AI controlled units will only make a momentary salute, unless the AI is in safe or careless behaviour mode.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["salute", ''targetUnit'']
+
| style="width: 99%" | Causes a person to salute. AI controlled units will only make a momentary salute, unless the AI is in safe or careless behaviour mode.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person to make the salute.
+
! Syntax
|-valign=top
+
| ''unit'' action ["salute", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["salute", soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person to make the salute.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["salute", soldierOne];</sqf>
 
|}
 
|}
  
  
 
== ScudCancel ==
 
== ScudCancel ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["scudCancel", ''targetVehicle'']
+
| style="width: 99%" | There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Syntax unknown.
+
! Syntax
|-valign=top
+
| ''unit'' action ["scudCancel", ''targetVehicle'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
| Syntax unknown.
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== ScudLaunch ==
 
== ScudLaunch ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["scudLaunch", ''targetVehicle'']
+
| style="width: 99%" | There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Syntax unknown.
+
! Syntax
|-valign=top
+
| ''unit'' action ["scudLaunch", ''targetVehicle'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
| Syntax unknown.
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== ScudStart ==
 
== ScudStart ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':               ||''unit'' action ["scudStart", ''targetVehicle'']
+
| style="width: 99%" | There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Syntax unknown.
+
! Syntax
|-valign=top
+
| ''unit'' action ["scudStart", ''targetVehicle'']
|'''Example''':             ||
+
|- style="vertical-align: top"
 +
|
 +
| Syntax unknown.
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== SearchlightOff ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Turns off the searchlight in the WY-55 Hellcat. Only works on a unit sitting in the copilot seat, and only works with the Hellcat, no other vehicles have searchlights.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["SearchlightOff", ''vehicle'']
 +
|- style="vertical-align: top"
 +
! Example
 +
| hellcatCopilot action ["SearchlightOff", vehicle hellcatCopilot]
 +
|}
 +
 
 +
 
 +
== SearchlightOn ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Turns on the searchlight in the WY-55 Hellcat. Only works on a unit sitting in the copilot seat, and only works with the Hellcat, no other vehicles have searchlights.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["SearchlightOn", ''vehicle'']
 +
|- style="vertical-align: top"
 +
! Example
 +
| hellcatCopilot action ["SearchlightOn", vehicle hellcatCopilot]
 
|}
 
|}
  
  
 
== SetTimer ==
 
== SetTimer ==
:{|style="background:transparent"
 
|-valign=top
 
|'''Description''':          ||Soldier 'unitOne' plays the action animation. UnitTwo activates and adds thirty seconds to the timer for a satchel charge. Neither unit needs to be near the satchel.
 
Charge has to be places first using ''unitname [[Fire]] ["pipebombmuzzle", "pipebombmuzzle", "pipebomb"]'' command.
 
  
|-valign=top
+
:{|
|'''Syntax''':               ||''unitOne'' action ["SetTimer", ''unitTwo'', ''bombName'']
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|                           ||
+
| style="width: 99%" | Soldier 'unitOne' plays the action animation. UnitTwo activates and adds 40 seconds to the timer for a satchel charge. Neither unit needs to be near the satchel.
|-valign=top
+
Charge has to be placed first using ''unitname [[Fire]] ["pipebombmuzzle", "pipebombmuzzle", "pipebomb"]'' or [[createMine]] command.
|'''Example''':              ||
+
 
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unitOne'' action ["SetTimer", ''unitTwo'', ''bombName'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== SitDown ==
 
== SitDown ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Causes a person to sit down on the ground (or get up, if already sitting). AI controlled units will only stay seated if they are in safe or careless behaviour mode.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["sitDown", ''targetUnit'']
+
| style="width: 99%" | Causes a person to sit down on the ground (or get up, if already sitting). AI controlled units will only stay seated if they are in safe or careless behaviour mode.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person who is to sit down.
+
! Syntax
|-valign=top
+
| ''unit'' action ["sitDown", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["sitDown", soldierOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person who is to sit down.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["sitDown", soldierOne];</sqf>
 
|}
 
|}
 +
  
 
== StrokeFist ==
 
== StrokeFist ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Does nothing. There is no punch animation in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["strokeFist", ''targetVehicle'']
+
| style="width: 99%" | Does nothing. There is no punch animation in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Syntax unknown.
+
! Syntax
|-valign=top
+
| ''unit'' action ["strokeFist", ''targetVehicle'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
| Syntax unknown.
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== StrokeGun ==
 
== StrokeGun ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Does nothing (other than making a person twitch a little). There is no suitable animation for this action in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["strokeGun", ''targetVehicle'']
+
| style="width: 99%" | Does nothing (other than making a person twitch a little). There is no suitable animation for this action in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Syntax unknown.
+
! Syntax
|-valign=top
+
| ''unit'' action ["strokeGun", ''targetVehicle'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
| Syntax unknown.
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== Surrender ==
 
== Surrender ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Makes unit to put weapon on shoulder and put hands behind the head temporarily. For the lasting effect all weapons from the unit should be removed first.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["Surrender", ''targetUnit'']
+
| style="width: 99%" | Makes unit to put weapon on shoulder and put hands behind the head temporarily. For the lasting effect all weapons from the unit should be removed first.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''targetUnit'' is the unit to surrender.
+
! Syntax
|-valign=top
+
| ''unit'' action ["Surrender", ''targetUnit'']
|'''Example''':              ||<code>soldierOne [[action]] ["Surrender", soldierTwo];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''targetUnit'' is the unit to surrender.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>soldierOne action ["Surrender", soldierTwo];</sqf>
 
|}
 
|}
  
  
 
== SuspendVehicleControl ==
 
== SuspendVehicleControl ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Release vehicle controls from co-pilot. Control immediately returns to pilot.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["SuspendVehicleControl", ''vehicle'']
+
| style="width: 99%" | Release vehicle controls from co-pilot. Control immediately returns to pilot.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
+
! Syntax
|-valign=top
+
| ''unit'' action ["SuspendVehicleControl", ''vehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["SuspendVehicleControl", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["SuspendVehicleControl", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== SwitchMagazine ==
 
== SwitchMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Target unit switches to the given firing mode index. This allows selection of any firing mode for any weapon carried by a soldier, or mounted on a weapon. First are the firing modes for the primary weapon (index 0 upwards), then secondary weapon, then optics, then pistol, then thrown and placed weapons. Changing to NVGoggles just plays an animation, not actually setting NV mode. Unfortunately, the list of firing modes seems to only be created when a soldier is initiated; modes are removed from the list when a weapon is dropped and not re-added when a weapon is picked up. Thus, only use this during the initiation phase of the soldier. On vehicles, where the weapons are not likely to be changed, this action might be useful after the vehicle has been initiated.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|                           ||If the mode index is higher than available indices, it assumes index 0. If you just want to change the muzzle used, rather than the firing mode, the standard command [[selectWeapon]] is generally more useful.
+
| style="width: 99%" | Target unit switches to the given firing mode index. This allows selection of any firing mode for any weapon carried by a soldier, or mounted on a weapon. First are the firing modes for the primary weapon (index 0 upwards), then secondary weapon, then optics, then pistol, then thrown and placed weapons. Changing to NVGoggles just plays an animation, not actually setting NV mode. Unfortunately, the list of firing modes seems to only be created when a soldier is initiated; modes are removed from the list when a weapon is dropped and not re-added when a weapon is picked up. Thus, only use this during the initiation phase of the soldier. On vehicles, where the weapons are not likely to be changed, this action might be useful after the vehicle has been initiated.
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unit'' action ["SwitchMagazine", ''targetVehicle'', ''targetUnit'', ''mode index'']
+
|
|-valign=top
+
| If the mode index is higher than available indices, it assumes index 0. If you just want to change the muzzle used, rather than the firing mode, the standard command [[selectWeapon]] is generally more useful.
|                           ||
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|'''Example''':              ||<code>gameLogic [[action]] ["SwitchMagazine", unit1, unit1, 3];
+
| ''unit'' action ["SwitchMagazine", ''targetVehicle'', ''targetUnit'', ''mode index'']
gameLogic [[action]] ["SwitchMagazine", m1a1, [[gunner]] m1a1, 1];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>
 +
gameLogic action ["SwitchMagazine", unit1, unit1, 3];
 +
gameLogic action ["SwitchMagazine", m1a1, gunner m1a1, 1];
 +
</sqf>
 
|}
 
|}
  
  
 
== SwitchWeapon ==
 
== SwitchWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||UnitOne plays the action animation. Target unit switches to the given muzzle/mode index. Target unit can also be a vehicle. The weapons array is a list of all weapon modes specific to each weapon, muzzle and firing mode combination.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["SwitchWeapon", ''targetUnit'', ''targetUnit'', ''muzzle index'']
+
| style="width: 99%" | UnitOne plays the action animation. Target unit switches to the given muzzle/mode index. Target unit can also be a vehicle. The weapons array is a list of all weapon modes specific to each weapon, muzzle and firing mode combination.
|-valign=top
+
|- style="vertical-align: top"
|                            ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["SwitchWeapon", ''targetUnit'', ''targetUnit'', ''muzzle index'']
|'''Example''':
+
|- style="vertical-align: top"
|<code>unit2 [[action]] ["SwitchWeapon", unit1, unit1, 7];
 
[[player]] [[action]] ["SwitchWeapon", [[vehicle]] [[player]], [[vehicle]] [[player]], 3];</code>
 
|-valign=top
 
 
|
 
|
|<code>[[player]] [[action]] ["SwitchWeapon", [[player]], [[player]], weaponIndex];</code>  
+
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>
 +
unit2 action ["SwitchWeapon", unit1, unit1, 7];
 +
player action ["SwitchWeapon", player, player, 3]; // switching personal weapon
 +
player action ["SwitchWeapon", vehicle player, player, 3]; // switching vehicle weapon
 +
</sqf>
 +
|- style="vertical-align: top"
 +
|
 +
| <sqf>player action ["SwitchWeapon", player, player, weaponIndex];</sqf>
 
Result => weaponIndex: [[weaponState]] for "B_soldier_LAT_F"
 
Result => weaponIndex: [[weaponState]] for "B_soldier_LAT_F"
  
Line 1,175: Line 1,695:
 
  29: ["Put","ClassicMineWireMuzzle","ClassicMineWireMuzzle","",0]
 
  29: ["Put","ClassicMineWireMuzzle","ClassicMineWireMuzzle","",0]
 
|}
 
|}
 +
  
 
== SwitchToUAVDriver ==
 
== SwitchToUAVDriver ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Moves player control into driver position of connected UAV. Does what "Take UAV controls" UI action does.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["SwitchToUAVDriver", ''uav'']
+
| style="width: 99%" | Moves player control into driver position of connected UAV. Does what "Take UAV controls" UI action does.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a player and ''uav'' is the connected UAV.
+
! Syntax
|-valign=top
+
| ''unit'' action ["SwitchToUAVDriver", ''uav'']
|'''Example''':              ||<code>[[player]] [[action]] ["SwitchToUAVDriver", [[getConnectedUAV]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a player and ''uav'' is the connected UAV.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["SwitchToUAVDriver", getConnectedUAV player];</sqf>
 
|}
 
|}
  
  
 
== SwitchToUAVGunner ==
 
== SwitchToUAVGunner ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         || Moves player control into gunner position of connected UAV. Does what "Take UAV turret controls" UI action does.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["SwitchToUAVGunner", ''uav'']
+
| style="width: 99%" | Moves player control into gunner position of connected UAV. Does what "Take UAV turret controls" UI action does.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a player and ''uav'' is the connected UAV.
+
! Syntax
|-valign=top
+
| ''unit'' action ["SwitchToUAVGunner", ''uav'']
|'''Example''':              ||<code>[[player]] [[action]] ["SwitchToUAVGunner", [[getConnectedUAV]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a player and ''uav'' is the connected UAV.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["SwitchToUAVGunner", getConnectedUAV player];</sqf>
 
|}
 
|}
  
  
 
== TakeFlag ==
 
== TakeFlag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Soldier 'unitname' takes control of 'flag1'. He must be close to the flagpole and it must belong to an enemy side.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["TakeFlag", ''flag1'']
+
| style="width: 99%" | Soldier 'unitname' takes control of 'flag1'. He must be close to the flagpole and it must belong to an enemy side.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["TakeFlag", ''flag1'']
|'''Example''':              ||<code>[[player]] [[action]] ["TakeFlag", FlagOne];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TakeFlag", FlagOne];</sqf>
 
|}
 
|}
  
  
== TakeMagazine / TakeWeapon ==
+
== TakeMagazine ==
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         ||Soldier 'unitname' takes one magazine/weapon of specified type ([[:Category: Weapons|see list]]) from the ground (Weaponholder) or from named vehicle (ammo box, car, etc.) Transfer happens immediately and via teleportation. Unit1 plays pickup animation at its current position, no matter where 'weapon or magazine' is.
+
! Description
|-valign=top
+
| style="width: 99%" | Soldier 'unit' takes one magazine of specified type from the ground (Weaponholder) or from named vehicle (ammo box, car, etc.) Transfer happens immediately and via teleportation. Unit plays pickup animation at its current position, no matter where magazine is. Since Arma 3 v2.06.147667 optional param 'forcePutInBackpack' is added allowing to store picked up magazine in backpack. By default the magazine will go to any unit container with space, starting with uniform.
|'''Syntax''':              ||''unit'' action ["TakeMagazine", ''vehicle'', ''magazineName'']
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                            ||''unit'' action ["TakeWeapon", ''vehicle'', ''weaponName'']
+
| ''unit'' action ["TakeMagazine", ''weaponholder'', ''magazineName'', (''forcePutInBackpack'')]
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''vehicle'' is any unit or vehicle.
+
|
|-valign=top
+
| Where ''unit'' is any unit, and ''weaponholder'' is storage container.
|'''Example''':             ||<code>[[player]] [[action]] ["TakeMagazine", SoldierTwo, "RPGLauncher"];</code>
+
|- style="vertical-align: top"
 +
! Example1
 +
| <sqf>player action ["TakeMagazine", ammoBox, "RPGLauncher"];</sqf>
 +
|- style="vertical-align: top"
 +
! Example2
 +
| Drop Magazine, then make your buddy Bob come and take magazine and put it in backpack:
 +
<sqf>
 +
0 spawn
 +
{
 +
private _wh = "Weapon_Empty" createVehicle (player getRelPos [2, 0]);
 +
_mag = [[currentMagazine]] [[player]];
 +
[[player]] [[action]] ["PutMagazine", _wh, _mag];
 +
_bob = [[group]] [[player]] [[createUnit]] ["B_Soldier_F", [[player]] [[getRelPos]] [10, 0], [], 0, "NONE"];
 +
_bob [[addBackpack]] "B_AssaultPack_blk";
 +
_bob [[doMove]] [[position]] _wh;
 +
[[waitUntil]] { [[unitReady]] _bob };
 +
_bob [[action]] ["TakeMagazine", _wh, _mag, [[true]]];
 +
};</code>
 
|}
 
|}
  
 +
== TakeWeapon ==
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Soldier 'unitname' takes weapon of specified type ([[:Category: Weapons|see list]]) from the ground (Weaponholder) or from named vehicle (ammo box, car, etc.) Transfer happens immediately and via teleportation. Unit1 plays pickup animation at its current position, no matter where weapon is.
 +
|- style="vertical-align: top"
 +
|
 +
| ''unit'' action ["TakeWeapon", ''vehicle'', ''weaponName'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''vehicle'' is any unit or vehicle.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TakeWeapon", SoldierTwo, currentWeapon player];</sqf>
 +
|}
  
 
== TakeMine ==
 
== TakeMine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Unit will perform pick up action animation. The closest mine that is within two meters of the target unit will be placed into the target unit's inventory. The mine has to be active for this action to succeed. If there is not enough room in the target inventory, the mine will still be picked up but will not appear in inventory.  
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["TakeMine", ''targetUnit'']
+
| style="width: 99%" | Unit will perform pick up action animation. The closest mine that is within two meters of the target unit will be placed into the target unit's inventory. The mine has to be active for this action to succeed. If there is not enough room in the target inventory, the mine will still be picked up but will not appear in inventory. See [[createMine]] for how to place explosive by script.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["TakeMine", ''targetUnit'']
|'''Example''':              ||<code>[[player]] [[action]] ["TakeMine", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TakeMine", player];</sqf>
 
|}
 
|}
  
  
 
== TakeVehicleControl ==
 
== TakeVehicleControl ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||In case of a helicopter, copilot will take flying controls, even if [[enableCopilot]] is disabled and [[isCopilotEnabled]] is [[false]].
+
|- style="vertical-align: top"
|                            ||Use [[Arma_3:_Actions#SuspendVehicleControl|SuspendVehicleControl]] action to release control.
+
! Description
|-valign=top
+
| style="width: 99%" | In case of a helicopter, copilot will take flying controls, even if [[enableCopilot]] is disabled and [[isCopilotEnabled]] is [[false]].
|'''Syntax''':              ||''unit'' action ["TakeVehicleControl", ''vehicle'']
+
| Use [[Arma_3:_Actions#SuspendVehicleControl|SuspendVehicleControl]] action to release control.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
+
! Syntax
|-valign=top
+
| ''unit'' action ["TakeVehicleControl", ''vehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["TakeVehicleControl", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TakeVehicleControl", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== Talk ==
 
== Talk ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Use and effects unknown.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["Talk", ''target'']
+
| style="width: 99%" | Use and effects unknown.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["Talk", ''target'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== TeamSwitch ==
 
== TeamSwitch ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Opens the normal team-switch dialog. <current unit> will be greyed out in the list and thus unselectable. The effect of the second array element is unknown, but it must be a unit. Works in single-player game only (in MP games, will just momentarily show the mouse cursor without the team-switch window being shown).
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''currentUnit'' action ["TeamSwitch", ''unit'']
+
| style="width: 99%" | Opens the normal team-switch dialog. <current unit> will be greyed out in the list and thus unselectable.
|-valign=top
+
The effect of the second array element is unknown, but it must be a unit.
|                           ||
+
Works in single-player game only (in MP games, will just momentarily show the mouse cursor without the team-switch window being shown).
|-valign=top
+
|- style="vertical-align: top"
|'''Example''':              ||<code>[[player]] [[action]] ["TeamSwitch", [[player]]];</code>
+
! Syntax
 +
| ''currentUnit'' action ["TeamSwitch", ''unit'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TeamSwitch", player];</sqf>
 
|}
 
|}
  
  
 
== TouchOff ==
 
== TouchOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Soldier 'unitOne' plays the action animation. UnitTwo's satchels are "touched off". UnitTwo must be within range (300m) of his satchels to touch them off.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unitOne'' action ["TouchOff", ''unitTwo'']
+
| style="width: 99%" | Soldier 'unitOne' plays the action animation. UnitTwo's satchels are "touched off".
|-valign=top
+
UnitTwo must be within range (300m) of his satchels to touch them off. See [[createMine]] for how to place explosives with script.
|                           ||
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|'''Example''':              ||<code>[[player]] [[action]] ["TouchOff", [[player]]];</code>
+
| ''unitOne'' action ["TouchOff", ''unitTwo'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["TouchOff", player];</sqf>
 
|}
 
|}
  
  
 
== TurnIn / TurnOut ==
 
== TurnIn / TurnOut ==
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         ||Crew of 'vehiclename' turns in/out (gets in and out of hatches). UnitName must be a player in effective commander of vehicleName. AI will automatically turn in/out based on their current behaviour mode. Only to be used on positions that have the turnIn/turnOut capability (otherwise it breaks the cargo anim.).
+
! Description
|-valign=top
+
| style="width: 99%" | Crew of 'vehiclename' turns in/out (gets in and out of hatches).
|'''Syntax''':              ||''unit'' action ["TurnIn", ''vehicle'']
+
UnitName must be a player in effective commander of vehicleName. AI will automatically turn in/out based on their current behaviour mode.
|-valign=top
+
Only to be used on positions that have the turnIn/turnOut capability (otherwise it breaks the cargo anim).
|                           ||''unit'' action ["TurnOut", ''vehicle'']
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                           ||
+
| ''unit'' action ["TurnIn", ''vehicle'']
|-valign=top
+
|- style="vertical-align: top"
|'''Example''':              ||<code>TankOne [[action]] ["TurnIn", TankOne];
+
|
[[player]] [[action]] ["TurnOut", [[vehicle]] [[player]]];</code>
+
| ''unit'' action ["TurnOut", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>TankOne action ["TurnIn", TankOne];
 +
player action ["TurnOut", vehicle player];</sqf>
 +
|}
 +
 
 +
 
 +
== UAVTerminalHackConnection ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Hacks into given UAV. Does what "Hack UAV" UI action does.
 +
 
 +
'''NOTE''': Player has to be in normal UI action proximity to the UAV for this action to work.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["UAVTerminalHackConnection", ''uav'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit (enemy to the drone) and ''uav'' is the UAV to hack.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["UAVTerminalHackConnection", drone];</sqf>
 
|}
 
|}
  
  
 
== UAVTerminalMakeConnection ==
 
== UAVTerminalMakeConnection ==
:{|style="background:transparent"
 
|-valign=top
 
|'''Description''':          ||Connects player to chosen UAV. Does what "Connect terminal to UAV" UI action does.
 
  
'''NOTE''': Player has to be in normal UI action proximity to the UAV for this action to work. To connect to far away UAV use [[connectTerminalToUAV]] command instead.
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unit'' action ["UAVTerminalMakeConnection", ''uav'']
+
! Description
|-valign=top
+
| style="width: 99%" | Connects player to chosen UAV. Does what "Connect terminal to UAV" UI action does.
|                           ||Where ''unit'' is a player and ''uav'' is UAV to be connected to.
+
 
|-valign=top
+
'''NOTE''': Player has to be in normal UI action proximity to the UAV for this action to work.
|'''Example''':              ||<code>[[player]] [[action]] ["UAVTerminalMakeConnection", [[allUnitsUAV]] [[select]] 0];</code>
+
To connect to far away UAV use connectTerminalToUAV command instead.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["UAVTerminalMakeConnection", ''uav'']
 +
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a player and ''uav'' is UAV to be connected to.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["UAVTerminalMakeConnection", allUnitsUAV select 0];</sqf>
 
|}
 
|}
  
  
 
== UAVTerminalOpen ==
 
== UAVTerminalOpen ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Opens UAV Terminal UI. Player must have UAV Terminal item in GPS slot of inventory. Does what "Open UAV Terminal" UI action does.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["UAVTerminalOpen", ''unit'']
+
| style="width: 99%" | Opens UAV Terminal UI. Player must have UAV Terminal item in GPS slot of inventory. Does what "Open UAV Terminal" UI action does.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is a player.  
+
! Syntax
|-valign=top
+
| ''unit'' action ["UAVTerminalOpen", ''unit'']
|'''Example''':              ||<code>[[player]] [[action]] ["UAVTerminalOpen", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is a player.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["UAVTerminalOpen", player];</sqf>
 
|}
 
|}
  
  
 
== UAVTerminalReleaseConnection ==
 
== UAVTerminalReleaseConnection ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Disconnects player from connected UAV. Does what "Disconnect terminal from UAV" UI action does.
+
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Disconnects player from connected UAV. Does what "Disconnect terminal from UAV" UI action does.
  
 
'''NOTE''': Unlike with "UAVTerminalMakeConnection", player can be far away from the UAV. Notice how the passed params are swapped around for this action.
 
'''NOTE''': Unlike with "UAVTerminalMakeConnection", player can be far away from the UAV. Notice how the passed params are swapped around for this action.
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''uav'' action ["UAVTerminalReleaseConnection", ''unit'']
+
! Syntax
|-valign=top
+
| ''uav'' action ["UAVTerminalReleaseConnection", ''unit'']
|                           ||Where ''uav'' is the connected UAV and ''unit'' is the player controlling it.
+
|- style="vertical-align: top"
|-valign=top
+
|
|'''Example''':              ||<code>[[getConnectedUAV]] [[player]] [[action]] ["UAVTerminalReleaseConnection", [[player]]];</code>
+
| Where ''uav'' is the connected UAV and ''unit'' is the player controlling it.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>getConnectedUAV player action ["UAVTerminalReleaseConnection", player];</sqf>
 
|}
 
|}
  
  
 
== UnlockVehicleControl ==
 
== UnlockVehicleControl ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Unlocks co-pilot controls, shows [[Arma_3:_Actions#TakeVehicleControl|Take Control]] action. [[enableCopilot]] must be set true to function.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["UnlockVehicleControl", ''vehicle'']
+
| style="width: 99%" | Unlocks co-pilot controls, shows Arma_3:_Actions#TakeVehicleControl|Take Control action. enableCopilot must be set true to function.
|-valign=top
+
|- style="vertical-align: top"
|                           ||Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
+
! Syntax
|-valign=top
+
| ''unit'' action ["UnlockVehicleControl", ''vehicle'']
|'''Example''':              ||<code>[[player]] [[action]] ["UnlockVehicleControl", [[vehicle]] [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
| Where ''unit'' is any unit, and ''vehicle'' is any vehicle with co-pilot controls.
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["UnlockVehicleControl", vehicle player];</sqf>
 
|}
 
|}
  
  
 
== UseMagazine ==
 
== UseMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Loads a weapon with magazine with known id and fires that weapon. The weapon is selected based on magazine type. Details for <cr> and <id> can be found with [[magazinesDetail]] command (not 100% about <cr> but it seems 0 works for all weapons)
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''LOGIC'' action ["UseMagazine", ''target'', ''magazine creator'', ''<cr>'', ''<id>'']
+
| style="width: 99%" | Loads a weapon with magazine with known id and fires that weapon. The weapon is selected based on magazine type. Details for <cr> and <id> can be found with magazinesDetail command (not 100% about <cr> but it seems 0 works for all weapons)
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''LOGIC'' action ["UseMagazine", ''target'', ''magazine creator'', ''<cr>'', ''<id>'']
|'''Example''':              ||
+
|- style="vertical-align: top"
<code>_logic = [[createGroup]] [[west]] [[createUnit]] ["Logic", [0,0,0], [], 0, "NONE"];
+
|
[[hint]] [[str]] [[magazinesDetail]] [[player]]; //loaded mags not shown
+
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
<sqf>
 +
private _logic = createGroup west createUnit ["Logic", [0,0,0], [], 0, "NONE"];
 +
hint str magazinesDetail player; // loaded mags not shown
 
/*[
 
/*[
"6.5mm 30Rnd STANAG Mag(30/30)[id/cr:3/0]",
+
"6.5mm 30Rnd STANAG Mag(30/30)[id/cr:3/0]",
"Smoke Round (White)(1/1)[id/cr:121/0]",
+
"Smoke Round (White)(1/1)[id/cr:121/0]",
"Smoke Round (White)(1/1)[id/cr:122/0]",
+
"Smoke Round (White)(1/1)[id/cr:122/0]",
"9mm 16Rnd Mag(16/16)[id/cr:11/0]"
+
"9mm 16Rnd Mag(16/16)[id/cr:11/0]"
 
]*/
 
]*/
_logic [[action]] ["UseMagazine", [[player]], [[player]], 0, 3]; //loads rifle with mag id 3 and fires
+
_logic action ["UseMagazine", player, player, 0, 3]; // loads rifle with mag id 3 and fires
_logic [[action]] ["UseMagazine", [[player]], [[player]], 0, 11]; //loads pistol with mag id 11 and fires from inventory
+
_logic action ["UseMagazine", player, player, 0, 11]; // loads pistol with mag id 11 and fires from inventory
_logic [[action]] ["UseMagazine", [[player]], [[player]], 0, 121]; //throws smoke grenade with id 121</code>
+
_logic action ["UseMagazine", player, player, 0, 121]; // throws smoke grenade with id 121
 +
</sqf>
 
|}
 
|}
  
  
 
== User ==
 
== User ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Soldier 'unitName' does nothing. Executes the custom action with the given index of the the target unit. Indexes are based upon the order in which the actions are added to the unit. See [[addAction]].
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unitName'' action ["User", ''target unit'', ''action index'']
+
| style="width: 99%" | Soldier 'unitName' does nothing. Executes the custom action with the given index of the the target unit. Indexes are based upon the order in which the actions are added to the unit. See addAction.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unitName'' action ["User", ''target unit'', ''action index'']
|'''Example''':              ||<code>gameLogic [[action]] ["User", [[player]], 3];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>gameLogic action ["User", player, 3];</sqf>
 
|}
 
|}
  
  
 
== UserType ==
 
== UserType ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||As of ArmA version 1.08, using this action type will cause ArmA to crash to desktop.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||''unit'' action ["UserType", ''target'', ''action index'']
+
| style="width: 99%" | As of ArmA version 1.08, using this action type will cause ArmA to crash to desktop.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| ''unit'' action ["UserType", ''target'', ''action index'']
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== UseWeapon ==
 
== UseWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Soldier 'unitOne' will play the action animation. Target unit will fire the specified unit's position in the target vehicle's (can be the unit itself) weapon mode index. The indexes seem to be based upon the order in which weapons are added to the unit/vehicle, with each weapon's muzzle's fire mode having an unique index. Weapons can be fired in this way from a not-readied position (eg, firing a rifle on a soldiers back). Pistols will fire from the current weapon's proxy. It can also be used to sound the horn on AI controlled vehicles.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|                           ||'''NOTE:''' If 'unitOne' is [[player]] object, the player goes into pick up animation before action is performed. If 'unitOne' is a game logic, the action is performed immediately with no animation.
+
| style="width: 99%" | Soldier 'unitOne' will play the action animation. Target unit will fire the specified unit's position in the target vehicle's (can be the unit itself) weapon mode index. The indexes seem to be based upon the order in which weapons are added to the unit/vehicle, with each weapon's muzzle's fire mode having an unique index. Weapons can be fired in this way from a not-readied position (eg, firing a rifle on a soldiers back). Pistols will fire from the current weapon's proxy. It can also be used to sound the horn on AI controlled vehicles.
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':              ||''unitOne'' action ["UseWeapon", ''target vehicle'', ''target unit'', ''weapon index'']
+
|
|-valign=top
+
| '''NOTE:''' If 'unitOne' is player object, the player goes into pick up animation before action is performed. If 'unitOne' is a game logic, the action is performed immediately with no animation.
|                           ||
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|'''Example''':              ||
+
| ''unitOne'' action ["UseWeapon", ''target vehicle'', ''target unit'', ''weapon index'']
<code>_logic = [[createGroup]] [[west]] [[createUnit]] ["Logic", [0,0,0], [], 0, "NONE"];
+
|- style="vertical-align: top"
_logic [[action]] ["useWeapon", [[player]], [[player]], 0]; //player fires single shot
+
|
_logic [[action]] ["useWeapon", [[player]], [[player]], 2]; //player fires 3 round burst
+
|
_logic [[action]] ["useWeapon", [[player]], [[player]], 5]; //player fires pistol from inventory
+
|- style="vertical-align: top"
_logic [[action]] ["useWeapon", [[player]], [[player]], 7]; //player throws hand grenade
+
! Example
_logic [[action]] ["useWeapon", car, car, 0]; //car sounds its horn
+
| <sqf>
//more examples
+
_logic = createGroup west createUnit ["Logic", [0,0,0], [], 0, "NONE"];
gameLogic [[action]] ["useWeapon", unit1, unit1,16];
+
_logic action ["useWeapon", player, player, 0]; // player fires single shot
gameLogic [[action]] ["useWeapon", [[vehicle]] unit1, unit1, 0];
+
_logic action ["useWeapon", player, player, 2]; // player fires 3 round burst
gameLogic [[action]] ["useWeapon", myTank, [[gunner]] myTank, 1];
+
_logic action ["useWeapon", player, player, 5]; // player fires pistol from inventory
gameLogic [[action]] ["useWeapon", myTank, [[commander]] myTank, 0];</code>
+
_logic action ["useWeapon", player, player, 7]; // player throws hand grenade
 +
_logic action ["useWeapon", car, car, 0]; // car sounds its horn
 +
// more examples
 +
gameLogic action ["useWeapon", unit1, unit1, 16];
 +
gameLogic action ["useWeapon", vehicle unit1, unit1, 0];
 +
gameLogic action ["useWeapon", myTank, gunner myTank, 1];
 +
gameLogic action ["useWeapon", myTank, commander myTank, 0];
 +
</sqf>
 +
|}
 +
 
 +
 
 +
== VectoringDown ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | If VTOL auto-vectoring is off, incremental forward tilt of engine nacelles.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["VectoringDown", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== VectoringUp ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | If VTOL auto-vectoring is off, incremental upward tilt of engine nacelles.
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["VectoringUp", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== VTOLVectoring ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Toggles '''off''' VTOL auto-vectoring (manual mode)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["VTOLVectoring", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== VTOLVectoringCancel ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Toggles '''on''' VTOL auto-vectoring (forward mode)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["VTOLVectoringCancel", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== WeaponInHand / WeaponOnBack ==
 
== WeaponInHand / WeaponOnBack ==
:{|style="background:transparent"
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Description''':         ||Soldier 'unitName' does nothing, 'target unit' moves his weapon from/to the safety position (gun held across chest pointing at the ground).  
+
! Description
Change is persistent with player, but AI units will change back to suit their current [[setBehaviour|behaviour mode]]. AI generally keep their rifles safe unless moving or targeting.<br>
+
| style="width: 99%" | Soldier 'unitName' does nothing, 'target unit' moves his weapon from/to the safety position (gun held across chest pointing at the ground).
(''VBS2 calls this action "PutWeaponOnBack"'')
+
Change is persistent with player, but AI units will change back to suit their current setBehaviour|behaviour mode. AI generally keep their rifles safe unless moving or targeting.
|-valign=top
+
<!-- (''VBS2 calls this action "PutWeaponOnBack"'') -->
|'''Syntax''':              ||''unitName'' action ["WeaponInHand", ''target unit'']
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|                           ||''unitName'' action ["WeaponOnBack", ''target unit'']
+
| ''unitName'' action ["WeaponInHand", ''target unit'']
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
|
|-valign=top
+
| ''unitName'' action ["WeaponOnBack", ''target unit'']
|'''Example''':              ||<code>SoldierOne [[action]] ["WeaponOnBack", SoldierTwo]</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>SoldierOne action ["WeaponOnBack", SoldierTwo];</sqf>
 
|}
 
|}
  
 +
 +
== WheelsBrakeOn ==
 +
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Engages wheels brakes on RTM helicopter
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["WheelsBrakeOn", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["WheelsBrakeOn", heli];</sqf>
 +
|}
 +
 +
 +
== WheelsBrakeOff ==
 +
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | Disengages wheels brakes on RTM helicopter
 +
|- style="vertical-align: top"
 +
! Syntax
 +
| ''unit'' action ["WheelsBrakeOff", ''vehicle'']
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["WheelsBrakeOff", heli];</sqf>
 +
|}
  
  
Line 1,466: Line 2,246:
  
 
== LoadOtherMagazine ==
 
== LoadOtherMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== LoadEmptyMagazine ==
 
== LoadEmptyMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== PutWeapon ==
 
== PutWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||is synonym for DropWeapon (same syntax)?
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
| style="width: 99%" | Is alias of DropWeapon
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>_wh = "GroundWeaponHolder_Scripted" createVehicle position player;
 +
player action ["PutWeapon", _wh, currentWeapon player];</sqf>
 
|}
 
|}
  
  
 
== PutMagazine ==
 
== PutMagazine ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||is synonym for DropMagazine (same syntax)?
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
| style="width: 99%" | is synonym for DropMagazine (same syntax)?
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== StartTimer ==
 
== StartTimer ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||is synonym for SetTimer (same syntax) ?
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
| style="width: 99%" | is synonym for SetTimer (same syntax) ?
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== HideWeapon ==
 
== HideWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||unit action ["hideWeapon",<object>,<object>,<Number>]
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| unit action ["hideWeapon",<object>,<object>,<Number>]
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== MarkWeapon ==
 
== MarkWeapon ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
| style="width: 99%" | Something to do with campaign. Campaign param "WeaponPool" has to be enabled as well as mission param "MarkWeapons". Possibly related to "MarkEntity" action as well.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== HandGunOffStand ==
 
== HandGunOffStand ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
 +
  
 
== HandGunOnStand ==
 
== HandGunOnStand ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
== TakeDropMagazine/TakeDropWeapon ==
+
 
:{|style="background:transparent"
+
== TakeDropMagazine ==
|-valign=top
+
 
|'''Description''':         ||
+
:{|
|-valign=top
+
|- style="vertical-align: top"
|'''Syntax''':               ||
+
| '''Description''': Redundant even if works, use [[Arma_3:_Actions#TakeMagazine | TakeMagazine]]
|-valign=top
+
|
|                           ||
+
|- style="vertical-align: top"
|-valign=top
+
! Syntax
|'''Example''':             ||
+
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
== TakeDropWeapon ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
 
== Assemble ==
 
== Assemble ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||OA only.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||<code>_unit [[action]] ["Assemble", (nearestObject [_unit, "Tripod_Bag"])];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>_unit action ["Assemble", (nearestObject [_unit, "Tripod_Bag"])];</sqf>
 
|}
 
|}
  
  
 
== FirstAid ==
 
== FirstAid ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== GetOver ==
 
== GetOver ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
  
 
== GunLightOff ==
 
== GunLightOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||<code>[[player]] [[action]] ["GunLightOff", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["GunLightOff", player];</sqf>
 
|}
 
|}
  
  
 
== GunLightOn ==
 
== GunLightOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||<code>[[player]] [[action]] ["GunLightOn", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["GunLightOn", player];</sqf>
 
|}
 
|}
  
  
 
== IRLaserOff ==
 
== IRLaserOff ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||<code>[[player]] [[action]] ["IRLaserOff", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["IRLaserOff", player];</sqf>
 
|}
 
|}
  
  
 
== IRLaserOn ==
 
== IRLaserOn ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||<code>[[player]] [[action]] ["IRLaserOn", [[player]]];</code>
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| <sqf>player action ["IRLaserOn", player];</sqf>
 
|}
 
|}
  
  
 
== OpenBag ==
 
== OpenBag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Opens inventory UI with backpack of a unit (another unit). Unit must be in proximity.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||unit1 action ["OpenBag", unit2];
+
| style="width: 99%" | Opens inventory UI with backpack of a unit (another unit). Unit must be in proximity.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| unit1 action ["OpenBag", unit2];
|'''Example''':              ||player action ["OpenBag", bob];
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
| player action ["OpenBag", bob];
 
|}
 
|}
 +
  
 
== TakeBag ==
 
== TakeBag ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':         ||Unit takes specified backpack from the ground.
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||_unit action ["TakeBag", _bag];
+
| style="width: 99%" | Unit takes specified backpack from the ground.
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
| _unit action ["TakeBag", _bag];
|'''Example''':              ||
+
|- style="vertical-align: top"
<code>player addEventHandler ["WeaponDisassembled",
+
|
{
+
|
_this spawn
+
|- style="vertical-align: top"
{
+
! Example
_unit = _this select 0;
+
|
_bag1 = _this select 1;
+
[[player]] [[addEventHandler]] ["WeaponDisassembled",
_bag2 = _this select 2;<br/>
+
{
_currBag = unitBackpack _unit;<br/>
+
_this [[spawn]] {
titleText ["You are not allowed to disassemble static weapons.", "PLAIN DOWN", 0.5];<br/>
+
_unit = _this [[select]] 0;
_unit action ["TakeBag", _bag1];<br/>
+
_bag1 = _this [[select]] 1;
_time = time;
+
_bag2 = _this [[select]] 2;
waitUntil {unitBackpack _unit == _bag1 || time - _time > 3};<br/>
+
_unit action ["Assemble", _bag2];<br/>
+
_currBag = [[unitBackpack]] _unit;
if (!isNull _currBag) then { _unit action ["TakeBag", _currBag] };
+
[[titleText]] ["You are not allowed to disassemble static weapons.", "PLAIN DOWN", 0.5];
};
+
_unit [[action]] ["TakeBag", _bag1];
}];</code>
+
 +
_time = [[time]] + 3;
 +
[[waitUntil]] { [[unitBackpack]] _unit == _bag1 || [[time]] > _time };
 +
 +
_unit [[action]] ["Assemble", _bag2];
 +
[[if]] (![[isNull]] _currBag) [[then]] { _unit [[action]] ["TakeBag", _currBag] };
 +
};
 +
}];
 
|}
 
|}
 +
  
 
== Tell ==
 
== Tell ==
:{|style="background:transparent"
+
 
|-valign=top
+
:{|
|'''Description''':          ||
+
|- style="vertical-align: top"
|-valign=top
+
! Description
|'''Syntax''':              ||
+
|
|-valign=top
+
|- style="vertical-align: top"
|                           ||
+
! Syntax
|-valign=top
+
|
|'''Example''':              ||
+
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 
|}
 
|}
  
[[Category: Arma 3: Editing|Actions]]
+
 
[[Category: Actions]]
+
== APUOn ==
[[Category: Scripting Topics]]
+
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== APUOff ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== BatteriesOn ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== BatteriesOff ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== StarterOn<#> ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | StarterOn(1-3)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== StarterOff<#> ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | StarterOff(1-3)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ThrottleFull<#> ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | ThrottleFull(1-3)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ThrottleIdle<#> ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | ThrottleIdle(1-3)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ThrottleOff<#> ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
| style="width: 99%" | ThrottleOff(1-3)
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== RotorBrakeOn ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== RotorBrakeOff ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== AIAssemble ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ListLeftVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ListRightVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ListPrevLeftVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== ListPrevRightVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== CloseLeftVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== CloseRightVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== NextModeLeftVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== NextModeRightVehicleDisplay ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== UnloadUnconsciousUnits ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== HookCargo ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== UnhookCargo ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== LoadVehicle ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== UnloadVehicle ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
== UnloadAllVehicles ==
 +
 
 +
:{|
 +
|- style="vertical-align: top"
 +
! Description
 +
|
 +
|- style="vertical-align: top"
 +
! Syntax
 +
|
 +
|- style="vertical-align: top"
 +
|
 +
|
 +
|- style="vertical-align: top"
 +
! Example
 +
|
 +
|}
 +
 
 +
 
 +
[[Category:Actions]]

Latest revision as of 23:40, 28 June 2022

Contents

General Syntax

unit action ["actionType", parameter(s)]
unit: Object. Can be any occupied vehicle or person that is not in a vehicle or also a Game Logic.
"actionType": String. Name of the action, found in the CfgActions class. Not case sensitive.
parameter(s): Various data types, dependant on the action used. The number of required parameters depends on the action type.


Actions

ActiveSensorsOn

Description Activates the vehicle's active sensor (radar).
Syntax unit action ["ActiveSensorsOn", vehicle]
Example
player action ["ActiveSensorsOn", vehicle player];


ActiveSensorsOff

Description Deactivates the vehicle's active sensor (radar).
Syntax unit action ["ActiveSensorsOff", vehicle]
Example
player action ["ActiveSensorsOff", vehicle player];


AddBag

Description Causes a unit to take backpack from another unit/vehicle or weaponholder.
Syntax targetUnit action ["AddBag", sourceUnit, "backpackName"]
Where targetUnit is the person to recieve a backpack (the action animation will be performed), sourceUnit is either another unit/vehicle or weaponholder containing the backpack. "backpackName" is the classname (string) of the backpack to be picked up.
Note Bags can be picked up at any distance. To drop bag use "DropBag" action. If several backpacks of the same class name exist in the container, the oldest will be added first.
Examples
soldierOne action ["AddBag", soldierTwo, backpack soldierTwo];

player action ["AddBag", car, typeOf firstBackpack car];
Swap player bag with parachute:
player action ["DropBag", _plane, backpack player]; player action ["AddBag", _plane, "B_Parachute"];


ArtilleryComputer

Description Opens up Artillery Computer display just like the one in action menu for a mortar. Unit has to be in gunner position or display will immediately close.
Syntax unit action ["ArtilleryComputer", artillery]
Where unit is any unit, and artillery is the artillery weapon
Example
soldierOne action ["ArtilleryComputer", mortarOne];


AutoHover

Description Toggles auto-hovering on. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
Syntax unit action ["autoHover", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is any vehicle that is capable of hovering.
Example
chopperOne action ["autoHover", chopperOne];


AutoHoverCancel

Description Toggles auto-hovering off. Note that while the auto-hover status can be toggled on an AI crewed or even an empty vehicle, it will only affect a vehicle controlled by a human pilot.
Syntax unit action ["autoHoverCancel", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is any vehicle that is capable of hovering.
Example
chopperOne action ["autoHoverCancel", chopperOne];


BackFromUAV

Description Moves player control back from driver/gunner position of connected UAV. Does what "Release UAV controls" UI action does.
Syntax uav action ["BackFromUAV", unit]
Where uav is the connected UAV and unit is the player controlling it.
Example


CancelAction

Description Cancels an action in progress. The target unit will complete it is current animation, although the action itself will not be performed.
Syntax unit action ["cancelAction", targetUnit]
Where unit is any unit (no action animation is performed) and targetUnit is any unit that is in the process of performing an action.
Example
soldierOne action ["CancelAction", soldierOne];


CancelLand

Description Cancels autopilot landing for an aircraft, including AI controlled aircraft.
Syntax unit action ["cancelLand", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is any vehicle that is currently performing an autopilot landing.
Example
planeOne action ["cancelLand", planeOne];


CancelTakeFlag

Description Cancels taking of a flag. The unit will complete the taking/action animation, but the flag will remain attached to it is current object. This action needs to be executed while the flag is being taken (which happens after the unit completes the taking/action animation) to prevent a unit taking the flag. For example, if a person is taking a flag from a flagpole, then the cancelTakeFlag action should be executed while the flag is descending the flagpole.
Syntax unit action ["cancelTakeFlag", targetFlag]
Where unit is any unit that is currently taking a flag (no action animation is performed) and targetFlag' is a flag object.
Example
westSoldierOne action ["cancelTakeFlag", eastFlag];


CollisionLightOff

Description Turns off the collision lights of an air vehicle.
Syntax unit action ["CollisionLightOff", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle with lights.
Example
player action ["CollisionLightOff", vehicle player];


CollisionLightOn

Description Turns on the collision lights of an air vehicle.
Syntax unit action ["CollisionLightOn", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle with lights.
Example
player action ["CollisionLightOn", vehicle player];


Deactivate

Description Causes a unit to deactivate and take a active satchel charge placed by any unit. This action can be performed upon a satchel object from any distance.

This action also works for landmines created with createVehicle command:

mine = "ATMine_Range_Ammo" createVehicle getPosATL player; // create player action ["Deactivate", player, mine]; // deactivate

Syntax unit action ["deactivate", targetUnit, targetObject]
Where unit is any unit (they will perform the action animation as if deactivating a satchel charge). targetUnit will have the deactivated satchel charge added to it is inventory. targetObject is the armed satchel object to be deactivated (class "pipeBomb" or "timeBomb").
Examples
soldierOne action ["deactivate", soldierOne, mySatchelCharge];
soldierOne action ["deactivate", soldierOne, nearestObject [soldierOne, "pipeBomb"]];


DeactivateMine

Description Causes a unit to deactivate any armed landmine that is within about two meters of a unit. Neither unit requires the ability to disable landmines.

NOTE: This action works only with mines that have been spotted by player (marked with triangle). Use "Deactivate" if you need to deactivate any mine.

Syntax unit action ["deactivateMine", targetUnit]
Where unit is any unit, who will perform the action animation. The closest landmine to targetUnit will be deactivated.
Example
soldierOne action ["deactivateMine", soldierOne];


Diary

Description Use and effects unknown.
Syntax unit action ["diary", <target>]
Example


Disassemble

Description Takes assembled weapon to parts (carry bags). Assembled weapon object reference may need to be kept for assembly. See also: enableWeaponDisassembly
Syntax unit action ["Disassemble", weapon]
Where unit is any unit and weapon is assembled weapon
Example
soldierOne action ["Disassemble", mortarOne];


DropBag

Description Causes a unit to drop a backpack into another unit/vehicle. To drop backpack on the ground, a weaponholder object needs to be created first.
Syntax sourceUnit action ["DropBag", targetUnit, "backpackName"]
Where sourceUnit is the person to drop a backpack (the action animation will be performed), targetUnit is either another unit/vehicle into which the backpack will be dropped or a weaponholder. "backpackName" is the classname (string) of the backpack to be dropped.
Note Bags can be dropped into other units at any distance. If targetUnit already has a backpack, sourceUnit's backpack will drop to the ground at targetUnit's feet, and be unavailable (for picking up/using).
Examples
soldierOne action ["DropBag", soldierTwo, backpack soldierOne];

_gwh = "Weapon_Empty" createVehicle getPosATL player; player action ["DropBag", _gwh, typeOf unitBackpack player]; // the reason "Weapon_Empty" type of weaponholder is used in this case is because // unlike other weaponholders it is not autodeleted when empty and will not disappear before the action is complete. // you should take care of deleting it after yourself. Alternatively use "PutBag" action.

(unitBackpack player) setVariable ["backpackOwner", name player, true]; player action ["DropBag", car, typeOf unitBackpack player]; hint ((firstBackpack car) getVariable "backpackOwner");

Swap player bag with parachute:

player action ["DropBag", _plane, backpack player]; player action ["AddBag", _plane, "B_Parachute"];

Transfer player's backpack to bob

player action ["DropBag", bob];


DropMagazine

Description Causes a person to drop a magazine either into another unit (both persons and vehicles), or onto the ground (creating a new WeaponHolder object). Magazines can be dropped into other units at any distance.
Syntax unit action ["dropMagazine", targetUnit, "magazineName"]
Where unit is the person to drop a magazine (the action animation will be performed), targetUnit is either another unit into which the magazine will be dropped, or the same unit that is dropping the magazine. "magazineName" is the classname (string) of the magazine to be dropped (see the ArmA weapons list for magazine classnames).
Examples
soldierOne action ["dropMagazine", soldierOne, "30Rnd_545x39_AK"];
soldierOne action ["dropMagazine", ammoCrateOne, "30Rnd_545x39_AK"];


DropWeapon

Description Causes a person to drop a weapon and all associated magazines either into specified vehicle or weaponholder. Weapons can be dropped at any distance.
Syntax unit action ["dropWeapon", targetHolder, "weaponName"]
Where unit is the person to drop a weapon (the action animation will be performed), targetHolder is either a vehicle or weaponholder. "weaponName" is the classname (string) of the CfgWeapons class.
Examples
private _weaponHolder = "GroundWeaponHolder_Scripted" createVehicle getPosATL player; player action ["DropWeapon", _weaponHolder, currentWeapon player];

soldierOne action ["DropWeapon", unitBackpack soldierTwo, currentWeapon soldierOne];
player action ["DropWeapon", tank, "arifle_MX_ACO_pointer_F"];


Eject

Description Causes a person to eject out of the vehicle they are currently inside. If the unit was the driver of the vehicle, the vehicle will retain it is steering control input and it is engine will remain on. This action has a global effect when used on a local unit in multiplayer. If the vehicle parameter used is an moving aircraft, the ejecting person will use a parachute (and likewise if it is not an moving aircraft, no parachute will be used).
Syntax unit action ["eject", vehicle]
Where unit is the person to eject from their current vehicle, and vehicle is any vehicle (generally the vehicle unit is within).
Example
soldierOne action ["Eject", vehicle soldierOne];


EngineOn

Description Turns a vehicle's engine on. This command will not override an AI driver's desires.
Syntax unit action ["engineOn", targetVehicle]
Where unit is any unit, and targetVehicle is the vehicle to start it is engine.
Example
soldierOne action ["engineOn", vehicle soldierOne];


EngineOff

Description Turns a vehicle's engine off. This command will not override an AI driver's desires.
Syntax unit action ["engineOff", targetVehicle]
Where unit is any unit, and targetVehicle is the vehicle to have it is engine turned off.
Example
soldierOne action ["engineOff", vehicle soldierOne];


FireInflame

Description Ignites a fireplace object (from any distance).
Syntax unit action ["FireInflame", targetObject]
Where unit is any unit(the action animation will be performed), and targetObject is the fireplace to be ignited.
Example
soldierOne action ["FireInflame", firePlaceOne];


FirePutDown

Description Extinguishes a fireplace object (from any distance).
Syntax unit action ["FirePutDown", targetObject]
Where unit is any unit (the action animation will be performed), and targetObject is the fireplace to be extinguished.
Example
soldierOne action ["FirePutDown", firePlaceOne];


FlapsUp

Description Adjusts an aircraft's flaps upwards one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
Syntax unit action ["flapsUp", targetVehicle]
Where unit is any unit (the action animation will not be performed), and targetVehicle is the aircraft to have it is flaps adjusted.
Example
harrierOne action ["flapsUp", harrierOne];


FlapsDown

Description Adjusts an aircraft's flaps down one notch. AI pilot's will instantly adjust their flaps to whatever setting they feel is suitable.
Syntax unit action ["flapsDown", targetVehicle]
Where unit is any unit (the action animation will not be performed), and targetVehicle is the aircraft to have it is flaps adjusted.
Example
harrierOne action ["flapsDown", harrierOne];


Gear

Description Opens inventory dialog for the player and plays the appropriate animation. The left part of the inventory dialog gets populated with the inventory of the target unit. Player has to be in range of inventory operations with the targetUnit (~ <5m).
Syntax unit action ["Gear", targetUnit]
Where unit is a player, and targetUnit is another player, vehicle or container.
Examples
player action ["Gear","GroundWeaponHolder" createVehicle position player];
player action ["Gear", objNull];
player action ["Gear", soldier1];


GetInCargo

Description Instantly moves a person to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as cargo, in a specific cargo position if given as an optional parameter, otherwise in the first available cargo position. If the specific position is already occupied, the person will board in the first available cargo position. If the all cargo positions are already occupied by living persons, or no cargo position exists, the boarding will fail. This action works only with cargo positions that have no person turret, i.e. if player cannot shoot his rifle from them. If position is cargo but also person turret, it will be ignored. Use fullCrew [_veh, "cargo", true] to determine which positions are compatible cargo. Alternatively, use moveInCargo command instead, which has no such limitation.
Syntax unit action ["getInCargo", targetVehicle]
unit action ["getInCargo", targetVehicle, positionNumber]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded. positionNumber is a specific cargo position index number.
Examples
soldierOne action ["getInCargo", truckOne];
soldierOne action ["getInCargo", truckOne, 0];


GetInCommander

Description Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, they then attempt to board the vehicle as the commander. The boarding will fail if the position is already occupied or does not exist.
Syntax unit action ["getInCommander", targetVehicle]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded.
Example
soldierOne action ["getInCommander", tankOne];


GetInDriver

Description Instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
Syntax unit action ["getInDriver", targetVehicle]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded.
Example
soldierOne action ["getInDriver", carOne];


GetInGunner

Description Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the primary gunner. If the gunner position is already occupied by another living person or it does not exist, the boarding will fail. Also see getInTurret.
Syntax unit action ["getInGunner", targetVehicle]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded.
Example
soldierOne action ["getInGunner", mySpotlight];


GetInPilot

Description This action is identical to getInDriver. It instantly moves an person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the driver/pilot. The boarding will fail if the position is already occupied or does not exist.
Syntax unit action ["getInPilot", targetVehicle]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded.
Example
pilotOne action ["getInPilot", chopperOne];


GetInTurret

Description Instantly moves a person (who is not already in a vehicle) to the appropriate boarding position of a vehicle, then they attempt to board the vehicle as the specified turret user. If the turret position is already occupied by another living person the boarding will fail. If the turret position does not exist, ArmA may crash. See also getInGunner.
Syntax unit action ["getInTurret", targetVehicle, turretArray]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded, and turretArray is an array defining the turret. For example, [1] would be a vehicle's second turret, and [0, 2, 1] is the second turret of the third turret of the first turret. A vehicle's turret order is defined in it is class CfgVehicles of the Config.
Examples
gunnerTwo action ["getInTurret", myUH60MG, [1]];
tankCommanderOne action ["getInTurret", myT72, [0,1]];


GetOut

Description Causes a person to disembark from a vehicle, without a parachute in the case of aircraft. See also eject.
Syntax unit action ["getOut", targetVehicle]
Where unit is the person to disembark, and targetVehicle is the vehicle to disembark from.
Example
soldierOne action ["getOut", carOne];


HandGunOn

Description Causes a person to ready their hand gun (if equiped). This action may not work if the unit does not have a primary rifle.
Syntax unit action ["handGunOn", targetUnit]
Where unit is any unit (who will not play the action animation), and targetUnit is the unit who will ready their pistol.
Example
soldierOne action ["handGunOn", soldierOne];


HandGunOff

Description Causes a person to return a readied pistol to it is holster, then switch to the primary rifle. This action may not work if the unit does not have a primary rifle.
Syntax unit action ["handGunOff", targetUnit]
Where unit is any unit (who will not play the action animation), and targetUnit is the person to holster it is pistol.
Example
soldierOne action ["handGunOff", soldierOne];


Heal

Description Instantly teleports a person unit to the target medic. The target medic then heals the unit. If the target unit is not a medic, the animations will still be played, but no healing occurs. If the medic is within a vehicle, no teleporting will occur and the wounded unit will only be healed if they are already within healing range (a few meters).
Syntax unit action ["heal", targetUnit]
Where unit is a wounded person, and targetUnit is the medic to do the healing.
Example
soldierOne action ["heal", medicOne];


HealSoldier

Description Performs one soldier healing of another soldier. Needs to have MedKit or FAK (first aid kit) in the inventory, which gets used.
Syntax unit action ["HealSoldier", targetUnit]
Where unit is the unit to perform treatment, and targetUnit is the unit to recieve treatment.
Example
player action ["HealSoldier", soldier1];


HealSoldierSelf

Description Performs one soldier healing of another soldier. In case the target is the same unit, the soldier performs treatment on himself. Needs to have FAK (first aid kit) in the inventory, which gets used.
Syntax unit action ["HealSoldierSelf", targetUnit]
Where unit is the unit to perform treatment, and targetUnit is the unit to recieve treatment.
Example
player action ["HealSoldierSelf", soldier1];


HideBody

Description Causes a person to bend down and hide (bury) a body in the ground. The body is automatically deleted within a few seconds. The person performing the action does not require the ability to hide bodies, and may be any distance from the body.
Syntax unit action ["hideBody", targetUnit]
Where unit is a person, and targetUnit is a dead person.
Example
soldierOne action ["hideBody", soldierTwo];


InGameMenu

Description Use and effects unknown.
Syntax unit action ["inGameMenu", <target>]
Example


LadderDown

Description Causes a person to play an animation as if mounting the top of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the ladderOff action is executed upon them. It may also crash ArmA (pre 1.09).
Syntax unit action ["ladderDown", targetObject]
unit action ["ladderDown", targetObject, ladderNumber, positionNumber]
Where unit is any person unit, targetObject is an object with a ladder, ladderNumber is a number defining the desired ladder, and positionNumber is a number defining the desired position.
Example
soldierOne action ["ladderDown", (position soldierOne nearestObject 452221), 0, 1];


LadderUp

Description Causes a person to play an animation as if mounting the bottom of a ladder, then instantly teleport onto the specified ladder in the specified position. If the person is controlled by AI, they will automatically climb up or down the ladder. If the 2 parameter syntax is used, the person will become stuck in the ladder mounting animation state until the ladderOff action is executed upon them. It may also crash ArmA (pre 1.09).
Syntax unit action ["ladderUp", targetObject] !!!Warning!!! This syntax causes Arma 3 to freeze
unit action ["ladderUp", targetObject, ladderNumber, positionNumber]
Where unit is any person unit, targetObject is an object with a ladder, ladderNumber is a number defining the desired ladder, and positionNumber is a number defining the desired position (0 - bottom, 1 - top). All numbers in between get rounded towards 1 or 0.
Example
soldierOne action ["ladderUp", (position soldierOne nearestObject 452221), 0, 0];


LadderOff

Description Causes a person to dismount from any ladder of the specified object they may be happen to be on. The alternative 3 parameter syntax expects a number, the use of which is not known.
Syntax unit action ["ladderOff", targetObject]
unit action ["ladderOff", targetObject, unknownNumber]
Where unit is any person unit, targetObject is the object with a ladder that the person is currently upon, unknownNumber is a number.
Example
soldierOne action ["ladderOff", (position soldierOne nearestObject 452221)];


LadderOnDown

Description: This action appears to be identical to LadderDown.


LadderOnUp

Description: This action appears to be identical to LadderUp.


Land

Description Turns on autopilot landing for an aircraft, including AI controlled aircraft. The aircraft will land at the closest airfield.
Syntax unit action ["Land", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle that can perform an autopilot landing.
Example
planeOne action ["Land", planeOne];


LandGear

Description Lowers the landing gear of an aircraft. In the case of AI-controlled aircraft, it has to be used in an each-frame loop to to override the AI behavior (otherwise they'll raise the landing gear when they take off).
Syntax unit action ["LandGear", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle that can perform an autopilot landing.
Example
planeOne action ["LandGear", planeOne];

LandGearUp

Description Raises the landing gear of an aircraft. In the case of AI-controlled aircraft, it has to be used in an each-frame loop to override the AI behavior (otherwise they'll lower the landing gear when they're close to the ground).
Syntax unit action ["LandGearUp", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle that can perform an autopilot landing.
Example
planeOne action ["LandGearUp", planeOne];


LightOff

Description Turns off the headlights of an empty vehicle. If the vehicle is AI-controlled (either as the lone driver, or as the commander/gunner) then the light status depends on the AI's behaviour mode ("combat" or "stealth" = lights off, any other mode = lights on).
Syntax unit action ["lightOff", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle with lights.
Example
player action ["lightOff", vehicle player];


LightOn

Description Turns on the headlights of an empty vehicle. If vehicle is AI-controlled, see notes under the LightOff action.
Syntax unit action ["lightOn", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is a vehicle with lights.
Example
player action ["lightOn", vehicle player];


LoadMagazine

Description Plays a reload weapon animation.
Syntax unit action ["loadMagazine", target, magazineCreator, number1, number2, weaponName, muzzleName]
Expects a 7 element array:
target: Object - unit to perform the reload action.
magazineCreator: Object - unknown. Can be objNull.
number1: Number - cr - see magazinesDetail. For characters it is mainly 0
number2: Number - id - magazine ID - can be obtained via magazinesDetail. With 0, it only plays the reload animation. With values from 1 up, it actually reloads the magazine. If the number becomes too high (meaning of the upper limit is also unknown), the action will no longer be performed.
weaponName: String - weapon to reload. Must not be selected, but may cause weapon not to reload to the full amount.
muzzleName: String - weapon's muzzle to reload.
Example
player action ["loadmagazine", player, player, 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"];


LockVehicleControl

Description Locks co-pilot controls, removes Take Control action. enableCopilot must be set true to function.
Syntax unit action ["LockVehicleControl", vehicle]
Where unit is any unit, and vehicle is any vehicle with co-pilot controls.
Example
player action ["LockVehicleControl", vehicle player];


ManualFire

Description Enables manual fire mode for a player unit that is driver or commander of a vehicle. This action toggled manual fire mode in old versions of ArmA. (See also isManualFire)
Syntax unit action ["manualFire", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is the vehicle in which manual fire mode is to be enabled.
Example
player action ["ManualFire", vehicle player];


ManualFireCancel

Description Disables manual fire mode for a player unit that is driver or commander of a vehicle. (See also isManualFire)
Syntax unit action ["manualFireCancel", targetVehicle]
Where unit is any unit (no action animation is performed) and targetVehicle is the vehicle in which manual fire mode is to be disabled.
Example
player action ["manualFireCancel", vehicle player];


MarkEntity

Description Use and effects unknown. Same as Arma_3_Actions#MarkWeapon action.
Syntax unit action ["markEntity", <target>]
Example


MoveToCargo

Description Move a unit to the chosen cargo position within a vehicle. If another unit is already in that position, the units will swap positions. This works only with cargo positions that have no person turret, i.e. if player cannot shoot his rifle from them. If position is cargo but also person turret, it will be ignored. Use fullCrew [_veh, "cargo", true] to determine which positions are compatible cargo.
Syntax unit action ["moveToCargo", targetVehicle, cargoPosition]
Where unit is a unit within targetVehicle, and cargoPosition is the number of the desired cargo position (0 being the first).
Example
player action ["moveToCargo", vehicle player, 2];


MoveToCommander

Description Move a unit to the commander's position within a vehicle. If another unit is already in that position, the units will swap positions.
Syntax unit action ["moveToCommander", targetVehicle]
Where unit is a unit within targetVehicle.
Example
player action ["moveToCommander", vehicle player];


MoveToDriver

Description Move a unit to the driver's position within a vehicle. If another unit is already in that position, the units will generally swap positions, although in some scenarios this action may not work (although having the existing driver move always works).
Syntax unit action ["moveToDriver", targetVehicle]
Where unit is a unit within targetVehicle.
Example
player action ["moveToDriver", vehicle player];


MoveToGunner

Description Move a unit to the primary gunner's position within a vehicle. If another unit is already in that position, the units will swap positions. See also moveToTurret.
Syntax unit action ["moveToGunner", targetVehicle]
Where unit is a unit within targetVehicle.
Example
player action ["moveToGunner", vehicle player];


MoveToPilot

Description: Identical to moveToDriver.


MoveToTurret

Description Move a unit to the chosen turret position within a vehicle. If another unit is already in that position, the units will swap positions.
Syntax unit action ["moveToTurret", targetVehicle, turretArray]
Where unit is a unit within targetVehicle, and turret Array is an array referring to the desired turret (for example, [0,1,2] refers to the third turret of the second turret of the first turret of the vehicle).
Examples
player action ["moveToTurret", vehicle player, [0]];
player action ["moveToTurret", vehicle player, [0,1]];


None

Description Use and effects unknown.
Syntax unit action ["none", <target>]
Example


NVGoggles

Description Causes a unit to put on it is night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
Syntax unit action ["nvGoggles", <anything>]
Where unit is the unit to put on NVGoggles, and <anything> can be anything (it seems to not be used at all, but the action parameter array must contain at least two elements).
Example
player action ["nvGoggles", player];


NVGogglesOff

Description Causes a unit to take off it is night vision goggles. AI controlled units will automatically put on and take off goggles depending on daylight.
Syntax unit action ["nvGogglesOff", <anything>]
Where unit is the unit to put on goggles, and <anything> can be anything (it seems not to be used at all, but the action parameter array must contain at least two elements).
Example
player action ["nvGogglesOff", player];


OpenParachute

Description Opens unit's parachute. Unit must have parachute backpack.
Syntax unit action ["OpenParachute", unit]
Where unit is the unit with parachute backpack.
Example
player action ["OpenParachute", player];


PutBag

Description Causes sourceUnit to bend over and put target backpack on the ground. If the targetUnit param is omitted or it is the same as sourceUnit, the sourceUnit will drop own backpack. If targetUnit is another unit, sourceUnit will bend over but targetUnit will drop its backpack at its feet.
Syntax sourceUnit action ["PutBag", targetUnit]
targetUnit is optional
Note To pick the backpack from the ground use "AddBag" action.
Examples
player action ["PutBag"]; unit1 action ["PutBag", unit2];


Rearm

Description Causes an occupied vehicle or person to rearm from any object with some ammoCargo (generally an ammo truck) in the case of vehicles, or some magazines in it is cargo in the case of a rearming person. The rearming vehicle/person can be any distance from the rearming object. Rearming vehicles takes some time and will be interrupted if the vehicle starts to move. A rearming person will bend down as if picking up something.
Syntax unit action ["rearm", reamingObject]
Where unit is the occupied vehicle or person to be rearmed, and rearmingObject is the object from which to rearm.
Examples
tankOne action ["rearm", ammoTruckOne];
soldierOne action ["rearm", ammoTruckOne];


Refuel

Description Causes an occupied vehicle to refuel from any object with some fuelCargo (generally an refueling truck). The refueling object can be any distance from the vehicle. Refueling takes some time and will be interrupted if the vehicle starts to move.
Syntax vehicle action ["refuel", refuelingObject]
Where vehicle is the occupied vehicle to be refueled, and refuelingObject is the object from which to refuel.
Example
tankOne action ["refuel", refuelTruckOne];


Repair

Description Causes an occupied vehicle to repair from any object with some repairCargo (generally an repair truck). The repair object can be any distance from the vehicle. Repairing takes some time and will be interrupted if the vehicle starts to move.
Syntax vehicle action ["repair", repairingObject]
Where vehicle is the occupied vehicle to be repaired, and repairingObject is the object from which to repair.
Example
tankOne action ["repair", repairTruckOne];


ReturnFlag

Description Causes a person to return a flag from a nearby dead person back to it is flagpole. As of ArmA v1.12 this action is bugged and can not be used upon flags attached to destroyed vehicles.
Syntax unit action ["returnFlag", targetObject]
Where unit is any person, and targetObject is the dead person with a flag to be returned.
Example
soldierOne action ["returnFlag", westFlag];


RepairVehicle

Description Causes an Engineer unit to repair an object using their Engineer Repair ability (from v1.54). The Engineer can be any distance from the vehicle. Repairing takes some time. If unit is not the Engineer class no repairs are made but the animation will still play.
Syntax unit action ["repairVehicle", vehicle]
Where unit is an Engineer unit, and vehicle is the object to repair.
Example
engineerOne action ["repairVehicle", truckOne];


Salute

Description Causes a person to salute. AI controlled units will only make a momentary salute, unless the AI is in safe or careless behaviour mode.
Syntax unit action ["salute", targetUnit]
Where unit is any unit (no animation is performed), and targetUnit is the person to make the salute.
Example
soldierOne action ["salute", soldierOne];


ScudCancel

Description There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
Syntax unit action ["scudCancel", targetVehicle]
Syntax unknown.
Example


ScudLaunch

Description There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
Syntax unit action ["scudLaunch", targetVehicle]
Syntax unknown.
Example


ScudStart

Description There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
Syntax unit action ["scudStart", targetVehicle]
Syntax unknown.
Example


SearchlightOff

Description Turns off the searchlight in the WY-55 Hellcat. Only works on a unit sitting in the copilot seat, and only works with the Hellcat, no other vehicles have searchlights.
Syntax unit action ["SearchlightOff", vehicle]
Example hellcatCopilot action ["SearchlightOff", vehicle hellcatCopilot]


SearchlightOn

Description Turns on the searchlight in the WY-55 Hellcat. Only works on a unit sitting in the copilot seat, and only works with the Hellcat, no other vehicles have searchlights.
Syntax unit action ["SearchlightOn", vehicle]
Example hellcatCopilot action ["SearchlightOn", vehicle hellcatCopilot]


SetTimer

Description Soldier 'unitOne' plays the action animation. UnitTwo activates and adds 40 seconds to the timer for a satchel charge. Neither unit needs to be near the satchel.

Charge has to be placed first using unitname Fire ["pipebombmuzzle", "pipebombmuzzle", "pipebomb"] or createMine command.

Syntax unitOne action ["SetTimer", unitTwo, bombName]
Example


SitDown

Description Causes a person to sit down on the ground (or get up, if already sitting). AI controlled units will only stay seated if they are in safe or careless behaviour mode.
Syntax unit action ["sitDown", targetUnit]
Where unit is any unit (no animation is performed), and targetUnit is the person who is to sit down.
Example
soldierOne action ["sitDown", soldierOne];


StrokeFist

Description Does nothing. There is no punch animation in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
Syntax unit action ["strokeFist", targetVehicle]
Syntax unknown.
Example


StrokeGun

Description Does nothing (other than making a person twitch a little). There is no suitable animation for this action in ArmA, however this action (presumably) remains in the engine from the days of Operation Flashpoint.
Syntax unit action ["strokeGun", targetVehicle]
Syntax unknown.
Example


Surrender

Description Makes unit to put weapon on shoulder and put hands behind the head temporarily. For the lasting effect all weapons from the unit should be removed first.
Syntax unit action ["Surrender", targetUnit]
Where unit is any unit, and targetUnit is the unit to surrender.
Example
soldierOne action ["Surrender", soldierTwo];


SuspendVehicleControl

Description Release vehicle controls from co-pilot. Control immediately returns to pilot.
Syntax unit action ["SuspendVehicleControl", vehicle]
Where unit is any unit, and vehicle is any vehicle with co-pilot controls.
Example
player action ["SuspendVehicleControl", vehicle player];


SwitchMagazine

Description Target unit switches to the given firing mode index. This allows selection of any firing mode for any weapon carried by a soldier, or mounted on a weapon. First are the firing modes for the primary weapon (index 0 upwards), then secondary weapon, then optics, then pistol, then thrown and placed weapons. Changing to NVGoggles just plays an animation, not actually setting NV mode. Unfortunately, the list of firing modes seems to only be created when a soldier is initiated; modes are removed from the list when a weapon is dropped and not re-added when a weapon is picked up. Thus, only use this during the initiation phase of the soldier. On vehicles, where the weapons are not likely to be changed, this action might be useful after the vehicle has been initiated.
If the mode index is higher than available indices, it assumes index 0. If you just want to change the muzzle used, rather than the firing mode, the standard command selectWeapon is generally more useful.
Syntax unit action ["SwitchMagazine", targetVehicle, targetUnit, mode index]
Example
gameLogic action ["SwitchMagazine", unit1, unit1, 3]; gameLogic action ["SwitchMagazine", m1a1, gunner m1a1, 1];


SwitchWeapon

Description UnitOne plays the action animation. Target unit switches to the given muzzle/mode index. Target unit can also be a vehicle. The weapons array is a list of all weapon modes specific to each weapon, muzzle and firing mode combination.
Syntax unit action ["SwitchWeapon", targetUnit, targetUnit, muzzle index]
Example
unit2 action ["SwitchWeapon", unit1, unit1, 7]; player action ["SwitchWeapon", player, player, 3]; // switching personal weapon player action ["SwitchWeapon", vehicle player, player, 3]; // switching vehicle weapon
player action ["SwitchWeapon", player, player, weaponIndex];

Result => weaponIndex: weaponState for "B_soldier_LAT_F"

0: ["arifle_MX_ACO_pointer_F","arifle_MX_ACO_pointer_F","Single","30Rnd_65x39_caseless_mag",30]
1: ["arifle_MX_ACO_pointer_F","arifle_MX_ACO_pointer_F","FullAuto","30Rnd_65x39_caseless_mag",30]
2: ["arifle_MX_ACO_pointer_F","arifle_MX_ACO_pointer_F","fullauto_medium","30Rnd_65x39_caseless_mag",30]
3: ["arifle_MX_ACO_pointer_F","arifle_MX_ACO_pointer_F","single_medium_optics1","30Rnd_65x39_caseless_mag",30]
4: ["arifle_MX_ACO_pointer_F","arifle_MX_ACO_pointer_F","single_far_optics2","30Rnd_65x39_caseless_mag",30]
5: ["launch_NLAW_F","launch_NLAW_F","launch_NLAW_F","NLAW_F",1]
6: ["hgun_P07_F","hgun_P07_F","hgun_P07_F","16Rnd_9x21_Mag",16]
7: ["Throw","HandGrenade_Stone","HandGrenade_Stone","",0]
8: ["Throw","HandGrenadeMuzzle","HandGrenadeMuzzle","",0]
9: ["Throw","MiniGrenadeMuzzle","MiniGrenadeMuzzle","",0]
10: ["Throw","MiniGrenadeMuzzle","MiniGrenadeMuzzle","",0]
11: ["Throw","SmokeShellYellowMuzzle","SmokeShellYellowMuzzle","",0]
12: ["Throw","SmokeShellYellowMuzzle","SmokeShellYellowMuzzle","",0]
13: ["Throw","SmokeShellRedMuzzle","SmokeShellRedMuzzle","",0]
14: ["Throw","SmokeShellPurpleMuzzle","SmokeShellPurpleMuzzle","",0]
15: ["Throw","SmokeShellOrangeMuzzle","SmokeShellOrangeMuzzle","",0]
16: ["Throw","SmokeShellBlueMuzzle","SmokeShellBlueMuzzle","",0]
17: ["Throw","SmokeShellBlueMuzzle","SmokeShellBlueMuzzle","",0]
18: ["Throw","ChemlightRedMuzzle","ChemlightRedMuzzle","",0]
19: ["Throw","ChemlightYellowMuzzle","ChemlightYellowMuzzle","",0]
20: ["Throw","ChemlightBlueMuzzle","ChemlightBlueMuzzle","",0]
21: ["Throw","IRGrenade","IRGrenade","",0]
22: ["Put","DemoChargeMuzzle","DemoChargeMuzzle","",0]
23: ["Put","PipeBombMuzzle","PipeBombMuzzle","",0]
24: ["Put","MineMuzzle","MineMuzzle","",0]
25: ["Put","ClassicMineRangeMuzzle","ClassicMineRangeMuzzle","",0]
27: ["Put","BoundingMineRangeMuzzle","BoundingMineRangeMuzzle","",0]
28: ["Put","DirectionalMineRangeMuzzle","DirectionalMineRangeMuzzle","",0]
29: ["Put","ClassicMineWireMuzzle","ClassicMineWireMuzzle","",0]


SwitchToUAVDriver

Description Moves player control into driver position of connected UAV. Does what "Take UAV controls" UI action does.
Syntax unit action ["SwitchToUAVDriver", uav]
Where unit is a player and uav is the connected UAV.
Example
player action ["SwitchToUAVDriver", getConnectedUAV player];


SwitchToUAVGunner

Description Moves player control into gunner position of connected UAV. Does what "Take UAV turret controls" UI action does.
Syntax unit action ["SwitchToUAVGunner", uav]
Where unit is a player and uav is the connected UAV.
Example
player action ["SwitchToUAVGunner", getConnectedUAV player];


TakeFlag

Description Soldier 'unitname' takes control of 'flag1'. He must be close to the flagpole and it must belong to an enemy side.
Syntax unit action ["TakeFlag", flag1]
Example
player action ["TakeFlag", FlagOne];


TakeMagazine

Description Soldier 'unit' takes one magazine of specified type from the ground (Weaponholder) or from named vehicle (ammo box, car, etc.) Transfer happens immediately and via teleportation. Unit plays pickup animation at its current position, no matter where magazine is. Since Arma 3 v2.06.147667 optional param 'forcePutInBackpack' is added allowing to store picked up magazine in backpack. By default the magazine will go to any unit container with space, starting with uniform.
Syntax unit action ["TakeMagazine", weaponholder, magazineName, (forcePutInBackpack)]
Where unit is any unit, and weaponholder is storage container.
Example1
player action ["TakeMagazine", ammoBox, "RPGLauncher"];
Example2 Drop Magazine, then make your buddy Bob come and take magazine and put it in backpack:

0 spawn { private _wh = "Weapon_Empty" createVehicle (player getRelPos [2, 0]); _mag = [[currentMagazine]] [[player]]; [[player]] [[action]] ["PutMagazine", _wh, _mag]; _bob = [[group]] [[player]] [[createUnit]] ["B_Soldier_F", [[player]] [[getRelPos]] [10, 0], [], 0, "NONE"]; _bob [[addBackpack]] "B_AssaultPack_blk"; _bob [[doMove]] [[position]] _wh; [[waitUntil]] { [[unitReady]] _bob }; _bob [[action]] ["TakeMagazine", _wh, _mag, [[true]]]; };</code> |} == TakeWeapon == :{| |- style="vertical-align: top" ! Description | style="width: 99%" | Soldier 'unitname' takes weapon of specified type ([[:Category: weapons|see list]]) from the ground (Weaponholder) or from named vehicle (ammo box, car, etc.) Transfer happens immediately and via teleportation. Unit1 plays pickup animation at its current position, no matter where weapon is. |- style="vertical-align: top" | | ''unit'' action ["TakeWeapon", ''vehicle'', ''weaponName''] |- style="vertical-align: top" | | Where ''unit'' is any unit, and ''vehicle'' is any unit or vehicle. |- style="vertical-align: top" ! Example | <sqf>player action ["TakeWeapon", SoldierTwo, currentWeapon player];

TakeMine

Description Unit will perform pick up action animation. The closest mine that is within two meters of the target unit will be placed into the target unit's inventory. The mine has to be active for this action to succeed. If there is not enough room in the target inventory, the mine will still be picked up but will not appear in inventory. See createMine for how to place explosive by script.
Syntax unit action ["TakeMine", targetUnit]
Example
player action ["TakeMine", player];


TakeVehicleControl

Description In case of a helicopter, copilot will take flying controls, even if enableCopilot is disabled and isCopilotEnabled is false. Use SuspendVehicleControl action to release control.
Syntax unit action ["TakeVehicleControl", vehicle]
Where unit is any unit, and vehicle is any vehicle with co-pilot controls.
Example
player action ["TakeVehicleControl", vehicle player];


Talk

Description Use and effects unknown.
Syntax unit action ["Talk", target]
Example


TeamSwitch

Description Opens the normal team-switch dialog. <current unit> will be greyed out in the list and thus unselectable.

The effect of the second array element is unknown, but it must be a unit. Works in single-player game only (in MP games, will just momentarily show the mouse cursor without the team-switch window being shown).

Syntax currentUnit action ["TeamSwitch", unit]
Example
player action ["TeamSwitch", player];


TouchOff

Description Soldier 'unitOne' plays the action animation. UnitTwo's satchels are "touched off".

UnitTwo must be within range (300m) of his satchels to touch them off. See createMine for how to place explosives with script.

Syntax unitOne action ["TouchOff", unitTwo]
Example
player action ["TouchOff", player];


TurnIn / TurnOut

Description Crew of 'vehiclename' turns in/out (gets in and out of hatches).

UnitName must be a player in effective commander of vehicleName. AI will automatically turn in/out based on their current behaviour mode. Only to be used on positions that have the turnIn/turnOut capability (otherwise it breaks the cargo anim).

Syntax unit action ["TurnIn", vehicle]
unit action ["TurnOut", vehicle]
Example
TankOne action ["TurnIn", TankOne]; player action ["TurnOut", vehicle player];


UAVTerminalHackConnection

Description Hacks into given UAV. Does what "Hack UAV" UI action does.

NOTE: Player has to be in normal UI action proximity to the UAV for this action to work.

Syntax unit action ["UAVTerminalHackConnection", uav]
Where unit is any unit (enemy to the drone) and uav is the UAV to hack.
Example
player action ["UAVTerminalHackConnection", drone];


UAVTerminalMakeConnection

Description Connects player to chosen UAV. Does what "Connect terminal to UAV" UI action does.

NOTE: Player has to be in normal UI action proximity to the UAV for this action to work. To connect to far away UAV use connectTerminalToUAV command instead.

Syntax unit action ["UAVTerminalMakeConnection", uav]
Where unit is a player and uav is UAV to be connected to.
Example
player action ["UAVTerminalMakeConnection", allUnitsUAV select 0];


UAVTerminalOpen

Description Opens UAV Terminal UI. Player must have UAV Terminal item in GPS slot of inventory. Does what "Open UAV Terminal" UI action does.
Syntax unit action ["UAVTerminalOpen", unit]
Where unit is a player.
Example
player action ["UAVTerminalOpen", player];


UAVTerminalReleaseConnection

Description Disconnects player from connected UAV. Does what "Disconnect terminal from UAV" UI action does.

NOTE: Unlike with "UAVTerminalMakeConnection", player can be far away from the UAV. Notice how the passed params are swapped around for this action.

Syntax uav action ["UAVTerminalReleaseConnection", unit]
Where uav is the connected UAV and unit is the player controlling it.
Example
getConnectedUAV player action ["UAVTerminalReleaseConnection", player];


UnlockVehicleControl

Description Unlocks co-pilot controls, shows Arma_3:_Actions#TakeVehicleControl|Take Control action. enableCopilot must be set true to function.
Syntax unit action ["UnlockVehicleControl", vehicle]
Where unit is any unit, and vehicle is any vehicle with co-pilot controls.
Example
player action ["UnlockVehicleControl", vehicle player];


UseMagazine

Description Loads a weapon with magazine with known id and fires that weapon. The weapon is selected based on magazine type. Details for <cr> and <id> can be found with magazinesDetail command (not 100% about <cr> but it seems 0 works for all weapons)
Syntax LOGIC action ["UseMagazine", target, magazine creator, <cr>, <id>]
Example

private _logic = createGroup west createUnit ["Logic", [0,0,0], [], 0, "NONE"]; hint str magazinesDetail player; // loaded mags not shown /*[ "6.5mm 30Rnd STANAG Mag(30/30)[id/cr:3/0]", "Smoke Round (White)(1/1)[id/cr:121/0]", "Smoke Round (White)(1/1)[id/cr:122/0]", "9mm 16Rnd Mag(16/16)[id/cr:11/0]" ]*/ _logic action ["UseMagazine", player, player, 0, 3]; // loads rifle with mag id 3 and fires _logic action ["UseMagazine", player, player, 0, 11]; // loads pistol with mag id 11 and fires from inventory _logic action ["UseMagazine", player, player, 0, 121]; // throws smoke grenade with id 121


User

Description Soldier 'unitName' does nothing. Executes the custom action with the given index of the the target unit. Indexes are based upon the order in which the actions are added to the unit. See addAction.
Syntax unitName action ["User", target unit, action index]
Example
gameLogic action ["User", player, 3];


UserType

Description As of ArmA version 1.08, using this action type will cause ArmA to crash to desktop.
Syntax unit action ["UserType", target, action index]
Example


UseWeapon

Description Soldier 'unitOne' will play the action animation. Target unit will fire the specified unit's position in the target vehicle's (can be the unit itself) weapon mode index. The indexes seem to be based upon the order in which weapons are added to the unit/vehicle, with each weapon's muzzle's fire mode having an unique index. Weapons can be fired in this way from a not-readied position (eg, firing a rifle on a soldiers back). Pistols will fire from the current weapon's proxy. It can also be used to sound the horn on AI controlled vehicles.
NOTE: If 'unitOne' is player object, the player goes into pick up animation before action is performed. If 'unitOne' is a game logic, the action is performed immediately with no animation.
Syntax unitOne action ["UseWeapon", target vehicle, target unit, weapon index]
Example
_logic = createGroup west createUnit ["Logic", [0,0,0], [], 0, "NONE"]; _logic action ["useWeapon", player, player, 0]; // player fires single shot _logic action ["useWeapon", player, player, 2]; // player fires 3 round burst _logic action ["useWeapon", player, player, 5]; // player fires pistol from inventory _logic action ["useWeapon", player, player, 7]; // player throws hand grenade _logic action ["useWeapon", car, car, 0]; // car sounds its horn // more examples gameLogic action ["useWeapon", unit1, unit1, 16]; gameLogic action ["useWeapon", vehicle