---
title: "MoveObject | open.mp"
description: "Move an object to a new position with a set speed."
canonical: https://omp.itsneufox.com/docs/scripting/functions/MoveObject
language: en
---

# MoveObject

## Description

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

| Name | Description |
| --- | --- |
| objectid | The ID of the object to move. |
| Float:targetX | The X coordinate to move the object to. |
| Float:targetY | The Y coordinate to move the object to. |
| Float:targetZ | The Z coordinate to move the object to. |
| Float:speed | The speed at which to move the object (units per second). |
| Float:rotationX | The FINAL X rotation (optional). |
| Float:rotationY | The FINAL Y rotation (optional). |
| Float:rotationZ | The FINAL Z rotation (optional). |

## Returns

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

## Examples

```c
new gAirportGate; // Somewhere at the top of your script

public OnGameModeInit()
{
    gAirportGate = 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[64],
            moveTime = MoveObject(gAirportGate, 0.0, 0.0, 10.0, 2.00);

        format(string, sizeof(string), "Object will finish moving in %d milliseconds", moveTime);
        SendClientMessage(playerid, 0xFF0000FF, string);
        return 1;
    }
    return 0;
}
```

## Notes

warning

-   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 rotate the object.

## Related Functions

-   [CreateObject](https://omp.itsneufox.com/docs/scripting/functions/CreateObject): Create an object.
-   [DestroyObject](https://omp.itsneufox.com/docs/scripting/functions/DestroyObject): Destroy an object.
-   [IsValidObject](https://omp.itsneufox.com/docs/scripting/functions/IsValidObject): Checks if a certain object is vaild.
-   [IsObjectMoving](https://omp.itsneufox.com/docs/scripting/functions/IsObjectMoving): Check if the object is moving.
-   [StopObject](https://omp.itsneufox.com/docs/scripting/functions/StopObject): Stop an object from moving.
-   [SetObjectPos](https://omp.itsneufox.com/docs/scripting/functions/SetObjectPos): Set the position of an object.
-   [SetObjectRot](https://omp.itsneufox.com/docs/scripting/functions/SetObjectRot): Set the rotation of an object.
-   [GetObjectPos](https://omp.itsneufox.com/docs/scripting/functions/GetObjectPos): Locate an object.
-   [GetObjectRot](https://omp.itsneufox.com/docs/scripting/functions/GetObjectRot): Check the rotation of an object.
-   [AttachObjectToPlayer](https://omp.itsneufox.com/docs/scripting/functions/AttachObjectToPlayer): Attach an object to a player.
-   [CreatePlayerObject](https://omp.itsneufox.com/docs/scripting/functions/CreatePlayerObject): Create an object for only one player.
-   [DestroyPlayerObject](https://omp.itsneufox.com/docs/scripting/functions/DestroyPlayerObject): Destroy a player object.
-   [IsValidPlayerObject](https://omp.itsneufox.com/docs/scripting/functions/IsValidPlayerObject): Checks if a certain player object is vaild.
-   [MovePlayerObject](https://omp.itsneufox.com/docs/scripting/functions/MovePlayerObject): Move a player object.
-   [StopPlayerObject](https://omp.itsneufox.com/docs/scripting/functions/StopPlayerObject): Stop a player object from moving.
-   [IsPlayerObjectMoving](https://omp.itsneufox.com/docs/scripting/functions/IsPlayerObjectMoving): Check if the player object is moving.
-   [SetPlayerObjectPos](https://omp.itsneufox.com/docs/scripting/functions/SetPlayerObjectPos): Set the position of a player object.
-   [SetPlayerObjectRot](https://omp.itsneufox.com/docs/scripting/functions/SetPlayerObjectRot): Set the rotation of a player object.
-   [GetPlayerObjectPos](https://omp.itsneufox.com/docs/scripting/functions/GetPlayerObjectPos): Locate a player object.
-   [GetPlayerObjectRot](https://omp.itsneufox.com/docs/scripting/functions/GetPlayerObjectRot): Check the rotation of a player object.
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/docs/scripting/functions/AttachPlayerObjectToPlayer): Attach a player object to a player.

## Related Callbacks

-   [OnObjectMoved](https://omp.itsneufox.com/docs/scripting/callbacks/OnObjectMoved): Called when an object stops moving.