animationState

Global argument
Arma 3 v0.50
First in Armed Assault v1.00

Command · Markdown · JSON · original wiki page

Description

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

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

animationState unitName

Parameters:

unitName: Object

Returns: String

Examples

Example 1

_state = animationState 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.

Community notes

POLPOX

2019-08-13

In case you need to get the animation name including upper cases:

configName (configFile >> getText (configFile >> "CfgVehicles" >> typeOf _unit >> "moves") >> "States" >> (animationState _unit)) // e.g. "AmovPercMstpSrasWrflDnon"

Opposite to regular animationState return value:

animationState _unit // e.g. "amovpercmstpsraswrfldnon"