From SA-MP Wiki

Jump to: navigation, search

CreateActor 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!


Create a static 'actor' in the world. These 'actors' are like NPCs, however they have limited functionality. They do not take up server player slots.

(modelid, Float:X, Float:Y, Float:Z, Float:Rotation)
modelidThe model ID (skin ID) the actor should have.
xThe X coordinate to create the actor at.
yThe Y coordinate to create the actor at.
zThe Z coordinate to create the actor at.
RotationThe facing angle (rotation) for the actor to have.

Return Values:

  • The created Actor ID (start at 0).
  • INVALID_ACTOR_ID (65535) If the actor limit (1000) is reached.



  • Actors are completely separate from NPCs. They do NOT use player IDs/slots on the server and CANNOT be handled like NPCs.
  • Actors are limited to 1000 (MAX_ACTORS).
  • Actors can be pushed by vehicles, use a timer to put them back at their positions.
  • As of 0.3.7 R2 actors default to being invulnerable.



Actors are designed to just stand somewhere, for example cashiers and bartenders. They can perform animations (once or looping) using ApplyActorAnimation.

Example Usage:

new ActorCJ;
public OnGameModeInit()
    // Create an actor (CJ) at Blueberry Acres (Center of SA map)
    ActorCJ = CreateActor(0, 0.0, 0.0, 3.0, 0.0);

Related Functions

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

Related Callbacks

The following callbacks might be useful, as they're related to this function in one way or another.

Personal tools
In other languages