SetVehicleParamsEx

SetVehicleParamsEx

Description:

Function SetVehicleParamsEx sets a vehicle's parameters for all players.

Function SetVehicleParamsEx was added in 0.3c and will not work in earlier versions!

The alarm will not reset when finished, you'll need to reset it by yourself with this function. Lights also operate during the day (Only when ManualVehicleEngineAndLights is enabled).

Parameters:

(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective)

int

vehicleid

The ID of the vehicle to set the parameters of.

bool

engine

Engine status. 0 - Off, 1 - On.

bool

lights

Light status. 0 - Off, 1 - On.

bool

alarm

Vehicle alarm status. If on, the alarm starts. 0 - Off, 1 - On.

bool

doors

Door lock status. 0 - Unlocked, 1 - Locked.

bool

bonnet

Bonnet (hood) status. 0 - Closed, 1 - Open.

bool

boot

Boot/trunk status. 0 - Closed, 1 - Open.

bool

objective

Toggle the objective arrow above the vehicle. 0 - Off, 1 - On.

Return Values:

• 1: The function executed successfully.
• 0: The function failed to execute. This means the vehicle does not exist.

Examples:

Example 1Example 2

// If setting a single parameter, you should obtain the current parameters so they aren't ALL changed
new engine, lights, alarm, doors, bonnet, boot, objective;
GetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective);
SetVehicleParamsEx(vehicleid, VEHICLE_PARAMS_ON, lights, alarm, doors, bonnet, boot, objective); // ONLY the engine param was changed to VEHICLE_PARAMS_ON (1)

new Timer_VehAlarm[MAX_VEHICLES];
 
SetVehicleParamsEx_Fixed(vehicleid, &engine, &lights, &alarm, &doors, &bonnet, &boot, &objective)
{
    SetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective);
    if(alarm)
    {
        KillTimer(Timer_VehAlarm[vehicleid]);
        Timer_VehAlarm[vehicleid] = SetTimerEx("DisableVehicleAlarm", 20000, false, "d", vehicleid);
    }
}
 
forward DisableVehicleAlarm(vehicleid);
public DisableVehicleAlarm(vehicleid)
{
    new engine, lights, alarm, doors, bonnet, boot, objective;
    GetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective);
    if(alarm == VEHICLE_PARAMS_ON)
    {
    	SetVehicleParamsEx(vehicleid, engine, lights, VEHICLE_PARAMS_OFF, doors, bonnet, boot, objective);
    }
}

Related Functions

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

• GetVehicleParamsEx: Get a vehicle's parameters.
• SetVehicleParamsForPlayer: Set the parameters of a vehicle for a player.
• UpdateVehicleDamageStatus: Update the vehicle damage.