Difference between revisions of "Arma 3: Event Handlers"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (IncomingMissile added description of AI or Player - also fires when player fires a missile. Not just AI.)
(Page lifting)
Line 1: Line 1:
 
__NOEDITSECTION__
 
__NOEDITSECTION__
 +
<div style="float: right; margin-left: 1.5em;">__TOC__</div>
  
An event handler (abbreviated to EH) allows you to automatically monitor and then execute custom code upon particular events being triggered.
+
An event handler (abbreviated to EH) allows you to automatically monitor and then execute custom code upon particular events being triggered.<br />
 
 
 
See also [[Event Scripts]] for special event triggered scripts.
 
See also [[Event Scripts]] for special event triggered scripts.
  
== addEventHandler ==
+
== Basic Event Handlers ==
 
Object event handler, always executed on the computer where it was added.
 
Object event handler, always executed on the computer where it was added.
  
Line 14: Line 14:
  
 
'''Example:'''
 
'''Example:'''
  mySoldier addEventHandler ["Killed",{[[hint]] [[format]] ["%1 was killed by %2",[[name]] (_this [[select]] 0),name (_this select 1)];}]
+
  mySoldier addEventHandler ["Killed",{ [[hint]] [[format]] ["%1 was killed by %2",[[name]] (_this [[select]] 0), name (_this select 1)]; }];
  
=== Default ===
+
=== Standard ===
  
{| class="wikitable sortable"
+
==== AnimChanged ====
! Class
+
{{EffArg|cmd|args|global}}<br />
! class="unsortable" | Description
+
Triggered every time a new animation is started. This EH is only triggered for the 1st animation state in a sequence.
! class="unsortable" | Arguments
+
It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
! class="unsortable" | MP-Effects
+
<syntaxhighlight lang="cpp">this addEventHandler ["AnimChanged", {
! Since
+
params ["_unit", "_anim"];
 +
}];</syntaxhighlight>
  
|-
 
| <!-- Title -->
 
==== AnimChanged ====
 
| <!-- Description -->
 
Triggered every time a new animation is started. This EH is only triggered for the 1st animation state in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 
| <!-- Arguments -->
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* anim: [[String]] - Name of the anim that is started
 
* anim: [[String]] - Name of the anim that is started
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== AnimDone ====
 
==== AnimDone ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered every time an animation is finished. Triggered for all animation states in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
+
Triggered every time an animation is finished. Triggered for all animation states in a sequence.
| <!-- Arguments -->
+
It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["AnimDone", {
 +
params ["_unit", "_anim"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* anim: [[String]] - Name of the anim that has been finished
 
* anim: [[String]] - Name of the anim that has been finished
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== AnimStateChanged ====
 
==== AnimStateChanged ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered every time an animation state changes. Triggered for all animation states in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
+
Triggered every time an animation state changes. Triggered for all animation states in a sequence.
| <!-- Arguments -->
+
It can be assigned to a remote unit but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["AnimStateChanged", {
 +
params ["_unit", "_anim"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* anim: [[String]] - Name of the anim that has been started
 
* anim: [[String]] - Name of the anim that has been started
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.32}}</div>
| <!-- Title -->
 
 
==== ContainerClosed ====
 
==== ContainerClosed ====
| <!-- Description -->
+
</div>
Triggers when player finished accessing cargo container. This event handler is similar to "InventoryClosed" EH, but needs to be assigned to the container rather than the player. Note: will trigger only for the unit opening container.
+
{{EffArg|cmd|args|global}}<br />
 +
Triggers when player finished accessing cargo container.
 +
This event handler is similar to "InventoryClosed" EH, but needs to be assigned to the container rather than the player.
 +
Note: will trigger only for the unit opening container.
 +
 
 +
<syntaxhighlight lang="cpp">this addEventHandler ["ContainerClosed", {
 +
params ["_container", "_unit"];
 +
}];</syntaxhighlight>
  
| <!-- Arguments -->
 
 
* container: [[Object]] - Cargo container.
 
* container: [[Object]] - Cargo container.
 
* player: [[Object]] - Unit who accessed the container.
 
* player: [[Object]] - Unit who accessed the container.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.32}}
 
  
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.32}}</div>
| <!-- Title -->
 
 
==== ContainerOpened ====
 
==== ContainerOpened ====
| <!-- Description -->
+
</div>
Triggers when cargo container is accessed by player. This event handler is similar to "InventoryOpened" EH, but needs to be assigned to the container rather than the player and cannot be overridden. Note: will trigger only for the unit opening container..
+
{{EffArg|cmd|args|global}}<br />
 +
Triggers when cargo container is accessed by player.
 +
This event handler is similar to "InventoryOpened" EH, but needs to be assigned to the container rather than the player and cannot be overridden.
 +
Note: will trigger only for the unit opening container.
 +
 
 +
<syntaxhighlight lang="cpp">this addEventHandler ["ContainerOpened", {
 +
params ["_container", "_unit"];
 +
}];</syntaxhighlight>
  
| <!-- Arguments -->
 
 
* container: [[Object]] - Cargo container.
 
* container: [[Object]] - Cargo container.
 
* player: [[Object]] - Unit who accessed the container.
 
* player: [[Object]] - Unit who accessed the container.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.32}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.00}}</div>
 
==== ControlsShifted ====
 
==== ControlsShifted ====
| <!-- Description -->
+
</div>
Triggers when controls of vehicle are shifted (pilot->co-pilot, co-pilot->pilot). Works for both, "Take" and "Release" controls actions. Event only triggers on PC where vehicle is [[local]] and EH was added.
+
{{EffArg|cmd|args|local}}<br />
 +
Triggers when controls of vehicle are shifted (pilot->co-pilot, co-pilot->pilot). Works for both, "Take" and "Release" controls actions.
 +
Event only triggers on PC where vehicle is [[local]] and EH was added.
  
 
'''Notes:'''
 
'''Notes:'''
* If helicopter is [[local]] to the server and co-pilot takes controls, the helicopter changes locality to co-pilot PC. This means that if "ControlsShifted" EH was added on both server and client, "Take Controls" action will trigger EH on the server PC, but subsequent co-pilot "Release Controls" action will trigger it on co-pilot's PC.
+
* If helicopter is [[local]] to the server and co-pilot takes controls, the helicopter changes locality to co-pilot PC.
 +
This means that if "ControlsShifted" EH was added on both server and client, "Take Controls" action will trigger EH on the server PC, but subsequent co-pilot "Release Controls" action will trigger it on co-pilot's PC.
 +
 
 +
<syntaxhighlight lang="cpp">this addEventHandler ["ControlsShifted", {
 +
params ["_vehicle", "_newController", "_oldController"];
 +
}];</syntaxhighlight>
  
| <!-- Arguments -->
 
 
* vehicle: [[Object]] - Vehicle which controls were shifted.
 
* vehicle: [[Object]] - Vehicle which controls were shifted.
 
* newController: [[Object]] - Unit who controls vehicle after this event.
 
* newController: [[Object]] - Unit who controls vehicle after this event.
 
* oldController: [[Object]] - Unit who controled vehicle before this event.
 
* oldController: [[Object]] - Unit who controled vehicle before this event.
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.00}}
 
  
  
|-
 
| <!-- Title -->
 
 
==== Dammaged ====
 
==== Dammaged ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered when the unit is damaged. In ArmA works with all vehicles not only men like in OFP. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
+
Triggered when the unit is damaged. In ArmA works with all vehicles not only men like in OFP.
 +
It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
  
 
'''Notes:'''
 
'''Notes:'''
 +
* The typo is "intentional": it is Da'''mm'''aged with two "m".
 
* If simultaneous damage occured (e.g. via grenade) EH might be triggered several times.
 
* If simultaneous damage occured (e.g. via grenade) EH might be triggered several times.
 
* The Dammaged EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.
 
* The Dammaged EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.
  
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Dammaged", {
 +
params ["_unit", "_selection", "_damage", "_hitIndex", "_hitPoint", "_shooter", "_projectile"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* hitSelection: [[String]] - Name of the selection where the unit was damaged
 
* hitSelection: [[String]] - Name of the selection where the unit was damaged
 
* damage: [[Number]] - Resulting level of damage
 
* damage: [[Number]] - Resulting level of damage
''(Since Arma 3 v 1.67)''
+
* {{GVI|arma3|1.67}} hitPartIndex: [[Number]] - hit index of the hit selection
* hitPartIndex: [[Number]] - hit index of the hit selection
+
* {{GVI|arma3|1.67}} hitPoint: [[String]] - hit point Cfg name
* hitPoint: [[String]] - hit point Cfg name  
+
* {{GVI|arma3|1.69}} shooter: [[Object]] - shooter reference (to get instigator use [[getShotParents]] on projectile)
''(Since Arma 3 v 1.69)''
+
* {{GVI|arma3|1.69}} projectile: [[Object]] - the projectile that caused damage
* shooter: [[Object]] - shooter reference (to get instigator use [[getShotParents]] on projectile)
 
* projectile: [[Object]] - the projectile that caused damage
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.67}}</div>
 
==== Deleted ====
 
==== Deleted ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered just before the assigned entity is deleted.
 
Triggered just before the assigned entity is deleted.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Deleted", {
 +
params ["_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* entity: [[Object]] - Object the event handler is assigned to
 
* entity: [[Object]] - Object the event handler is assigned to
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma 3|1.67}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== Engine ====
 
==== Engine ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered when the engine of the unit is turned on/off.
 
Triggered when the engine of the unit is turned on/off.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Engine", {
 +
params ["_vehicle", "_engineState"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* engineState: [[Boolean]] - True when the engine is turned on, false when turned off
 
* engineState: [[Boolean]] - True when the engine is turned on, false when turned off
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.00}}</div>
 
==== EpeContact ====
 
==== EpeContact ====
| <!-- Description -->
+
</div>
Triggered when object collision (PhysX) is in progress. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when object collision (PhysX) is in progress.
 +
It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["EpeContact", {
 +
params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
 +
}];</syntaxhighlight>
 +
 
 
* object1: [[Object]] - Object with attached handler.
 
* object1: [[Object]] - Object with attached handler.
 
* object2: [[Object]] - Object which is colliding with object1.
 
* object2: [[Object]] - Object which is colliding with object1.
Line 174: Line 167:
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* force: [[Number]] - Force of collision.
 
* force: [[Number]] - Force of collision.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.00}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.00}}</div>
 
==== EpeContactEnd ====
 
==== EpeContactEnd ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered when object collision (PhysX) ends. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 
Triggered when object collision (PhysX) ends. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["EpeContactEnd", {
 +
params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
 +
}];</syntaxhighlight>
 +
 
 
* object1: [[Object]] - Object with attached handler.
 
* object1: [[Object]] - Object with attached handler.
 
* object2: [[Object]] - Object which is colliding with object1.
 
* object2: [[Object]] - Object which is colliding with object1.
Line 190: Line 183:
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* force: [[Number]] - Force of collision.
 
* force: [[Number]] - Force of collision.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.00}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.00}}</div>
 
==== EpeContactStart ====
 
==== EpeContactStart ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered when object collision (PhysX) starts. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 
Triggered when object collision (PhysX) starts. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["EpeContactStart", {
 +
params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
 +
}];</syntaxhighlight>
 +
 
 
* object1: [[Object]] - Object with attached handler.
 
* object1: [[Object]] - Object with attached handler.
 
* object2: [[Object]] - Object which is colliding with object1.
 
* object2: [[Object]] - Object which is colliding with object1.
Line 206: Line 199:
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* select2: [[String]] - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
 
* force: [[Number]] - Force of collision.
 
* force: [[Number]] - Force of collision.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.00}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.76}}</div>
 
==== Explosion ====
 
==== Explosion ====
| <!-- Description -->
+
</div>
Triggered when a vehicle or unit is damaged by a nearby explosion. It can be assigned to a remote unit or vehicle but will only fire on the PC where EH is added and explosion is local, i.e. it really needs to be added on every PC and JIP and will fire only where the explosion is originated.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when a vehicle or unit is damaged by a nearby explosion.
 +
It can be assigned to a remote unit or vehicle but will only fire on the PC where EH is added and explosion is local, i.e. it really needs to be added on every PC and JIP and will fire only where the explosion is originated.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["Explosion", {
 +
params ["_vehicle", "_damage"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Object the event handler is assigned to
 
* vehicle: [[Object]] - Object the event handler is assigned to
 
* damage: [[Number]] - Damage inflicted to the object
 
* damage: [[Number]] - Damage inflicted to the object
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|0.76}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== Fired ====
 
==== Fired ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered when the unit fires a weapon.<br>
+
Triggered when the unit fires a weapon.<br />
This EH will not trigger if a unit fires out of a vehicle. For those cases an EH has to be attached to that particular vehicle. When "Manual Fire" is used, the ''gunner'' is [[objNull]] if gunner is not present or the ''gunner'' is not the one who fires. To check if "Manual Fire" is on, use [[isManualFire]]. The actual shot instigator could be retrieved with [[getShotParents]] command.
+
This EH will not trigger if a unit fires out of a vehicle. For those cases an EH has to be attached to that particular vehicle.
| <!-- Arguments -->  
+
When "Manual Fire" is used, the ''gunner'' is [[objNull]] if gunner is not present or the ''gunner'' is not the one who fires.
* unit: [[Object]] - Object the event handler is assigned to <br />
+
To check if "Manual Fire" is on, use [[isManualFire]]. The actual shot instigator could be retrieved with [[getShotParents]] command.
* weapon: [[String]] - Fired weapon <br />
+
<syntaxhighlight lang="cpp">this addEventHandler ["Fired", {
* muzzle: [[String]] - Muzzle that was used <br />
+
params ["_unit", "_weapon", "_muzzle", "_mode", "_ammo", "_magazine", "_projectile", "_gunner"];
* mode: [[String]] - Current mode of the fired weapon<br />
+
}];</syntaxhighlight>
* ammo: [[String]] - Ammo used <br />
+
 
* magazine: [[String]] - magazine name which was used<br />
+
* unit: [[Object]] - Object the event handler is assigned to
''(Since Arma 2 OA)''
+
* weapon: [[String]] - Fired weapon
 +
* muzzle: [[String]] - Muzzle that was used
 +
* mode: [[String]] - Current mode of the fired weapon
 +
* ammo: [[String]] - Ammo used
 +
* magazine: [[String]] - magazine name which was used
 
* projectile: [[Object]] - Object of the projectile that was shot out
 
* projectile: [[Object]] - Object of the projectile that was shot out
''(Since Arma 3 v 1.65)''
+
* {{GVI|arma3|1.65}} gunner: [[Object]] - gunner whose weapons are firing.
* gunner: [[Object]] - gunner whose weapons are firing.  
+
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.65}}</div>
| <!-- Title -->
 
 
==== FiredMan ====
 
==== FiredMan ====
| <!-- Description -->
+
</div>
Triggered when the unit fires a weapon. This EH must be attached to a soldier and unlike with "Fired" EH, it will fire regardless of whether the soldier is on foot or firing vehicle weapon. For [[remoteControl]]ed unit use "Fired" EH instead.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when the unit fires a weapon. This EH must be attached to a soldier and unlike with "Fired" EH, it will fire regardless of whether the soldier is on foot or firing vehicle weapon.
 +
For [[remoteControl]]ed unit use "Fired" EH instead.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["FiredMan", {
 +
params ["_unit", "_weapon", "_muzzle", "_mode", "_ammo", "_magazine", "_projectile", "_vehicle"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Unit the event handler is assigned to (the instigator)
 
* unit: [[Object]] - Unit the event handler is assigned to (the instigator)
 
* weapon: [[String]] - Fired weapon
 
* weapon: [[String]] - Fired weapon
 
* muzzle: [[String]] - Muzzle that was used
 
* muzzle: [[String]] - Muzzle that was used
* mode: [[String]] - Current mode of the fired weapon  
+
* mode: [[String]] - Current mode of the fired weapon
 
* ammo: [[String]] - Ammo used
 
* ammo: [[String]] - Ammo used
* magazine: [[String]] - magazine name which was used
+
* magazine: [[String]] - magazine name which was used
 
* projectile: [[Object]] - Object of the projectile that was shot out
 
* projectile: [[Object]] - Object of the projectile that was shot out
 
* vehicle: [[Object]] - Vehicle, if weapon is vehicle weapon, otherwise [[objNull]]
 
* vehicle: [[Object]] - Vehicle, if weapon is vehicle weapon, otherwise [[objNull]]
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.65}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== FiredNear ====
 
==== FiredNear ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered when a weapon is fired somewhere ''near'' the unit or vehicle. It is also triggered if the unit itself is firing. (Exception(s): the Throw weapon wont broadcast the FiredNear event). When "Manual Fire" is used, the ''gunner'' is [[objNull]] if gunner is not present or the ''gunner'' is not the one who fires. To check if "Manual Fire" is on, use [[isManualFire]]. The actual shot instigator could be retrieved with [[getShotParents]] command.
+
Triggered when a weapon is fired somewhere ''near'' the unit or vehicle. It is also triggered if the unit itself is firing.
{{GVI|Arma 3|1.30|}} Works with thrown weapons.
+
(Exception(s): the Throw weapon wont broadcast the FiredNear event).
| <!-- Arguments -->
+
When "Manual Fire" is used, the ''gunner'' is [[objNull]] if gunner is not present or the ''gunner'' is not the one who fires.
 +
To check if "Manual Fire" is on, use [[isManualFire]]. The actual shot instigator could be retrieved with [[getShotParents]] command.
 +
{{GVI|Arma 3|1.30}} Works with thrown weapons.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["FiredNear", {
 +
params ["_unit", "_firer", "_distance", "_weapon", "_muzzle", "_mode", "_ammo", "_gunner"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
* vehicle: [[Object]] - Object which fires a weapon near the unit
+
* firer: [[Object]] - Object which fires a weapon near the unit
 
* distance: [[Number]] - Distance in meters between the ''unit'' and ''firer'' (max. distance ~69m)
 
* distance: [[Number]] - Distance in meters between the ''unit'' and ''firer'' (max. distance ~69m)
 
* weapon: [[String]] - Fired weapon
 
* weapon: [[String]] - Fired weapon
Line 279: Line 273:
 
* mode: [[String]] - Current mode of the fired weapon
 
* mode: [[String]] - Current mode of the fired weapon
 
* ammo: [[String]] - Ammo used
 
* ammo: [[String]] - Ammo used
''(Since Arma 3 v 1.65)''
+
* {{GVI|arma3|1.65}} gunner: [[Object]] - gunner, whose weapons are fired
* gunner: [[Object]] - gunner, whose weapons are fired
+
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
|-
 
| <!-- Title -->
 
 
==== Fuel ====
 
==== Fuel ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered when the unit's fuel status changes between completely empty / not empty (only useful if the event handler is assigned to a vehicle).
 
Triggered when the unit's fuel status changes between completely empty / not empty (only useful if the event handler is assigned to a vehicle).
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Fuel", {
 +
params ["_vehicle", "_fuel"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* fuelState: [[Boolean]] - 0 when no fuel, 1 when the fuel tank is full
 
* fuelState: [[Boolean]] - 0 when no fuel, 1 when the fuel tank is full
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== Gear ====
 
==== Gear ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered when the unit lowers/retracts the landing gear (only useful if the event handler is assigned to is a member of the class "Plane"). Also triggered for helicopters in landing mode, regardless if they have or don't have retractable gear.
+
Triggered when the unit lowers/retracts the landing gear (only useful if the event handler is assigned to is a member of the class "Plane").
| <!-- Arguments -->
+
Also triggered for helicopters in landing mode, regardless if they have or don't have retractable gear.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["Gear", {
 +
params ["_vehicle", "_gearState"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* gearState: [[Boolean]] - True when the gear is lowered, false when retracted
 
* gearState: [[Boolean]] - True when the gear is lowered, false when retracted
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== GetIn ====
 
==== GetIn ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggers when a unit enters a vehicle. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed. This EH is triggered by moveInXXXX commands and "GetInXXXX" [[action]]s, but not upon a seat change within the same vehicle.
 
Triggers when a unit enters a vehicle. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed. This EH is triggered by moveInXXXX commands and "GetInXXXX" [[action]]s, but not upon a seat change within the same vehicle.
  
 
In vehicles with multi-turret setup, entering any turret will show "gunner" for position.
 
In vehicles with multi-turret setup, entering any turret will show "gunner" for position.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["GetIn", {
 +
params ["_vehicle", "_role", "_unit", "_turret"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
* position: [[String]] - Can be either "driver", "gunner" or "cargo"
+
* role: [[String]] - Can be either "driver", "gunner" or "cargo"
 
* unit: [[Object]] - Unit that entered the vehicle
 
* unit: [[Object]] - Unit that entered the vehicle
''(Since Arma 3 v1.36)''
+
* {{GVI|arma3|1.36}} turret: [[Array]] - turret path
* turret: [[Array]] - turret path
+
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.57}}</div>
| <!-- Title -->
 
 
==== GetInMan ====
 
==== GetInMan ====
| <!-- Description -->
+
</div>
Triggers when a unit enters a vehicle. Similar to "GetIn" but must be assigned to a unit and not vehicle. Persistent on respawn if assigned where unit was [[local]]. This EH is triggered by moveInXXXX commands and "GetInXXXX" [[action]]s.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggers when a unit enters a vehicle. Similar to "GetIn" but must be assigned to a unit and not vehicle.
 +
Persistent on respawn if assigned where unit was [[local]]. This EH is triggered by moveInXXXX commands and "GetInXXXX" [[action]]s.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["GetInMan", {
 +
params ["_unit", "_role", "_vehicle", "_turret"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Unit the event handler is assigned to
 
* unit: [[Object]] - Unit the event handler is assigned to
* position: [[String]] - Can be either "driver", "gunner" or "cargo"
+
* role: [[String]] - Can be either "driver", "gunner" or "cargo"
 
* vehicle: [[Object]] - Vehicle the unit entered
 
* vehicle: [[Object]] - Vehicle the unit entered
 
* turret: [[Array]] - turret path
 
* turret: [[Array]] - turret path
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.57}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== GetOut ====
 
==== GetOut ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggers when a unit gets out from a vehicle. It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed. This EH is triggered by [[moveOut]], "GetOut" & "Eject" [[action]]s, if an [[alive]] [[crew]] member disconnects or is deleted, but not upon a seat change within the same vehicle.
+
Triggers when a unit gets out from a vehicle.
| <!-- Arguments -->
+
It can be assigned to a remote vehicle but will only fire on the PC where the actual [[addEventHandler]] command was executed.
 +
This EH is triggered by [[moveOut]], "GetOut" & "Eject" [[action]]s, if an [[alive]] [[crew]] member disconnects or is deleted, but not upon a seat change within the same vehicle.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["GetOut", {
 +
params ["_vehicle", "_role", "_unit", "_turret"];
 +
}];</syntaxhighlight>
 +
 
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
 
* vehicle: [[Object]] - Vehicle the event handler is assigned to
* position: [[String]] - Can be either "driver", "gunner" or "cargo"
+
* role: [[String]] - Can be either "driver", "gunner" or "cargo"
 
* unit: [[Object]] - Unit that left the vehicle
 
* unit: [[Object]] - Unit that left the vehicle
* turret: [[Array]] - turret path (since Arma 3 v1.36)
+
* {{GVI|arma3|1.36}} turret: [[Array]] - turret path
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.57}}</div>
 
==== GetOutMan ====
 
==== GetOutMan ====
| <!-- Description -->
+
</div>
Triggers when a unit exits a vehicle. Similar to "GetOut" but must be assigned to a unit and not vehicle. Persistent on respawn if assigned where unit was [[local]]. This EH is triggered by [[moveOut]] and "GetOut" & "Eject" [[action]]s.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggers when a unit exits a vehicle. Similar to "GetOut" but must be assigned to a unit and not vehicle.
 +
Persistent on respawn if assigned where unit was [[local]]. This EH is triggered by [[moveOut]] and "GetOut" & "Eject" [[action]]s.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["GetOutMan", {
 +
params ["_unit", "_role", "_vehicle", "_turret"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - unit the event handler is assigned to
 
* unit: [[Object]] - unit the event handler is assigned to
* position: [[String]] - Can be either "driver", "gunner" or "cargo"
+
* role: [[String]] - Can be either "driver", "gunner" or "cargo"
 
* vehicle: [[Object]] - Vehicle that the unit left
 
* vehicle: [[Object]] - Vehicle that the unit left
 
* turret: [[Array]] - turret path
 
* turret: [[Array]] - turret path
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.57}}
 
  
  
|-
 
| <!-- Title -->
 
 
==== HandleDamage ====
 
==== HandleDamage ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggers when the unit is damaged and fires for each damaged selection separately (Note: Currently, in Arma 3 v1.70 it triggers for every selection of a vehicle, no matter if the section was damaged or not). Works with all vehicles. This EH can accept a remote unit as argument however it will only fire when the unit is [[local]] to the PC this event handler was added on. For example, you can add this event handler to one particular vehicle on every PC. When this vehicle gets hit, only EH on PC where the vehicle is currently [[local]] will fire.
+
Triggers when the unit is damaged and fires for each damaged selection separately  
 +
Note: Currently, in Arma 3 v1.70 it triggers for every selection of a vehicle, no matter if the section was damaged or not). Works with all vehicles.
 +
This EH can accept a remote unit as argument however it will only fire when the unit is [[local]] to the PC this event handler was added on.
 +
For example, you can add this event handler to one particular vehicle on every PC.
 +
When this vehicle gets hit, only EH on PC where the vehicle is currently [[local]] will fire.
  
If code provided returns a numeric value, this value will overwrite the default damage of given selection after processing. Return value of 0 will make the unit invulnerable if damage is not scripted in other ways (i.e using [[setDamage]] and/or [[setHit]] for additional damage handling). If no value is returned, the default damage processing will be done. This allows for safe stacking of this event handler. Only the return value of the last added "HandleDamage" EH is considered.
+
If code provided returns a numeric value, this value will overwrite the default damage of given selection after processing.
 +
Return value of 0 will make the unit invulnerable if damage is not scripted in other ways (i.e using [[setDamage]] and/or [[setHit]] for additional damage handling).
 +
If no value is returned, the default damage processing will be done. This allows for safe stacking of this event handler.
 +
Only the return value of the last added "HandleDamage" EH is considered.
  
 
'''Notes:'''
 
'''Notes:'''
* Multiple "HandleDamage" event handlers can be added to the same unit. If multiple EHs return damage value for custom damage handling, only last returned value will be considered by the engine. EHs that do not return value can be safely added after EHs that do return value.  
+
* Multiple "HandleDamage" event handlers can be added to the same unit. If multiple EHs return damage value for custom damage handling, only last returned value will be considered by the engine.
 +
EHs that do not return value can be safely added after EHs that do return value.
 
* You can save the last event as timestamp ([[diag_tickTime]]) onto the unit, as well as the current health of the unit/its selections, with [[setVariable]] and query it on each "HandleDamage" event with [[getVariable]] to define a system how to handle the "HandleDamage" event.
 
* You can save the last event as timestamp ([[diag_tickTime]]) onto the unit, as well as the current health of the unit/its selections, with [[setVariable]] and query it on each "HandleDamage" event with [[getVariable]] to define a system how to handle the "HandleDamage" event.
 
* "HandleDamage" will continue to trigger even if the unit is already dead.
 
* "HandleDamage" will continue to trigger even if the unit is already dead.
* "HandleDamage" is persistent. If you add it to the [[player]] object, it will continue to exist after player respawned.
+
* "HandleDamage" is persistent. If you add it to the [[player]] object, it will continue to exist after player respawned.
 
* "HandleDamage" can trigger "twice" per damage event. Once for direct damage, once for indirect damage (explosive damage). This can happen even in the same frame, but is unlikely.
 
* "HandleDamage" can trigger "twice" per damage event. Once for direct damage, once for indirect damage (explosive damage). This can happen even in the same frame, but is unlikely.
  
 
Additional [https://forums.bistudio.com/forums/topic/205515-handledamage-event-handler-explained/ Celery's explanation (Updated by ShadowRanger for Arma 3)].
 
Additional [https://forums.bistudio.com/forums/topic/205515-handledamage-event-handler-explained/ Celery's explanation (Updated by ShadowRanger for Arma 3)].
  
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["HandleDamage", {
 +
params ["_unit", "_selection", "_damage", "_source", "_projectile", "_hitIndex", "_instigator", "_hitPoint"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to.
 
* unit: [[Object]] - Object the event handler is assigned to.
 
* hitSelection: [[String]] - Name of the selection where the unit was damaged. "" for over-all structural damage, "?" for unknown selections.
 
* hitSelection: [[String]] - Name of the selection where the unit was damaged. "" for over-all structural damage, "?" for unknown selections.
Line 399: Line 393:
 
* source: [[Object]] - The source unit that caused the damage.
 
* source: [[Object]] - The source unit that caused the damage.
 
* projectile: [[String]] - Classname of the projectile that caused inflicted the damage. ("" for unknown, such as falling damage.)
 
* projectile: [[String]] - Classname of the projectile that caused inflicted the damage. ("" for unknown, such as falling damage.)
''(Since Arma 3 v1.49)''
+
* {{GVI|arma3|1.49}} hitPartIndex: [[Number]] - Hit part index of the hit point, -1 otherwise.
* hitPartIndex: [[Number]] - Hit part index of the hit point, -1 otherwise.
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
''(Since Arma 3 v1.65)''
+
* {{GVI|arma3|1.67}} hitPoint: [[String]] - hit point Cfg name
* instigator: [[Object]] - Person who pulled the trigger
 
''(Since Arma 3 v 1.67)''
 
* hitPoint: [[String]] - hit point Cfg name  
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
  
|-
 
| <!-- Title -->
 
 
==== HandleHeal ====
 
==== HandleHeal ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered when unit starts to heal (player using heal action or AI heals after being ordered). Triggers only on PC where EH is added and unit is [[local]]. If code returns false, engine side healing follows. Return true if you handle healing in script, use [[AISFinishHeal]] to tell engine that script side healing is done. See also [[lifeState]] and [[setUnconscious]] commands.<br><br>'''NOTE''': This Event Handler is broken but somewhat usable. When attached to a unit it will fire when medic action is started (not finished!) on the unit. _this [[select]] 0 will be the unit itself, _this [[select]] 1 will be the healer. The 3rd param will always be [[false]] and neither returning [[true]] nor using [[AISFinishHeal]] will have any effect on engine's default healing behaviour. If unit walks away from the healer during healing action, the heal will not finish but there is no way of detecting this within "handleheal" framework.
+
Triggered when unit starts to heal (player using heal action or AI heals after being ordered).
<br><br>This code will fix unit to 100% health after self-use of medpack:<code>0 = this [[addEventHandler]] ["HandleHeal", {
+
Triggers only on PC where EH is added and unit is [[local]].
 +
If code returns false, engine side healing follows.
 +
Return true if you handle healing in script, use [[AISFinishHeal]] to tell engine that script side healing is done.
 +
See also [[lifeState]] and [[setUnconscious]] commands.<br /><br />
 +
'''NOTE''': This Event Handler is broken but somewhat usable.
 +
When attached to a unit it will fire when medic action is started (not finished!) on the unit.
 +
{{Inline code|_this [[select]] 0}} will be the unit itself, {{Inline code|_this [[select]] 1}} will be the healer.
 +
The 3rd param will always be [[false]] and neither returning [[true]] nor using [[AISFinishHeal]] will have any effect on the engine default healing behaviour.
 +
If unit walks away from the healer during healing action, the heal will not finish but there is no way to detect this within "HandleHeal" framework.<br /><br />
 +
This code will fix unit to 100% health after self-use of medpack:
 +
<code>0 = this [[addEventHandler]] ["HandleHeal", {
 
_this [[spawn]] {
 
_this [[spawn]] {
 
[[params]] ["_injured","_healer"];
 
[[params]] ["_injured","_healer"];
Line 428: Line 423:
 
};
 
};
 
}];</code>
 
}];</code>
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["HandleHeal", {
 +
params ["_unit", "_healer", "_isMedic"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]]
 
* unit: [[Object]]
 
* healer: [[Object]]
 
* healer: [[Object]]
 
* healercanheal: [[Boolean]] - true when healer is corpsman
 
* healercanheal: [[Boolean]] - true when healer is corpsman
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.32}}</div>
| <!-- Title -->
 
 
==== HandleRating ====
 
==== HandleRating ====
| <!-- Description -->
+
</div>
Triggered when engine adds rating to overall rating of the unit, usually after a kill or a friendly kill. If EH code returns [[Number]], this will override default engine behaviour and the resulting value added will be the one returned by EH code.
+
{{EffArg|cmd|args|local}}<br />
| <!-- Arguments -->
+
Triggered when engine adds rating to overall rating of the unit, usually after a kill or a friendly kill.
* unit: [[Object]] - Object the event handler is assigned to <br />
+
If EH code returns [[Number]], this will override default engine behaviour and the resulting value added will be the one returned by EH code.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["HandleRating", {
 +
params ["_unit", "_rating"];
 +
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - Object the event handler is assigned to
 
* rating: [[Number]] - rating to be added
 
* rating: [[Number]] - rating to be added
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma 3|1.32}}
 
  
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.31}}</div>
| <!-- Title -->
 
 
==== HandleScore ====
 
==== HandleScore ====
| <!-- Description -->
+
</div>
Triggered when engine adds score to overall score of the unit, usually after a kill. If the EH code returns [[true]] or [[Nothing]], the default engine score is applied, if it returns [[false]], the engine score doesn't get added. For remote units like players, the event does not persist after respawn, and must be re-added to the new unit. <br><br>'''NOTE:''' MP only, server only.
+
{{EffArg|cmd|args|global}}{{ServerExec}}<br />
| <!-- Arguments -->
+
Triggered when engine adds score to overall score of the unit, usually after a kill.
* unit: [[Object]] - Object the event handler is assigned to <br />
+
If the EH code returns [[true]] or [[Nothing]], the default engine score is applied, if it returns [[false]], the engine score doesn't get added.
* object: [[Object]] - object for which score was awarded <br />
+
For remote units like players, the event does not persist after respawn, and must be re-added to the new unit. <br /><br />
 +
'''NOTE:''' MP only.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["HandleScore", {
 +
params ["_unit", "_object", "_score"];
 +
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - Object the event handler is assigned to
 +
* object: [[Object]] - object for which score was awarded
 
* score: [[Number]] - score to be added
 
* score: [[Number]] - score to be added
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma 3|1.31}}
 
  
  
|-
+
==== Hit ====
| <!-- Title -->
+
{{EffArg|cmd|args|local}}<br />
 +
Triggered when the unit is hit/damaged.
  
==== Hit ====
+
Is ''not'' always triggered when unit is killed by a hit.<br />
| <!-- Description -->
+
Most of the time only the [[ArmA:_Event_Handlers#Killed|killed]] event handler is triggered when a unit dies from a hit.<br />
Triggered when the unit is hit/damaged.
+
The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.<br />
 +
Does not fire when a unit is set to allowDamage false.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["Hit", {
 +
params ["_unit", "_source", "_damage", "_instigator"];
 +
}];</syntaxhighlight>
  
Is ''not'' always triggered when unit is killed by a hit.<br>Most of the time only the [[ArmA:_Event_Handlers#Killed|killed]] event handler is triggered when a unit dies from a hit.<br>The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.<br>Does not fire when a unit is set to allowDamage false.
+
* unit: [[Object]] - Object the event handler is assigned to
| <!-- Arguments -->
+
* causedBy: [[Object]] - Object that caused the damage.<br />Contains the unit itself in case of collisions.
* unit: [[Object]] - Object the event handler is assigned to <br />
 
* causedBy: [[Object]] - Object that caused the damage.<br />Contains the unit itself in case of collisions. <br />
 
 
* damage: [[Number]] - Level of damage caused by the hit
 
* damage: [[Number]] - Level of damage caused by the hit
''(Since Arma 3 v1.65)''
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
* instigator: [[Object]] - Person who pulled the trigger
+
 
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
 
| <!-- Title -->
 
 
==== HitPart ====
 
==== HitPart ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Runs when the object it was added to gets injured/damaged. It returns the position and component that was hit on the object within a nested array, this is because the model may have more than one selection name for the hit component (i.e. a single piece of geometry can be simultaneously part of multiple, overlapping named selections).
+
Runs when the object it was added to gets injured/damaged.
 +
It returns the position and component that was hit on the object within a nested array, this is because the model may have more than one selection name for the hit component
 +
(i.e. a single piece of geometry can be simultaneously part of multiple, overlapping named selections).
  
While you can add "HitPart" handler to a remote unit, the respectful [[addEventHandler]] command must be executed on the shooter's PC and will only fire on shooter's PC as well. The event will not fire if the shooter is not local, even if the target itself is local. Additionally, if the unit gets damaged by any means other than shooter's shooting, "HitPart" will not fire. Because of this, this event handler is most suitable for when the shooter needs feedback on his shooting, such as target practicing or hitmarker creation.
+
While you can add "HitPart" handler to a remote unit, the respectful [[addEventHandler]] command must be executed on the shooter's PC and will only fire on shooter's PC as well.
 +
The event will not fire if the shooter is not local, even if the target itself is local.
 +
Additionally, if the unit gets damaged by any means other than shooter's shooting, "HitPart" will not fire.
 +
Because of this, this event handler is most suitable for when the shooter needs feedback on his shooting, such as target practicing or hitmarker creation.
  
'''Notes'''  
+
'''Notes'''
 
* The hit values from the ammo array are derived from the projectile's [[CfgAmmo Config Reference|CfgAmmo]] class, and do not match the actual damage inflicted, which is usually lower due to armor and other factors.
 
* The hit values from the ammo array are derived from the projectile's [[CfgAmmo Config Reference|CfgAmmo]] class, and do not match the actual damage inflicted, which is usually lower due to armor and other factors.
* This EH returns array of sub-arrays [[...],[...],...[...]]. Each sub-array contains data for the part that was hit as usually multiple parts are hit at the same time (see [[HitPart_Sample]]). The structure of each sub-array is listed on the right ->
+
* This EH returns array of sub-arrays [[...],[...],...[...]]. Each sub-array contains data for the part that was hit as usually multiple parts are hit at the same time (see [[HitPart_Sample]]). The structure of each sub-array is listed below.
  
  
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["HitPart", {
 +
(_this select 0) params ["_target", "_shooter", "_projectile", "_position", "_velocity", "_selection", "_ammo", "_vector", "_radius", "_surfaceType", "_isDirect"];
 +
}];</syntaxhighlight>
 +
 
 
* target: [[Object]] - Object that got injured/damaged.
 
* target: [[Object]] - Object that got injured/damaged.
* shooter: [[Object]] - Unit or vehicle that inflicted the damage. If injured by a vehicle impact or a fall the target itself is returned, or, in case of explosions, the [[objNull|null object]]. In case of explosives that were planted by someone (e.g. satchel charges), that unit is returned.
+
* shooter: [[Object]] - Unit or vehicle that inflicted the damage. If injured by a vehicle impact or a fall the target itself is returned, or, in case of explosions, the [[objNull|null object]].
* bullet: [[Object]] - Object that was fired.
+
In case of explosives that were planted by someone (e.g. satchel charges), that unit is returned.
 +
* projectile: [[Object]] - Object that was fired.
 
* position: [[Position3D]] - Position the bullet impacted (ASL).
 
* position: [[Position3D]] - Position the bullet impacted (ASL).
 
* velocity: [[Vector3D]] - 3D speed at which bullet impacted.
 
* velocity: [[Vector3D]] - 3D speed at which bullet impacted.
* selection: [[Array]] - Array of [[String]]s with named selection of the object that were hit.  
+
* selection: [[Array]] - Array of [[String]]s with named selection of the object that were hit.
 
* ammo: [[Array]] - Ammo info: [hit value, indirect hit value, indirect hit range, explosive damage, ammo class name] OR, if there is no shot object: [impulse value on object collided with,0,0,0]
 
* ammo: [[Array]] - Ammo info: [hit value, indirect hit value, indirect hit range, explosive damage, ammo class name] OR, if there is no shot object: [impulse value on object collided with,0,0,0]
* direction: [[Vector3D]] - vector that is orthogonal (perpendicular) to the surface struck. For example, if a wall was hit, vector would be pointing out of the wall at a 90 degree angle.
+
* vector: [[Vector3D]] - vector that is orthogonal (perpendicular) to the surface struck. For example, if a wall was hit, vector would be pointing out of the wall at a 90 degree angle.
 
* radius: [[Number]] - Radius (size) of component hit.
 
* radius: [[Number]] - Radius (size) of component hit.
 
* surface: [[String]] - Surface type struck.
 
* surface: [[String]] - Surface type struck.
 
* direct: [[Boolean]] - [[true]] if object was directly hit, [[false]] if it was hit by indirect/splash damage.
 
* direct: [[Boolean]] - [[true]] if object was directly hit, [[false]] if it was hit by indirect/splash damage.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.60}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== Init ====
 
==== Init ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered whenever an entity is created. Cannot be used in scripts, only inside class Eventhandlers in config.
 
Triggered whenever an entity is created. Cannot be used in scripts, only inside class Eventhandlers in config.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Init", {
* unit: [[Object]] - Object the event handler is assigned to
+
params ["_entity"];
| <!-- Effects -->
+
}];</syntaxhighlight>
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
+
* entity: [[Object]] - Object the event handler is assigned to
| <!-- Since -->
+
 
{{GVI|ofpr|1.85}}
 
  
|-
 
| <!-- Title -->
 
 
==== HandleIdentity ====
 
==== HandleIdentity ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggered whenever an entity is created. Can be used in scripts if EH is added immediately after unit is created in [[Scheduler#Unscheduled_Environment|unscheduled environment]]. If EH scope returns [[true]], the default engine identity application is overridden.  
+
Triggered whenever an entity is created. Can be used in scripts if EH is added immediately after unit is created in [[Scheduler#Unscheduled_Environment|unscheduled environment]].
| <!-- Arguments -->
+
If EH scope returns [[true]], the default engine identity application is overridden.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["HandleIdentity", {
 +
params ["_unit"];
 +
}];</syntaxhighlight>
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.60}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== IncomingMissile ====
 
==== IncomingMissile ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered when a guided missile locked on the target or unguided missile or rocket aimed by AI or Player at the target was fired.
 
Triggered when a guided missile locked on the target or unguided missile or rocket aimed by AI or Player at the target was fired.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["IncomingMissile", {
 +
params ["_target", "_ammo", "_vehicle", "_instigator"];
 +
}];</syntaxhighlight>
 +
 
 
* target: [[Object]] - Object the event handler is assigned to
 
* target: [[Object]] - Object the event handler is assigned to
 
* ammo: [[String]] - Ammo type that was fired on the target
 
* ammo: [[String]] - Ammo type that was fired on the target
''(Since Arma 3 v1.42)''
+
* {{GVI|arma3|1.42}} vehicle: [[Object]] - Vehicle that fired the weapon. In case of soldier, unit is returned
* vehicle: [[Object]] - Vehicle that fired the weapon. In case of soldier, unit is returned  
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
''(Since Arma 3 v1.65)''
 
* instigator: [[Object]] - Person who pulled the trigger
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
 
| <!-- Title -->
 
  
 +
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.22}}</div>
 
==== InventoryClosed ====
 
==== InventoryClosed ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered when unit closes inventory.
 
Triggered when unit closes inventory.
  
Line 568: Line 557:
 
[[deleteVehicle]] (_this [[select]] 1);
 
[[deleteVehicle]] (_this [[select]] 1);
 
}];</code>
 
}];</code>
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["InventoryClosed", {
 +
params ["_unit", "_container"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* targetContainer: [[Object]] - connected container or weaponholder
 
* targetContainer: [[Object]] - connected container or weaponholder
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.22}}
 
  
|-
 
| <!-- Title -->
 
  
 +
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.22}}</div>
 
==== InventoryOpened ====
 
==== InventoryOpened ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered when unit opens inventory. End EH main scope with [[true]] to override the opening of the inventory in case you wish to handle it yourself:
 
Triggered when unit opens inventory. End EH main scope with [[true]] to override the opening of the inventory in case you wish to handle it yourself:
  
Line 591: Line 579:
 
[[true]] //<-- inventory override
 
[[true]] //<-- inventory override
 
}];</code>
 
}];</code>
To return all nearby containers use [[nearSupplies]] command.    
+
To return all nearby containers use [[nearSupplies]] command.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["InventoryOpened", {
 +
params ["_unit", "_container"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* targetContainer: [[Object]] - connected container or weaponholder
 
* targetContainer: [[Object]] - connected container or weaponholder
''(Since Arma 3 v1.65.139079)''
+
* {{GVI|arma3|1.65}} secondaryContainer: [[Object]] - second connected container or weaponholder or [[objNull]]
* secondaryContainer: [[Object]] - second connected container or weaponholder or [[objNull]]
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.22}}
 
  
|-
 
| <!-- Title -->
 
  
 
==== Killed ====
 
==== Killed ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when the unit is killed.
 
Triggered when the unit is killed.
  
 
Be careful when the killer has been a vehicle. For most cases the reference of the vehicle is the same as the [[effectiveCommander]], but not always.
 
Be careful when the killer has been a vehicle. For most cases the reference of the vehicle is the same as the [[effectiveCommander]], but not always.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Killed", {
 +
params ["_unit", "_killer", "_instigator", "_useEffects"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* killer: [[Object]] - Object that killed the unit. Contains the unit itself in case of collisions
 
* killer: [[Object]] - Object that killed the unit. Contains the unit itself in case of collisions
''(Since Arma 3 v1.65)''
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
* instigator: [[Object]] - Person who pulled the trigger
+
* {{GVI|arma3|1.67}} useEffects: [[Boolean]] - same as ''useEffects'' in [[setDamage]] alt syntax
''(Since Arma 3 v1.67)''
+
 
* useEffects: [[Boolean]] - same as ''useEffects'' in [[setDamage]] alt syntax
 
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|ofpr|1.85}}
 
  
|-
 
| <!-- Title -->
 
 
==== LandedTouchDown ====
 
==== LandedTouchDown ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered when a plane (AI or player) touches the ground.
 
Triggered when a plane (AI or player) touches the ground.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["LandedTouchDown", {
 +
params ["_plane", "_airportID"];
 +
}];</syntaxhighlight>
 +
 
 
* plane: [[Object]] - Object the event handler is assigned to
 
* plane: [[Object]] - Object the event handler is assigned to
 
* airportID: [[Number]] - ID of the airport (-1 for anything else)
 
* airportID: [[Number]] - ID of the airport (-1 for anything else)
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.60}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== LandedStopped ====
 
==== LandedStopped ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggered when an AI pilot would get out usually. Not executed for player.
 
Triggered when an AI pilot would get out usually. Not executed for player.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["LandedStopped", {
 +
params ["_plane", "_airportID"];
 +
}];</syntaxhighlight>
 +
 
 
* plane: [[Object]] - Object the event handler is assigned to
 
* plane: [[Object]] - Object the event handler is assigned to
 
* airportID: [[Number]] - ID of the airport (-1 for anything else)
 
* airportID: [[Number]] - ID of the airport (-1 for anything else)
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.60}}
 
  
|-
 
  
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.70}}</div>
 
==== Landing ====
 
==== Landing ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggered when an AI pilot (or auto-pilot) is preparing for landing. The exact moment of triggering coincides with lowering of the gear ("Gear" EH)
 
Triggered when an AI pilot (or auto-pilot) is preparing for landing. The exact moment of triggering coincides with lowering of the gear ("Gear" EH)
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Landing", {
 +
params ["_plane", "_airportID", "_isCarrier"];
 +
}];</syntaxhighlight>
 +
 
 
* plane: [[Object]] - Object the event handler is assigned to
 
* plane: [[Object]] - Object the event handler is assigned to
 
* airportID: [[Number]] or [[Object]] - ID of the airport or aircraft carrier object
 
* airportID: [[Number]] or [[Object]] - ID of the airport or aircraft carrier object
 
* isCarrier: [[Boolean]] - true if landing on aircraft carrier
 
* isCarrier: [[Boolean]] - true if landing on aircraft carrier
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.70}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.70}}</div>
 
==== LandingCanceled ====
 
==== LandingCanceled ====
| <!-- Description -->
+
</div>
Triggered when AI pilot landing is cancelled (for example new order received to land elsewhere). The exact moment of triggering coincides with retracting of the gear ("Gear" EH). '''Note''': Doesn't trigger if player switches off auto-pilot. Canceled is spelled with one L
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when AI pilot landing is cancelled (for example new order received to land elsewhere).
 +
The exact moment of triggering coincides with retracting of the gear ("Gear" EH).
 +
'''Note''': Doesn't trigger if player switches off auto-pilot. Canceled is spelled with one L
 +
<syntaxhighlight lang="cpp">this addEventHandler ["LandingCanceled", {
 +
params ["_plane", "_airportID", "_isCarrier"];
 +
}];</syntaxhighlight>
 +
 
 
* plane: [[Object]] - Object the event handler is assigned to
 
* plane: [[Object]] - Object the event handler is assigned to
 
* airportID: [[Number]] or [[Object]] - ID of the airport or aircraft carrier object (-1 no airport)
 
* airportID: [[Number]] or [[Object]] - ID of the airport or aircraft carrier object (-1 no airport)
 
* isCarrier: [[Boolean]] - true if landing on aircraft carrier
 
* isCarrier: [[Boolean]] - true if landing on aircraft carrier
  
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.70}}
 
  
|-
 
| <!-- Title -->
 
 
==== Local ====
 
==== Local ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggers when locality of object in MP is changed. The event handler only triggers on the computers that are directly involved in change of locality. So if EH is added to every computer on network, it will only trigger on 2 computers, on the computer that receives ownership of the object (new owner), in which case [[_this]] [[select]] 1 will be [[true]], and on the computer from which ownership is transferred (old owner), in which case [[_this]] [[select]] 1 will be [[false]].
+
Triggers when locality of object in MP is changed. The event handler only triggers on the computers that are directly involved in change of locality.
| <!-- Arguments -->
+
So if EH is added to every computer on network, it will only trigger on 2 computers, on the computer that receives ownership of the object (new owner), in which case [[_this]] [[select]] 1 will be [[true]],
* object: [[Object]] - The object that changed locality.
+
and on the computer from which ownership is transferred (old owner), in which case [[_this]] [[select]] 1 will be [[false]].
 +
<syntaxhighlight lang="cpp">this addEventHandler ["Local", {
 +
params ["_entity", "_isLocal"];
 +
}];</syntaxhighlight>
 +
 
 +
* entity: [[Object]] - The object that changed locality.
 
* local: [[Boolean]] - If the object is local on given computer.
 
* local: [[Boolean]] - If the object is local on given computer.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.00}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== PostReset ====
 
==== PostReset ====
| <!-- Description -->
 
 
Triggers after PP effects have been reset by the engine
 
Triggers after PP effects have been reset by the engine
| <!-- Arguments -->
 
  
| <!-- Effects -->
 
  
| <!-- Since -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.56}}</div>
 
 
 
 
|-
 
| <!-- Title -->
 
 
==== Put ====
 
==== Put ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggers when a unit puts an item in a container.
 
Triggers when a unit puts an item in a container.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Put", {
* unit: [[Object]] - Unit to which the event handler is assigned
+
params ["_unit", "_container", "_item"];
* container: [[Object]] - The container into which the item was placed (vehicle, box, etc.)
+
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - Unit to which the event handler is assigned
 +
* container: [[Object]] - The container into which the item was placed (vehicle, box, etc.)
 
* item: [[String]] - The class name of the moved item
 
* item: [[String]] - The class name of the moved item
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|0.56}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.57}}</div>
 
==== Reloaded ====
 
==== Reloaded ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|local}}<br />
 
Triggers when a weapon is reloaded with a new magazine. For more information see: [[Arma_3:_Event_Handlers/Reloaded|Reloaded]]
 
Triggers when a weapon is reloaded with a new magazine. For more information see: [[Arma_3:_Event_Handlers/Reloaded|Reloaded]]
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Reloaded", {
* entity: [[Object]] - unit or vehicle to which EH is assigned
+
params ["_unit", "_weapon", "_muzzle", "_newMagazine", "_oldMagazine"];
* weapon: [[String]] - weapon that got reloaded  
+
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - unit or vehicle to which EH is assigned
 +
* weapon: [[String]] - weapon that got reloaded
 
* muzzle: [[String]] - weapon's muzzle that got reloaded
 
* muzzle: [[String]] - weapon's muzzle that got reloaded
* newMagazine: [[Array]] - new magazine info  
+
* newMagazine: [[Array]] - new magazine info
 
* oldMagazine: [[Array]] or [[Nothing]] - old magazine info
 
* oldMagazine: [[Array]] or [[Nothing]] - old magazine info
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.57}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== Respawn ====
 
==== Respawn ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a unit respawns.
 
Triggered when a unit respawns.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Respawn", {
 +
params ["_unit", "_corpse"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* corpse: [[Object]] - Object the event handler was assigned to, aka the corpse/unit player was previously controlling
 
* corpse: [[Object]] - Object the event handler was assigned to, aka the corpse/unit player was previously controlling
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2|1.00}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.34}}</div>
 
==== RopeAttach ====
 
==== RopeAttach ====
| <!-- Description -->
+
</div>
Triggered when a rope is attached to an object.<br>
+
Triggered when a rope is attached to an object.<br />
 
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each attached rope.
 
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each attached rope.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["RopeAttach", {
 +
params ["_object1", "_rope", "_object2"];
 +
}];</syntaxhighlight>
 +
 
 
*object 1: [[Object]] - Object to which the event handler is assigned.
 
*object 1: [[Object]] - Object to which the event handler is assigned.
 
*rope: [[Object]] - The rope being attached between object 1 and object 2.
 
*rope: [[Object]] - The rope being attached between object 1 and object 2.
 
*object 2: [[Object]] - The object that is being attached to object 1 via rope.
 
*object 2: [[Object]] - The object that is being attached to object 1 via rope.
| <!-- Effects -->
 
  
| <!-- Since -->
 
{{GVI|arma3|1.34}}
 
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.34}}</div>
| <!-- Title -->
 
 
==== RopeBreak ====
 
==== RopeBreak ====
| <!-- Description -->
+
</div>
Triggered when a rope is detached from an object.<br>
+
Triggered when a rope is detached from an object.<br />
 
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each detached rope.
 
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each detached rope.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["RopeBreak", {
 +
params ["_object1", "_rope", "_object2"];
 +
}];</syntaxhighlight>
 +
 
 
*object 1: [[Object]] - Object to which the event handler is assigned.
 
*object 1: [[Object]] - Object to which the event handler is assigned.
 
*rope: [[Object]] - The rope being detached between object 1 and object 2.
 
*rope: [[Object]] - The rope being detached between object 1 and object 2.
 
*object 2: [[Object]] - The object that is being detached from object 1 via rope.
 
*object 2: [[Object]] - The object that is being detached from object 1 via rope.
| <!-- Effects -->
 
  
| <!-- Since -->
 
{{GVI|arma3|1.34}}
 
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.49}}</div>
| <!-- Title -->
 
 
==== SeatSwitched ====
 
==== SeatSwitched ====
| <!-- Description -->
+
</div>
Triggered when unit changes seat within vehicle. EH returns both units switching seats. If switching seats with an empty seat, one of the returned units will be [[objNull]]. The new position can be obtained with [[assignedVehicleRole]] <unit>. This EH must be assigned to a vehicle.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when unit changes seat within vehicle. EH returns both units switching seats.
 +
If switching seats with an empty seat, one of the returned units will be [[objNull]].
 +
The new position can be obtained with [[assignedVehicleRole]] <unit>.
 +
This EH must be assigned to a vehicle.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["SeatSwitched", {
 +
params ["_vehicle", "_unit1", "_unit2"];
 +
}];</syntaxhighlight>
 +
 
 
*vehicle: [[Object]] - Vehicle to which the event handler is assigned.
 
*vehicle: [[Object]] - Vehicle to which the event handler is assigned.
 
*unit1: [[Object]] - Unit switching seat.
 
*unit1: [[Object]] - Unit switching seat.
 
*unit2: [[Object]] - Unit switching seat.
 
*unit2: [[Object]] - Unit switching seat.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.49}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.57}}</div>
 
==== SeatSwitchedMan ====
 
==== SeatSwitchedMan ====
| <!-- Description -->
+
</div>
Triggered when unit changes seat within vehicle. EH returns both units switching seats. If switching seats with an empty seat, one of the returned units will be [[objNull]]. The new position can be obtained with [[assignedVehicleRole]] <unit>. This EH must be assigned to a unit and not a vehicle. This EH is persistent and will be transferred to the new unit after respawn, but only if it was assigned where unit was local.
+
{{EffArg|cmd|args|global}}<br />
| <!-- Arguments -->
+
Triggered when unit changes seat within vehicle. EH returns both units switching seats.
 +
If switching seats with an empty seat, one of the returned units will be [[objNull]].
 +
The new position can be obtained with [[assignedVehicleRole]] <unit>. This EH must be assigned to a unit and not a vehicle.
 +
This EH is persistent and will be transferred to the new unit after respawn, but only if it was assigned where unit was local.
 +
<syntaxhighlight lang="cpp">this addEventHandler ["SeatSwitchedMan", {
 +
params ["_unit1", "_unit2", "_vehicle"];
 +
}];</syntaxhighlight>
 +
 
 
*unit1: [[Object]] - Unit switching seat.
 
*unit1: [[Object]] - Unit switching seat.
 
*unit2: [[Object]] - Unit with which unit1 is switching seat.
 
*unit2: [[Object]] - Unit with which unit1 is switching seat.
 
*vehicle: [[Object]] - Vehicle where switching seats is taking place.
 
*vehicle: [[Object]] - Vehicle where switching seats is taking place.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.57}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.56}}</div>
 
==== SoundPlayed ====
 
==== SoundPlayed ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|local}}<br />
 
Triggered when player is making noises when injured or fatigued for example. The number param passed to the EH code, points to the sound origin:
 
Triggered when player is making noises when injured or fatigued for example. The number param passed to the EH code, points to the sound origin:
 
* 1 : Breath
 
* 1 : Breath
* 2 : Breath Injured  
+
* 2 : Breath Injured
 
* 3 : Breath Scuba
 
* 3 : Breath Scuba
 
* 4 : Injured
 
* 4 : Injured
* 5 : Pulsation  
+
* 5 : Pulsation
* 6 : Hit Scream
+
* 6 : Hit Scream
* 7 : Burning  
+
* 7 : Burning
* 8 : Drowning  
+
* 8 : Drowning
 
* 9 : Drown
 
* 9 : Drown
 
* 10 : Gasping
 
* 10 : Gasping
Line 822: Line 794:
 
* 12 : Healing
 
* 12 : Healing
 
* 13 : Healing With Medikit
 
* 13 : Healing With Medikit
* 14 : Recovered  
+
* 14 : Recovered
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["SoundPlayed", {
* unit:  [[Object]] - Unit to which the event handler is assigned
+
params ["_unit", "_soundID"];
* sound code:  [[Number]] - sound origin
+
}];</syntaxhighlight>
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|0.56}}
 
  
|-
+
* unit: [[Object]] - Unit to which the event handler is assigned
| <!-- Title -->
+
* soundID: [[Number]] - sound origin
 +
 
 +
 
 +
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.56}}</div>
 
==== Take ====
 
==== Take ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggers when a unit takes an item from a container.
 
Triggers when a unit takes an item from a container.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["Take", {
* unit: [[Object]] - Unit to which the event handler is assigned
+
params ["_unit", "_container", "_item"];
* container: [[Object]] - The container from which the item was taken (vehicle, box, etc.)
+
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - Unit to which the event handler is assigned
 +
* container: [[Object]] - The container from which the item was taken (vehicle, box, etc.)
 
* item: [[String]] - The class name of the taken item
 
* item: [[String]] - The class name of the taken item
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|0.56}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.32}}</div>
 
==== TaskSetAsCurrent ====
 
==== TaskSetAsCurrent ====
| <!-- Description -->
+
</div>
 
Triggers when player's current task changes
 
Triggers when player's current task changes
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["TaskSetAsCurrent", {
* unit:  [[Object]] - The player to whom the event handler is assigned
+
params ["_unit", "_task"];
* task:  [[Task]] - The new current task
+
}];</syntaxhighlight>
| <!-- Effects -->
 
  
| <!-- Since -->
+
* unit: [[Object]] - The player to whom the event handler is assigned
{{GVI|arma3|1.32}}
+
* task: [[Task]] - The new current task
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.66}}</div>
 
==== TurnIn ====
 
==== TurnIn ====
| <!-- Description -->
+
</div>
 
Triggers when member of crew in a vehicle uses Turn In [[action]]
 
Triggers when member of crew in a vehicle uses Turn In [[action]]
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["TurnIn", {
* vehicle:  [[Object]] - The vehicle the event handler is assigned to
+
params ["_vehicle", "_unit", "_turret"];
* unit:  [[Object]] - The unit performing the Turn In action
+
}];</syntaxhighlight>
* turret:  [[Array]] - Turret path
 
| <!-- Effects -->
 
 
 
| <!-- Since -->
 
{{GVI|arma3|1.66}}
 
  
 +
* vehicle: [[Object]] - The vehicle the event handler is assigned to
 +
* unit: [[Object]] - The unit performing the Turn In action
 +
* turret: [[Array]] - Turret path
  
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.66}}</div>
| <!-- Title -->
 
 
==== TurnOut ====
 
==== TurnOut ====
| <!-- Description -->
+
</div>
 
Triggers when member of crew in a vehicle uses Turn Out [[action]]
 
Triggers when member of crew in a vehicle uses Turn Out [[action]]
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["TurnOut", {
* vehicle:  [[Object]] - The vehicle the event handler is assigned to
+
params ["_vehicle", "_unit", "_turret"];
* unit:  [[Object]] - The unit performing the Turn Out action
+
}];</syntaxhighlight>
* turret:  [[Array]] - Turret path
 
| <!-- Effects -->
 
  
| <!-- Since -->
+
* vehicle: [[Object]] - The vehicle the event handler is assigned to
{{GVI|arma3|1.66}}
+
* unit: [[Object]] - The unit performing the Turn Out action
 +
* turret: [[Array]] - Turret path
  
  
|-
 
| <!-- Title -->
 
 
==== WeaponAssembled ====
 
==== WeaponAssembled ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
 
Triggers when weapon gets assembled. EH should be attached to the unit and not the weapon.
 
Triggers when weapon gets assembled. EH should be attached to the unit and not the weapon.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["WeaponAssembled", {
 +
params ["_unit", "_staticWeapon"];
 +
}];</syntaxhighlight>
 +
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* weapon: [[Object]] - Object of the assembled weapon
 
* weapon: [[Object]] - Object of the assembled weapon
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.55}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== WeaponDisassembled ====
 
==== WeaponDisassembled ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}<br />
Triggers when weapon gets disassembled. EH should be attached to the unit and not the weapon.<br><br>'''NOTE:''' As of Arma 3 v1.32, this event does not fire if the weapon is not local. See http://feedback.arma3.com/view.php?id=21308
+
Triggers when weapon gets disassembled. EH should be attached to the unit and not the weapon.<br /><br />
| <!-- Arguments -->
+
'''NOTE:''' As of Arma 3 v1.32, this event does not fire if the weapon is not local. See http://feedback.arma3.com/view.php?id=21308
* unit: [[Object]] - Object the event handler is assigned to
+
<syntaxhighlight lang="cpp">this addEventHandler ["WeaponDisassembled", {
* primaryBag: [[Object]] - First backpack object which was weapon disassembled into
+
params ["_unit", "_backpack1", "_backpack2"];
 +
}];</syntaxhighlight>
 +
 
 +
* unit: [[Object]] - Object the event handler is assigned to
 +
* primaryBag: [[Object]] - First backpack object which was weapon disassembled into
 
* secondarybag: [[Object]] - Second backpack object which was weapon disassembled into
 
* secondarybag: [[Object]] - Second backpack object which was weapon disassembled into
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.55}}
 
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.43}}</div>
 
==== WeaponDeployed ====
 
==== WeaponDeployed ====
| <!-- Description -->
+
</div>
 +
{{EffArg|cmd|args|global}}<br />
 
Triggers when the deployed state of a weapon or bipod changes. Note: A weapon cannot be rested and deployed at the same time.
 
Triggers when the deployed state of a weapon or bipod changes. Note: A weapon cannot be rested and deployed at the same time.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["WeaponDeployed", {
* unit:  [[Object]] - Object the event handler is assigned to
+
params ["_unit", "_isDeployed"];
* isDeployed:  [[Boolean]] - true if deployed
+
}];</syntaxhighlight>
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.43}}
 
  
 +
* unit: [[Object]] - Object the event handler is assigned to
 +
* isDeployed: [[Boolean]] - true if deployed
  
|-
+
 
| <!-- Title -->
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.43}}</div>
 
==== WeaponRested ====
 
==== WeaponRested ====
| <!-- Description -->
+
</div>
Triggers when weapon rested state changes (weapon near a surface that can provide weapon support). Note: A weapon cannot be rested and deployed at the same time.
+
{{EffArg|cmd|args|local}}<br />
| <!-- Arguments -->
+
Triggers when weapon rested state changes (weapon near a surface that can provide weapon support).
* unit:  [[Object]] - Object the event handler is assigned to
+
Note: A weapon cannot be rested and deployed at the same time.
* isRested:  [[Boolean]] - true if rested
+
<syntaxhighlight lang="cpp">this addEventHandler ["WeaponRested", {
| <!-- Effects -->
+
params ["_unit", "_isRested"];
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
+
}];</syntaxhighlight>
| <!-- Since -->
 
{{GVI|arma3|1.43}}
 
  
|}
+
* unit: [[Object]] - Object the event handler is assigned to
 
+
* isRested: [[Boolean]] - true if rested
<!-------------------------------------------------------------------------------------->
 
=== [[Curator]] ===
 
  
Curator Event Handlers are also added with [[addEventHandler]] command and are supposed to be added to curator object (not [[player]] object) where curator object is local and will be executed only where curator is local (on computer of player who's in control of it).
 
  
{| class="wikitable sortable"
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|1.16}}</div>
! Class
+
=== Curator ===
! class="unsortable" | Description
+
</div>
! class="unsortable" | Arguments
+
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}<br />
! class="unsortable" | MP-Effects
+
[[Curator]] Event Handlers are also added with [[addEventHandler]] command.
! Since
+
They will be executed only where curator is local (on the computer of who is in control of it).
 +
All curator event handlers are local and have a global effect.
 +
{{Important|
 +
These events must be added to the curator object/module, '''not''' the player}}
  
|-
 
| <!-- Title -->
 
 
==== CuratorFeedbackMessage ====
 
==== CuratorFeedbackMessage ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when curator attempts invalid action in curator interface.
 
Triggered when curator attempts invalid action in curator interface.
  
Line 987: Line 944:
 
* 506 - trying to destroy an object when no object is selected
 
* 506 - trying to destroy an object when no object is selected
 
* 507 - trying to destroy a player (players cannot be manipulated with)
 
* 507 - trying to destroy a player (players cannot be manipulated with)
<br />''This handler is supposed to be added to curator module, not player.''
+
''This handler is supposed to be added to curator module, not player.''
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorFeedbackMessage", {
 +
params ["_curator", "_errorID"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* errorID: [[Number]]
 
* errorID: [[Number]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorGroupDoubleClicked ====
 
==== CuratorGroupDoubleClicked ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a group is double-clicked on in curator interface.
 
Triggered when a group is double-clicked on in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorGroupDoubleClicked", {
| <!-- Arguments -->
+
params ["_curator", "_group"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Group]]
+
* group: [[Group]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorGroupPlaced ====
 
==== CuratorGroupPlaced ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when new group is placed in curator interface.
 
Triggered when new group is placed in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorGroupPlaced", {
| <!-- Arguments -->
+
params ["_curator", "_group"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Group]]
+
* group: [[Group]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorGroupSelectionChanged ====
 
==== CuratorGroupSelectionChanged ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a group is selected in curator interface.
 
Triggered when a group is selected in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorGroupSelectionChanged", {
| <!-- Arguments -->
+
params ["_curator", "_group"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Group]]
+
* group: [[Group]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorMarkerDeleted ====
 
==== CuratorMarkerDeleted ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a marker is deleted in curator interface.
 
Triggered when a marker is deleted in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorMarkerDeleted", {
| <!-- Arguments -->
+
params ["_curator", "_marker"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[String]]
+
* marker: [[String]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorMarkerDoubleClicked ====
 
==== CuratorMarkerDoubleClicked ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a marker is double-clicked on in curator interface.
 
Triggered when a marker is double-clicked on in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorMarkerDoubleClicked", {
| <!-- Arguments -->
+
params ["_curator", "_marker"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[String]]
+
* marker: [[String]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorMarkerEdited ====
 
==== CuratorMarkerEdited ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a marker is moved in curator interface.
 
Triggered when a marker is moved in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorMarkerEdited", {
| <!-- Arguments -->
+
params ["_curator", "_marker"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[String]]
+
* marker: [[String]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorMarkerPlaced ====
 
==== CuratorMarkerPlaced ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when new marker is placed in curator interface.
 
Triggered when new marker is placed in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorMarkerPlaced", {
| <!-- Arguments -->
+
params ["_curator", "_marker"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[String]]
+
* marker: [[String]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorMarkerSelectionChanged ====
 
==== CuratorMarkerSelectionChanged ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a marker is selected in curator interface.
 
Triggered when a marker is selected in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorMarkerSelectionChanged", {
| <!-- Arguments -->
+
params ["_curator", "_marker"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[String]]
+
* marker: [[String]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorObjectDeleted ====
 
==== CuratorObjectDeleted ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when an object is deleted in curator interface.
 
Triggered when an object is deleted in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectDeleted", {
| <!-- Arguments -->
+
params ["_curator", "_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* entity: [[Object]]
 
* entity: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorObjectDoubleClicked ====
 
==== CuratorObjectDoubleClicked ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when an object is double-clicked on in curator interface.
 
Triggered when an object is double-clicked on in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectDoubleClicked", {
| <!-- Arguments -->
+
params ["_curator", "_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* entity: [[Object]]
 
* entity: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorObjectEdited ====
 
==== CuratorObjectEdited ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when an object is moved or rotated in curator interface.
 
Triggered when an object is moved or rotated in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectEdited", {
| <!-- Arguments -->
+
params ["_curator", "_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* entity: [[Object]]
 
* entity: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorObjectPlaced ====
 
==== CuratorObjectPlaced ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
Triggered when new object is placed in curator interface. This event handler will trigger individually for each unit in a placed group - excluding the crew in vehicles.
+
Triggered when new object is placed in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
This event handler will trigger individually for each unit in a placed group - excluding the crew in vehicles.
| <!-- Arguments -->
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectPlaced", {
 +
params ["_curator", "_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* entity: [[Object]]
 
* entity: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorObjectRegistered ====
 
==== CuratorObjectRegistered ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
Triggered when player enters curator interface. Assign curator cost to every object in the game. This is the primary method that a mission designer can use to limit the objects a curator can place.
+
Triggered when player enters curator interface. Assign curator cost to every object in the game.
 
+
This is the primary method that a mission designer can use to limit the objects a curator can place.<br />
 
''Full article - [[Curator#Manual_Assigning|Curator]]''
 
''Full article - [[Curator#Manual_Assigning|Curator]]''
  
''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectRegistered", {
 +
params ["_curator", "_input"];
 +
}];</syntaxhighlight>
  
| <!-- Arguments -->
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* input: [[Array]] of [[String]]s - all CfgVehicles classes
 
* input: [[Array]] of [[String]]s - all CfgVehicles classes
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorObjectSelectionChanged ====
 
==== CuratorObjectSelectionChanged ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when an object is selected in curator interface.
 
Triggered when an object is selected in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorObjectSelectionChanged", {
| <!-- Arguments -->
+
params ["_curator", "_entity"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* entity: [[Object]]
 
* entity: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorPinged ====
 
==== CuratorPinged ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a player pings his curator(s) by pressing ''Zeus'' key. To add player to specific curator, use [[addCuratorEditableObjects]] command.
 
Triggered when a player pings his curator(s) by pressing ''Zeus'' key. To add player to specific curator, use [[addCuratorEditableObjects]] command.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorPinged", {
| <!-- Arguments -->
+
params ["_curator", "_unit"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* player: [[Object]]
 
* player: [[Object]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorWaypointDeleted ====
 
==== CuratorWaypointDeleted ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a waypoint is deleted in curator interface.
 
Triggered when a waypoint is deleted in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorWaypointDeleted", {
| <!-- Arguments -->
+
params ["_curator", "_waypoint"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Array]]
+
* waypoint: [[Array]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorWaypointDoubleClicked ====
 
==== CuratorWaypointDoubleClicked ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a waypoint is double-clicked on in curator interface.
 
Triggered when a waypoint is double-clicked on in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorWaypointDoubleClicked", {
| <!-- Arguments -->
+
params ["_curator", "_waypoint"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Array]]
+
* waypoint: [[Array]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorWaypointEdited ====
 
==== CuratorWaypointEdited ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a waypoint is moved in curator interface.
 
Triggered when a waypoint is moved in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorWaypointEdited", {
| <!-- Arguments -->
+
params ["_curator", "_waypoint"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Array]]
+
* waypoint: [[Array]]
| <!-- Effects -->
+
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
 
| <!-- Title -->
 
 
==== CuratorWaypointPlaced ====
 
==== CuratorWaypointPlaced ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when new waypoint is placed in curator interface.
 
Triggered when new waypoint is placed in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorWaypointPlaced", {
| <!-- Arguments -->
+
params ["_curator", "_group", "_waypointID"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
 
* Group: [[Group]]
 
* Group: [[Group]]
 
* Waypoint Index: [[Number]]
 
* Waypoint Index: [[Number]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|-
+
 
| <!-- Title -->
 
 
==== CuratorWaypointSelectionChanged ====
 
==== CuratorWaypointSelectionChanged ====
| <!-- Description -->
+
{{EffArg|cmd|args|local}}<br />
 
Triggered when a waypoint is selected in curator interface.
 
Triggered when a waypoint is selected in curator interface.
<br />''This handler is supposed to be added to curator module, not player.''
+
<syntaxhighlight lang="cpp">this addEventHandler ["CuratorWaypointSelectionChanged", {
| <!-- Arguments -->
+
params ["_curator", "_waypoint"];
 +
}];</syntaxhighlight>
 +
 
 
* curator: [[Object]]
 
* curator: [[Object]]
* entity: [[Array]]
+
* waypoint: [[Array]]
| <!-- Effects -->
 
{{EffArg|cmd|args|local}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma3|1.16}}
 
  
|}
 
  
<!-------------------------------------------------------------------------------------->
+
=== Multiplayer Event Handlers ===
=== [[Eden Editor]] ===
+
Global object event handler, executed on every connected machine.<br />
''Full article - [[Arma 3: Event Handlers: Eden Editor#Object Event Handlers|Event Handlers: Eden Editor]]''
+
Commands are:
 
 
<!-------------------------------------------------------------------------------------->
 
== addMPEventHandler ==
 
 
 
Global object event handler, executed on every connected machine.
 
 
 
Commands:
 
 
* [[addMPEventHandler]]
 
* [[addMPEventHandler]]
 
* [[removeMPEventHandler]]
 
* [[removeMPEventHandler]]
Line 1,298: Line 1,186:
  
 
'''Example:'''
 
'''Example:'''
  mySoldier [[addMPEventHandler]] ["MPKilled",{[[hint]] [[format]] ["%1 was killed by %2",[[name]] (_this [[select]] 0),name (_this select 1)];}]
+
  mySoldier [[addMPEventHandler]] ["MPKilled",{ [[hint]] [[format]] ["%1 was killed by %2",[[name]] (_this [[select]] 0), name (_this select 1)]; }];
  
 
{| class="wikitable sortable"
 
! Class
 
! class="unsortable" | Description
 
! class="unsortable" | Arguments
 
! class="unsortable" | MP-Effects
 
! Since
 
 
|-
 
| <!-- Title -->
 
 
==== MPHit ====
 
==== MPHit ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}<br />
Triggered when the unit is hit/damaged. EH can be added on any machine and EH code will trigger globally on every connected client and server. This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.
+
Triggered when the unit is hit/damaged. EH can be added on any machine and EH code will trigger globally on every connected client and server.
 +
This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.
  
Is ''not'' always triggered when unit is killed by a hit. Most of the time only the [[ArmA_3:_Event_Handlers#Killed|Killed]] event handler is triggered when a unit dies from a hit. The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased. Can also trigger several times for an explosion (direct and indirect damage). Does not fire when a unit is set to [[allowDamage]] [[false]]. However it will fire with "HandleDamage" EH added alongside stopping unit from taking damage [[addEventHandler]] ["HandleDamage",{0}]; Will not trigger when unit is dead.
+
Is ''not'' always triggered when unit is killed by a hit.
 +
Most of the time only the [[ArmA_3:_Event_Handlers#Killed|Killed]] event handler is triggered when a unit dies from a hit.
 +
The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.
 +
Can also trigger several times for an explosion (direct and indirect damage). Does not fire when a unit is set to [[allowDamage]] [[false]].
 +
However it will fire with "HandleDamage" EH added alongside stopping unit from taking damage ({{Inline code|unit [[addEventHandler]] ["HandleDamage", {0}];}}.
 +
Will not trigger once the unit is dead.
  
This EH must be used in conjunction with the [[addMPEventHandler]] command.
+
Note: call a function from the MPHit EH code space rather than defining the full code in there directly.
 
+
The reason is the code space will be transferred over network on each event activation - so keep the data as small as possible!
Note: Call a function from the MPHit EH code space, rather to define the full code in there directly. The reason is the code space will be transferred over network on each event activation - so keep the data as small as possible!
 
| <!-- Arguments -->
 
 
* unit: [[Object]] - Object the event handler is assigned to <br />
 
* unit: [[Object]] - Object the event handler is assigned to <br />
 
* causedBy: [[Object]] - Object that caused the damage. Contains the unit itself in case of collisions. <br />
 
* causedBy: [[Object]] - Object that caused the damage. Contains the unit itself in case of collisions. <br />
 
* damage: [[Number]] - Level of damage caused by the hit
 
* damage: [[Number]] - Level of damage caused by the hit
''(Since Arma 3 v1.65)''
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
* instigator: [[Object]] - Person who pulled the trigger
+
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.55}}
 
  
|-
 
| <!-- Title -->
 
 
==== MPKilled ====
 
==== MPKilled ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}<br />
Triggered when the unit is killed. EH can be added on any machine and EH code will trigger globally on every connected client and server. This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.  
+
Triggered when the unit is killed. EH can be added on any machine and EH code will trigger globally on every connected client and server.
 +
This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.
  
This EH must be used in conjunction with the [[addMPEventHandler]] command.
 
| <!-- Arguments -->
 
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* killer: [[Object]] - Object that killed the unit<br />Contains the unit itself in case of collisions
 
* killer: [[Object]] - Object that killed the unit<br />Contains the unit itself in case of collisions
''(Since Arma 3 v1.65)''
+
* {{GVI|arma3|1.65}} instigator: [[Object]] - Person who pulled the trigger
* instigator: [[Object]] - Person who pulled the trigger
+
* {{GVI|arma3|1.67}} useEffects: [[Boolean]] - same as ''useEffects'' in [[setDamage]] alt syntax
''(Since Arma 3 v1.67)''
+
 
* useEffects: [[Boolean]] - same as ''useEffects'' in [[setDamage]] alt syntax
 
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|global}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.55}}
 
  
|-
 
| <!-- Title -->
 
 
==== MPRespawn ====
 
==== MPRespawn ====
| <!-- Description -->
+
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}<br />
Triggered when a unit, it is assigned to, respawns. This EH does not work as one would expect MP EH should work like. It is only triggered on one machine where the unit it was assigned to is [[local]]. The only difference between '''Respawn''' and '''MPRespawn''' is that '''MPRespawn''' can be assigned from anywhere while '''Respawn''' requires the unit to be local. This EH must be used in conjunction with the [[addMPEventHandler]] command.
+
Triggered when a unit, it is assigned to, respawns. This EH does not work as one would expect MP EH should work like.
<br><br>
+
It is only triggered on one machine where the unit it was assigned to is [[local]].
MPRespawn EH expects the EH code to return array in format of [[Position]], which will be used to place respawned unit at desired coordinates. For example: <code>[[player]] [[addMPEventHandler]] ["MPRespawn", {[1234,1234,0]}];</code> will place player at [1234,1234,0] immediately on respawn.
+
The only difference between '''Respawn''' and '''MPRespawn''' is that '''MPRespawn''' can be assigned from anywhere while '''Respawn''' requires the unit to be local.<br /><br />
| <!-- Arguments -->
+
MPRespawn EH expects the EH code to return array in format of [[Position]], which will be used to place respawned unit at desired coordinates.
 +
For example: <code>[[player]] [[addMPEventHandler]] ["MPRespawn", {[1234,1234,0]}];</code> will place player at [1234,1234,0] immediately on respawn.
 
* unit: [[Object]] - Object the event handler is assigned to
 
* unit: [[Object]] - Object the event handler is assigned to
 
* corpse: [[Object]] - Object the event handler was assigned to, aka the corpse/unit player was previously controlling.
 
* corpse: [[Object]] - Object the event handler was assigned to, aka the corpse/unit player was previously controlling.
| <!-- Effects -->
 
{{EffArg|cmd|args|global}}{{EffArg|cmd|effs|local}}
 
| <!-- Since -->
 
{{GVI|arma2oa|1.55}}
 
  
|}
 
  
 
<!-------------------------------------------------------------------------------------->
 
 
== Mission Event Handlers ==
 
== Mission Event Handlers ==
  
Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over. There are following mission EHs available in Arma 3:  
+
Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over.
 
+
The following mission EHs are available in Arma 3:
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#Draw3D|Draw3D]] - Drawing HUD event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#Draw3D|Draw3D]] - Drawing HUD event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#Ended|Ended]] - Mission end event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#Ended|Ended]] - Mission end event
Line 1,386: Line 1,248:
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#GroupIconOverEnter|GroupIconOverEnter]] - High Command icon enter event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#GroupIconOverEnter|GroupIconOverEnter]] - High Command icon enter event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#GroupIconOverLeave|GroupIconOverLeave]] - High Command icon leave event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#GroupIconOverLeave|GroupIconOverLeave]] - High Command icon leave event
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerConnected|PlayerConnected]] - Client joining MP mission event  
+
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerConnected|PlayerConnected]] - Client joining MP mission event
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerDisconnected|PlayerDisconnected]] - Client leaving MP mission event  
+
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerDisconnected|PlayerDisconnected]] - Client leaving MP mission event
* [[Arma_3:_Event_Handlers/addMissionEventHandler#TeamSwitch|TeamSwitch]] - Player teamswitch event  
+
* [[Arma_3:_Event_Handlers/addMissionEventHandler#TeamSwitch|TeamSwitch]] - Player teamswitch event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PreloadStarted|PreloadStarted]] - Mission preload start event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PreloadStarted|PreloadStarted]] - Mission preload start event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PreloadFinished|PreloadFinished]] - Mission preload finish event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PreloadFinished|PreloadFinished]] - Mission preload finish event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerViewChanged|PlayerViewChanged]] - Player view change event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerViewChanged|PlayerViewChanged]] - Player view change event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#BuildingChanged|BuildingChanged]] - Building model change event
 
* [[Arma_3:_Event_Handlers/addMissionEventHandler#BuildingChanged|BuildingChanged]] - Building model change event
For detailed description see [[Arma_3:_Event_Handlers/addMissionEventHandler|Mission Event Handlers]] page.  
+
For detailed description see [[Arma_3:_Event_Handlers/addMissionEventHandler|Mission Event Handlers]] page.
 +
 
  
<!-------------------------------------------------------------------------------------->
 
 
== In Game UI Event Handlers ==
 
== In Game UI Event Handlers ==
  
In Game UI Event Handlers trigger when user scrolls or activates in game action menu. There are following mission EHs available in Arma 3:  
+
In Game UI Event Handlers trigger when user scrolls or activates in game action menu. There are following mission EHs available in Arma 3:
  
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#PrevAction|PrevAction]] - Action menu scroll up event  
+
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#PrevAction|PrevAction]] - Action menu scroll up event
 
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#Action|Action]] - Action menu action event
 
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#Action|Action]] - Action menu action event
 
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#NextAction|NextAction]] - Action menu scroll down event
 
* [[Arma_3:_Event_Handlers/inGameUISetEventHandler#NextAction|NextAction]] - Action menu scroll down event
  
For detailed description see [[Arma_3:_Event_Handlers/inGameUISetEventHandler|In Game UI Event Handlers]] page.  
+
For detailed description see [[Arma_3:_Event_Handlers/inGameUISetEventHandler|In Game UI Event Handlers]] page.
  
<!-------------------------------------------------------------------------------------->
 
== addMusicEventHandler ==
 
  
Music event handler, always executed on the computer where it was added.
+
== Music Event Handlers ==
  
Commands:
+
Music event handler, always executed on the computer where it was added.<br />
 +
Commands are:
 
* [[setMusicEventHandler]]
 
* [[setMusicEventHandler]]
 
* [[addMusicEventHandler]]
 
* [[addMusicEventHandler]]
Line 1,421: Line 1,282:
  
  
{| class="wikitable sortable"
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.50}}</div>
! Class
+
=== MusicStart ===
! class="unsortable" | Description
+
</div>
! class="unsortable" | Arguments
+
Triggers when [[Description.ext#cfgMusic|CfgMusic]] sound starts playing, after being executed with [[playMusic]] command.
! Since
 
  
|-
+
This event handler needs to be added with [[addMusicEventHandler]] command and removed with [[removeMusicEventHandler]].
| <!-- Title -->
+
* className: [[String]] - [[Description.ext#Music|CfgMusic]] class name of currently playing sound.
==== MusicStart ====
+
* handlerID: [[Number]] - EH id returned by [[addMusicEventHandler]].
| <!-- Description -->
 
Triggers when [[Description.ext#cfgMusic|CfgMusic]] sound starts playing, after being executed with [[playMusic]] command.
 
  
This event handler needs to be added with [[addMusicEventHandler]] command and removed with [[removeMusicEventHandler]].
 
| <!-- Arguments -->
 
* className:  [[String]] - [[Description.ext#Music|CfgMusic]] class name of currently playing sound.
 
* handlerID:  [[Number]] - EH id returned by [[addMusicEventHandler]].
 
| <!-- Since -->
 
{{GVI|arma3|0.50}}
 
  
|-
+
<div><div style="float: left; margin-right: 0.5em;">{{GVI|arma3|0.50}}</div>
| <!-- Title -->
+
=== MusicStop ===
==== MusicStop ====
+
</div>
| <!-- Description -->
+
Triggers when [[Description.ext#cfgMusic|CfgMusic]] sound finished playing, after being executed with [[playMusic]] command.
Triggers when [[Description.ext#cfgMusic|CfgMusic]] sound finished playing, after being executed with [[playMusic]] command. Note that EH will not be triggered if you force stop the music with [[playMusic]] "".
+
Note that EH will not be triggered if you force stop the music with [[playMusic]] "".
  
 
This event handler needs to be added with [[addMusicEventHandler]] command and removed with [[removeMusicEventHandler]].
 
This event handler needs to be added with [[addMusicEventHandler]] command and removed with [[removeMusicEventHandler]].
| <!-- Arguments -->
+
* className: [[String]] - [[Description.ext#Music|CfgMusic]] class name of currently played sound.
* className: [[String]] - [[Description.ext#Music|CfgMusic]] class name of currently played sound.
+
* handlerID: [[Number]] - EH id returned by [[addMusicEventHandler]].
* handlerID: [[Number]] - EH id returned by [[addMusicEventHandler]].
+
 
| <!-- Since -->
+
 
{{GVI|arma3|0.50}}
+
== [[Eden Editor]] ==
 +
''Full article - [[Arma 3: Event Handlers: Eden Editor#Object Event Handlers|Event Handlers: Eden Editor]]''
  
|}
 
  
<!-------------------------------------------------------------------------------------->
 
 
== add3DENEventHandler ==
 
== add3DENEventHandler ==
 
''Full article - [[Arma 3: Event Handlers: Eden Editor]]''
 
''Full article - [[Arma 3: Event Handlers: Eden Editor]]''
  
<!-------------------------------------------------------------------------------------->
+
 
 
== ctrlAddEventHandler ==
 
== ctrlAddEventHandler ==
 
''Full article - [[User Interface Event Handlers]]''
 
''Full article - [[User Interface Event Handlers]]''
  
  
<!-------------------------------------------------------------------------------------->
 
 
== displayAddEventHandler ==
 
== displayAddEventHandler ==
 
''Full article - [[User Interface Event Handlers]]''
 
''Full article - [[User Interface Event Handlers]]''

Revision as of 21:59, 12 April 2018

Contents

An event handler (abbreviated to EH) allows you to automatically monitor and then execute custom code upon particular events being triggered.
See also Event Scripts for special event triggered scripts.

Basic Event Handlers

Object event handler, always executed on the computer where it was added.

Commands:

Example:

mySoldier addEventHandler ["Killed",{ hint format ["%1 was killed by %2",name (_this select 0), name (_this select 1)]; }];

Standard

AnimChanged

Template:EffArg
Triggered every time a new animation is started. This EH is only triggered for the 1st animation state in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["AnimChanged", {
	params ["_unit", "_anim"];
}];
  • unit: Object - Object the event handler is assigned to
  • anim: String - Name of the anim that is started


AnimDone

Template:EffArg
Triggered every time an animation is finished. Triggered for all animation states in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["AnimDone", {
	params ["_unit", "_anim"];
}];
  • unit: Object - Object the event handler is assigned to
  • anim: String - Name of the anim that has been finished


AnimStateChanged

Template:EffArg
Triggered every time an animation state changes. Triggered for all animation states in a sequence. It can be assigned to a remote unit but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["AnimStateChanged", {
	params ["_unit", "_anim"];
}];
  • unit: Object - Object the event handler is assigned to
  • anim: String - Name of the anim that has been started


ContainerClosed

Template:EffArg
Triggers when player finished accessing cargo container. This event handler is similar to "InventoryClosed" EH, but needs to be assigned to the container rather than the player. Note: will trigger only for the unit opening container.

this addEventHandler ["ContainerClosed", {
	params ["_container", "_unit"];
}];
  • container: Object - Cargo container.
  • player: Object - Unit who accessed the container.


ContainerOpened

Template:EffArg
Triggers when cargo container is accessed by player. This event handler is similar to "InventoryOpened" EH, but needs to be assigned to the container rather than the player and cannot be overridden. Note: will trigger only for the unit opening container.

this addEventHandler ["ContainerOpened", {
	params ["_container", "_unit"];
}];
  • container: Object - Cargo container.
  • player: Object - Unit who accessed the container.


ControlsShifted

Template:EffArg
Triggers when controls of vehicle are shifted (pilot->co-pilot, co-pilot->pilot). Works for both, "Take" and "Release" controls actions. Event only triggers on PC where vehicle is local and EH was added.

Notes:

  • If helicopter is local to the server and co-pilot takes controls, the helicopter changes locality to co-pilot PC.

This means that if "ControlsShifted" EH was added on both server and client, "Take Controls" action will trigger EH on the server PC, but subsequent co-pilot "Release Controls" action will trigger it on co-pilot's PC.

this addEventHandler ["ControlsShifted", {
	params ["_vehicle", "_newController", "_oldController"];
}];
  • vehicle: Object - Vehicle which controls were shifted.
  • newController: Object - Unit who controls vehicle after this event.
  • oldController: Object - Unit who controled vehicle before this event.


Dammaged

Template:EffArg
Triggered when the unit is damaged. In ArmA works with all vehicles not only men like in OFP. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed.

Notes:

  • The typo is "intentional": it is Dammaged with two "m".
  • If simultaneous damage occured (e.g. via grenade) EH might be triggered several times.
  • The Dammaged EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.
this addEventHandler ["Dammaged", {
	params ["_unit", "_selection", "_damage", "_hitIndex", "_hitPoint", "_shooter", "_projectile"];
}];
  • unit: Object - Object the event handler is assigned to
  • hitSelection: String - Name of the selection where the unit was damaged
  • damage: Number - Resulting level of damage
  • Arma 3 logo black.png1.67 hitPartIndex: Number - hit index of the hit selection
  • Arma 3 logo black.png1.67 hitPoint: String - hit point Cfg name
  • Arma 3 logo black.png1.69 shooter: Object - shooter reference (to get instigator use getShotParents on projectile)
  • Arma 3 logo black.png1.69 projectile: Object - the projectile that caused damage


Deleted

Template:EffArg
Triggered just before the assigned entity is deleted.

this addEventHandler ["Deleted", {
	params ["_entity"];
}];
  • entity: Object - Object the event handler is assigned to


Engine

Template:EffArg
Triggered when the engine of the unit is turned on/off.

this addEventHandler ["Engine", {
	params ["_vehicle", "_engineState"];
}];
  • vehicle: Object - Vehicle the event handler is assigned to
  • engineState: Boolean - True when the engine is turned on, false when turned off


EpeContact

Template:EffArg
Triggered when object collision (PhysX) is in progress. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["EpeContact", {
	params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
}];
  • object1: Object - Object with attached handler.
  • object2: Object - Object which is colliding with object1.
  • select1: String - Selection of object1 which is colliding - not in use at this moment, empty string is always returned.
  • select2: String - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
  • force: Number - Force of collision.


EpeContactEnd

Template:EffArg
Triggered when object collision (PhysX) ends. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["EpeContactEnd", {
	params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
}];
  • object1: Object - Object with attached handler.
  • object2: Object - Object which is colliding with object1.
  • select1: String - Selection of object1 which is colliding - not in use at this moment, empty string is always returned.
  • select2: String - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
  • force: Number - Force of collision.


EpeContactStart

Template:EffArg
Triggered when object collision (PhysX) starts. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed.

this addEventHandler ["EpeContactStart", {
	params ["_object1", "_object2", "_selection1", "_selection2", "_force"];
}];
  • object1: Object - Object with attached handler.
  • object2: Object - Object which is colliding with object1.
  • select1: String - Selection of object1 which is colliding - not in use at this moment, empty string is always returned.
  • select2: String - Selection of object2 which is colliding - not in use at this moment, empty string is always returned.
  • force: Number - Force of collision.


Explosion

Template:EffArg
Triggered when a vehicle or unit is damaged by a nearby explosion. It can be assigned to a remote unit or vehicle but will only fire on the PC where EH is added and explosion is local, i.e. it really needs to be added on every PC and JIP and will fire only where the explosion is originated.

this addEventHandler ["Explosion", {
	params ["_vehicle", "_damage"];
}];
  • vehicle: Object - Object the event handler is assigned to
  • damage: Number - Damage inflicted to the object


Fired

Template:EffArg
Triggered when the unit fires a weapon.
This EH will not trigger if a unit fires out of a vehicle. For those cases an EH has to be attached to that particular vehicle. When "Manual Fire" is used, the gunner is objNull if gunner is not present or the gunner is not the one who fires. To check if "Manual Fire" is on, use isManualFire. The actual shot instigator could be retrieved with getShotParents command.

this addEventHandler ["Fired", {
	params ["_unit", "_weapon", "_muzzle", "_mode", "_ammo", "_magazine", "_projectile", "_gunner"];
}];
  • unit: Object - Object the event handler is assigned to
  • weapon: String - Fired weapon
  • muzzle: String - Muzzle that was used
  • mode: String - Current mode of the fired weapon
  • ammo: String - Ammo used
  • magazine: String - magazine name which was used
  • projectile: Object - Object of the projectile that was shot out
  • Arma 3 logo black.png1.65 gunner: Object - gunner whose weapons are firing.


FiredMan

Template:EffArg
Triggered when the unit fires a weapon. This EH must be attached to a soldier and unlike with "Fired" EH, it will fire regardless of whether the soldier is on foot or firing vehicle weapon. For remoteControled unit use "Fired" EH instead.

this addEventHandler ["FiredMan", {
	params ["_unit", "_weapon", "_muzzle", "_mode", "_ammo", "_magazine", "_projectile", "_vehicle"];
}];
  • unit: Object - Unit the event handler is assigned to (the instigator)
  • weapon: String - Fired weapon
  • muzzle: String - Muzzle that was used
  • mode: String - Current mode of the fired weapon
  • ammo: String - Ammo used
  • magazine: String - magazine name which was used
  • projectile: Object - Object of the projectile that was shot out
  • vehicle: Object - Vehicle, if weapon is vehicle weapon, otherwise objNull


FiredNear

Template:EffArg
Triggered when a weapon is fired somewhere near the unit or vehicle. It is also triggered if the unit itself is firing. (Exception(s): the Throw weapon wont broadcast the FiredNear event). When "Manual Fire" is used, the gunner is objNull if gunner is not present or the gunner is not the one who fires. To check if "Manual Fire" is on, use isManualFire. The actual shot instigator could be retrieved with getShotParents command. Arma 3 logo black.png1.30 Works with thrown weapons.

this addEventHandler ["FiredNear", {
	params ["_unit", "_firer", "_distance", "_weapon", "_muzzle", "_mode", "_ammo", "_gunner"];
}];
  • unit: Object - Object the event handler is assigned to
  • firer: Object - Object which fires a weapon near the unit
  • distance: Number - Distance in meters between the unit and firer (max. distance ~69m)
  • weapon: String - Fired weapon
  • muzzle: String - Muzzle that was used
  • mode: String - Current mode of the fired weapon
  • ammo: String - Ammo used
  • Arma 3 logo black.png1.65 gunner: Object - gunner, whose weapons are fired


Fuel

Template:EffArg
Triggered when the unit's fuel status changes between completely empty / not empty (only useful if the event handler is assigned to a vehicle).

this addEventHandler ["Fuel", {
	params ["_vehicle", "_fuel"];
}];
  • vehicle: Object - Vehicle the event handler is assigned to
  • fuelState: Boolean - 0 when no fuel, 1 when the fuel tank is full


Gear

Template:EffArg
Triggered when the unit lowers/retracts the landing gear (only useful if the event handler is assigned to is a member of the class "Plane"). Also triggered for helicopters in landing mode, regardless if they have or don't have retractable gear.

this addEventHandler ["Gear", {
	params ["_vehicle", "_gearState"];
}];
  • vehicle: Object - Vehicle the event handler is assigned to
  • gearState: Boolean - True when the gear is lowered, false when retracted


GetIn

Template:EffArg
Triggers when a unit enters a vehicle. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed. This EH is triggered by moveInXXXX commands and "GetInXXXX" actions, but not upon a seat change within the same vehicle.

In vehicles with multi-turret setup, entering any turret will show "gunner" for position.

this addEventHandler ["GetIn", {
	params ["_vehicle", "_role", "_unit", "_turret"];
}];
  • vehicle: Object - Vehicle the event handler is assigned to
  • role: String - Can be either "driver", "gunner" or "cargo"
  • unit: Object - Unit that entered the vehicle
  • Arma 3 logo black.png1.36 turret: Array - turret path


GetInMan

Template:EffArg
Triggers when a unit enters a vehicle. Similar to "GetIn" but must be assigned to a unit and not vehicle. Persistent on respawn if assigned where unit was local. This EH is triggered by moveInXXXX commands and "GetInXXXX" actions.

this addEventHandler ["GetInMan", {
	params ["_unit", "_role", "_vehicle", "_turret"];
}];
  • unit: Object - Unit the event handler is assigned to
  • role: String - Can be either "driver", "gunner" or "cargo"
  • vehicle: Object - Vehicle the unit entered
  • turret: Array - turret path


GetOut

Template:EffArg
Triggers when a unit gets out from a vehicle. It can be assigned to a remote vehicle but will only fire on the PC where the actual addEventHandler command was executed. This EH is triggered by moveOut, "GetOut" & "Eject" actions, if an alive crew member disconnects or is deleted, but not upon a seat change within the same vehicle.

this addEventHandler ["GetOut", {
	params ["_vehicle", "_role", "_unit", "_turret"];
}];
  • vehicle: Object - Vehicle the event handler is assigned to
  • role: String - Can be either "driver", "gunner" or "cargo"
  • unit: Object - Unit that left the vehicle
  • Arma 3 logo black.png1.36 turret: Array - turret path


GetOutMan

Template:EffArg
Triggers when a unit exits a vehicle. Similar to "GetOut" but must be assigned to a unit and not vehicle. Persistent on respawn if assigned where unit was local. This EH is triggered by moveOut and "GetOut" & "Eject" actions.

this addEventHandler ["GetOutMan", {
	params ["_unit", "_role", "_vehicle", "_turret"];
}];
  • unit: Object - unit the event handler is assigned to
  • role: String - Can be either "driver", "gunner" or "cargo"
  • vehicle: Object - Vehicle that the unit left
  • turret: Array - turret path


HandleDamage

Template:EffArg
Triggers when the unit is damaged and fires for each damaged selection separately Note: Currently, in Arma 3 v1.70 it triggers for every selection of a vehicle, no matter if the section was damaged or not). Works with all vehicles. This EH can accept a remote unit as argument however it will only fire when the unit is local to the PC this event handler was added on. For example, you can add this event handler to one particular vehicle on every PC. When this vehicle gets hit, only EH on PC where the vehicle is currently local will fire.

If code provided returns a numeric value, this value will overwrite the default damage of given selection after processing. Return value of 0 will make the unit invulnerable if damage is not scripted in other ways (i.e using setDamage and/or setHit for additional damage handling). If no value is returned, the default damage processing will be done. This allows for safe stacking of this event handler. Only the return value of the last added "HandleDamage" EH is considered.

Notes:

  • Multiple "HandleDamage" event handlers can be added to the same unit. If multiple EHs return damage value for custom damage handling, only last returned value will be considered by the engine.

EHs that do not return value can be safely added after EHs that do return value.

  • You can save the last event as timestamp (diag_tickTime) onto the unit, as well as the current health of the unit/its selections, with setVariable and query it on each "HandleDamage" event with getVariable to define a system how to handle the "HandleDamage" event.
  • "HandleDamage" will continue to trigger even if the unit is already dead.
  • "HandleDamage" is persistent. If you add it to the player object, it will continue to exist after player respawned.
  • "HandleDamage" can trigger "twice" per damage event. Once for direct damage, once for indirect damage (explosive damage). This can happen even in the same frame, but is unlikely.

Additional Celery's explanation (Updated by ShadowRanger for Arma 3).

this addEventHandler ["HandleDamage", {
	params ["_unit", "_selection", "_damage", "_source", "_projectile", "_hitIndex", "_instigator", "_hitPoint"];
}];
  • unit: Object - Object the event handler is assigned to.
  • hitSelection: String - Name of the selection where the unit was damaged. "" for over-all structural damage, "?" for unknown selections.
  • damage: Number - Resulting level of damage for the selection.
  • source: Object - The source unit that caused the damage.
  • projectile: String - Classname of the projectile that caused inflicted the damage. ("" for unknown, such as falling damage.)
  • Arma 3 logo black.png1.49 hitPartIndex: Number - Hit part index of the hit point, -1 otherwise.
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger
  • Arma 3 logo black.png1.67 hitPoint: String - hit point Cfg name


HandleHeal

Template:EffArg
Triggered when unit starts to heal (player using heal action or AI heals after being ordered). Triggers only on PC where EH is added and unit is local. If code returns false, engine side healing follows. Return true if you handle healing in script, use AISFinishHeal to tell engine that script side healing is done. See also lifeState and setUnconscious commands.

NOTE: This Event Handler is broken but somewhat usable. When attached to a unit it will fire when medic action is started (not finished!) on the unit. Template:Inline code will be the unit itself, Template:Inline code will be the healer. The 3rd param will always be false and neither returning true nor using AISFinishHeal will have any effect on the engine default healing behaviour. If unit walks away from the healer during healing action, the heal will not finish but there is no way to detect this within "HandleHeal" framework.

This code will fix unit to 100% health after self-use of medpack: 0 = this addEventHandler ["HandleHeal", { _this spawn { params ["_injured","_healer"]; _damage = damage _injured; if (_injured == _healer) then { waitUntil {damage _injured != _damage}; if (damage _injured < _damage) then { _injured setDamage 0; }; }; }; }];

this addEventHandler ["HandleHeal", {
	params ["_unit", "_healer", "_isMedic"];
}];


HandleRating

Template:EffArg
Triggered when engine adds rating to overall rating of the unit, usually after a kill or a friendly kill. If EH code returns Number, this will override default engine behaviour and the resulting value added will be the one returned by EH code.

this addEventHandler ["HandleRating", {
	params ["_unit", "_rating"];
}];
  • unit: Object - Object the event handler is assigned to
  • rating: Number - rating to be added


HandleScore

Template:EffArgTemplate:ServerExec
Triggered when engine adds score to overall score of the unit, usually after a kill. If the EH code returns true or Nothing, the default engine score is applied, if it returns false, the engine score doesn't get added. For remote units like players, the event does not persist after respawn, and must be re-added to the new unit.

NOTE: MP only.

this addEventHandler ["HandleScore", {
	params ["_unit", "_object", "_score"];
}];
  • unit: Object - Object the event handler is assigned to
  • object: Object - object for which score was awarded
  • score: Number - score to be added


Hit

Template:EffArg
Triggered when the unit is hit/damaged.

Is not always triggered when unit is killed by a hit.
Most of the time only the killed event handler is triggered when a unit dies from a hit.
The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased.
Does not fire when a unit is set to allowDamage false.

this addEventHandler ["Hit", {
	params ["_unit", "_source", "_damage", "_instigator"];
}];
  • unit: Object - Object the event handler is assigned to
  • causedBy: Object - Object that caused the damage.
    Contains the unit itself in case of collisions.
  • damage: Number - Level of damage caused by the hit
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger


HitPart

Template:EffArg
Runs when the object it was added to gets injured/damaged. It returns the position and component that was hit on the object within a nested array, this is because the model may have more than one selection name for the hit component (i.e. a single piece of geometry can be simultaneously part of multiple, overlapping named selections).

While you can add "HitPart" handler to a remote unit, the respectful addEventHandler command must be executed on the shooter's PC and will only fire on shooter's PC as well. The event will not fire if the shooter is not local, even if the target itself is local. Additionally, if the unit gets damaged by any means other than shooter's shooting, "HitPart" will not fire. Because of this, this event handler is most suitable for when the shooter needs feedback on his shooting, such as target practicing or hitmarker creation.

Notes

  • The hit values from the ammo array are derived from the projectile's CfgAmmo class, and do not match the actual damage inflicted, which is usually lower due to armor and other factors.
  • This EH returns array of sub-arrays [[...],[...],...[...]]. Each sub-array contains data for the part that was hit as usually multiple parts are hit at the same time (see HitPart_Sample). The structure of each sub-array is listed below.


this addEventHandler ["HitPart", {
	(_this select 0) params ["_target", "_shooter", "_projectile", "_position", "_velocity", "_selection", "_ammo", "_vector", "_radius", "_surfaceType", "_isDirect"];
}];
  • target: Object - Object that got injured/damaged.
  • shooter: Object - Unit or vehicle that inflicted the damage. If injured by a vehicle impact or a fall the target itself is returned, or, in case of explosions, the null object.

In case of explosives that were planted by someone (e.g. satchel charges), that unit is returned.

  • projectile: Object - Object that was fired.
  • position: Position3D - Position the bullet impacted (ASL).
  • velocity: Vector3D - 3D speed at which bullet impacted.
  • selection: Array - Array of Strings with named selection of the object that were hit.
  • ammo: Array - Ammo info: [hit value, indirect hit value, indirect hit range, explosive damage, ammo class name] OR, if there is no shot object: [impulse value on object collided with,0,0,0]
  • vector: Vector3D - vector that is orthogonal (perpendicular) to the surface struck. For example, if a wall was hit, vector would be pointing out of the wall at a 90 degree angle.
  • radius: Number - Radius (size) of component hit.
  • surface: String - Surface type struck.
  • direct: Boolean - true if object was directly hit, false if it was hit by indirect/splash damage.


Init

Template:EffArg
Triggered whenever an entity is created. Cannot be used in scripts, only inside class Eventhandlers in config.

this addEventHandler ["Init", {
	params ["_entity"];
}];
  • entity: Object - Object the event handler is assigned to


HandleIdentity

Template:EffArg
Triggered whenever an entity is created. Can be used in scripts if EH is added immediately after unit is created in unscheduled environment. If EH scope returns true, the default engine identity application is overridden.

this addEventHandler ["HandleIdentity", {
	params ["_unit"];
}];
  • unit: Object - Object the event handler is assigned to


IncomingMissile

Template:EffArg
Triggered when a guided missile locked on the target or unguided missile or rocket aimed by AI or Player at the target was fired.

this addEventHandler ["IncomingMissile", {
	params ["_target", "_ammo", "_vehicle", "_instigator"];
}];
  • target: Object - Object the event handler is assigned to
  • ammo: String - Ammo type that was fired on the target
  • Arma 3 logo black.png1.42 vehicle: Object - Vehicle that fired the weapon. In case of soldier, unit is returned
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger


InventoryClosed

Template:EffArg
Triggered when unit closes inventory.

//Delete dropped items when inventory closed player addEventHandler ["InventoryClosed", { deleteVehicle (_this select 1); }];

this addEventHandler ["InventoryClosed", {
	params ["_unit", "_container"];
}];
  • unit: Object - Object the event handler is assigned to
  • targetContainer: Object - connected container or weaponholder


InventoryOpened

Template:EffArg
Triggered when unit opens inventory. End EH main scope with true to override the opening of the inventory in case you wish to handle it yourself:

//Create and open an ammo box when "Inventory" button is pressed player addEventHandler ["InventoryOpened", { player removeAllEventHandlers "InventoryOpened"; _box = "Box_NATO_Ammo_F" createVehicle [0,0,0]; _box setPos (player modelToWorld [0,1.5,0.5]); player action ["Gear", _box]; true //<-- inventory override }]; To return all nearby containers use nearSupplies command.

this addEventHandler ["InventoryOpened", {
	params ["_unit", "_container"];
}];
  • unit: Object - Object the event handler is assigned to
  • targetContainer: Object - connected container or weaponholder
  • Arma 3 logo black.png1.65 secondaryContainer: Object - second connected container or weaponholder or objNull


Killed

Template:EffArg
Triggered when the unit is killed.

Be careful when the killer has been a vehicle. For most cases the reference of the vehicle is the same as the effectiveCommander, but not always.

this addEventHandler ["Killed", {
	params ["_unit", "_killer", "_instigator", "_useEffects"];
}];
  • unit: Object - Object the event handler is assigned to
  • killer: Object - Object that killed the unit. Contains the unit itself in case of collisions
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger
  • Arma 3 logo black.png1.67 useEffects: Boolean - same as useEffects in setDamage alt syntax


LandedTouchDown

Template:EffArg
Triggered when a plane (AI or player) touches the ground.

this addEventHandler ["LandedTouchDown", {
	params ["_plane", "_airportID"];
}];
  • plane: Object - Object the event handler is assigned to
  • airportID: Number - ID of the airport (-1 for anything else)


LandedStopped

Template:EffArg
Triggered when an AI pilot would get out usually. Not executed for player.

this addEventHandler ["LandedStopped", {
	params ["_plane", "_airportID"];
}];
  • plane: Object - Object the event handler is assigned to
  • airportID: Number - ID of the airport (-1 for anything else)


Landing

Template:EffArg
Triggered when an AI pilot (or auto-pilot) is preparing for landing. The exact moment of triggering coincides with lowering of the gear ("Gear" EH)

this addEventHandler ["Landing", {
	params ["_plane", "_airportID", "_isCarrier"];
}];
  • plane: Object - Object the event handler is assigned to
  • airportID: Number or Object - ID of the airport or aircraft carrier object
  • isCarrier: Boolean - true if landing on aircraft carrier


LandingCanceled

Template:EffArg
Triggered when AI pilot landing is cancelled (for example new order received to land elsewhere). The exact moment of triggering coincides with retracting of the gear ("Gear" EH). Note: Doesn't trigger if player switches off auto-pilot. Canceled is spelled with one L

this addEventHandler ["LandingCanceled", {
	params ["_plane", "_airportID", "_isCarrier"];
}];
  • plane: Object - Object the event handler is assigned to
  • airportID: Number or Object - ID of the airport or aircraft carrier object (-1 no airport)
  • isCarrier: Boolean - true if landing on aircraft carrier


Local

Template:EffArg
Triggers when locality of object in MP is changed. The event handler only triggers on the computers that are directly involved in change of locality. So if EH is added to every computer on network, it will only trigger on 2 computers, on the computer that receives ownership of the object (new owner), in which case _this select 1 will be true, and on the computer from which ownership is transferred (old owner), in which case _this select 1 will be false.

this addEventHandler ["Local", {
	params ["_entity", "_isLocal"];
}];
  • entity: Object - The object that changed locality.
  • local: Boolean - If the object is local on given computer.


PostReset

Triggers after PP effects have been reset by the engine


Put

Template:EffArg
Triggers when a unit puts an item in a container.

this addEventHandler ["Put", {
	params ["_unit", "_container", "_item"];
}];
  • unit: Object - Unit to which the event handler is assigned
  • container: Object - The container into which the item was placed (vehicle, box, etc.)
  • item: String - The class name of the moved item


Reloaded

Template:EffArg
Triggers when a weapon is reloaded with a new magazine. For more information see: Reloaded

this addEventHandler ["Reloaded", {
	params ["_unit", "_weapon", "_muzzle", "_newMagazine", "_oldMagazine"];
}];
  • unit: Object - unit or vehicle to which EH is assigned
  • weapon: String - weapon that got reloaded
  • muzzle: String - weapon's muzzle that got reloaded
  • newMagazine: Array - new magazine info
  • oldMagazine: Array or Nothing - old magazine info


Respawn

Template:EffArg
Triggered when a unit respawns.

this addEventHandler ["Respawn", {
	params ["_unit", "_corpse"];
}];
  • unit: Object - Object the event handler is assigned to
  • corpse: Object - Object the event handler was assigned to, aka the corpse/unit player was previously controlling


RopeAttach

Triggered when a rope is attached to an object.
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each attached rope.

this addEventHandler ["RopeAttach", {
	params ["_object1", "_rope", "_object2"];
}];
  • object 1: Object - Object to which the event handler is assigned.
  • rope: Object - The rope being attached between object 1 and object 2.
  • object 2: Object - The object that is being attached to object 1 via rope.


RopeBreak

Triggered when a rope is detached from an object.
In the case of sling loading, this event handler must be assigned to the helicopter and will trigger for each detached rope.

this addEventHandler ["RopeBreak", {
	params ["_object1", "_rope", "_object2"];
}];
  • object 1: Object - Object to which the event handler is assigned.
  • rope: Object - The rope being detached between object 1 and object 2.
  • object 2: Object - The object that is being detached from object 1 via rope.


SeatSwitched

Template:EffArg
Triggered when unit changes seat within vehicle. EH returns both units switching seats. If switching seats with an empty seat, one of the returned units will be objNull. The new position can be obtained with assignedVehicleRole <unit>. This EH must be assigned to a vehicle.

this addEventHandler ["SeatSwitched", {
	params ["_vehicle", "_unit1", "_unit2"];
}];
  • vehicle: Object - Vehicle to which the event handler is assigned.
  • unit1: Object - Unit switching seat.
  • unit2: Object - Unit switching seat.


SeatSwitchedMan

Template:EffArg
Triggered when unit changes seat within vehicle. EH returns both units switching seats. If switching seats with an empty seat, one of the returned units will be objNull. The new position can be obtained with assignedVehicleRole <unit>. This EH must be assigned to a unit and not a vehicle. This EH is persistent and will be transferred to the new unit after respawn, but only if it was assigned where unit was local.

this addEventHandler ["SeatSwitchedMan", {
	params ["_unit1", "_unit2", "_vehicle"];
}];
  • unit1: Object - Unit switching seat.
  • unit2: Object - Unit with which unit1 is switching seat.
  • vehicle: Object - Vehicle where switching seats is taking place.


SoundPlayed

Template:EffArg
Triggered when player is making noises when injured or fatigued for example. The number param passed to the EH code, points to the sound origin:

  • 1 : Breath
  • 2 : Breath Injured
  • 3 : Breath Scuba
  • 4 : Injured
  • 5 : Pulsation
  • 6 : Hit Scream
  • 7 : Burning
  • 8 : Drowning
  • 9 : Drown
  • 10 : Gasping
  • 11 : Stabilizing
  • 12 : Healing
  • 13 : Healing With Medikit
  • 14 : Recovered
this addEventHandler ["SoundPlayed", {
	params ["_unit", "_soundID"];
}];
  • unit: Object - Unit to which the event handler is assigned
  • soundID: Number - sound origin


Take

Template:EffArg
Triggers when a unit takes an item from a container.

this addEventHandler ["Take", {
	params ["_unit", "_container", "_item"];
}];
  • unit: Object - Unit to which the event handler is assigned
  • container: Object - The container from which the item was taken (vehicle, box, etc.)
  • item: String - The class name of the taken item


TaskSetAsCurrent

Triggers when player's current task changes

this addEventHandler ["TaskSetAsCurrent", {
	params ["_unit", "_task"];
}];
  • unit: Object - The player to whom the event handler is assigned
  • task: Task - The new current task


TurnIn

Triggers when member of crew in a vehicle uses Turn In action

this addEventHandler ["TurnIn", {
	params ["_vehicle", "_unit", "_turret"];
}];
  • vehicle: Object - The vehicle the event handler is assigned to
  • unit: Object - The unit performing the Turn In action
  • turret: Array - Turret path


TurnOut

Triggers when member of crew in a vehicle uses Turn Out action

this addEventHandler ["TurnOut", {
	params ["_vehicle", "_unit", "_turret"];
}];
  • vehicle: Object - The vehicle the event handler is assigned to
  • unit: Object - The unit performing the Turn Out action
  • turret: Array - Turret path


WeaponAssembled

Template:EffArg
Triggers when weapon gets assembled. EH should be attached to the unit and not the weapon.

this addEventHandler ["WeaponAssembled", {
	params ["_unit", "_staticWeapon"];
}];
  • unit: Object - Object the event handler is assigned to
  • weapon: Object - Object of the assembled weapon


WeaponDisassembled

Template:EffArg
Triggers when weapon gets disassembled. EH should be attached to the unit and not the weapon.

NOTE: As of Arma 3 v1.32, this event does not fire if the weapon is not local. See http://feedback.arma3.com/view.php?id=21308

this addEventHandler ["WeaponDisassembled", {
	params ["_unit", "_backpack1", "_backpack2"];
}];
  • unit: Object - Object the event handler is assigned to
  • primaryBag: Object - First backpack object which was weapon disassembled into
  • secondarybag: Object - Second backpack object which was weapon disassembled into


WeaponDeployed

Template:EffArg
Triggers when the deployed state of a weapon or bipod changes. Note: A weapon cannot be rested and deployed at the same time.

this addEventHandler ["WeaponDeployed", {
	params ["_unit", "_isDeployed"];
}];
  • unit: Object - Object the event handler is assigned to
  • isDeployed: Boolean - true if deployed


WeaponRested

Template:EffArg
Triggers when weapon rested state changes (weapon near a surface that can provide weapon support). Note: A weapon cannot be rested and deployed at the same time.

this addEventHandler ["WeaponRested", {
	params ["_unit", "_isRested"];
}];
  • unit: Object - Object the event handler is assigned to
  • isRested: Boolean - true if rested


Curator

Template:EffArgTemplate:EffArg
Curator Event Handlers are also added with addEventHandler command. They will be executed only where curator is local (on the computer of who is in control of it). All curator event handlers are local and have a global effect. Template:Important

CuratorFeedbackMessage

Template:EffArg
Triggered when curator attempts invalid action in curator interface.

Each error has its own unique ID, recognized values are:

  • 003 - when trying to teleport camera outside of curatorCameraArea
  • 101 - trying to place an object when placing is disabled using setCuratorCoef "place"
  • 102 - trying to place an object which is too expensive (cost set in curatorObjectRegistered multiplied by setCuratorCoef "place" is larger than curatorPoints)
  • 103 - trying to place an object outside of curatorEditingArea
  • 201 - trying to place a waypoint when waypoint placing is disabled
  • 202 - trying to place a waypoint which is too expensive (cost set by setCuratorWaypointCost multiplied by setCuratorCoef "place" is larger than curatorPoints)
  • 206 - trying to place a waypoint when no AI unit is selected
  • 301 - trying to move or rotate an entity when editing is disabled using setCuratorCoef "edit"
  • 302 - trying to move or rotate an entity when it's too expensive (entity cost multiplied by setCuratorCoef "edit" is larger than curatorPoints)
  • 303 - trying to move an entity outside of curatorEditingArea
  • 304 - trying to move or rotate an entity which is outside of curatorEditingArea
  • 307 - trying to move or rotate a player (players cannot be manipulated with)
  • 401 - trying to delete an entity when deleting is disabled using setCuratorCoef "delete"
  • 402 - trying to delete an entity which is too expensive (cost multiplied by setCuratorCoef "delete" is larger than curatorPoints)
  • 404 - trying to delete an entity which is outside of curatorEditingArea
  • 405 - trying to delete an entity which has non-editable crew in it
  • 407 - trying to delete a player (players cannot be manipulated with)
  • 501 - trying to destroy an object when destroying is disabled using setCuratorCoef "destroy"
  • 502 - trying to destroy an object which is too expensive (cost multiplied by setCuratorCoef "destroy" is larger than curatorPoints)
  • 504 - trying to destroy an object which is outside of curatorEditingArea
  • 505 - trying to destroy an object which has non-editable crew in it
  • 506 - trying to destroy an object when no object is selected
  • 507 - trying to destroy a player (players cannot be manipulated with)

This handler is supposed to be added to curator module, not player.

this addEventHandler ["CuratorFeedbackMessage", {
	params ["_curator", "_errorID"];
}];


CuratorGroupDoubleClicked

Template:EffArg
Triggered when a group is double-clicked on in curator interface.

this addEventHandler ["CuratorGroupDoubleClicked", {
	params ["_curator", "_group"];
}];


CuratorGroupPlaced

Template:EffArg
Triggered when new group is placed in curator interface.

this addEventHandler ["CuratorGroupPlaced", {
	params ["_curator", "_group"];
}];


CuratorGroupSelectionChanged

Template:EffArg
Triggered when a group is selected in curator interface.

this addEventHandler ["CuratorGroupSelectionChanged", {
	params ["_curator", "_group"];
}];


CuratorMarkerDeleted

Template:EffArg
Triggered when a marker is deleted in curator interface.

this addEventHandler ["CuratorMarkerDeleted", {
	params ["_curator", "_marker"];
}];


CuratorMarkerDoubleClicked

Template:EffArg
Triggered when a marker is double-clicked on in curator interface.

this addEventHandler ["CuratorMarkerDoubleClicked", {
	params ["_curator", "_marker"];
}];


CuratorMarkerEdited

Template:EffArg
Triggered when a marker is moved in curator interface.

this addEventHandler ["CuratorMarkerEdited", {
	params ["_curator", "_marker"];
}];


CuratorMarkerPlaced

Template:EffArg
Triggered when new marker is placed in curator interface.

this addEventHandler ["CuratorMarkerPlaced", {
	params ["_curator", "_marker"];
}];


CuratorMarkerSelectionChanged

Template:EffArg
Triggered when a marker is selected in curator interface.

this addEventHandler ["CuratorMarkerSelectionChanged", {
	params ["_curator", "_marker"];
}];


CuratorObjectDeleted

Template:EffArg
Triggered when an object is deleted in curator interface.

this addEventHandler ["CuratorObjectDeleted", {
	params ["_curator", "_entity"];
}];


CuratorObjectDoubleClicked

Template:EffArg
Triggered when an object is double-clicked on in curator interface.

this addEventHandler ["CuratorObjectDoubleClicked", {
	params ["_curator", "_entity"];
}];


CuratorObjectEdited

Template:EffArg
Triggered when an object is moved or rotated in curator interface.

this addEventHandler ["CuratorObjectEdited", {
	params ["_curator", "_entity"];
}];


CuratorObjectPlaced

Template:EffArg
Triggered when new object is placed in curator interface. This event handler will trigger individually for each unit in a placed group - excluding the crew in vehicles.

this addEventHandler ["CuratorObjectPlaced", {
	params ["_curator", "_entity"];
}];


CuratorObjectRegistered

Template:EffArg
Triggered when player enters curator interface. Assign curator cost to every object in the game. This is the primary method that a mission designer can use to limit the objects a curator can place.
Full article - Curator

this addEventHandler ["CuratorObjectRegistered", {
	params ["_curator", "_input"];
}];


CuratorObjectSelectionChanged

Template:EffArg
Triggered when an object is selected in curator interface.

this addEventHandler ["CuratorObjectSelectionChanged", {
	params ["_curator", "_entity"];
}];


CuratorPinged

Template:EffArg
Triggered when a player pings his curator(s) by pressing Zeus key. To add player to specific curator, use addCuratorEditableObjects command.

this addEventHandler ["CuratorPinged", {
	params ["_curator", "_unit"];
}];


CuratorWaypointDeleted

Template:EffArg
Triggered when a waypoint is deleted in curator interface.

this addEventHandler ["CuratorWaypointDeleted", {
	params ["_curator", "_waypoint"];
}];


CuratorWaypointDoubleClicked

Template:EffArg
Triggered when a waypoint is double-clicked on in curator interface.

this addEventHandler ["CuratorWaypointDoubleClicked", {
	params ["_curator", "_waypoint"];
}];


CuratorWaypointEdited

Template:EffArg
Triggered when a waypoint is moved in curator interface.

this addEventHandler ["CuratorWaypointEdited", {
	params ["_curator", "_waypoint"];
}];


CuratorWaypointPlaced

Template:EffArg
Triggered when new waypoint is placed in curator interface.

this addEventHandler ["CuratorWaypointPlaced", {
	params ["_curator", "_group", "_waypointID"];
}];


CuratorWaypointSelectionChanged

Template:EffArg
Triggered when a waypoint is selected in curator interface.

this addEventHandler ["CuratorWaypointSelectionChanged", {
	params ["_curator", "_waypoint"];
}];


Multiplayer Event Handlers

Global object event handler, executed on every connected machine.
Commands are:

Example:

mySoldier addMPEventHandler ["MPKilled",{ hint format ["%1 was killed by %2",name (_this select 0), name (_this select 1)]; }];

MPHit

Template:EffArgTemplate:EffArg
Triggered when the unit is hit/damaged. EH can be added on any machine and EH code will trigger globally on every connected client and server. This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.

Is not always triggered when unit is killed by a hit. Most of the time only the Killed event handler is triggered when a unit dies from a hit. The hit EH will not necessarily fire if only minor damage occurred (e.g. firing a bullet at a tank), even though the damage increased. Can also trigger several times for an explosion (direct and indirect damage). Does not fire when a unit is set to allowDamage false. However it will fire with "HandleDamage" EH added alongside stopping unit from taking damage (Template:Inline code. Will not trigger once the unit is dead.

Note: call a function from the MPHit EH code space rather than defining the full code in there directly. The reason is the code space will be transferred over network on each event activation - so keep the data as small as possible!

  • unit: Object - Object the event handler is assigned to
  • causedBy: Object - Object that caused the damage. Contains the unit itself in case of collisions.
  • damage: Number - Level of damage caused by the hit
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger


MPKilled

Template:EffArgTemplate:EffArg
Triggered when the unit is killed. EH can be added on any machine and EH code will trigger globally on every connected client and server. This EH is clever enough to be triggered globally only once even if added on all clients or a single client that is then disconnected, EH will still trigger globally only once.

  • unit: Object - Object the event handler is assigned to
  • killer: Object - Object that killed the unit
    Contains the unit itself in case of collisions
  • Arma 3 logo black.png1.65 instigator: Object - Person who pulled the trigger
  • Arma 3 logo black.png1.67 useEffects: Boolean - same as useEffects in setDamage alt syntax


MPRespawn

Template:EffArgTemplate:EffArg
Triggered when a unit, it is assigned to, respawns. This EH does not work as one would expect MP EH should work like. It is only triggered on one machine where the unit it was assigned to is local. The only difference between Respawn and MPRespawn is that MPRespawn can be assigned from anywhere while Respawn requires the unit to be local.

MPRespawn EH expects the EH code to return array in format of Position, which will be used to place respawned unit at desired coordinates. For example: player addMPEventHandler ["MPRespawn", {[1234,1234,0]}]; will place player at [1234,1234,0] immediately on respawn.

  • unit: Object - Object the event handler is assigned to
  • corpse: Object - Object the event handler was assigned to, aka the corpse/unit player was previously controlling.


Mission Event Handlers

Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over. The following mission EHs are available in Arma 3:

For detailed description see Mission Event Handlers page.


In Game UI Event Handlers

In Game UI Event Handlers trigger when user scrolls or activates in game action menu. There are following mission EHs available in Arma 3:

For detailed description see In Game UI Event Handlers page.


Music Event Handlers

Music event handler, always executed on the computer where it was added.
Commands are:

Example:

addMusicEventHandler ["MusicStop",{playMusic (_this select 0);}]


MusicStart

Triggers when CfgMusic sound starts playing, after being executed with playMusic command.

This event handler needs to be added with addMusicEventHandler command and removed with removeMusicEventHandler.


MusicStop

Triggers when CfgMusic sound finished playing, after being executed with playMusic command. Note that EH will not be triggered if you force stop the music with playMusic "".

This event handler needs to be added with addMusicEventHandler command and removed with removeMusicEventHandler.


Eden Editor

Full article - Event Handlers: Eden Editor


add3DENEventHandler

Full article - Arma 3: Event Handlers: Eden Editor


ctrlAddEventHandler

Full article - User Interface Event Handlers


displayAddEventHandler

Full article - User Interface Event Handlers