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 change their damage status.


Image:32px-Ambox_warning_orange.png

Note

This does not include vehicle health changes


Parameters:
(vehicleid, playerid)
vehicleidThe ID of the vehicle that was changed its damage status.
playeridThe ID of the player who synced the change in the damage status (who had the car damaged or repaired).


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
Navigation
Toolbox
In other languages