---
name: "incapacitatedState"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/incapacitatedState
revid: 379354
updated: 2026-10-30T23:55:22Z
---

# incapacitatedState

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

## Description

Returns the incapacitated sub-state of the given unit, when the [lifeState](../commands/lifeState.md) of the unit is "INCAPACITATED". Could be one of:

- "UNCONSCIOUS"
- "MOVING"
- "SHOOTING"

## Syntax

```sqf
incapacitatedState person
```

**Parameters:**

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

**Returns:** [String](../topics/String.md) - incapacitated sub-state (see description) or empty string ""

## Examples

### Example 1

```sqf
_result = incapacitatedState player;
```

## See also

[setUnconscious](../commands/setUnconscious.md) · [lifeState](../commands/lifeState.md)

## Community notes

**HazJ** — 2018-07-18

This command returns "SHOOTING" (intentional behaviour?) when checking a unit's state while they are unconscious. Tested with BIS revive. I recommend just using the lifeState command instead.

---

**Tankbuster** — 2019-12-29

Returns
"UNCONSCIOUS" when awaiting revive.
"" when alive or when awaiting respawn. This means that when a unit dies instantly, ie through drowning, this command will return empty string throughout. As Haz says above, it sometimes show "SHOOTING" when the player is unconscious for reasons that are not clear.

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