BlowVehicle: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(updated syntax)
m (root is a built in MTA var.)
Line 38: Line 38:
It is worth noting that the same could be achieved with the following:
It is worth noting that the same could be achieved with the following:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
root = getRootElement ()
blowVehicle ( root ) -- root (getRootElement) is a built in MTA variable and therefore we do not have to define it.
blowVehicle ( root )
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>

Revision as of 01:03, 21 October 2013

This function will blow up a vehicle. This will cause an explosion and will kill the driver and any passengers inside it.

Syntax

Click to collapse [-]
Server
bool blowVehicle ( vehicle vehicleToBlow, [ bool explode=true ] )

Required Arguments

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

Optional 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.
Click to collapse [-]
Client
bool blowVehicle ( vehicle vehicleToBlow )

Required Arguments

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

Returns

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

Example

Click to collapse [-]
Example 1: Server and client

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:

blowVehicle ( root ) -- root (getRootElement) is a built in MTA variable and therefore we do not have to define it.
Click to collapse [-]
Example 2: Server

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

See Also

Shared