Initialisation Order
Jump to navigation
Jump to search
Whenever a mission is launched (or joined in Multiplayer) certain tasks are performed to ensure the mission's various components are initialised correctly and that everyone is synced in multiplayer games (particularly JIP players). Initialisation order refers to the order in which those tasks are executed and it is important to take into account when setting up the start of a mission.
Event Scripts are a key part of a mission's initialisation order and will be utilised often when working with SQF.
| Item | Meaning |
|---|---|
| Single Player Only | |
| Multiplayer Only | |
| Order is not guaranteed |
Take note that the order of initialisation is different in single player and multiplayer environments. If an entry is unmarked then it applies to both.
Arma 3
| Task | Applies To | JIP | Related To | Exec Environment | Notes |
|---|---|---|---|---|---|
| Functions with recompile attribute are recompiled | All | Template:Checkbox | Arma 3 Functions Library | ||
| Functions with preInit attribute are called | All | Template:Checkbox | Arma 3 Functions Library | Unscheduled | |
| Object Init Event Handlers are called | All | Template:Checkbox | Unscheduled | ||
| Expressions of Eden Editor entity attributes are called | Template:Checkbox | Eden Editor: Configuring Attributes | Unscheduled | They are called on the server. isPlayer _entity; does not return true immediately. Once entity has become a player, the entity is transfered to the client.
| |
| Object initialisation fields are called | All | Template:Checkbox | Unscheduled | ||
| init.sqs is executed | Singleplayer | N/A | Event Scripts | ||
| init.sqf is executed | Singleplayer | N/A | Event Scripts | Scheduled[1] | |
| Expressions of Eden Editor scenario attributes are called | All | Template:Checkbox | Eden Editor: Configuring Attributes | Unscheduled | player is not available immediately. |
| Persistent functions are called | Client | Template:Checkbox | BIS_fnc_MP | ||
| Modules are initialised | All | Template:Checkbox | |||
| initServer.sqf is executed | Server | N/A | Event Scripts | Scheduled | |
| initPlayerLocal.sqf is executed | Client | Template:Checkbox | Event Scripts | Scheduled | |
| initPlayerServer.sqf is executed on the server | Client | Template:Checkbox | Event Scripts | Scheduled | |
| Functions with postInit attribute are called | All | Template:Checkbox | Arma 3 Functions Library | Scheduled[1] | |
| "BIS_fnc_init" variable is set to true | All | Template:Checkbox | Arma 2: Functions Library | ||
| init.sqs is executed | Multiplayer | Template:Checkbox | Event Scripts | Scheduled | |
| init.sqf is executed | Multiplayer | Template:Checkbox | Event Scripts | Scheduled |
- ↑ 1.0 1.1 Note that while the environment is Scheduled (canSuspend returns true), the engine seems to wait until the script is done executing, essentially behaving similarly to an Unscheduled environment - infinite loops will freeze the game, uiSleep may pause the game for up to ~20secs (postInit), etc.