---
name: "BIS_fnc_ambientPlanes"
type: function
status: ok
groups: ["Ambient"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_ambientPlanes
revid: 378072
updated: 2026-02-11T08:03:13Z
---

# BIS_fnc_ambientPlanes

*Function · Ambient · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

Locality: effect **global**

## Description

Creates ambient airplanes fly-by near airports around the [player](../commands/player.md). It will automatically get classes from `configFile >> "CfgVehicles"` on all planes that have "ambientType" attribute > 0.

## Syntax

```sqf
[quantity, areaRadius, dirStep] call BIS_fnc_ambientPlanes
```

**Parameters:**

- `quantity`: [Number](../topics/Number.md) - (Optional, default 5)
- `areaRadius`: [Number](../topics/Number.md) - (Optional, default 10000) area radius around airports where planes can spawn/fly
- `dirStep`: [Number](../topics/Number.md) - (Optional, default 30)

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

## Examples

### Example 1

```sqf
[] call BIS_fnc_ambientPlanes;
```

### Example 2

```sqf
[30, 3000] call BIS_fnc_ambientPlanes;
```

## Multiplayer

Since this function uses [player](../commands/player.md) and its effect is [global](../topics/Multiplayer_Scripting.md#locality),
this can only be used in singleplayer or executed locally on a player, usually the group leader.

## See also

[createUnit](../commands/createUnit.md) · [createVehicle](../commands/createVehicle.md) · [BIS_fnc_spawnGroup](../functions/BIS_fnc_spawnGroup.md)

<sub>Source: [BI Community Wiki — BIS fnc ambientPlanes](https://community.bistudio.com/wiki/BIS_fnc_ambientPlanes) (revision 378072).</sub>