---
name: "BIS_fnc_helicopterDamage"
type: function
status: ok
groups: ["Helicopters"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_helicopterDamage
revid: 370866
updated: 2025-02-21T10:43:59Z
---

# BIS_fnc_helicopterDamage

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

## Description

Handling EH-based helicopter damage, event handler in question being [Da*mm*aged](../topics/Event_Handlers.md#dammaged) [sic].

> [!NOTE]
> Executed script is:
>
> ```sqf
> helicopter execVM "hsim\air_h\data\scripts\main_rotor_destruction.sqf";
> ```
>
> helicopter rotor status can be found via variable **HSim_mainRotorDestroyed**:
>
> ```sqf
> _isRotorDestroyed = helicopter getVariable ["HSim_mainRotorDestroyed", false];
> ```

## Syntax

```sqf
[helicopter, selection, damage] call BIS_fnc_helicopterDamage
```

**Parameters:**

- `helicopter`: [Object](../topics/Object.md)
- `selection`: [String](../topics/String.md) - name of the helicopter selection receiving damage. Must be "main rotor"
- `damage`: [Number](../topics/Number.md) - *selection*'s damage. Will only trigger effects if *damage* > 0.999

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) when done

## Examples

### Example 1

```sqf
myHelicopter addEventHandler ["Dammaged", { _this call BIS_fnc_helicopterDamage; }];
```

<sub>Source: [BI Community Wiki — BIS fnc helicopterDamage](https://community.bistudio.com/wiki/BIS_fnc_helicopterDamage) (revision 370866).</sub>