---
name: "BIS_fnc_planeAiEject"
type: function
status: ok
groups: ["Aircraft Functionality"]
arma3_since: "1.70"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_planeAiEject
revid: 376187
updated: 2025-09-13T15:54:56Z
---

# BIS_fnc_planeAiEject

*Function · Aircraft Functionality · Arma 3 v1.70*

## Description

- This function is designed as part of set of functions to implement semi-authenthic ejection system on fixed wing aircrfat that have such functionality enabled/configured.
- AI behaviour handler.

## Syntax

```sqf
plane call BIS_fnc_planeAiEject
```

**Parameters:**

- `plane`: [Object](../topics/Object.md) - living vehicle with a pilot and with ejection systems set up in its config

**Returns:** [Nothing](../topics/Nothing.md) if plane was invalid or no ejection was needed, otherwise [Script Handle](../topics/Script_Handle.md) - script handle of spawned [BIS_fnc_planeEjection](../functions/BIS_fnc_planeEjection.md)

## Examples

### Example 1

```sqf
_myPlane call BIS_fnc_planeAiEject;
```

## Function header

The comment at the top of the function's file in the game; this page's description come from it.

```sqf
/*
Author: Bravo Zero One development
- John_Spartan

Description:
- This function is designed as part of set of functions to implement semi-authenthic ejection system on fixed wing aircrfat that have such functionality enabled/configured.
- AI behaviour handler.

Exucution:
- Call the function via attached EH to the aircrfat itself.

    Example:
    class Eventhandlers : Eventhandlers
    {
        Hit = "_this call BIS_fnc_planeAiEject";
    };

Requirments:
- Compatible aircrfat must have a config definition for all subsytems that will be invoked by ejection system (see BIS_fnc_PlaneEjection).

Parameter(s):
    _this select 0: mode (Scalar)
    0: plane/object

Returns: nothing
Result: AI pilot will be forced to eject from aircrfat upon damage treshold reached. Semi-authenthic behaviour.
*/
```

## See also

[BIS_fnc_planeEjection](../functions/BIS_fnc_planeEjection.md) · [BIS_fnc_planeEjectionFX](../functions/BIS_fnc_planeEjectionFX.md) · [BIS_fnc_ejectionSeatRelease](../functions/BIS_fnc_ejectionSeatRelease.md)

<sub>Source: [BI Community Wiki — BIS fnc planeAiEject](https://community.bistudio.com/wiki/BIS_fnc_planeAiEject) (revision 376187).</sub>