SetPlayerAttachedObject

warning

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

Description

Attach an object to a specific bone on a player.

NameDescription
playeridThe ID of the player to attach the object to.
indexThe index (slot) to assign the object to (0-9 since 0.3d, 0-4 in previous versions).
modelidThe model to attach.
boneThe bone to attach the object to.
fOffsetX(optional) X axis offset for the object position.
fOffsetY(optional) Y axis offset for the object position.
fOffsetZ(optional) Z axis offset for the object position.
fRotX(optional) X axis rotation of the object.
fRotY(optional) Y axis rotation of the object.
fRotZ(optional) Z axis rotation of the object.
fScaleX(optional) X axis scale of the object.
fScaleY(optional) Y axis scale of the object.
fScaleZ(optional) Z axis scale of the object.
materialcolor1(optional) The first object color to set, as an integer or hex in ARGB color format.
materialcolor2(optional) The second object color to set, as an integer or hex in ARGB color format

Returns

1 on success, 0 on failure.

Examples

public OnPlayerSpawn(playerid)
{
SetPlayerAttachedObject(playerid, 3, 1609, 2); //Attach a turtle to the playerid's head, in slot 3
// example of using colors on an object being attached to the player:
SetPlayerAttachedObject(playerid, 3, 19487, 2, 0.101, -0.0, 0.0, 5.50, 84.60, 83.7, 1.0, 1.0, 1.0, 0xFF00FF00);
// Attach a white hat to the head of the player and paint it green
return 1;
}
#define SetPlayerHoldingObject(%1,%2,%3,%4,%5,%6,%7,%8,%9) SetPlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1,%2,%3,%4,%5,%6,%7,%8,%9)
#define StopPlayerHoldingObject(%1) RemovePlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)
#define IsPlayerHoldingObject(%1) IsPlayerAttachedObjectSlotUsed(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)

Notes

tip

This function is separate from the CreateObject / CreatePlayerObject pools.

warning

In version 0.3d and onwards, 10 objects can be attached to a single player (index 0-9). In earlier versions, the limit is 5 (index 0-4).

Related Functions