OnVehicleStartExit: 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)
 
(12 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Category:Incomplete Event]]
__NOTOC__  
__NOTOC__  
This event is triggered when a player starts to leave a vehicle. It can be used to cancel the exit and cause the player to remain in the vehicle, if necessary.
{{Server event}}
This event is triggered when a player or ped starts to exit a vehicle. This event can be used to cancel exit, if necessary.


==Syntax==  
==Parameters==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
void onVehicleStartExit ( player player, int seat, player jacker )
ped exitingPed, int seat, ped jacked, int door
</syntaxhighlight>  
</syntaxhighlight>  
*'''exitingPed''': a [[player]] or [[ped]] element who is starting to exit a vehicle.
*'''seat''': an [[int]] representing the seat in which the ped is exiting from.
*'''jacked''': a [[player]] or [[ped]] element representing who is jacking.
*'''door''': an [[int]] representing the door that the ped is using to leave.
==Source==
The [[event system#Event source|source]] of this event is the [[vehicle]] in which a ped began to exit.


===Canceling===
===Canceling===
If this event is [[Events#Canceling|canceled]], the player will not exit a vehicle.
If this event is [[Event system #Canceling|canceled]], the ped will not exit the vehicle.


==Example==  
==Example==  
This example does...
This example locks a player inside a police vehicle if he is a policeman.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--This line does...
local policeVehicles = {[598] = true,[596] = true,[597] = true,[599] = true } -- Police vehicle IDs
blabhalbalhb --abababa
local policeSkins = {[280] = true,[281] = true,[282] = true,[283] = true,[284] = true,[285] = true,[286] = true } -- Police Skins
--This line does this...
mooo
function exitVehicle ( thePlayer, seat, jacked )
  if (policeVehicles[getElementModel (source)]) and (policeSkins[getElementModel(thePlayer)]) then
      outputChatBox ( "You're the cop! Don't exit the car!", thePlayer ) 
      cancelEvent()
  end
end
addEventHandler ( "onVehicleStartExit", getRootElement(), exitVehicle)
</syntaxhighlight>
</syntaxhighlight>
{{See also/Server event|Vehicle events}}

Latest revision as of 18:54, 29 November 2020

This event is triggered when a player or ped starts to exit a vehicle. This event can be used to cancel exit, if necessary.

Parameters

ped exitingPed, int seat, ped jacked, int door
  • exitingPed: a player or ped element who is starting to exit a vehicle.
  • seat: an int representing the seat in which the ped is exiting from.
  • jacked: a player or ped element representing who is jacking.
  • door: an int representing the door that the ped is using to leave.

Source

The source of this event is the vehicle in which a ped began to exit.

Canceling

If this event is canceled, the ped will not exit the vehicle.

Example

This example locks a player inside a police vehicle if he is a policeman.

local policeVehicles = {[598] = true,[596] = true,[597] = true,[599] = true } -- Police vehicle IDs
local policeSkins = {[280] = true,[281] = true,[282] = true,[283] = true,[284] = true,[285] = true,[286] = true } -- Police Skins
 
function exitVehicle ( thePlayer, seat, jacked ) 
   if (policeVehicles[getElementModel (source)]) and (policeSkins[getElementModel(thePlayer)]) then 
      outputChatBox ( "You're the cop! Don't exit the car!", thePlayer )  
      cancelEvent()
   end
end
addEventHandler ( "onVehicleStartExit", getRootElement(), exitVehicle)

See Also

Vehicle events


Event functions