From SA-MP Wiki
| 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.
Parameters:(playerid, index, modelid, bone, Float:fOffsetX = 0.0, Float:fOffsetY = 0.0, Float:fOffsetZ = 0.0, Float:fRotX = 0.0, Float:fRotY = 0.0, Float:fRotZ = 0.0, Float:fScaleX = 1.0, Float:fScaleY = 1.0, Float:fScaleZ = 1.0, materialcolor1 = 0, materialcolor2 = 0)
| playerid | The ID of the player to attach the object to. |
| index | The index (slot) to assign the object to (0-9 since 0.3d, 0-4 in previous versions). |
| modelid | The model to attach. |
| bone | The 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 |
Return Values:
1 on success, 0 on failure.
Important
Note
| 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).
|
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;
}
Useful defines for updating to 0.3c
#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)
Related Functions
The following functions may be helpful as they relate to this function in one way or another.
