OnVehicleDamageStatusUpdate

From SA-MP Wiki

Jump to: navigation, search


OnVehicleDamageStatusUpdate was added in SA-MP 0.3a This callback was added in SA-MP 0.3a and will not work in earlier versions!


Description:

This callback is called when a vehicle element such as doors, tires, panels, or lights get damaged.


Image:32px-Ambox_warning_orange.png

Note

This does not include vehicle health changes


Parameters:
(vehicleid, playerid)
vehicleidThe ID of the vehicle that was damaged.
playeridThe ID of the player who synced the damage (who had the car damaged).


Return Values:

  • 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.


Example Usage: Prevent tire popping

public OnVehicleDamageStatusUpdate(vehicleid, playerid)
{	
    // Get the damage status of all the components
    new panels, doors, lights, tires;	
    GetVehicleDamageStatus(vehicleid, panels, doors, lights, tires);
 
    // Set the tires to 0, which means none are popped
    tires = 0;
 
    // Update the vehicle's damage status with unpopped tires
    UpdateVehicleDamageStatus(vehicleid, panels, doors, lights, tires);
    return 1;	
}
Tip

Image:Light_bulb_icon.png

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


Related Functions

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

Personal tools
In other languages