{"name":"getUnitMovesInfo","operator":null,"title":"getUnitMovesInfo","type":"command","url":"https://community.bistudio.com/wiki/getUnitMovesInfo","revid":378281,"updated":"2026-03-31T10:06:54Z","groups":["Animations"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.18"}],"since":{"game":"arma3","name":"Arma 3","version":"2.18"},"arma3_since":"2.18","branch":null,"locality":{"argument":"global","effect":null,"server_exec":false},"exec":null,"description":"Returns various information about the unit moves (primary animation) and gestures (masked animation)\n\n> [!NOTE]\n> 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.","syntaxes":[{"syntax":"getUnitMovesInfo unit","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unit: Object"}],"returns":{"type":"Array format:","types":["Array"],"description":"0 - moveProgress: Number - move progress in range 0-1 - 1 - moveTime: Number - move elapsed time (`move progress * move duration`) - 2 - moveDuration: Number - move duration in seconds - 3 - moveFactor: Number - move blend factor - 4 - rtmStep: Vector3D - rtm step (how many meters the unit will move after finishing the animation) - 5 - gestureProgress: Number - gesture progress in range 0-1 - 6 - gestureTime: Number - gesture elapsed time (`gesture progress * gesture duration`) - 7 - gestureDuration: Number - gesture duration in seconds - 8 - gestureFactor: Number - gesture blend factor","text":"Array format:\n- 0 - moveProgress: Number - move progress in range 0-1\n- 1 - moveTime: Number - move elapsed time (`move progress * move duration`)\n- 2 - moveDuration: Number - move duration in seconds\n- 3 - moveFactor: Number - move blend factor\n- 4 - rtmStep: Vector3D - rtm step (how many meters the unit will move after finishing the animation)\n- 5 - gestureProgress: Number - gesture progress in range 0-1\n- 6 - gestureTime: Number - gesture elapsed time (`gesture progress * gesture duration`)\n- 7 - gestureDuration: Number - gesture duration in seconds\n- 8 - gestureFactor: Number - gesture blend factor"},"form":"unary","operator":null,"left":null,"right":{"text":"unit","types":["Object"]}},{"syntax":"unit getUnitMovesInfo index","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unit: Object"},{"name":"index","type":"Number","optional":false,"default":null,"description":"index of property from the main syntax","types":["Number"],"since":null,"text":"index: Number - index of property from the main syntax"}],"returns":{"type":"Anything","types":["Anything"],"description":"Value of the requested property, or Nothing if index is invalid. See the main syntax.","text":"Anything - Value of the requested property, or Nothing if index is invalid. See the main syntax."},"form":"binary","operator":null,"left":{"text":"unit","types":["Object"]},"right":{"text":"index","types":["Number"]}}],"examples":[{"text":"```sqf\n// Getting the move velocity of the animation\nprivate _animInfo = getUnitMovesInfo player;\n// velocity = displacement / time\nprivate _animVelocity = _animInfo # 4 vectorMultiply -1 / _animInfo # 2;    // -1 is because man model is reversed\n                                                                            // so the rtm animation moves \"backwards\"\n```","code":["// Getting the move velocity of the animation\nprivate _animInfo = getUnitMovesInfo player;\n// velocity = displacement / time\nprivate _animVelocity = _animInfo # 4 vectorMultiply -1 / _animInfo # 2;\t// -1 is because man model is reversed\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t// so the rtm animation moves \"backwards\""]},{"text":"```sqf\ngetUnitMovesInfo player params [\n    \"_moveProgress\",\n    \"_moveTime\",\n    \"_moveDuration\",\n    \"_moveFactor\",\n    \"_rtmStep\",\n    \"_gestureProgress\",\n    \"_gestureTime\",\n    \"_gestureDuration\",\n    \"_gestureFactor\"\n];\n```","code":["getUnitMovesInfo player params [\n\t\"_moveProgress\",\n\t\"_moveTime\",\n\t\"_moveDuration\",\n\t\"_moveFactor\",\n\t\"_rtmStep\",\n\t\"_gestureProgress\",\n\t\"_gestureTime\",\n\t\"_gestureDuration\",\n\t\"_gestureFactor\"\n];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["switchMove","switchGesture","moveTime","gestureState","animationState"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Animations","Introduced with Arma 3 version 2.18","Scripting Commands"]}