Event Scripts

From Bohemia Interactive Community
Revision as of 04:50, 20 May 2015 by Benargee (talk | contribs) (onPlayerRespawn.sqf respawnOnStart)
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 Logo A0.png1.00 ofpr version.gif1.75 -wrong parameter ("Arma") defined!-1.00 Logo A2.png1.00 A2 OA Logo.png1.51 Arma 3 logo black.png1.00 tkoh logo small.png1.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]
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. [player:Object, killer:Object, seagull: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. [isDedicated:Boolean]
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 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. [<newUnit>, <oldUnit>, <respawn>, <respawnDelay>]
Note
Additional init scripts can be executed using functions with preInit or postInit attribute.

See also