OnVehicleDamageStatusUpdate

From SA-MP Wiki

Revision as of 05:05, 2 February 2014

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

Description:

Note	This does not include vehicle health changes

Return Values:

public OnVehicleDamageStatusUpdate(vehicleid, playerid)
{
    printf("Vehicle ID %d of playerid %d was damaged.", vehicleid, playerid);
    return 1;
}

// example code: protect vehicle tires from being popped
// uses encode_tires function from: http://forum.sa-mp.com/index.php?topic=161491.msg960040#msg960040
 
public OnVehicleDamageStatusUpdate(vehicleid, playerid)
{
    #pragma unused playerid
 
    new panels, doors, lights, tires;	
    GetVehicleDamageStatus(vehicleid, panels, doors, lights, tires);
    tires = encode_tires(0, 0, 0, 0); // fix all tires
    panels = encode_panels(0, 0, 0, 0, 0, 0, 0); // fix all panels //fell off - (3, 3, 3, 3, 3, 3, 3)
    doors = encode_doors(0, 0, 0, 0, 0, 0); // fix all doors //fell off - (4, 4, 4, 4, 0, 0)
    lights = encode_lights(0, 0, 0, 0); // fix all lights
    UpdateVehicleDamageStatus(vehicleid, panels, doors, lights, tires);
    return 1;	
}
 
encode_tires(tire1, tire2, tire3, tire4) return tire1 | (tire2 << 1) | (tire3 << 2) | (tire4 << 3);
encode_panels(flp, frp, rlp, rrp, windshield, front_bumper, rear_bumper)
{
    return flp | (frp << 4) | (rlp << 8) | (rrp << 12) | (windshield << 16) | (front_bumper << 20) | (rear_bumper << 24);
}
encode_doors(bonnet, boot, driver_door, passenger_door, behind_driver_door, behind_passenger_door)
{
    #pragma unused behind_driver_door
    #pragma unused behind_passenger_door
    return bonnet | (boot << 8) | (driver_door << 16) | (passenger_door << 24);
}
encode_lights(light1, light2, light3, light4)
{
    return light1 | (light2 << 1) | (light3 << 2) | (light4 << 3);
}

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.