---
name: "setUnitAbility"
type: command
status: ok
groups: ["AI Behaviour"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setUnitAbility
revid: 379387
updated: 2026-10-30T23:59:44Z
---

# setUnitAbility

*Command · AI Behaviour · Arma 3 v0.50 · introduced in Operation Flashpoint: Elite v1.00*

## Description

Sets skill of given unit. Unlike [setSkill](../commands/setSkill.md), [setUnitAbility](../commands/setUnitAbility.md) can set values > 1. Even though the [skill](../commands/skill.md) command will correctly return set value, the actual unit ability will be capped to max available.

## Syntax

```sqf
unit setUnitAbility value
```

**Parameters:**

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

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

## Examples

### Example 1

```sqf
_unit setUnitAbility 1;
```

### Example 2

```sqf
bob setUnitAbility -log 0;
hint str skill bob; //1.#INF
```

## See also

[skill](../commands/skill.md) · [setSkill](../commands/setSkill.md) · [CfgAISkill](../topics/AI_Skill.md) · [Combat Modes](../topics/Combat_Modes.md)

## Community notes

**Dwarden** — 2014-10-08

AFAIK not used in Arma 3 anymore (or equals to setSkill)

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