Mission Event Handlers – Arma 3

Mission Event Handlers

Description

Mission event handlers are specific EHs that are anchored to the running mission and automatically removed when mission is over.

Related Commands

• addMissionEventHandler
• removeMissionEventHandler
• removeAllMissionEventHandlers

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.		0.50
Ended	Triggered when mission ends, either using trigger of type "End", endMission command, BIS_fnc_endMission function or ENDMISSION cheat.	endType: String - mission end type. Used in Debriefing among other things.	0.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.	unit: Object - unit formerly occupied by player id: Number - same as _id in onPlayerDisconnected uid: String - same as _uid in onPlayerDisconnected name: String - same as _name in onPlayerDisconnected 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;	1.32
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	0.50
EntityRespawned	Triggered when an entity is respawned.	newEntity: Object - respawned entity oldEntity: Object - corpse/wreck	1.55
EntityKilled	Triggered when an entity is killed.	killed: Object - entity that was killed killer: Object - the killer	1.55