QueueUnitAnimation

Parameters

whichUnit	unit
whichAnimation	string	animation name, case-insensitive

comment

Start new animation after the currently active animation finishes.

Allows for a smooth transition (where possible) unlike SetUnitAnimation.

The start/end behavior (like forced restart or transition to a different animation at the end) depends on the animation itself.

note

Example (Lua, 2.0.3):

-- Play goblin merchant's forgotten slide animation once
-- then return to regular "Stand" (idle) animation
u_ngme = CreateUnit(Player(0), FourCC("ngme"), 0, 0, -80)
QueueUnitAnimation(u_ngme, "Stand Work")
QueueUnitAnimation(u_ngme, "Stand")

note

See: SetUnitAnimation, SetUnitAnimationByIndex, SetUnitAnimationWithRarity, AddUnitAnimationProperties

patch

1.00

Source

common.j (suggest an edit or discuss on Github)

return type

nothing

Source code

native          QueueUnitAnimation          takes unit whichUnit, string whichAnimation returns nothing