Actions – Arma 2

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{SideTOC *\| *([0-9]?\.[0-9]+)\}\}" to "{{TOC|side|$1}}")
m (spaces → naught)
Line 9: Line 9:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=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]].
|''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]].
|-valign=top
|-valign=top
|''"actionType"'':               ||[[String]]. Not case sensitive.
|''"actionType"'':
| [[String]]. Not case sensitive.
|-valign=top
|-valign=top
|''parameter(s)'':               ||Various [[Data_Types|data types]], dependant on the action used. The number of required parameters depends on the action type.
|''parameter(s)'':
| Various [[Data_Types|data types]], dependant on the action used. The number of required parameters depends on the action type.
|}
|}


Line 21: Line 24:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["autoHover", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["autoHover", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.  
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.
|-valign=top
|-valign=top
|'''Example''':             ||chopperOne action ["autoHover", chopperOne]
|'''Example''':
| chopperOne action ["autoHover", chopperOne]
|}
|}


Line 33: Line 40:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Cancels an action in progress. The target unit will complete it is current animation, although the action itself will not be performed.
|'''Description''':
| Cancels an action in progress. The target unit will complete it is current animation, although the action itself will not be performed.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["cancelAction", ''targetUnit'']'''
|'''Syntax''':
| ''unit'' action ["cancelAction", ''targetUnit'']'''
|-valign=top
|-valign=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.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetUnit'' is any unit that is in the process of performing an action.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["CancelAction", soldierOne]
|'''Example''':
| soldierOne action ["CancelAction", soldierOne]
|}
|}


Line 46: Line 57:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Cancels autopilot landing for an aircraft, including AI controlled aircraft.
|'''Description''':
| Cancels autopilot landing for an aircraft, including AI controlled aircraft.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["cancelLand", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["cancelLand", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is currently performing an autopilot landing.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is currently performing an autopilot landing.
|-valign=top
|-valign=top
|'''Example''':             ||planeOne action ["cancelLand", planeOne]
|'''Example''':
| planeOne action ["cancelLand", planeOne]
|}
|}


Line 59: Line 74:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["cancelTakeFlag", ''targetFlag'']
|'''Syntax''':
| ''unit'' action ["cancelTakeFlag", ''targetFlag'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit that is currently taking a flag (no action animation is performed) and ''targetFlag''' is a flag object.
|
| Where ''unit'' is any unit that is currently taking a flag (no action animation is performed) and ''targetFlag''' is a flag object.
|-valign=top
|-valign=top
|'''Example''':             ||westSoldierOne action ["cancelTakeFlag", eastFlag]
|'''Example''':
| westSoldierOne action ["cancelTakeFlag", eastFlag]
|}
|}


Line 72: Line 91:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.  
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["deactivate", ''targetUnit'', ''targetObject'']
|'''Syntax''':
| ''unit'' action ["deactivate", ''targetUnit'', ''targetObject'']
|-valign=top
|-valign=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 is inventory. ''targetObject'' is the armed satchel object to be deactivated (class "pipeBomb" or "timeBomb").
|
| 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").
|-valign=top
|-valign=top
|'''Examples''':             ||soldierOne action ["deactivate", soldierOne, mySatchelCharge]
|'''Examples''':
| soldierOne action ["deactivate", soldierOne, mySatchelCharge]
|-valign=top
|-valign=top
|                           ||soldierOne action ["deactivate", soldierOne, nearestObject [soldierOne, "pipeBomb"]]
|
| soldierOne action ["deactivate", soldierOne, nearestObject [soldierOne, "pipeBomb"]]
|}
|}


Line 87: Line 111:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["deactivateMine", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["deactivateMine", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit, who will perform the action animation. The closest landmine to ''targetUnit'' will be deactivated.
|
| Where ''unit'' is any unit, who will perform the action animation. The closest landmine to ''targetUnit'' will be deactivated.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["deactivateMine", soldierOne]
|'''Example''':
| soldierOne action ["deactivateMine", soldierOne]
|}
|}


Line 100: Line 128:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Use and effects unknown.
|'''Description''':
| Use and effects unknown.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["diary", ''<target>'']
|'''Syntax''':
| ''unit'' action ["diary", ''<target>'']
|-valign=top
|-valign=top
|                           ||
|
|
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 113: Line 145:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["dropMagazine", ''targetUnit'', ''"magazineName"'']
|'''Syntax''':
| ''unit'' action ["dropMagazine", ''targetUnit'', ''"magazineName"'']
|-valign=top
|-valign=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).
|
| 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).
|-valign=top
|-valign=top
|'''Examples''':             ||soldierOne action ["dropMagazine", soldierOne, "30Rnd_545x39_AK"]
|'''Examples''':
| soldierOne action ["dropMagazine", soldierOne, "30Rnd_545x39_AK"]
|-valign=top
|-valign=top
|                           ||soldierOne action ["dropMagazine", ammoCrateOne, "30Rnd_545x39_AK"]
|
| soldierOne action ["dropMagazine", ammoCrateOne, "30Rnd_545x39_AK"]
|}
|}


Line 128: Line 165:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Causes a person to drop a weapon and all associated magazines either into another unit (including persons and vehicles), or onto the ground (creating a new WeaponHolder object). Weapons can be dropped into other units at any distance.
|'''Description''':
| Causes a person to drop a weapon and all associated magazines either into another unit (including persons and vehicles), or onto the ground (creating a new WeaponHolder object). Weapons can be dropped into other units at any distance.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["dropWeapon", ''targetUnit'', ''"weaponName"'']
|'''Syntax''':
| ''unit'' action ["dropWeapon", ''targetUnit'', ''"weaponName"'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to drop a weapon (the action animation will be performed), ''targetUnit'' is either another unit into which the weapon will be dropped, or the same unit that is dropping the weapon to place it onto the ground. ''"weaponName"'' is the classname (string) of the weapon to be dropped (see the [[ArmA:_Weapons|ArmA weapons list]] for classnames).
|
| Where ''unit'' is the person to drop a weapon (the action animation will be performed), ''targetUnit'' is either another unit into which the weapon will be dropped, or the same unit that is dropping the weapon to place it onto the ground. ''"weaponName"'' is the classname (string) of the weapon to be dropped (see the [[ArmA:_Weapons|ArmA weapons list]] for classnames).
|-valign=top
|-valign=top
|'''Examples''':             ||soldierOne action ["dropWeapon", soldierOne, "AK74GL"]
|'''Examples''':
| soldierOne action ["dropWeapon", soldierOne, "AK74GL"]
|-valign=top
|-valign=top
|                           ||soldierOne action ["dropWeapon", ammoCrateOne, "RPG7V"]
|
| soldierOne action ["dropWeapon", ammoCrateOne, "RPG7V"]
|}
|}


Line 143: Line 185:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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 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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["eject", ''vehicle'']
|'''Syntax''':
| ''unit'' action ["eject", ''vehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to eject from their current vehicle, and ''vehicle'' is any vehicle (generally the vehicle ''unit'' is within).
|
| Where ''unit'' is the person to eject from their current vehicle, and ''vehicle'' is any vehicle (generally the vehicle ''unit'' is within).
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["Eject", vehicle soldierOne]
|'''Example''':
| soldierOne action ["Eject", vehicle soldierOne]
|}
|}


Line 156: Line 202:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         || Turns a vehicle's engine on. This command will not override an AI driver's desires.
|'''Description''':
| Turns a vehicle's engine on. This command will not override an AI driver's desires.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["engineOn", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["engineOn", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to start it is engine.
|
| Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to start it is engine.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["engineOn", vehicle soldierOne]
|'''Example''':
| soldierOne action ["engineOn", vehicle soldierOne]
|}
|}


Line 169: Line 219:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         || Turns a vehicle's engine off. This command will not override an AI driver's desires.
|'''Description''':
| Turns a vehicle's engine off. This command will not override an AI driver's desires.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["engineOff", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["engineOff", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to have it is engine turned off.
|
| Where ''unit'' is any unit, and ''targetVehicle'' is the vehicle to have it is engine turned off.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["engineOff", vehicle soldierOne]
|'''Example''':
| soldierOne action ["engineOff", vehicle soldierOne]
|}
|}


Line 183: Line 237:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         || Ignites a fireplace object (from any distance).
|'''Description''':
| Ignites a fireplace object (from any distance).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["fireInFlame", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["fireInFlame", ''targetObject'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit(the action animation will be performed), and ''targetObject'' is the fireplace to be ignited.
|
| Where ''unit'' is any unit(the action animation will be performed), and ''targetObject'' is the fireplace to be ignited.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["fireInFlame", firePlaceOne]
|'''Example''':
| soldierOne action ["fireInFlame", firePlaceOne]
|}
|}


Line 196: Line 254:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         || Extinguishes a fireplace object (from any distance).
|'''Description''':
| Extinguishes a fireplace object (from any distance).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["firePutDown", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["firePutDown", ''targetObject'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (the action animation will be performed), and ''targetObject'' is the fireplace to be extinguished.
|
| Where ''unit'' is any unit (the action animation will be performed), and ''targetObject'' is the fireplace to be extinguished.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["firePutDown", firePlaceOne]
|'''Example''':
| soldierOne action ["firePutDown", firePlaceOne]
|}
|}


Line 210: Line 272:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''Description''':
| 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
|-valign=top
|'''Syntax''':               ||''unit'' action ["flapsUp", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["flapsUp", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.  
|
| Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.
|-valign=top
|-valign=top
|'''Example''':             ||harrierOne action ["flapsUp", harrierOne]
|'''Example''':
| harrierOne action ["flapsUp", harrierOne]
|}
|}


Line 223: Line 289:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''Description''':
| 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
|-valign=top
|'''Syntax''':               ||''unit'' action ["flapsDown", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["flapsDown", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.  
|
| Where ''unit'' is any unit (the action animation will not be performed), and ''targetVehicle'' is the aircraft to have it is flaps adjusted.
|-valign=top
|-valign=top
|'''Example''':             ||harrierOne action ["flapsDown", harrierOne]
|'''Example''':
| harrierOne action ["flapsDown", harrierOne]
|}
|}


Line 236: Line 306:
'''unitName action ["Gear",<target unit>]'''
'''unitName action ["Gear",<target unit>]'''


UnitName opens the gear of <target unit> (but only if he is within normal range) and plays the "pick up" animation, allowing transfer of gear between the two units. This works even if <target unit> does not normally have a gear action (for instance between two soldiers). Using "" or ObjNull for <target unit> will drop the gear on the ground, but it will take a little while before the game recognizes the weapon holder.
UnitName opens the gear of <target unit> (but only if he is within normal range) and plays the "pick up" animation, allowing transfer of gear between the two units. This works even if <target unit> does not normally have a gear action (for instance between two soldiers). Using "" or ObjNull for <target unit> will drop the gear on the ground, but it will take a little while before the game recognizes the weapon holder.


Example:
Example:
Line 244: Line 314:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInCargo", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getInCargo", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||''unit'' action ["getInCargo", ''targetVehicle'', ''positionNumber'']
|
| ''unit'' action ["getInCargo", ''targetVehicle'', ''positionNumber'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded. ''positionNumber is a specific cargo position index number.
|
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded. ''positionNumber is a specific cargo position index number.
|-valign=top
|-valign=top
|'''Examples''':             ||soldierOne action ["getInCargo", truckOne]
|'''Examples''':
| soldierOne action ["getInCargo", truckOne]
|-valign=top
|-valign=top
|                           ||soldierOne action ["getInCargo", truckOne, 0]
|
| soldierOne action ["getInCargo", truckOne, 0]
|}
|}


Line 261: Line 337:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInCommmander", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getInCommmander", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
|
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["getInCommmander", tankOne]
|'''Example''':
| soldierOne action ["getInCommmander", tankOne]
|}
|}


Line 274: Line 354:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInDriver", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getInDriver", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
|
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["getInDriver", carOne]
|'''Example''':
| soldierOne action ["getInDriver", carOne]
|}
|}


Line 287: Line 371:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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]].
|'''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]].
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInGunner", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getInGunner", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
|
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["getInGunner", mySpotlight]
|'''Example''':
| soldierOne action ["getInGunner", mySpotlight]
|}
|}


Line 300: Line 388:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInPilot", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getInPilot", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.  
|
| Where ''unit'' is the person to board, and ''targetVehicle'' is the vehicle to be boarded.
|-valign=top
|-valign=top
|'''Example''':             ||pilotOne action ["getInPilot", chopperOne]
|'''Example''':
| pilotOne action ["getInPilot", chopperOne]
|}
|}


Line 313: Line 405:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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]].
|'''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]].
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getInTurret", ''targetVehicle'', ''turretArray'']
|'''Syntax''':
| ''unit'' action ["getInTurret", ''targetVehicle'', ''turretArray'']
|-valign=top
|-valign=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 is class CfgVehicles of the Config.
|
| 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.
|-valign=top
|-valign=top
|'''Examples''':             ||gunnerTwo action ["getInTurret", myUH60MG, [1]]
|'''Examples''':
| gunnerTwo action ["getInTurret", myUH60MG, [1]]
|-valign=top
|-valign=top
|                           ||tankCommanderOne action ["getInTurret", myT72, [0,1]]
|
| tankCommanderOne action ["getInTurret", myT72, [0,1]]
|}
|}


Line 328: Line 425:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Causes a person to disembark from a vehicle, without a parachute in the case of aircraft. See also [[#Eject|eject]].
|'''Description''':
| Causes a person to disembark from a vehicle, without a parachute in the case of aircraft. See also [[#Eject|eject]].
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["getOut", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["getOut", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the person to disembark, and ''targetVehicle'' is the vehicle to disembark from.
|
| Where ''unit'' is the person to disembark, and ''targetVehicle'' is the vehicle to disembark from.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["getOut", carOne]
|'''Example''':
| soldierOne action ["getOut", carOne]
|}
|}


Line 341: Line 442:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["handGunOn", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["handGunOn", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the unit who will ready their pistol.
|
| Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the unit who will ready their pistol.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["handGunOn", soldierOne]
|'''Example''':
| soldierOne action ["handGunOn", soldierOne]
|}
|}


Line 354: Line 459:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.  
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["handGunOff", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["handGunOff", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the person to holster it is pistol.
|
| Where ''unit'' is any unit (who will not play the action animation), and ''targetUnit'' is the person to holster it is pistol.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["handGunOff", soldierOne]
|'''Example''':
| soldierOne action ["handGunOff", soldierOne]
|}
|}


Line 367: Line 476:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["heal", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["heal", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a wounded person, and ''targetUnit'' is the medic to do the healing.  
|
| Where ''unit'' is a wounded person, and ''targetUnit'' is the medic to do the healing.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["heal", medicOne]
|'''Example''':
| soldierOne action ["heal", medicOne]
|}
|}


Line 380: Line 493:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["hideBody", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["hideBody", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a person, and ''targetUnit'' is a dead person.  
|
| Where ''unit'' is a person, and ''targetUnit'' is a dead person.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["hideBody", soldierTwo]
|'''Example''':
| soldierOne action ["hideBody", soldierTwo]
|}
|}


Line 393: Line 510:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Use and effects unknown.
|'''Description''':
| Use and effects unknown.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["inGameMenu", ''<target>'']
|'''Syntax''':
| ''unit'' action ["inGameMenu", ''<target>'']
|-valign=top
|-valign=top
|                           ||
|
|
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 406: Line 527:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["ladderDown", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["ladderDown", ''targetObject'']
|-valign=top
|-valign=top
|                           ||''unit'' action ["ladderDown", ''targetObject'', ''ladderNumber'', ''positionNumber'']
|
| ''unit'' action ["ladderDown", ''targetObject'', ''ladderNumber'', ''positionNumber'']
|-valign=top
|-valign=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.
|
| 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.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["ladderDown", (position soldierOne nearestObject 452221), 0, 1]
|'''Example''':
| soldierOne action ["ladderDown", (position soldierOne nearestObject 452221), 0, 1]
|}
|}


Line 421: Line 547:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["ladderUp", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["ladderUp", ''targetObject'']
|-valign=top
|-valign=top
|                           ||''unit'' action ["ladderUp", ''targetObject'', ''ladderNumber'', ''positionNumber'']
|
| ''unit'' action ["ladderUp", ''targetObject'', ''ladderNumber'', ''positionNumber'']
|-valign=top
|-valign=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.
|
| 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.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["ladderUp", (position soldierOne nearestObject 452221), 0, 0]
|'''Example''':
| soldierOne action ["ladderUp", (position soldierOne nearestObject 452221), 0, 0]
|}
|}


Line 436: Line 567:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["ladderOff", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["ladderOff", ''targetObject'']
|-valign=top
|-valign=top
|                           ||''unit'' action ["ladderDown", ''targetObject'', ''unknownNumber'']
|
| ''unit'' action ["ladderDown", ''targetObject'', ''unknownNumber'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any person unit, ''targetObject'' is the object with a ladder that the person is currently upon, ''unknownNumber'' is a number.
|
| Where ''unit'' is any person unit, ''targetObject'' is the object with a ladder that the person is currently upon, ''unknownNumber'' is a number.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["ladderOff", (position soldierOne nearestObject 452221)]
|'''Example''':
| soldierOne action ["ladderOff", (position soldierOne nearestObject 452221)]
|}
|}


Line 451: Line 587:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         This action appears to be identical to [[#LadderDown|LadderDown]].
|'''Description''': This action appears to be identical to [[#LadderDown|LadderDown]].
|}
|}


Line 458: Line 594:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         This action appears to be identical to [[#LadderUp|LadderUp]].
|'''Description''': This action appears to be identical to [[#LadderUp|LadderUp]].
|}
|}


Line 465: Line 601:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Turns on autopilot landing for an aircraft, including AI controlled aircraft. The aircraft will land at the closest airfield.
|'''Description''':
| Turns on autopilot landing for an aircraft, including AI controlled aircraft. The aircraft will land at the closest airfield.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["Land", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["Land", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|-valign=top
|-valign=top
|'''Example''':             ||planeOne action ["Land", planeOne]
|'''Example''':
| planeOne action ["Land", planeOne]
|}
|}


Line 479: Line 619:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Lowers the landing gear of an aircraft. Only works on player controlled aircraft.
|'''Description''':
| Lowers the landing gear of an aircraft. Only works on player controlled aircraft.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["LandGear", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["LandGear", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|-valign=top
|-valign=top
|'''Example''':             ||planeOne action ["LandGear", planeOne]
|'''Example''':
| planeOne action ["LandGear", planeOne]
|}
|}


Line 492: Line 636:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Raises the landing gear of an aircraft. Only works on player controlled aircraft.
|'''Description''':
| Raises the landing gear of an aircraft. Only works on player controlled aircraft.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["LandGearUp", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["LandGearUp", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle that can perform an autopilot landing.
|-valign=top
|-valign=top
|'''Example''':             ||planeOne action ["LandGearUp", planeOne]
|'''Example''':
| planeOne action ["LandGearUp", planeOne]
|}
|}


Line 505: Line 653:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["lightOff", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["lightOff", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["lightOff", vehicle player]
|'''Example''':
| player action ["lightOff", vehicle player]
|}
|}


Line 518: Line 670:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''Description''':
| Turns on the headlights of an empty vehicle. If vehicle is AI-controlled, see notes under the [[ArmA:_Actions#LightOff|LightOff]] action.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["lightOn", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["lightOn", ''targetVehicle'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is a vehicle with lights.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["lightOn", spotLight]
|'''Example''':
| player action ["lightOn", spotLight]
|}
|}


Line 531: Line 687:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Use and effects unknown.
|'''Description''':
| Use and effects unknown.
|-valign=top
|-valign=top
|'''Syntax''':               ||Unknown, something like - ''unit'' action ["loadMagazine", <target>, <magazine creator>, <number>, <number> ,<weapon name>, <muzzle name>]
|'''Syntax''':
| Unknown, something like - ''unit'' action ["loadMagazine", <target>, <magazine creator>, <number>, <number> ,<weapon name>, <muzzle name>]
|-valign=top
|-valign=top
|                           ||Expects a 7 element array. ArmA crashes when given incompatible syntax or data with this action, making it hard to test.
|
| Expects a 7 element array. ArmA crashes when given incompatible syntax or data with this action, making it hard to test.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["loadmagazine",player, player, 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"]  
|'''Example''':
| player action ["loadmagazine",player, player, 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"]
|}
|}


Line 544: Line 704:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.  
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["manualFire", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["manualFire", ''targetVehicle'']'''
|-valign=top
|-valign=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.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be enabled.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["ManualFire", vehicle player]
|'''Example''':
| player action ["ManualFire", vehicle player]
|}
|}


Line 557: Line 721:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Disables manual fire mode for a player unit that is driver or commander of a vehicle.
|'''Description''':
| Disables manual fire mode for a player unit that is driver or commander of a vehicle.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["manualFireCancel", ''targetVehicle'']'''
|'''Syntax''':
| ''unit'' action ["manualFireCancel", ''targetVehicle'']'''
|-valign=top
|-valign=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.
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is the vehicle in which manual fire mode is to be disabled.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["manualFireCancel", vehicle player]
|'''Example''':
| player action ["manualFireCancel", vehicle player]
|}
|}


Line 570: Line 738:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Use and effects unknown.
|'''Description''':
| Use and effects unknown.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["markEntity", <target>]
|'''Syntax''':
| ''unit'' action ["markEntity", <target>]
|-valign=top
|-valign=top
|                           ||
|
|
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 583: Line 755:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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?)
|'''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?)
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["moveToCargo", ''targetVehicle'', ''cargoPosition'']
|'''Syntax''':
| ''unit'' action ["moveToCargo", ''targetVehicle'', ''cargoPosition'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a unit within ''targetVehicle'', and ''cargoPosition'' is the number of the desired cargo position (0 being the first).
|
| Where ''unit'' is a unit within ''targetVehicle'', and ''cargoPosition'' is the number of the desired cargo position (0 being the first).
|-valign=top
|-valign=top
|'''Example''':             ||player action ["moveToCargo", vehicle player, 2]
|'''Example''':
| player action ["moveToCargo", vehicle player, 2]
|}
|}


Line 596: Line 772:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["moveToCommander", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["moveToCommander", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
|
| Where ''unit'' is a unit within ''targetVehicle''.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["moveToCommander", vehicle player]
|'''Example''':
| player action ["moveToCommander", vehicle player]
|}
|}


Line 609: Line 789:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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).
|'''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).
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["moveToDriver", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["moveToDriver", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
|
| Where ''unit'' is a unit within ''targetVehicle''.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["moveToDriver", vehicle player]
|'''Example''':
| player action ["moveToDriver", vehicle player]
|}
|}


Line 622: Line 806:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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]].
|'''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]].
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["moveToGunner", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["moveToGunner", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is a unit within ''targetVehicle''.
|
| Where ''unit'' is a unit within ''targetVehicle''.
|-valign=top
|-valign=top
|'''Example''':             ||player action ["moveToGunner", vehicle player]
|'''Example''':
| player action ["moveToGunner", vehicle player]
|}
|}


Line 635: Line 823:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         Identical to [[#MoveToDriver|moveToDriver]].
|'''Description''': Identical to [[#MoveToDriver|moveToDriver]].
|}
|}


Line 642: Line 830:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["moveToTurret", ''targetVehicle'', ''turretArray'']
|'''Syntax''':
| ''unit'' action ["moveToTurret", ''targetVehicle'', ''turretArray'']
|-valign=top
|-valign=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).
|
| 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).
|-valign=top
|-valign=top
|'''Examples''':             ||player action ["moveToTurret", vehicle player, [0]]
|'''Examples''':
| player action ["moveToTurret", vehicle player, [0]]
|-valign=top
|-valign=top
|                           ||player action ["moveToTurret", vehicle player, [0,1]]
|
| player action ["moveToTurret", vehicle player, [0,1]]
|}
|}


Line 657: Line 850:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Use and effects unknown.
|'''Description''':
| Use and effects unknown.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["none", ''<target>'']
|'''Syntax''':
| ''unit'' action ["none", ''<target>'']
|-valign=top
|-valign=top
|                           ||
|
|
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 670: Line 867:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["nvGoggles", ''<anything>'']
|'''Syntax''':
| ''unit'' action ["nvGoggles", ''<anything>'']
|-valign=top
|-valign=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).
|
| 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).
|-valign=top
|-valign=top
|'''Example''':             ||player action ["nvGoggles", player]
|'''Example''':
| player action ["nvGoggles", player]
|}
|}


Line 683: Line 884:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["nvGogglesOff", ''<anything>'']
|'''Syntax''':
| ''unit'' action ["nvGogglesOff", ''<anything>'']
|-valign=top
|-valign=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).
|
| 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).
|-valign=top
|-valign=top
|'''Example''':             ||player action ["nvGogglesOff", player]
|'''Example''':
| player action ["nvGogglesOff", player]
|}
|}


Line 696: Line 901:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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 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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["rearm", ''reamingObject'']
|'''Syntax''':
| ''unit'' action ["rearm", ''reamingObject'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is the occupied vehicle or person to be rearmed, and ''rearmingObject'' is the object from which to rearm.
|
| Where ''unit'' is the occupied vehicle or person to be rearmed, and ''rearmingObject'' is the object from which to rearm.
|-valign=top
|-valign=top
|'''Examples''':             ||tankOne action ["rearm", ammoTruckOne]
|'''Examples''':
| tankOne action ["rearm", ammoTruckOne]
|-valign=top
|-valign=top
|                           ||soldierOne action ["rearm", ammoTruckOne]
|
| soldierOne action ["rearm", ammoTruckOne]
|}
|}


Line 711: Line 921:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''vehicle'' action ["refuel", ''refuelingObject'']
|'''Syntax''':
| ''vehicle'' action ["refuel", ''refuelingObject'']
|-valign=top
|-valign=top
|                           ||Where ''vehicle'' is the occupied vehicle to be refueled, and ''refuelingObject'' is the object from which to refuel.
|
| Where ''vehicle'' is the occupied vehicle to be refueled, and ''refuelingObject'' is the object from which to refuel.
|-valign=top
|-valign=top
|'''Example''':             ||tankOne action ["refuel", refuelTruckOne]
|'''Example''':
| tankOne action ["refuel", refuelTruckOne]
|}
|}


Line 724: Line 938:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''vehicle'' action ["repair", ''repairingObject'']
|'''Syntax''':
| ''vehicle'' action ["repair", ''repairingObject'']
|-valign=top
|-valign=top
|                           ||Where ''vehicle'' is the occupied vehicle to be repaired, and ''repairingObject'' is the object from which to repair.
|
| Where ''vehicle'' is the occupied vehicle to be repaired, and ''repairingObject'' is the object from which to repair.
|-valign=top
|-valign=top
|'''Example''':             ||tankOne action ["refuel", repairTruckOne]
|'''Example''':
| tankOne action ["refuel", repairTruckOne]
|}
|}


Line 737: Line 955:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["returnFlag", ''targetObject'']
|'''Syntax''':
| ''unit'' action ["returnFlag", ''targetObject'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any person, and ''targetObject'' is the dead person with a flag to be returned.  
|
| Where ''unit'' is any person, and ''targetObject'' is the dead person with a flag to be returned.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["returnFlag", westFlag]
|'''Example''':
| soldierOne action ["returnFlag", westFlag]
|}
|}


Line 753: Line 975:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["repairVehicle", ''vehicle'']
|'''Syntax''':
| ''unit'' action ["repairVehicle", ''vehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is an Engineer unit, and ''vehicle'' is the object to repair.
|
| Where ''unit'' is an Engineer unit, and ''vehicle'' is the object to repair.
|-valign=top
|-valign=top
|'''Example''':             ||engineerOne action ["repairVehicle", truckOne]
|'''Example''':
| engineerOne action ["repairVehicle", truckOne]
|}
|}


Line 765: Line 991:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.  
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["salute", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["salute", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person to make the salute.
|
| Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person to make the salute.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["salute", soldierOne]
|'''Example''':
| soldierOne action ["salute", soldierOne]
|}
|}


Line 778: Line 1,008:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
|'''Description''':
| There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["scudCancel", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["scudCancel", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Syntax unknown.
|
| Syntax unknown.
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 791: Line 1,025:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
|'''Description''':
| There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["scudLaunch", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["scudLaunch", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Syntax unknown.
|
| Syntax unknown.
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 803: Line 1,041:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.  
|'''Description''':
| There is no Scud Launcher in ArmA, however this action (probably) remains in the engine from the days of Operation Flashpoint.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["scudStart", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["scudStart", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Syntax unknown.
|
| Syntax unknown.
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}




== SetTimer ==
== SetTimer ==
'''unitOne action ["SetTimer", unitTwo, <bombName>]'''  
'''unitOne action ["SetTimer", unitTwo, <bombName>]'''


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.
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.
Line 823: Line 1,065:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["sitDown", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["sitDown", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person who is to sit down.
|
| Where ''unit'' is any unit (no animation is performed), and ''targetUnit'' is the person who is to sit down.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["sitDown", soldierOne]
|'''Example''':
| soldierOne action ["sitDown", soldierOne]
|}
|}


Line 835: Line 1,081:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''Description''':
| 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
|-valign=top
|'''Syntax''':               ||''unit'' action ["strokeFist", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["strokeFist", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Syntax unknown.
|
| Syntax unknown.
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 848: Line 1,098:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["strokeGun", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["strokeGun", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Syntax unknown.
|
| Syntax unknown.
|-valign=top
|-valign=top
|'''Example''':             ||
|'''Example''':
|
|}
|}


Line 861: Line 1,115:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["Surrender", ''targetUnit'']
|'''Syntax''':
| ''unit'' action ["Surrender", ''targetUnit'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit, and ''targetUnit'' is the unit to surrender.
|
| Where ''unit'' is any unit, and ''targetUnit'' is the unit to surrender.
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["Surrender", soldierTwo]
|'''Example''':
| soldierOne action ["Surrender", soldierTwo]
|}
|}


Line 906: Line 1,164:
'''unitname action ["TakeWeapon", (vehiclename or unitname), "WEAPONNAME"]'''
'''unitname action ["TakeWeapon", (vehiclename or unitname), "WEAPONNAME"]'''


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.).<br>
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.).<br>
Transfer happens immediately and via teleportation. Unit1 plays pickup animation at its current position, no matter where 'weapon or magazine' is.
Transfer happens immediately and via teleportation. Unit1 plays pickup animation at its current position, no matter where 'weapon or magazine' is.


Line 959: Line 1,217:
'''["UseMagazine", <target>, <magazine creator>, <number>, <number>]'''
'''["UseMagazine", <target>, <magazine creator>, <number>, <number>]'''


This makes the target bend down, like he's using an ammo crate. I don't notice anything else happening. I don't know what the number values at the end do.
This makes the target bend down, like he's using an ammo crate. I don't notice anything else happening. I don't know what the number values at the end do.


Example:
Example:
Line 995: Line 1,253:
'''unitName action ["WeaponOnBack",<target unit>]'''
'''unitName action ["WeaponOnBack",<target unit>]'''


Soldier 'unitName' does nothing, 'target unit' moves his weapon from/to the safety position (gun held across chest pointing at the ground).  
Soldier 'unitName' does nothing, 'target unit' moves his weapon from/to the safety position (gun held across chest pointing at the ground).
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>
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>
(''VBS2 calls this action "PutWeaponOnBack"'')
(''VBS2 calls this action "PutWeaponOnBack"'')
Line 1,036: Line 1,294:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=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''':
| 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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["ArtilleryComputer", ''artillery'']
|'''Syntax''':
| ''unit'' action ["ArtilleryComputer", ''artillery'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit, and ''artillery'' is the artillery weapon
|
| Where ''unit'' is any unit, and ''artillery'' is the artillery weapon
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["ArtilleryComputer", mortarOne]
|'''Example''':
| soldierOne action ["ArtilleryComputer", mortarOne]
|}
|}


Line 1,055: Line 1,317:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-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.
|'''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.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["autoHover", ''targetVehicle'']
|'''Syntax''':
| ''unit'' action ["autoHover", ''targetVehicle'']
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.  
|
| Where ''unit'' is any unit (no action animation is performed) and ''targetVehicle'' is any vehicle that is capable of hovering.
|-valign=top
|-valign=top
|'''Example''':             ||chopperOne action ["autoHover", chopperOne]
|'''Example''':
| chopperOne action ["autoHover", chopperOne]
|}
|}


Line 1,070: Line 1,336:
:{|style="background:transparent"
:{|style="background:transparent"
|-valign=top
|-valign=top
|'''Description''':         ||Takes assembled weapon to parts (carry bags). Assembled weapon object reference may need to be kept for assembly.
|'''Description''':
| Takes assembled weapon to parts (carry bags). Assembled weapon object reference may need to be kept for assembly.
|-valign=top
|-valign=top
|'''Syntax''':               ||''unit'' action ["Disassemble", ''weapon'']'''
|'''Syntax''':
| ''unit'' action ["Disassemble", ''weapon'']'''
|-valign=top
|-valign=top
|                           ||Where ''unit'' is any unit and ''weapon'' is assembled weapon
|
| Where ''unit'' is any unit and ''weapon'' is assembled weapon
|-valign=top
|-valign=top
|'''Example''':             ||soldierOne action ["Disassemble", mortarOne]
|'''Example''':
| soldierOne action ["Disassemble", mortarOne]
|}
|}



Revision as of 20:30, 25 April 2021

See ArmA Actions - Introduction.

Arma 3
For Arma 3 actions see Arma 3: Actions.

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. Not case sensitive.
parameter(s): Various data types, dependant on the action used. The number of required parameters depends on the action type.

Actions

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]

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]


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.
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.
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:


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 another unit (including persons and vehicles), or onto the ground (creating a new WeaponHolder object). Weapons can be dropped into other units at any distance.
Syntax: unit action ["dropWeapon", targetUnit, "weaponName"]
Where unit is the person to drop a weapon (the action animation will be performed), targetUnit is either another unit into which the weapon will be dropped, or the same unit that is dropping the weapon to place it onto the ground. "weaponName" is the classname (string) of the weapon to be dropped (see the ArmA weapons list for classnames).
Examples: soldierOne action ["dropWeapon", soldierOne, "AK74GL"]
soldierOne action ["dropWeapon", ammoCrateOne, "RPG7V"]


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

unitName action ["Gear",<target unit>]
unitName action ["Gear",<target unit>]

UnitName opens the gear of <target unit> (but only if he is within normal range) and plays the "pick up" animation, allowing transfer of gear between the two units. This works even if <target unit> does not normally have a gear action (for instance between two soldiers). Using "" or ObjNull for <target unit> will drop the gear on the ground, but it will take a little while before the game recognizes the weapon holder.

Example: SoldierOne action ["Gear", SoldierTwo]

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.
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 ["getInCommmander", targetVehicle]
Where unit is the person to board, and targetVehicle is the vehicle to be boarded.
Example: soldierOne action ["getInCommmander", 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]


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]
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.
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 ["ladderDown", 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. Only works on player controlled aircraft.
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. Only works on player controlled aircraft.
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", spotLight]


LoadMagazine

Description: Use and effects unknown.
Syntax: Unknown, something like - unit action ["loadMagazine", <target>, <magazine creator>, <number>, <number> ,<weapon name>, <muzzle name>]
Expects a 7 element array. ArmA crashes when given incompatible syntax or data with this action, making it hard to test.
Example: player action ["loadmagazine",player, player, 0, 1 ,"vbs2_us_m16a2_iron_gla", "vbs2_us_m16a2_iron_gla"]


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.
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.
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.
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. (possibly alternate syntax to place unit in first empty cargo position?)
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]


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 ["refuel", 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

OA only. Required version 1.54.

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:


SetTimer

unitOne action ["SetTimer", unitTwo, <bombName>]

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.


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]


SwitchMagazine

<unit> action ["SwitchMagazine", <target vehicle>, <target unit>, <mode index>]

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.

Example: gameLogic action ["SwitchMagazine", unit1, unit1, 3]; gameLogic action ["SwitchMagazine", m1a1, gunner m1a1, 1];

SwitchWeapon

unitOne action ["SwitchWeapon", <target unit>, <target unit>, <muzzle index>]

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.

Example: unit2 action ["SwitchWeapon",unit1,unit1,7] player action ["SwitchWeapon", vehicle player, vehicle player, 3]

TakeFlag

unitname action ["TakeFlag", flag1]

Soldier 'unitname' takes control of 'flag1'. He must be close to the flagpole and it must belong to an enemy side.

Example: SoldierOne action ["TakeFlag", FlagOne]


TakeMagazine / TakeWeapon

unitname action ["TakeMagazine", (vehiclename or unitname), "MAGAZINENAME"]
unitname action ["TakeWeapon", (vehiclename or unitname), "WEAPONNAME"]

Soldier 'unitname' takes one magazine/weapon of specified type (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.

Example: SoldierOne action ["TakeMagazine", SoldierTwo, "RPGLauncher"]


TakeMine

unitName action ["TakeMine", <target unit>]

UnitName will perform the action animation. The closest mine that is within two meters of the target unit will be placed into the target unit's inventory.

Example: unit1 action ["takeMine",unit2]


Talk

["Talk", <target>]


TeamSwitch

<current unit> action ["TeamSwitch ", <unit>]

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).

Example: player action ["TeamSwitch", player]


TouchOff

unitOne action ["TouchOff", unitTwo]

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.

Example: unitname action ["TouchOff", unitname]


TurnIn / TurnOut

unitName action ["TurnIn", vehicleName]
unitName action ["TurnOut", vehicleName]

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.

Examples: TankOne action ["TurnIn", TankOne] player action ["TurnOut,vehicle player]


UseMagazine

["UseMagazine", <target>, <magazine creator>, <number>, <number>]

This makes the target bend down, like he's using an ammo crate. I don't notice anything else happening. I don't know what the number values at the end do.

Example: player action["UseMagazine", player, player, 0, 0]

User

unitName ["User", <target unit>, <action index>]

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.

Example: gameLogic action ["User", player, 3]


UserType

["UserType", <target>, <action index>]

As of ArmA version 1.08, using this action type will cause ArmA to crash to desktop.


UseWeapon

unitOne ["UseWeapon", <target vehicle>, <target unit>, <weapon index>]

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.

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]


WeaponInHand / WeaponOnBack

unitName action ["WeaponInHand",<target unit>]
unitName action ["WeaponOnBack",<target unit>]

Soldier 'unitName' does nothing, 'target unit' moves his weapon from/to the safety position (gun held across chest pointing at the ground). Change is persistent with player, but AI units will change back to suit their current behaviour mode. AI generally keep their rifles safe unless moving or targeting.
(VBS2 calls this action "PutWeaponOnBack")

Example: SoldierOne action ["WeaponOnBack", SoldierTwo]

Unsorted actions found in UI.pbo/config.bin

LoadOtherMagazine

LoadEmptyMagazine

PutWeapon

is synonym for DropWeapon (same syntax)?

PutMagazine

is synonym for DropMagazine (same syntax)?

StartTimer

is synonym for SetTimer (same syntax) ?

HideWeapon

unit action ["hideWeapon",<object>,<object>,<Number>]

MarkWeapon

HandGunOffStand

HandGunOnStand

TakeDropMagazine/TakeDropWeapon

AddBag

OA only.

ArtilleryComputer

OA only. Required version 1.54.

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]

Assemble

OA only.

Example : _unit action ["Assemble", (nearestObject [_unit, "Tripod_Bag"])];

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 ["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]

Disassemble

OA only.

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

DropBag

Works the same as dropWeapon and dropMagazine, but with backpacks. Syntax:

unit1 action ["dropbag", unit2, (typeOf unitBackPack unit1)];

unit1 will perform the 'gear' action, and unit1's backpack will be moved to unit2, IF unit2 has free backpack space. Will actually transfer backpack + content (if applicable). Units do not need to be close for this to work. Note: if unit2 already has a backpack, unit1's backpack will drop to the ground at unit2's feet, and be unavailable (for picking up/using).

OA only.

FirstAid

GetOver

GunLightOff

OA only.

GunLightOn

OA only.

HealSoldier

IRLaserOff

OA only.

IRLaserOn

OA only.

OpenBag

OA only.

PutBag

OA only.

_unit action ["putbag", _unit];

_unit will bend down and place his backpack on the ground.

TakeBag

OA only.

Tell