AttachPlayerObjectToVehicle

From SA-MP Wiki

Jump to: navigation, search


Description:

Attach a player object to a vehicle.


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


Parameters:
(playerid, objectid, vehicleid, Float:fOffsetX, Float:fOffsetY, Float:fOffsetZ, Float:fRotX, Float:fRotY, Float:RotZ)
playeridThe ID of the player the object was created for.
objectidThe ID of the object to attach to the vehicle.
vehicleidThe ID of the vehicle to attach the object to.
Float:OffsetXThe X position offset for attachment.
Float:OffsetYThe Y position offset for attachment.
Float:OffsetZThe Z position offset for attachment.
Float:RotXThe X rotation offset for attachment.
Float:RotYThe Y rotation offset for attachment.
Float:RotZThe Z rotation offset for attachment.


Return Values:

This function does not return any specific values.


Image:32px-Ambox_warning_orange.png

Note

  • You need to create the object before attempting to attach it to a vehicle.
  • Calling AttachPlayerObjectToVehicle after calling SetPlayerObjectMaterialText on objectid may cause the object to lose the custom text and revert to its default appearance. Calling them in reverse order seems to fix this behavior.


Example Usage:

public OnPlayerStateChange(playerid, newstate, oldstate)
{
    if(newstate == PLAYER_STATE_DRIVER) // If player enters vehicle
    {
        // Attach massive cow.
        new cow_object = CreatePlayerObject(playerid, 16442, 0, 0, 0, 0, 0, 0);
 
        AttachPlayerObjectToVehicle(playerid, cow_object, GetPlayerVehicleID(playerid), 0.0, 0.0, 1.0, 0.0, 0.0, 0.0);
    }
}

Related Functions

The following functions may be helpful as they relate to this function in one way or another.


Navigation
In other languages