OnVehicleExplode: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Add missing parameter)
m (player argument)
 
Line 6: Line 6:
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool withExplosion
bool withExplosion, player player
</syntaxhighlight>
</syntaxhighlight>
*'''withExplosion:''' Determines whether the vehicle was blown with or without an explosion.
*'''withExplosion:''' Determines whether the vehicle was blown with or without an explosion.
{{New feature/item|3.0161|1.6.0|22680|
*'''player:''' The player who sent the explosion packet.
}}


==Source==
==Source==

Latest revision as of 19:20, 18 August 2024

This event is triggered when a vehicle explodes.

[[{{{image}}}|link=|]] Note: This event can not be canceled.

Parameters

bool withExplosion, player player
  • withExplosion: Determines whether the vehicle was blown with or without an explosion.
ADDED/UPDATED IN VERSION 1.6.0 r22680:
  • player: The player who sent the explosion packet.

Source

The source of this event is the vehicle that exploded.

Example

Example 1

local vagosVehicle = nil

-- This will get called when the vagos vehicle explodes
function onVagosVehicleExplode ()
	outputChatBox ( "VAGOS VEHICLE DESTROYED!" )
end

-- This is called when THIS resource starts
function onThisResourceStart ()

	-- Create the vagos vehicle. A van.
	vagosVehicle = createVehicle ( 522, 0, 0, 5 )

	-- Add its explode handler. When this car explodes, onVagosVehicleExplode is called
	addEventHandler ( "onVehicleExplode", vagosVehicle, onVagosVehicleExplode )
end

--Add the resource start event
addEventHandler ( "onResourceStart", resourceRoot, onThisResourceStart )

Example 2: This will show the name of any vehicle that blew up:

function notifyAboutExplosion()
    -- source is the element that triggered the event and can be used in other events as well
    outputChatBox(getVehicleName(source) .. " just blew up")
end

-- by using root, it will work for any vehicle (even if it wasn't created via this resource)
addEventHandler("onVehicleExplode", root, notifyAboutExplosion)

See Also

Vehicle events


Event functions