OnVehicleDeath

From SA-MP Wiki

Jump to: navigation, search


Description:

This callback is called when a vehicle is destroyed - either by exploding or becoming submerged in water.


Parameters:
(vehicleid, killerid)
vehicleidThe ID of the vehicle that was destroyed.
killeridThe ID of the player that reported (synced) the vehicle's destruction (name is misleading). Generally the driver or a passenger (if any) or the closest player.


Return Values:

This callback does not handle returns.
  • It is always called first in filterscripts.


Image:32px-Ambox_warning_orange.png

Note

This callback will also be called when a vehicle enters water, but the vehicle can be saved from destruction by teleportation or driving out (if only partially submerged). The callback won't be called a second time, and the vehicle may disappear when the driver exits, or after a short time.


Example Usage:

public OnVehicleDeath(vehicleid, killerid)
{
    new string[40];
    format(string, sizeof(string), "Vehicle %i was destroyed. Reported by player %i.", vehicleid, killerid);
    SendClientMessageToAll(0xFFFFFFFF, string);
    return 1;
}

Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.


Related Functions

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

Personal tools