{"name":"animationPhase","title":"animationPhase","type":"command","url":"https://community.bistudio.com/wiki/animationPhase","revid":379102,"updated":"2026-10-03T12:06:54Z","groups":["Animations"],"status":"ok","games":{"ofp":"1.75","ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofp 1.75","arma3_since":"0.50","locality":{"argument":"global"},"description":"Returns the phase of the given animation on the given object. Animation can be scripted (animate, animateSource, animateDoor) or engine driven. Animation names for an object could be found out with animationNames command. When animation is rotation, like with \"MainTurret\" for example, the output is in radians, to convert to degrees use deg command.\n\n> [!NOTE]\n> Since Arma 3 v2.24 parachutes are supported. The phases for a parachute animation are: 0...1 - pulling of the parachute from the bag, 1...2 - opening of the canopy, 2...3 packing of the canopy. The animation name is \"\".\n>\n> ```sqf\n> _para animationPhase \"\"; // current animation phase\n> ```\n>\n> See also animate","syntaxes":[{"syntax":"object animationPhase animationName","params":[{"name":"object","type":"Object","type_expr":"Object"},{"name":"animationName","type":"String","description":"name of the animation. This is the class-name of the animation defined in the addon's config.cpp","type_expr":"String"}],"returns":{"type":"Number in range 0..1","type_expr":"Number","description":"where 0 is the start point of the animation and 0 is the end point"},"form":"binary","left":{"text":"object"},"right":{"text":"animationName"}}],"examples":[{"code":["_building animate [\"maindoor\",1];\nsleep 1;\n_p = _building animationPhase \"maindoor\";// Returns 1, if the animation speed is two seconds"]},{"code":["_flagPole animationPhase \"flag\";"]},{"code":["_tank animationPhase \"MainTurret\";"]}],"multiplayer":"In Operation Flashpoint, on dedicated servers, *animationPhase* will always return 0, no matter what the actual phase is.","see_also":["animate","moveTime","setFaceAnimation","animateDoor","doorPhase","animateSource","animationSourcePhase","animationNames"]}