---
name: "getUnitMovesInfo"
type: command
status: ok
groups: ["Animations"]
arma3_since: "2.18"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getUnitMovesInfo
revid: 378281
updated: 2026-03-31T10:06:54Z
---

# getUnitMovesInfo

*Command · Animations · Arma 3 v2.18*

Locality: arguments **global**

## Description

Returns various information about the unit moves (primary animation) and gestures (masked animation)

> [!NOTE]
> Up until Arma 3 v2.20 this command only worked for a man unit, and other units such as animals couldn't use this command. As of Arma 3 v2.22 animals are supported as well.

## Syntax

### Syntax 1

```sqf
getUnitMovesInfo unit
```

**Parameters:**

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

**Returns:** [Array](../topics/Array.md) format:
- 0 - moveProgress: [Number](../topics/Number.md) - move progress in range 0-1
- 1 - moveTime: [Number](../topics/Number.md) - move elapsed time (`move progress * move duration`)
- 2 - moveDuration: [Number](../topics/Number.md) - move duration in seconds
- 3 - moveFactor: [Number](../topics/Number.md) - move blend factor
- 4 - rtmStep: [Vector3D](../topics/Vector3D.md) - rtm step (how many meters the unit will move after finishing the animation)
- 5 - gestureProgress: [Number](../topics/Number.md) - gesture progress in range 0-1
- 6 - gestureTime: [Number](../topics/Number.md) - gesture elapsed time (`gesture progress * gesture duration`)
- 7 - gestureDuration: [Number](../topics/Number.md) - gesture duration in seconds
- 8 - gestureFactor: [Number](../topics/Number.md) - gesture blend factor

### Syntax 2

```sqf
unit getUnitMovesInfo index
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `index`: [Number](../topics/Number.md) - index of property from the main syntax

**Returns:** [Anything](../topics/Anything.md) - Value of the requested property, or [Nothing](../topics/Nothing.md) if index is invalid. See the main syntax.

## Examples

### Example 1

```sqf
// Getting the move velocity of the animation
private _animInfo = getUnitMovesInfo player;
// velocity = displacement / time
private _animVelocity = _animInfo # 4 vectorMultiply -1 / _animInfo # 2;    // -1 is because man model is reversed
                                                                            // so the rtm animation moves "backwards"
```

### Example 2

```sqf
getUnitMovesInfo player params [
    "_moveProgress",
    "_moveTime",
    "_moveDuration",
    "_moveFactor",
    "_rtmStep",
    "_gestureProgress",
    "_gestureTime",
    "_gestureDuration",
    "_gestureFactor"
];
```

## See also

[switchMove](../commands/switchMove.md) · [switchGesture](../commands/switchGesture.md) · [moveTime](../commands/moveTime.md) · [gestureState](../commands/gestureState.md) · [animationState](../commands/animationState.md)

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