---
title: "MoveObject | open.mp"
description: "آبجکت را با سرعت تعیین شده به موقعیت جدید منتقل کن."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/MoveObject
language: fa
---

# MoveObject

## توضیحات

آبجکت را با سرعت تعیین شده به موقعیت جدید منتقل می‌کند. بازیکنان/وسایل نقلیه روی آبجکت "surf" خواهند کرد تا زمانی که حرکت می‌کند.

| نام | توضیحات |
| --- | --- |
| objectid | ID آبجکتی که باید منتقل شود. |
| Float:targetX | مختصات X برای انتقال آبجکت. |
| Float:targetY | مختصات Y برای انتقال آبجکت. |
| Float:targetZ | مختصات Z برای انتقال آبجکت. |
| Float:speed | سرعت انتقال آبجکت (واحد در ثانیه). |
| Float:rotationX | چرخش نهایی X (اختیاری). |
| Float:rotationY | چرخش نهایی Y (اختیاری). |
| Float:rotationZ | چرخش نهایی Z (اختیاری). |

## مقدار بازگشتی

زمانی که برای انتقال آبجکت نیاز است به میلی‌ثانیه.

## مثال‌ها

```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;
}
```

## نکات

هشدار

-   این تابع می‌تواند برای چرخاندن نرم آبجکت‌ها استفاده شود. اما برای این کار، آبجکت باید **منتقل** هم بشود. چرخش مشخص شده، چرخشی است که آبجکت پس از انتقال خواهد داشت. بنابراین آبجکت هنگامی که انتقالی اعمال نشود، نخواهد چرخید. برای نمونه اسکریپت به ferriswheel.pwn filterscript ساخته شده توسط Kye که در بسته سرور (SA-MP 0.3d و بالاتر) گنجانده شده نگاه کنید.
-   برای درک کامل نکته بالا، می‌توانی (اما محدود نیستی به) موقعیت z را (+0.001) افزایش دهی و سپس (-0.001) پس از انتقال مجدد آن، زیرا عدم تغییر X،Y یا Z آبجکت را نخواهد چرخاند.

## توابع مرتبط

-   [CreateObject](https://omp.itsneufox.com/fa/docs/scripting/functions/CreateObject): آبجکت بساز.
-   [DestroyObject](https://omp.itsneufox.com/fa/docs/scripting/functions/DestroyObject): آبجکت را نابود کن.
-   [IsValidObject](https://omp.itsneufox.com/fa/docs/scripting/functions/IsValidObject): بررسی کن که آیا آبجکت خاصی معتبر است.
-   [IsObjectMoving](https://omp.itsneufox.com/fa/docs/scripting/functions/IsObjectMoving): بررسی کن که آیا آبجکت در حال حرکت است.
-   [StopObject](https://omp.itsneufox.com/fa/docs/scripting/functions/StopObject): آبجکت را از حرکت متوقف کن.
-   [SetObjectPos](https://omp.itsneufox.com/fa/docs/scripting/functions/SetObjectPos): موقعیت آبجکت را تنظیم کن.
-   [SetObjectRot](https://omp.itsneufox.com/fa/docs/scripting/functions/SetObjectRot): چرخش آبجکت را تنظیم کن.
-   [GetObjectPos](https://omp.itsneufox.com/fa/docs/scripting/functions/GetObjectPos): آبجکت را پیدا کن.
-   [GetObjectRot](https://omp.itsneufox.com/fa/docs/scripting/functions/GetObjectRot): چرخش آبجکت را بررسی کن.
-   [AttachObjectToPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachObjectToPlayer): آبجکت را به بازیکن متصل کن.
-   [CreatePlayerObject](https://omp.itsneufox.com/fa/docs/scripting/functions/CreatePlayerObject): آبجکت فقط برای یک بازیکن بساز.
-   [DestroyPlayerObject](https://omp.itsneufox.com/fa/docs/scripting/functions/DestroyPlayerObject): آبجکت بازیکن را نابود کن.
-   [IsValidPlayerObject](https://omp.itsneufox.com/fa/docs/scripting/functions/IsValidPlayerObject): بررسی کن که آیا آبجکت بازیکن خاصی معتبر است.
-   [MovePlayerObject](https://omp.itsneufox.com/fa/docs/scripting/functions/MovePlayerObject): آبجکت بازیکن را منتقل کن.
-   [StopPlayerObject](https://omp.itsneufox.com/fa/docs/scripting/functions/StopPlayerObject): آبجکت بازیکن را از حرکت متوقف کن.
-   [IsPlayerObjectMoving](https://omp.itsneufox.com/fa/docs/scripting/functions/IsPlayerObjectMoving): بررسی کن که آیا آبجکت بازیکن در حال حرکت است.
-   [SetPlayerObjectPos](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerObjectPos): موقعیت آبجکت بازیکن را تنظیم کن.
-   [SetPlayerObjectRot](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerObjectRot): چرخش آبجکت بازیکن را تنظیم کن.
-   [GetPlayerObjectPos](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerObjectPos): آبجکت بازیکن را پیدا کن.
-   [GetPlayerObjectRot](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerObjectRot): چرخش آبجکت بازیکن را بررسی کن.
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachPlayerObjectToPlayer): آبجکت بازیکن را به بازیکن متصل کن.

## کالبک‌های مرتبط

-   [OnObjectMoved](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnObjectMoved): زمانی فراخوانی می‌شود که یک شیء حرکت خود را متوقف کند.