OnVehicleExit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Using "ped" instead of "player" when parameter refers to both)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
__NOTOC__
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
{{Server event}}
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
This event is triggered when a player or ped leaves a vehicle.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
==Parameters==
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
<syntaxhighlight lang="lua">
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
ped thePed, int seat, ped jacker, bool forcedByScript
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
</syntaxhighlight>
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
*'''thePed''': a [[player]] or [[ped]] element who exited the [[vehicle]].
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
*'''seat''': an [[int]] representing the seat in which the ped exited from.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
*'''jacker''': a [[player]] or [[ped]] element who jacked the driver.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
{{New feature/item|3.0154|1.5.3|11247|
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
*'''forcedByScript:''' a [[boolean]] representing whether the exit was forced using [[removePedFromVehicle]] or by the ped/player.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
}}
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
==Source==
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
The [[event system#Event source|source]] of this event is the [[vehicle]] that was exited.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
==Example==
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
This example adds a 'moto' helmet to a player when he gets on a nrg bike, and removes it when he gets off.
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
<syntaxhighlight lang="lua">
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
function addHelmetOnEnter ( thePlayer, seat, jacked )
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
    if ( getElementModel ( source ) == 522 ) then -- if its a nrg
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
        addPedClothes ( thePlayer, "moto", "moto", 16 ) -- add the helmet
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
    end
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
end
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
addEventHandler ( "onVehicleEnter", getRootElement(), addHelmetOnEnter )
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
function removeHelmetOnExit ( thePlayer, seat, jacked )
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
    if ( getElementModel ( source ) == 522 ) then -- if its a nrg
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
        removePedClothes ( thePlayer, 16 ) -- remove the helmet
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
    end
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
end
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
addEventHandler ( "onVehicleExit", getRootElement(), removeHelmetOnExit )
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
</syntaxhighlight>
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
 
Extrem liże hazowi dupsko a Barcioo liże cipsko Trinowi
==Example 2==
This example will turn off a vehicle's engine when the driver gets out of the car.
<syntaxhighlight lang="lua">
addEventHandler ( "onPlayerVehicleExit", getRootElement(), function(theVehicle, leftSeat, jackerPlayer)
    if leftSeat == 0 and not jackerPlayer then
      setVehicleEngineState( theVehicle, false)
    end
end)
</syntaxhighlight>
 
==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.3-9.11247|Added forcedByScript argument}}
 
{{See also/Server event|Vehicle events}}

Latest revision as of 18:51, 29 November 2020

This event is triggered when a player or ped leaves a vehicle.

Parameters

ped thePed, int seat, ped jacker, bool forcedByScript
  • thePed: a player or ped element who exited the vehicle.
  • seat: an int representing the seat in which the ped exited from.
  • jacker: a player or ped element who jacked the driver.

Source

The source of this event is the vehicle that was exited.

Example

This example adds a 'moto' helmet to a player when he gets on a nrg bike, and removes it when he gets off.

function addHelmetOnEnter ( thePlayer, seat, jacked )
    if ( getElementModel ( source ) == 522 ) then -- if its a nrg
        addPedClothes ( thePlayer, "moto", "moto", 16 ) -- add the helmet
    end
end
addEventHandler ( "onVehicleEnter", getRootElement(), addHelmetOnEnter )

function removeHelmetOnExit ( thePlayer, seat, jacked )
    if ( getElementModel ( source ) == 522 ) then -- if its a nrg
        removePedClothes ( thePlayer, 16 ) -- remove the helmet
    end
end
addEventHandler ( "onVehicleExit", getRootElement(), removeHelmetOnExit )


Example 2

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

addEventHandler ( "onPlayerVehicleExit", getRootElement(), function(theVehicle, leftSeat, jackerPlayer)
    if leftSeat == 0 and not jackerPlayer then
       setVehicleEngineState( theVehicle, false)
    end
end)

Changelog

Version Description
1.5.3-9.11247 Added forcedByScript argument

See Also

Vehicle events


Event functions

Shared