Difference between revisions of "Arma 3: Event Handlers/addMissionEventHandler"

From Bohemia Interactive Community
Jump to navigation Jump to search
(chronology)
(link back to parent)
Line 4: Line 4:
 
== Description ==
 
== Description ==
  
Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over.  
+
Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over. For all other available EHs see the [[Arma_3:_Event_Handlers|main page]].
  
 
== Related Commands ==
 
== Related Commands ==

Revision as of 21:55, 31 March 2016

Mission Event Handlers

Description

Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over. For all other available EHs see the main page.

Related Commands

Examples

handle1 = addMissionEventHandler ["Loaded",{playMusic "EventTrack03_F_EPB"}]; removeMissionEventHandler ["Loaded", handle1]; addMissionEventHandler ["HandleDisconnect",{diag_log _this}]; removeAllMissionEventHandlers "HandleDisconnect";

Events

Class Description Arguments Since

Draw3D

Runs the EH code each frame in unscheduled environment. Client side EH only (presence of UI). Will stop executing when UI loses focus (if user Alt+Tabs for example). Usually used with drawIcon3D, drawLine3D.

Introduced with Arma 3 version 0.500.50

Ended

Triggered when mission ends, either using trigger of type "End", endMission command, BIS_fnc_endMission function or ENDMISSION cheat.

Introduced with Arma 3 version 0.500.50

Loaded

Triggered when mission is loaded from save.

  • saveType: String - save type, can be have following values:
    • "save" - custom save, achieved by pressing SAVE button in the pause menu
    • "autosave" - automatic checkpoint, saved using saveGame command
    • "continue" - saved when leaving a mission to the main menu

Introduced with Arma 3 version 0.500.50

HandleDisconnect

Triggered when player disconnects from the game. Similar to onPlayerDisconnected event but can be stacked and contains the unit occupied by player before disconnect. Must be added on the server and triggers only on the server.

Override: If this EH code returns true, the unit, previously occupied by player, gets transferred to the server, becomes AI and continues to live, even with description.ext param disabledAI = 1;

Introduced with Arma 3 version 1.321.32

EntityRespawned

Triggered when an entity is respawned.

  • newEntity: Object - respawned entity
  • oldEntity: Object - corpse/wreck

Introduced with Arma 3 version 1.551.55

EntityKilled

Triggered when an entity is killed.

  • killed: Object - entity that was killed
  • killer: Object - the killer

Introduced with Arma 3 version 1.551.55