---
title: "AttachPlayerObjectToObject | open.mp"
description: "می‌توانید از این تابع برای اتصال player-objectها به سایر player-objectها استفاده کنید."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/AttachPlayerObjectToObject
language: fa
---

# AttachPlayerObjectToObject

هشدار

This function was added in omp v1.1.0.2612 and will not work in earlier versions!

## توضیحات

می‌توانید از این تابع برای اتصال player-objectها به سایر player-objectها استفاده کنید. اشیاء متصل شده شیء اصلی را دنبال خواهند کرد.

| نام | توضیحات |
| --- | --- |
| playerid | ID بازیکن. |
| objectid | player-object که به player-object دیگری متصل می‌شود. |
| parentid | شیئی که شیء به آن متصل می‌شود. |
| Float:OffsetX | فاصله بین شیء اصلی و شیء در جهت X. |
| Float:OffsetY | فاصله بین شیء اصلی و شیء در جهت Y. |
| Float:OffsetZ | فاصله بین شیء اصلی و شیء در جهت Z. |
| Float:RotX | چرخش X بین شیء و شیء اصلی. |
| Float:RotY | چرخش Y بین شیء و شیء اصلی. |
| Float:RotZ | چرخش Z بین شیء و شیء اصلی. |
| bool:syncRotation | اگر روی `false` تنظیم شود، چرخش objectid با parentid تغییر نخواهد کرد. |

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

`true` - تابع با موفقیت اجرا شد.

`false` - تابع در اجرا ناکام بود. این یعنی شیء اول (objectid) وجود ندارد. هیچ بررسی داخلی برای تأیید وجود شیء دوم (parentid) انجام نمی‌شود.

## مثال‌ها

```c
new objectid = CreatePlayerObject(...);
new parentid = CreatePlayerObject(...);

AttachPlayerObjectToObject(playerid, objectid, parentid, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, true);
```

## نکات

یادداشت

هر دو شیء باید قبل از تلاش برای اتصال آن‌ها ایجاد شوند.

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

-   [AttachObjectToObject](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachObjectToObject): اتصال یک شیء به شیء دیگر.
-   [AttachObjectToPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachObjectToPlayer): اتصال یک شیء به بازیکن.
-   [AttachObjectToVehicle](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachObjectToVehicle): اتصال یک شیء به وسیله نقلیه.
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/AttachPlayerObjectToPlayer): اتصال یک شیء بازیکن به بازیکن.
-   [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): متوقف کردن حرکت یک شیء بازیکن.
-   [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): بررسی چرخش یک شیء بازیکن.