Event Handlers – Arma 2
Jump to navigation
Jump to search
(removed Arma 1 event handlers. Now only new Arma 2 ehs, or A1 ehs that behave differently in A2, are listed here) |
|||
| Line 1: | Line 1: | ||
=Introduction= | =Introduction= | ||
In addition to all the [[ArmA: Event Handlers|ArmA 1 event handlers]], the following event handlers can be added in Arma 2. | |||
=Event Handler List= | =Event Handler List= | ||
==AnimStateChanged== | ==AnimStateChanged== | ||
[[Image:Arma2_1.00.gif]] | [[Image:Arma2_1.00.gif]] <br /> | ||
(placeholder) | (placeholder) | ||
==FiredNear== | ==FiredNear== | ||
[[Image:Arma2_1.00.gif]] | [[Image:Arma2_1.00.gif]] <br /> | ||
Triggered when a weapon is fired somewhere ''near'' the unit or vehicle.<br /> | Triggered when a weapon is fired somewhere ''near'' the unit or vehicle.<br /> | ||
It is also triggered if the unit itself is firing. | It is also triggered if the unit itself is firing. | ||
| Line 91: | Line 25: | ||
* ammo: [[String]] - Ammo used | * ammo: [[String]] - Ammo used | ||
==HandleDamage== | ==HandleDamage== | ||
[[Image:Arma2_1.00.gif]] | [[Image:Arma2_1.00.gif]] <br /> | ||
Triggered when the unit is damaged. Works with all vehicles. Code provided must return a value what should be the damage of given part after processing. Adding this eventhandler with no return value or with return value 0 replaces damage handling by the engine, making the object invulnerable if damage is not scripted in the eventhandler. If you want default processing to be done, be sure to return ''_this select 2''. See [[setDamage]] and [[setHit]] for more information regarding damage handling. | Triggered when the unit is damaged. Works with all vehicles. Code provided must return a value what should be the damage of given part after processing. Adding this eventhandler with no return value or with return value 0 replaces damage handling by the engine, making the object invulnerable if damage is not scripted in the eventhandler. If you want default processing to be done, be sure to return ''_this select 2''. See [[setDamage]] and [[setHit]] for more information regarding damage handling. | ||
| Line 163: | Line 59: | ||
==HandleHeal== | ==HandleHeal== | ||
[[Image:Arma2_1.00.gif]] | [[Image:Arma2_1.00.gif]] <br /> | ||
Passed array: '''[unit, healer, healercanheal]''' | Passed array: '''[unit, healer, healercanheal]''' | ||
| Line 171: | Line 67: | ||
* healercanheal: [[Boolean]] - true when healer is corpsman | * healercanheal: [[Boolean]] - true when healer is corpsman | ||
[[Category: Event Handlers]] | [[Category: Event Handlers]] | ||
Revision as of 04:09, 24 December 2009
Introduction
In addition to all the ArmA 1 event handlers, the following event handlers can be added in Arma 2.
Event Handler List
AnimStateChanged
(placeholder)
FiredNear
Triggered when a weapon is fired somewhere near the unit or vehicle.
It is also triggered if the unit itself is firing.
Global. (Exception(s): the Throw weapon wont broadcast the FiredNear event)
Passed array: [unit, firer, distance, weapon, muzzle, mode, ammo]
- 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
HandleDamage
Triggered when the unit is damaged. Works with all vehicles. Code provided must return a value what should be the damage of given part after processing. Adding this eventhandler with no return value or with return value 0 replaces damage handling by the engine, making the object invulnerable if damage is not scripted in the eventhandler. If you want default processing to be done, be sure to return _this select 2. See setDamage and setHit for more information regarding damage handling.
Unknown locality
This EH is triggered separately for every selection of the damaged object.
Passed array: [unit, selectionName, damage, source, projectile]
- unit: Object - Object the event handler is assigned to.
- selectionName: 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.)
Example:
HANDLE = TargetSoldier addeventhandler ["HandleDamage",{diag_log text format ["T=%1 : %2", time, _this];_this select 2;} ];
When shooting the soldier once in the head, and once in the torso, ArmA2.RPT shows:
T=6.754 : [TargetSoldier,"",0.350463,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=6.754 : [TargetSoldier,"head_hit",3.23586,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=6.754 : [TargetSoldier,"body",0.0743558,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=6.754 : [TargetSoldier,"hands",0.667459,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=6.754 : [TargetSoldier,"legs",0.00307311,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=10.078 : [TargetSoldier,"",0.350179,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=10.078 : [TargetSoldier,"head_hit",0.230999,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=10.078 : [TargetSoldier,"body",1.52881,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=10.078 : [TargetSoldier,"hands",0.105206,B 1-1-A:1 (Matthijs),"B_556x45_Ball"] T=10.078 : [TargetSoldier,"legs",0.0211435,B 1-1-A:1 (Matthijs),"B_556x45_Ball"]
HandleHeal
Passed array: [unit, healer, healercanheal]