Event Scripts
Jump to navigation
Jump to search
Event scripts are scripts which are executed by the game engine upon specific events.
To use an event script, create a file of given name in the mission directory.
Available Scripts
File | Description | Arguments | 1.00 | 1.75 | -wrong parameter ("Arma") defined!-1.00 | 1.00 | 1.51 | 1.00 | 1.00 |
---|---|---|---|---|---|---|---|---|---|
init.sqs | Executed when mission is started (before briefing screen) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
init.sqf | Executed when mission is started (before briefing screen) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||
initIntro.sqf | Executed when intro, outro win or outro lose is started. | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
exit.sqs | Executed when mission is finished (before debriefing screen). In Arma 3, "ended" mission event handler has the same functionality. | [endType:String] | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
onFlare.sqs | Executed when a flare is lit after being fired from grenade launcher. | [colorRGB:Array,shooter:Object] | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
pauseOnLoad.sqf | Executed when pause menu is activated.
To make it work in MP, use onPauseScript = "myScript.sqf" in description.ext |
[pauseMenuDisplay:Display] | ✔ | ✔ | ✔ | ||||
onPlayerKilled.sqs | Executed when player is killed in singleplayer or in multiplayer mission with "NONE" respawn type. | [player:Object, killer:Object] | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
onPlayerKilled.sqs | Executed when player is killed in singleplayer or in multiplayer mission with "NONE" respawn type. | [player:Object, killer:Object] | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
onPlayerRespawnOtherUnit.sqs | Executed when player is killed in multiplayer mission with "GROUP" or "SIDE" respawn type. This script will replace the default respawn sequence. | [player:Object, killer:Object, newPlayer:Object] | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
initJIPcompatible.sqf | Executed by Multiplayer framework on all machines when a player joins mission (includes both mission start and JIP). | ✔ | ✔ | ||||||
initServer.sqf | Executed only on server when mission is started. See initialization order for details about when the script is exactly executed. | ✔ | |||||||
initPlayerServer.sqf | Executed only on server when a player joins mission (includes both mission start and JIP). See initialization order for details about when the script is exactly executed. | [player:Object,didJIP:Boolean] | ✔ | ||||||
initPlayerLocal.sqf | Executed locally when player joins mission (includes both mission start and JIP). See initialization order for details about when the script is exactly executed. | [player:Object,didJIP:Boolean] | ✔ | ||||||
onPlayerKilled.sqf | Executed when player is killed in singleplayer or in multiplayer mission. | [<oldUnit>,<killer>,<respawn>,<respawnDelay>] | ✔ | ||||||
onPlayerRespawn.sqf | Executed when player respawns in a multiplayer mission. | [<newUnit>,<oldUnit>,<respawn>,<respawnDelay>] | ✔ |
Note: Additional init scripts can be executed using functions with preInit or postInit attribute.