BlowVehicle

From Multi Theft Auto: Wiki
Revision as of 15:44, 7 August 2011 by MrHankey (talk | contribs) (updated syntax)
Jump to navigation Jump to search

<pageclass class="both" subcaption="Shared function"></pageclass> <lowercasetitle></lowercasetitle> This function will blow up a vehicle. This will cause an explosion and will kill the driver and any passengers inside it.

Syntax

<section name="Server" class="server" show="true">
bool blowVehicle ( vehicle vehicleToBlow, [ bool explode=true ] )

Required ArgumentsRequired Arguments

  • vehicleToBlow: The vehicle that you wish to blow up.

Optional ArgumentsOptional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • explode: If this argument is true then the vehicle will explode, otherwise it will just be blown up silently.

</section>

<section name="Client" class="client" show="true">
bool blowVehicle ( vehicle vehicleToBlow )

Required ArgumentsRequired Arguments

  • vehicleToBlow: The vehicle that you wish to blow up.

</section>

Returns

Returns true if the vehicle was blown up, false if invalid arguments were passed to the function.

Example

<section name="Example 1: Server and client" class="both" show="true"> This example will blow up every vehicle in the game.
vehicles = getElementsByType ( "vehicle" )
for vehicleKey, vehicleValue in ipairs(vehicles) do
	blowVehicle ( vehicleValue )
end

It is worth noting that the same could be achieved with the following:

root = getRootElement ()
blowVehicle ( root )

</section>

<section name="Example 2: Server" class="server" show="true"> This example will blow a player's vehicle when he enters the car, like a carbomb.
riggedVehicle = createVehicle(445, 0, 0, 5)
function blowVehicleEnter ( thePlayer, seat, jacked )
	--ENGINE START BOMB. 
	if seat == 0 then --check if the seat the player got into was id 0 - i.e. driver seat
		blowVehicle ( source ) --if it was, toast him
	end
end
addEventHandler ( "onVehicleEnter", riggedVehicle, blowVehicleEnter ) --trigger the function when a certain vehicle is entered

</section>

See Also