---
title: "AttachPlayerObjectToObject | open.mp"
description: "You can use this function to attach player-objects to other player-objects."
canonical: https://omp.itsneufox.com/docs/scripting/functions/AttachPlayerObjectToObject
language: en
---

# AttachPlayerObjectToObject

warning

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

## Description

You can use this function to attach player-objects to other player-objects. The objects will follow the main object.

| Name | Description |
| --- | --- |
| playerid | The ID of the player. |
| objectid | The player-object to attach to another player-object. |
| parentid | The object to attach the object to. |
| Float:OffsetX | The distance between the main object and the object in the X direction. |
| Float:OffsetY | The distance between the main object and the object in the Y direction. |
| Float:OffsetZ | The distance between the main object and the object in the Z direction. |
| Float:RotX | The X rotation between the object and the main object. |
| Float:RotY | The Y rotation between the object and the main object. |
| Float:RotZ | The Z rotation between the object and the main object. |
| bool:syncRotation | If set to `false`, objectid's rotation will not change with parentid's. |

## Returns

`true` - The function executed successfully.

`false` - The function failed to execute. This means the first object (objectid) does not exist. There are no internal checks to verify that the second object (parentid) exists.

## Examples

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

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

## Notes

note

Both objects need to be created before attempting to attach them.

## Related Functions

-   [AttachObjectToObject](https://omp.itsneufox.com/docs/scripting/functions/AttachObjectToObject): Attach an object to other object.
-   [AttachObjectToPlayer](https://omp.itsneufox.com/docs/scripting/functions/AttachObjectToPlayer): Attach an object to a player.
-   [AttachObjectToVehicle](https://omp.itsneufox.com/docs/scripting/functions/AttachObjectToVehicle): Attach an object to a vehicle.
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/docs/scripting/functions/AttachPlayerObjectToPlayer): Attach a player 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.
-   [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.