Event Handlers – Arma Reforger

From Bohemia Interactive Community
Jump to navigation Jump to search
(Add Script Invoker guidelines)
(Add HHMMSS, Fix dupe)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOEDITSECTION__{{TOC|side}}
__NOEDITSECTION__
== Script Invokers ==
{{TOC|side}}
{{TOC|subtoc|content=
* 1 {{Link|#Script Invokers}}
* 2 {{Link|#Event Handler Manager Component Events}}
* 3 {{Link|#Entity Event Handlers}}
}}


An Event Handler can be created using the {{Link/Enfusion|armaR|ScriptInvoker}} class; it is good practice to '''not''' instanciate them on instance creation but rather create them on request (using its getter):
<enforce>
class TAG_Example
{
protected ScriptInvoker m_OnEvent; // do not create it by default as ScriptInvokers take some RAM (and might be numerous)


ScriptInvoker GetOnEvent()
== Script Invokers ==
{
if (!m_OnEvent)
m_OnEvent = new ScriptInvoker();


return m_OnEvent;
* An Event Handler can be created using a '''{{Link|enfusion://ScriptEditor/scripts/Game/Helpers/SCR_ScriptInvokerHelper.c|ScriptInvoker}}''' class.
}
* Any Script Invoker signature can be created using {{hl|{{Link|Arma Reforger:Scripting: Keywords#typedef|typedef}}}} - see {{Link|Arma Reforger:ScriptInvoker Usage#Signature Declaration}}.
 
* Using the {{Link/Enfusion|armaR|ScriptInvoker}} class itself is considered bad practice and '''must''' be avoided.
void Event()
* As Script Invokers are big objects and can be numerous, it is good practice to '''not''' instanciate them by default but to rather create them on request, using their getter - saving memory.
{
if (m_OnEvent) // if it does not exist, do not create it - it simply means no one subscribed to it
m_OnEvent.Invoke();
}
}
</enforce>


{{Feature|informative|
{{Feature|informative|
For a tutorial on how to use Script Invokers, see {{Link|Arma Reforger:ScriptInvoker Usage|ScriptInvoker Usage}}.<br>
See {{Link|Arma Reforger:ScriptInvoker Usage}} and its {{Link|Arma Reforger:ScriptInvoker Usage#Signature Declaration|Signature Declaration}} section for tutorials on how to use Script Invokers.
For the proper way to define an event with parameters, see <!-- the {{hl|SCR_ScriptInvokerHelper}} class and e.g {{Link/Enfusion|armaR|ScriptInvokerIntMethod}: -->{{Link|Arma Reforger:ScriptInvoker Usage#Signature Declaration}}.
}}
}}




== Common Event Handlers ==
== Event Handler Manager Component Events ==


{{Feature|informative|The following table is a list of the most useful events and is not an extensive list of each event handlers.}}
The {{Link/Enfusion|armaR|EventHandlerManagerComponent}} groups the following events under its category:


{| class="wikitable sortable valign-top"
{| class="wikitable sortable valign="top"
! Event
! Class
! Class
! Event
! class="unsortable | Description
! class="unsortable" | Description
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnDestroyed ===
=== OnADSChanged ===
| {{Link/Enfusion|armaR|DamageManagerComponent}}
| rowspan="3" | {{Link/Enfusion|armaR|CharacterControllerComponent}}
| when default hitzone is set to destroyed
|
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnADSChanged ===
=== OnConsciousnessChanged ===
| rowspan="2" | {{Link/Enfusion|armaR|CharacterControllerComponent}}
|
| on player character which switches to ADS
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
Line 56: Line 45:
=== OnMagazineCountChanged ===
=== OnMagazineCountChanged ===
| {{Link/Enfusion|armaR|InventoryStorageManagerComponent}}
| {{Link/Enfusion|armaR|InventoryStorageManagerComponent}}
|
|-
| style="font-size: 0.8em" |
=== OnDestroyed ===
| {{Link/Enfusion|armaR|DamageManagerComponent}}
| when the default hit zone is set to destroyed
|-
| style="font-size: 0.8em" |
=== OnCompartmentEntering ===
| rowspan="4" | {{Link/Enfusion|armaR|BaseCompartmentManagerComponent}}
|
|
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnCompartmentEntered ===
=== OnCompartmentEntered ===
| rowspan="2" | {{Link/Enfusion|armaR|BaseCompartmentManagerComponent}}
|
|
|-
|-
Line 68: Line 66:
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnAmmoCountChanged ===
=== OnCompartmentLeaving ===
| {{Link/Enfusion|armaR|BaseMuzzleComponent}}
|
| Both weapon and character can raise the event (see {{Link|#BaseWeaponManagerComponent}})
|-
| style="font-size: 0.8em" |
=== OnLightStateChanged ===
| {{Link/Enfusion|armaR|BaseLightManagerComponent}}
|
|-
| style="font-size: 0.8em" |
=== OnTurretReload ===
| rowspan="2" | {{Link/Enfusion|armaR|TurretControllerComponent}}
| {{hl|isFinished}} is true when reload is done and false when it started
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnAmmoCountChanged ===
=== OnADSChanged ===
| rowspan="3" | {{Link/Enfusion|armaR|BaseWeaponManagerComponent}}
| on player character which switches to ADS<br>{{Link/Enfusion|armaR|TurretControllerComponent}} can also trigger this event
| Both weapon and character can raise the event (see {{Link|#BaseMuzzleComponent}})
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnWeaponChanged ===
=== OnWeaponChanged ===
| {{Link/Enfusion|armaR|BaseWeaponManagerComponent}}
|
|-
| style="font-size: 0.8em" |
=== OnMuzzleChanged ===
| {{Link/Enfusion|armaR|BaseWeaponComponent}}
|
|
|-
| style="font-size: 0.8em" |
=== OnAmmoCountChanged ===
| rowspan="4" | {{Link/Enfusion|armaR|BaseMuzzleComponent}}
| Both weapon and character can raise this event (see {{hl|BaseWeaponManagerComponent}})
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
Line 86: Line 103:
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnMuzzleChanged ===
=== OnProjectileShot ===
| {{Link/Enfusion|armaR|BaseWeaponComponent}}
|
|
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnFiremodeChanged ===
=== OnFiremodeChanged ===
| {{Link/Enfusion|armaR|BaseMuzzleComponent}}
|
|
|-
| style="font-size: 0.8em" |
=== OnWeaponAttachmentChanged ===
| rowspan="2" | {{Link/Enfusion|armaR|WeaponComponent}}
| {{hl|isAttached}} is true if {{hl|attachmentEntity}} was attached to the weapon, and false if it was detached
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnZeroingChanged ===
=== OnZeroingChanged ===
| {{Link/Enfusion|armaR|BaseSightsComponent}}
| currently does not carry currentMuzzle
| currently does not carry currentMuzzle
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnWeaponAttachmentChanged ===
=== OnGrenadeThrown ===
| {{Link/Enfusion|armaR|WeaponComponent}}
| {{Link/Enfusion|armaR|WeaponSlotComponent}}
| {{hl|isAttached}} is true if attachmentEntity was attached to the weapon, and false if it was detached.
|
|-
| style="font-size: 0.8em" |
=== HHMMSS ===
| rowspan="3" | {{Link/Enfusion|armaR|TimeAndWeatherManagerEntity}}
| Triggers based on {{Link/Enfusion|armaR|TimeAndWeatherManagerEntity}}'s {{hl|TIME_EVENT_PERIODICITY}} value:
* 0: never
* 1: every hour
* 2: every minute
* 3: every second
|-
| style="font-size: 0.8em" |
=== OnDayStart ===
|
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== OnTurretReload ===
=== OnNightStart ===
| {{Link/Enfusion|armaR|TurretControllerComponent}}
|
| isFinished is true when reload is done and false when it started.
|}
|}


Line 114: Line 145:
== Entity Event Handlers ==
== Entity Event Handlers ==


{{Feature|informative|See also {{Link|Arma Reforger:Entity Lifecycle}}.}}
The following events are present and available in the '''{{Link/Enfusion|armaR|IEntity}}''' class - read the code documentation to learn more about them and how to use them.
The following events are present and available in the '''{{Link/Enfusion|armaR|IEntity}}''' class - read the code documentation to learn more about them and how to use them.
{{Feature|informative|'''E''' in e.g '''E'''OnInit stands for Event (not Entity).}}
{{Feature|informative|'''E''' in e.g '''E'''OnInit stands for Event (not Entity).}}
Line 123: Line 155:
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== EOnInit ===
=== EOnInit ===
| Event after the entity is allocated and initialized.
| Event after the entity is allocated and initialised.
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
Line 139: Line 171:
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== EOnFixedFrame ===
=== EOnFixedFrame ===
|
| {{Feature|warning|This event can be called on another thread than the main thread. This means that you must avoid any modifications on other entities during this event!}}
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
Line 180: Line 212:
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |
=== EOnDiag ===
=== EOnDiag ===
| Happens every frame after {{Link|#EOnFrame}} when "Entity Diag" is enabled in the [[Arma Reforger:Diag Menu|Diag Menu]] (e.g [[Arma Reforger:Workbench|Workbench]]).
| Happens every frame after {{Link|#EOnFrame}} when "Entity Diag" is enabled in the [[Arma Reforger:Diag Menu|Diag Menu]] (e.g {{GameCategory|armaR|Modding|Official Tools|text= Workbench}}).
|-
|-
| style="font-size: 0.8em" |
| style="font-size: 0.8em" |

Latest revision as of 12:54, 2 September 2024

Contents


Script Invokers

  • An Event Handler can be created using a ScriptInvoker class.
  • Any Script Invoker signature can be created using typedef - see ScriptInvoker Usage - Signature Declaration.
  • Using the ScriptInvoker class itself is considered bad practice and must be avoided.
  • As Script Invokers are big objects and can be numerous, it is good practice to not instanciate them by default but to rather create them on request, using their getter - saving memory.
ⓘ
See ScriptInvoker Usage and its Signature Declaration section for tutorials on how to use Script Invokers.


Event Handler Manager Component Events

The EventHandlerManagerComponent groups the following events under its category:

Event Class Description

OnADSChanged

 CharacterControllerComponent

OnConsciousnessChanged

OnInspectionModeChanged

 on player character which switches in/out of inspection mode

OnMagazineCountChanged

 InventoryStorageManagerComponent

OnDestroyed

 DamageManagerComponent when the default hit zone is set to destroyed

OnCompartmentEntering

 BaseCompartmentManagerComponent

OnCompartmentEntered

OnCompartmentLeft

OnCompartmentLeaving

OnLightStateChanged

 BaseLightManagerComponent

OnTurretReload

 TurretControllerComponent isFinished is true when reload is done and false when it started

OnADSChanged

 on player character which switches to ADS
TurretControllerComponent can also trigger this event

OnWeaponChanged

 BaseWeaponManagerComponent

OnMuzzleChanged

 BaseWeaponComponent

OnAmmoCountChanged

 BaseMuzzleComponent Both weapon and character can raise this event (see BaseWeaponManagerComponent)

OnMagazineChanged

OnProjectileShot

OnFiremodeChanged

OnWeaponAttachmentChanged

 WeaponComponent isAttached is true if attachmentEntity was attached to the weapon, and false if it was detached

OnZeroingChanged

 currently does not carry currentMuzzle

OnGrenadeThrown

 WeaponSlotComponent

HHMMSS

 TimeAndWeatherManagerEntity Triggers based on TimeAndWeatherManagerEntity's TIME_EVENT_PERIODICITY value:
  • 0: never
  • 1: every hour
  • 2: every minute
  • 3: every second

OnDayStart

OnNightStart


Entity Event Handlers

ⓘ

The following events are present and available in the IEntity class - read the code documentation to learn more about them and how to use them.

ⓘ
E in e.g EOnInit stands for Event (not Entity).
Event Description

EOnInit

 Event after the entity is allocated and initialised.

EOnVisible

 This event triggers when the entity is made visible (versus being invisible).

EOnFrame

 This event, as its name suggests, triggers on each simulation frame.

EOnPostFrame

 Triggers after physics update.

EOnFixedFrame
⚠
This event can be called on another thread than the main thread. This means that you must avoid any modifications on other entities during this event!

EOnFixedPostFrame

EOnAnimEvent

 Event from the animation system

EOnPhysicsActive

 Triggers on (de)activation of the RigidBody's physics.

EOnPhysicsMove

 Triggers when the physics engine moves this entity.

EOnSimulate

 Happens before physics engine iteration - called from sub-iterations.

EOnPostSimulate

 Happens after physics engine iteration. Happens once per frame.

EOnJointBreak

 Triggers when a joint attached to this entity's RigidBody is broken.

EOnTouch

 Event when touched by another entity. It requires the entity to have TouchComponent.

EOnContact

 Triggers when contact with another RigidBody has been registered.

EOnDiag

 Happens every frame after EOnFrame when "Entity Diag" is enabled in the Diag Menu (e.g Workbench).

EOnUser0

EOnUser1

EOnUser2

EOnUser3

EOnUser4
Retrieved from "https://community.bistudio.com/wiki?title=Arma_Reforger:Event_Handlers&oldid=369044"