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.

OnVehicleDamageStatusUpdate

tip

For some useful functions for working with vehicle damage values, see here.

Description

This callback is called when a vehicle element such as doors, tyres, panels, or lights change their damage status.

Name	Description
vehicleid	The ID of the vehicle that was changed its damage status.
playerid	The ID of the player who synced the change in the damage status (who had the car damaged or repaired).

Returns

1 - Will prevent other filterscripts from receiving this callback.

0 - Indicates that this callback will be passed to the next filterscript.

It is always called first in filterscripts.

Examples

public OnVehicleDamageStatusUpdate(vehicleid, playerid)
{
    // Get the damage status of all the components
    new 
        VEHICLE_PANEL_STATUS:panels,
        VEHICLE_DOOR_STATUS:doors,
        VEHICLE_LIGHT_STATUS:lights,
        VEHICLE_TYRE_STATUS:tyres;

    GetVehicleDamageStatus(vehicleid, panels, doors, lights, tyres);

    // Set the tyres to 0, which means none are popped
    tyres = VEHICLE_TYRE_STATUS_NONE;

    // Update the vehicle's damage status with unpopped tyres
    UpdateVehicleDamageStatus(vehicleid, panels, doors, lights, tyres);
    return 1;
}

Notes

tip

This does not include vehicle health changes.

Related Functions

The following functions might be useful, as they're related to this callback in one way or another.

GetVehicleDamageStatus: Get the vehicle damage state for each part individually.
UpdateVehicleDamageStatus: Update the vehicle damage.