SetVehicleEngineState

From Multi Theft Auto: Wiki
Revision as of 21:20, 27 August 2007 by Jbeta (talk | contribs) (Added sections, minor changes, improved example)
Jump to navigation Jump to search

This function turns a vehicle's engine on or off.

Syntax

Click to collapse [-]
Server and Client
bool setVehicleEngineState ( vehicle theVehicle, bool engineState )

Required Arguments

  • theVehicle: The vehicle you wish to change the engine state of.
  • engineState: A boolean value representing whether the engine will be turned on (true) or off (false).

Returns

Returns true if the vehicle's engine state was successfully changed, false otherwise. </section>

Example

Click to collapse [-]
Serverside example

This example will turn off a vehicle's engine when the driver gets out of the car.

function turnEngineOff ( theVehicle, leftSeat, jackerPlayer )
    -- if it's the driver who got out, and he was not jacked,
    if leftSeat == 0 and not jackerPlayer then
        -- turn off the engine
        setVehicleEngineState ( theVehicle, false )
    end
end
-- add 'turnEngineOff' as a handler for "onPlayerExitVehicle"
addEventHandler ( "onPlayerExitVehicle", getRootElement ( ), turnEngineOff )

</section>

See Also