---
name: "getSuppression"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.42"
locality: {"argument": "local", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getSuppression
revid: 320943
updated: 2022-05-13T10:04:43Z
---

# getSuppression

*Command · Object Manipulation · Arma 3 v1.42*

Locality: arguments **local**

## Description

Gets the suppression value for the given unit. Returns varying [Number](../topics/Number.md) between 0 and 1, or -1 if suppression is disabled (`disableAI "SUPPRESSION"`) or the suppression value is not available. Suppression is not calculated for player entities and is always 0, unless it is set with [setSuppression](../commands/setSuppression.md). In this case the return value is the set value. Before Arma 3 v1.92 this command could return [nil](../commands/nil.md).

> [!IMPORTANT]
> The unit must not be [objNull](../commands/objNull.md), must be [local](../topics/Multiplayer_Scripting.md#locality) and [alive](../commands/alive.md)

## Syntax

```sqf
getSuppression unit
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)

**Returns:** [Number](../topics/Number.md) - from 0 to 1, or -1 if suppression is not available.

## Examples

### Example 1

```sqf
getSuppression AI_unit_1;
```

## See also

[setSuppression](../commands/setSuppression.md) · [suppressFor](../commands/suppressFor.md) · [disableAI](../commands/disableAI.md) · [enableAI](../commands/enableAI.md)

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