From SA-MP Wiki

Jump to: navigation, search


Move an object to a new position with a set speed. Players/vehicles will 'surf' the object as it moves.

(objectid, Float:X, Float:Y, Float:Z, Float:Speed, Float:RotX = -1000.0, Float:RotY = -1000.0, Float:RotZ = -1000.0)
objectidThe ID of the object to move.
Float:XThe X coordinate to move the object to.
Float:YThe Y coordinate to move the object to.
Float:ZThe Z coordinate to move the object to.
Float:SpeedThe speed at which to move the object (units per second).
Float:RotXThe FINAL X rotation (optional).
Float:RotYThe FINAL Y rotation (optional).
Float:RotZThe FINAL Z rotation (optional).

Return Values:

The time it will take for the object to move in milliseconds.



  • This function can be used to make objects rotate smoothly. In order to achieve this however, the object must also be moved. The specified rotation is the rotation the object will have after the movement. Hence the object will not rotate when no movement is applied. For a script example take a look at the ferriswheel.pwn filterscript made by Kye included in the server package (SA-MP 0.3d and above).
  • To fully understand the above note, you can (but not limited to) increase the z position by (+0.001) and then (-0.001) after moving it again, as not changing the X,Y or Z will not move the object.

Example Usage:

new obj; // Somewhere at the top of your script
public OnGameModeInit()
    obj = CreateObject(980, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
    return 1;
public OnPlayerCommandText(playerid, cmdtext[])
    if(strcmp(cmdtext, "/moveobject", true) == 0)
        new string[50];
        new movetime = MoveObject(obj, 0, 0, 10, 2.00);
        format(string, sizeof(string), "Object will finish moving in %d milliseconds", movetime);
        SendClientMessage(playerid, 0xFF000000, string);
        return 1;
    return 0;

Related Callbacks

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

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