Event Scripts

Event Scripts are scripts which are executed upon specific events. Not all event scripts are executed directly by the engine.

To use an Event Script, create a file of the given name in the mission directory.

init* scripts	(on)Player* scripts	other scripts
init.sqf init.sqs init3DEN.sqf initIntro.sqf initIntro.sqs initJIPcompatible.sqf initPlayerLocal.sqf initPlayerServer.sqf initServer.sqf	onPlayerKilled.sqf onPlayerKilled.sqs onPlayerRespawn.sqf onPlayerRespawn.sqs onPlayerRespawnAsSeagull.sqs onPlayerRespawnOtherUnit.sqs onPlayerResurrect.sqs playerKilledScript.sqs playerRespawnScript.sqs	exit.sqf exit.sqs missionFlow.fsm onFlare.sqs pauseOnLoad.sqf teamSwitchScript.sqs

Available Scripts

File	Present in
	1.00	1.75	1.00	1.00	1.51	1.00	1.00
exit.sqf Executed when mission is finished (before debriefing screen). In Arma 3, "ended" mission event handler has the same functionality. params ["_endType"]; endType: String				Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
exit.sqs Executed when mission is finished (before debriefing screen). In Arma 3, "ended" mission event handler has the same functionality. params ["_endType"]; endType: String		Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
init.sqf Executed when mission is started (before briefing screen)			Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
init.sqs Executed when mission is started (before briefing screen)	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
init3DEN.sqf Executed when loading a scenario in Eden Editor if the file is present. Useful for executing scenario-specific editor functionality.						Template:Checkbox
initIntro.sqf Executed when intro, outro win or outro lose is started.					Template:Checkbox	Template:Checkbox	Template:Checkbox
initIntro.sqs Executed when intro, outro win or outro lose is started.		Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
initJIPcompatible.sqf Executed locally by Arma 2: Multiplayer Framework when a player joins mission (includes both mission start and JIP). Also executed locally on server at mission start.				Template:Checkbox	Template:Checkbox
initPlayerLocal.sqf Executed locally when player joins mission (includes both mission start and JIP). See Initialization Order for details about when exactly the script is executed. params ["_player", "_didJIP"]; player: Object didJIP: Boolean						Template:Checkbox
initPlayerServer.sqf Executed only on server when a player joins mission (includes both mission start and JIP). See Initialization Order for details about when exactly the script is executed. This script relies on BIS_fnc_execVM and remoteExec. If CfgRemoteExec's class Functions is set to mode = 0 or 1, the script will never be executed. Therefore, initPlayerServer.sqf should be avoided. params ["_playerUnit", "_didJIP"]; playerUnit: Object didJIP: Boolean						Template:Checkbox
initServer.sqf Executed only on server when mission is started. See Initialization Order for details about when exactly the script is executed.						Template:Checkbox
missionFlow.fsm Executed on post-init when mission is started. See BIS_fnc_missionFlow.						Template:Checkbox
onFlare.sqs Executed when a flare is lit after being fired from grenade launcher. params ["_colorRGB", "_shooter"]; colorRGB: Color (RGBA) shooter: Object		Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
onPlayerKilled.sqf Executed when player is killed in singleplayer or in multiplayer mission. params ["_oldUnit", "_killer", "_respawn", "_respawnDelay"]; oldUnit: Object killer: Object respawnType: Number respawnDelay: Number						Template:Checkbox
onPlayerKilled.sqs Executed when player is killed in singleplayer or in multiplayer mission with "NONE" respawn type. params ["_player", "_killer"]; player: Object killer: Object	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox		Template:Checkbox
onPlayerRespawn.sqf Executed locally when player respawns in a multiplayer mission. This event script will also fire at the beginning of a mission if respawnOnStart is 0 or 1, oldUnit will be objNull in this instance. This script will not fire at mission start if respawnOnStart equals -1. params ["_newUnit", "_oldUnit", "_respawn", "_respawnDelay"]; newUnit: Object oldUnit: Object respawnType: Number respawnDelay: Number						Template:Checkbox
onPlayerRespawn.sqs Executed when player is killed in multiplayer mission with "INSTANT" or "BASE" respawn type. It will not work if dta\scripts\onPlayerRespawn.sqs does not exist. params ["_player", "_killer", "_respawnDelay"]; player: Object killer: Object respawnDelay: Number		Template:Checkbox
onPlayerRespawnAsSeagull.sqs Executed when player is killed in multiplayer mission with "SEAGULL" respawn type, or when the type is "GROUP" or "SIDE", but no remaining respawn slots are left. This script will replace the default respawn sequence. playerRespawnSeagullScript.sqs in Arma 3. params ["_player", "_killer", "_seagull"]; player: Object killer: Object seagull: Object	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
onPlayerRespawnOtherUnit.sqs Executed when player is killed in multiplayer mission with "GROUP" or "SIDE" respawn type. This script will replace the default respawn sequence. playerRespawnOtherUnit.sqs in Arma 3. params ["_player", "_killer", "_newUnit"]; player: Object killer: Object newUnit: Object	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox	Template:Checkbox
onPlayerResurrect.sqs Executed when player is respawned in multiplayer mission with "INSTANT" or "BASE" respawn type. It will not work if dta\scripts\onPlayerResurrect.sqs does not exist. playerResurrectScript.sqs in Arma 3. params ["_player"]; player: Object		Template:Checkbox				Template:Checkbox
pauseOnLoad.sqf Executed when pause menu is activated. To make it work in MP or Arma 3, use onPauseScript = "pauseOnLoad.sqf"; in Description.ext params ["_pauseMenuDisplay"]; pauseMenuDisplay: Display				Template:Checkbox	Template:Checkbox		Template:Checkbox
playerKilledScript.sqs Executed locally when player is killed in singleplayer or in multiplayer mission with "NONE" respawn type. Overrides default behavior of mission death screen in single player. Game may become unplayable if not scripted correctly. Avoid use if not experienced with this script. params ["_player", "_killer"]; player: Object killer: Object	?	?	?	?	?	Template:Checkbox	?
playerRespawnScript.sqs Executed locally and immediately when player is killed in multiplayer mission with "BASE" or "INSTANT" respawn type. Overrides default behavior of multiplayer respawn. Game may become unplayable if not scripted correctly. Avoid use if not experienced with this script. params ["_player", "_killer", "_respawnDelay"]; player: Object killer: Object respawnDelay: Number	?	?	?	?	?	Template:Checkbox	?
teamSwitchScript.sqs Executed after a Team Switch is done. Not triggered by selectPlayer. params ["_oldUnit", "_newUnit"]; oldUnit: Object newUnit: Object						Template:Checkbox

ⓘ

Additional init scripts can be executed using functions with preInit or postInit attribute.

Default scripts location

Game	Path
1.00	DTA/scripts.pbo
1.00	Ca.pbo/data/scripts
1.00
1.51
1.00	functions_f.pbo/scripts
1.00	data_h.pbo/data/scripts

See also

• Script (File)
• Initialization Order
• SQF syntax
• SQS syntax
• BIS_fnc_missionFlow