---
name: "gestureState"
type: command
status: ok
groups: ["Animations"]
arma3_since: "2.06"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/gestureState
revid: 352842
updated: 2024-02-26T11:36:18Z
---

# gestureState

*Command · Animations · Arma 3 v2.06*

Locality: arguments **global**

## Description

Returns the name of a unit's current gesture. Seems to be forced to lower case in Arma 3.

> [!NOTE]
> This command is only for a man unit, other units such as animals cannot use this command.

## Syntax

```sqf
gestureState unitName
```

**Parameters:**

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

**Returns:** [String](../topics/String.md) - empty string if not available

## Examples

### Example 1

```sqf
private _state = gestureState player;
```

## Multiplayer

When executed on a client, this command only returns accurate results when the target unit is within sight of the client. When executed on a dedicated server, the returned value is accurate.

## See also

[switchAction](../commands/switchAction.md) · [playAction](../commands/playAction.md) · [BIS_fnc_ambientAnimGetParams](../functions/BIS_fnc_ambientAnimGetParams.md) · [animationState](../commands/animationState.md) · [getUnitMovesInfo](../commands/getUnitMovesInfo.md)

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