---
name: "BIS_fnc_moduleFriendlyFire"
type: function
status: ok
groups: ["Modules"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_moduleFriendlyFire
revid: 349534
updated: 2023-11-08T17:16:42Z
---

# BIS_fnc_moduleFriendlyFire

*Function · Modules · Arma 3 v1.00*

## Description

Handles the friendly fire. Use either the module interface in the editor, or call individual functions.

## Syntax

*syntax inferred from the function header*

```sqf
[param1, param2] call BIS_fnc_moduleFriendlyFire
```

**Parameters:**

- `param1` — 1: function called - string, list of functions:
  - Init
  - Destroy
  - AddUnits
  - RemoveUnits
  - ChangePriority
  - ListActiveUnit
- `param2` — 2: parameter for the function

**Returns:** depends on the function called

## Examples

### Example 1

```sqf
// Initializes the module if not added in editor
// No units are directly checked for friendly fire, but renegade state is checked anyway
_ret = ["Init", []] call BIS_fnc_moduleFriendlyFire
```

### Example 2

```sqf
// Initializes the module if not added in editor
// BIS_vip1, BIS_vip2, BIS_noVip units are directly checked for friendly fire
x = ["Init", [[BIS_vip1, BIS_vip2, BIS_noVip],true]] call BIS_fnc_moduleFriendlyFire
```

### Example 3

```sqf
// De-initializes the module
_ret = ["Destroy"] call BIS_fnc_moduleFriendlyFire
```

### Example 4

```sqf
// Add BIS_vip3 unit to be checked for friendly fire
x = ["AddUnits", [[BIS_vip3]]] call BIS_fnc_moduleFriendlyFire
```

### Example 5

```sqf
// Remove BIS_vip1 unit from active units
x = ["RemoveUnits", [[BIS_vip1]]] call BIS_fnc_moduleFriendlyFire
```

### Example 6

```sqf
// set another priority for a vehicle- if it is hit once, considered as friendly fire
x = ["ChangePriority",  [BIS_vip,1]] call BIS_fnc_moduleFriendlyFire
```

## Function header

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

```sqf
/*
Version:            2.0
Name:                Friendly Fire
Author:                Zozo
DESCRIPTION:    Handles the friendly fire. Use either the module interface in the editor, or call individual functions.
PARAMETERS:        1) function called - string, list of functions:
            - Init
            - Destroy
            - AddUnits
            - RemoveUnits
            - ChangePriority
            - ListActiveUnit
            2) parameter for the function
RETURNED VALUE:    depends on the function called
    EXAMPLES:
            // Initializes the module if not added in editor
            // No units are directly checked for friendly fire, but renegade state is checked anyway
            _ret = ["Init", []] call BIS_fnc_moduleFriendlyFire

            // Initializes the module if not added in editor
            // BIS_vip1, BIS_vip2, BIS_noVip units are directly checked for friendly fire
            x = ["Init", [[BIS_vip1, BIS_vip2, BIS_noVip],true]] call BIS_fnc_moduleFriendlyFire

            // De-initializes the module
            _ret = ["Destroy"] call BIS_fnc_moduleFriendlyFire

            // Add BIS_vip3 unit to be checked for friendly fire
            x = ["AddUnits", [[BIS_vip3]]] call BIS_fnc_moduleFriendlyFire

            // Remove BIS_vip1 unit from active units
            x = ["RemoveUnits", [[BIS_vip1]]] call BIS_fnc_moduleFriendlyFire

            // set another priority for a vehicle- if it is hit once, considered as friendly fire
            x = ["ChangePriority",  [BIS_vip,1]] call BIS_fnc_moduleFriendlyFire
*/
```

<sub>Source: [BI Community Wiki — BIS fnc moduleFriendlyFire](https://community.bistudio.com/wiki/BIS_fnc_moduleFriendlyFire) (revision 349534).</sub>