AddVehicleComponent

AddVehicleComponent

Description:

Function AddVehicleComponent adds a 'component' (often referred to as a 'mod' (modification)) to a vehicle. Valid components can be found here.

Using an invalid component ID crashes the player's game. There are no internal checks for this.

Parameters:

(vehicleid, componentid)

int

vehicleid

The ID of the vehicle to add the component to. Not to be confused with modelid.

int

componentid

The ID of the component to add to the vehicle.

Return Values:

• 0 - The component was not added because the vehicle does not exist.
• 1 - The component was successfully added to the vehicle.

Examples:

Example 1

new gTAXI;
 
public OnGameModeInit()
{
    gTAXI = AddStaticVehicle(420, -2482.4937, 2242.3936, 4.6225, 179.3656, 6, 1); // Taxi
    return 1;
}
 
public OnPlayerStateChange(playerid, newstate, oldstate)
{
    if (newstate == PLAYER_STATE_DRIVER && oldstate == PLAYER_STATE_ONFOOT)
    {
        if (GetPlayerVehicleID(playerid) == gTAXI)
        {
            AddVehicleComponent(gTAXI, 1010); // Nitro
            SendClientMessage(playerid, 0xFFFFFFAA, "Nitro added to the Taxi.");
        }
    }
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• RemoveVehicleComponent: Remove a component from a vehicle.
• GetVehicleComponentInSlot: Check what components a vehicle has.
• GetVehicleComponentType: Check the type of component via the ID.

Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.

• OnVehicleMod: Called when a vehicle is modded.
• OnEnterExitModShop: Called when a vehicle enters or exits a mod shop.