From SA-MP Wiki

Jump to: navigation, search

ApplyActorAnimation was added in SA-MP 0.3.7 This function was added in SA-MP 0.3.7 and will not work in earlier versions!


Apply an animation to an actor.

(actorid, animlib[], animname[], Float:fDelta, loop, lockx, locky, freeze, time)
actoridThe ID of the actor to apply the animation to.
animlib[]The animation library from which to apply an animation.
animname[]The name of the animation to apply, within the specified library.
fDeltaThe speed to play the animation (use 4.1).
loopIf set to 1, the animation will loop. If set to 0, the animation will play once.
lockxIf set to 0, the actor is returned to their old X coordinate once the animation is complete (for animations that move the actor such as walking). 1 will not return them to their old position.
lockySame as above but for the Y axis. Should be kept the same as the previous parameter.
freezeSetting this to 1 will freeze an actor at the end of the animation. 0 will not.
timeTimer in milliseconds. For a never-ending loop it should be 0.

Return Values:

  • 1: The function executed successfully.
  • 0: The function failed to execute. The actor specified does not exist.



You must preload the animation library for the player the actor will be applying the animation for, and not for the actor. Otherwise, the animation won't be applied to the actor until the function is executed again.

Example Usage:

new MyActor;
public OnGameModeInit()
    MyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // Actor as salesperson in Ammunation
    ApplyActorAnimation(MyActor, "DEALER", "shop_pay", 4.1, 0, 0, 0, 0, 0); // Pay anim
    return 1;

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

Personal tools
In other languages