---
name: "onPreloadFinished"
type: command
status: ok
groups: ["Event Handlers"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/onPreloadFinished
revid: 379455
updated: 2026-10-31T00:08:48Z
---

# onPreloadFinished

*Command · Event Handlers · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Defines an action performed after the preload screen finished. Preload event occurs after briefing screen on mission start.

> [!IMPORTANT]
> This event handler also fires on client after user closes the main map.

> [!NOTE]
> **Arma 3:**
>
> - Since Arma 3 v1.58 a stackable version of this EH is available: [PreloadFinished](../topics/Mission_Event_Handlers.md#preloadfinished)
> - Before that, the [BIS_fnc_addStackedEventHandler](../functions/BIS_fnc_addStackedEventHandler.md) and [BIS_fnc_removeStackedEventHandler](../functions/BIS_fnc_removeStackedEventHandler.md) functions should be used instead.

## Syntax

```sqf
onPreloadFinished command
```

**Parameters:**

- `command`: [String](../topics/String.md) or [Code](../topics/Code.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
onPreloadFinished {TAG_ReceivingScreenDone = true};
```

### Example 2

```sqf
// removes the event immediately after the first run again
onPreloadFinished { TAG_ReceivingScreenDone = true; onPreloadFinished "" };
```

## See also

[onPreloadStarted](../commands/onPreloadStarted.md)

## Community notes

**Tophe** — 2009-07-24

There is a bug in Arma 2 that will make this command execute every time the screen with "Receiving..." has been displayed.\
If this code is put in the Init.sqf it will run the startcam.sqf script when the loading screen has disappeared

```sqf
onPreloadFinished '[fire1] execVM "scripts\startcam.sqf"';
```

It will however also run every time a player change graphics settings, alt-tab or do anything else that will trigger the loading screen.\
You will have to script around it with if statements to get it to run only in the beginning of the mission.

<sub>Source: [BI Community Wiki — onPreloadFinished](https://community.bistudio.com/wiki/onPreloadFinished) (revision 379455).</sub>