note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
AddVehicleComponent
Description
Adds a 'component' (often referred to as a 'mod' (modification)) to a vehicle. Valid components can be found here.
| Name | Description |
|---|---|
| vehicleid | The ID of the vehicle to add the component to. Not to be confused with modelid. |
| component | The ID of the component to add to the vehicle. |
Returns
true - The component was successfully added to the vehicle.
false - The component was not added because the vehicle does not exist.
Examples
new gTaxi;
public OnGameModeInit()
{
gTaxi = AddStaticVehicle(420, -2482.4937, 2242.3936, 4.6225, 179.3656, 6, 1); // Taxi
return 1;
}
public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE: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;
}
Notes
warning
Using an invalid component ID crashes the player's game. (Fixed in open.mp)
Related Functions
- RemoveVehicleComponent: Remove a component from a vehicle.
- GetVehicleComponentInSlot: Check what components a vehicle has.
- GetVehicleComponentType: Check the type of component via the ID.
- VehicleCanHaveComponent: Is the component legal on the vehicle?
Related Callbacks
- OnVehicleMod: Called when a vehicle is modded.
- OnEnterExitModShop: Called when a vehicle enters or exits a mod shop.