AttachObjectToObject

warning

This function was added in SA-MP 0.3d and will not work in earlier versions!

Description

You can use this function to attach objects to other objects. The objects will folow the main object.

NameDescription
objectidThe object to attach to another object.
attachtoidThe object to attach the object to.
Float:OffsetXThe distance between the main object and the object in the X direction.
Float:OffsetYThe distance between the main object and the object in the Y direction.
Float:OffsetZThe distance between the main object and the object in the Z direction.
Float:RotXThe X rotation between the object and the main object.
Float:RotYThe Y rotation between the object and the main object.
Float:RotZThe Z rotation between the object and the main object.
SyncRotationIf set to 0, objectid's rotation will not change with attachtoid's.

Returns

1: The function executed successfully.

0: 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 (attachtoid) exists.

Examples

new gObjectId = CreateObject(...);
new gAttachToId = CreateObject(...);
AttachObjectToObject(gObjectId, gAttachToId, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1);

Notes

tip

Both objects need to be created before attempting to attach them. There is no player-object version of this function (AttachPlayerObjectToObject), meaning it will not be supported by streamers.

Related Functions