RemovePlayerFromVehicle: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
(7 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | |||
{{Server function}} | |||
{{Deprecated|removePedFromVehicle}} | |||
This function removes a player from a vehicle immediately. This works for drivers and passengers. Note that this removes the player from the vehicle and puts him in the exact position where the command was initiated. | |||
This | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool removePlayerFromVehicle ( | bool removePlayerFromVehicle ( player thePlayer ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''thePlayer:''' The player you wish to remove from a vehicle | ||
===Returns=== | ===Returns=== | ||
Returns ''true'' if | Returns ''true'' if the operation was successful, ''false'' otherwise. | ||
==Example== | ==Example== | ||
This example | This example forces a player out of a police vehicle if he is not a policeman. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | local policevehicles = { [596]=true, [597]=true, [598]=true, [599]=true } -- make a table of police vehicle IDs | ||
local policeskins = { [283]=true, [284]=true, [285]=true, [286]=true } -- make a table of police skin IDs | |||
-- | function enterVehicle ( theVehicle, seat, jacked ) -- when a player enters a vehicle | ||
local skinID = getPlayerSkin ( source ) -- get his skin ID | |||
local vehID = getVehicleID ( theVehicle ) | |||
if policevehicles[vehID] and not policeskins[skinID] then -- if the vehicle is one of 4 police cars, and the skin is not a police skin | |||
removePlayerFromVehicle ( source ) -- force the player out of the vehicle | |||
outputChatBox ( "Only policemen can enter police cars!", source ) -- and tell the player why | |||
end | |||
end | |||
addEventHandler ( "onPlayerEnterVehicle", root, enterVehicle ) -- add an event for onPlayerEnterVehicle | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{Vehicle functions}} |
Latest revision as of 08:13, 4 November 2020
This function is deprecated. This means that its use is discouraged and that it might not exist in future versions. | |
Please use removePedFromVehicle instead. |
This function removes a player from a vehicle immediately. This works for drivers and passengers. Note that this removes the player from the vehicle and puts him in the exact position where the command was initiated.
Syntax
bool removePlayerFromVehicle ( player thePlayer )
Required Arguments
- thePlayer: The player you wish to remove from a vehicle
Returns
Returns true if the operation was successful, false otherwise.
Example
This example forces a player out of a police vehicle if he is not a policeman.
local policevehicles = { [596]=true, [597]=true, [598]=true, [599]=true } -- make a table of police vehicle IDs local policeskins = { [283]=true, [284]=true, [285]=true, [286]=true } -- make a table of police skin IDs function enterVehicle ( theVehicle, seat, jacked ) -- when a player enters a vehicle local skinID = getPlayerSkin ( source ) -- get his skin ID local vehID = getVehicleID ( theVehicle ) if policevehicles[vehID] and not policeskins[skinID] then -- if the vehicle is one of 4 police cars, and the skin is not a police skin removePlayerFromVehicle ( source ) -- force the player out of the vehicle outputChatBox ( "Only policemen can enter police cars!", source ) -- and tell the player why end end addEventHandler ( "onPlayerEnterVehicle", root, enterVehicle ) -- add an event for onPlayerEnterVehicle
See Also
- addVehicleUpgrade
- attachTrailerToVehicle
- blowVehicle
- createVehicle
- detachTrailerFromVehicle
- fixVehicle
- getOriginalHandling
- getTrainDirection
- getTrainPosition
- getTrainSpeed
- getTrainTrack
- getVehicleColor
- getVehicleCompatibleUpgrades
- getVehicleController
- getVehicleDoorOpenRatio
- getVehicleDoorState
- getVehicleEngineState
- getVehicleHandling
- getVehicleHeadLightColor
- getVehicleLandingGearDown
- getVehicleLightState
- getVehicleMaxPassengers
- getVehicleModelFromName
- getVehicleName
- getVehicleNameFromModel
- getVehicleOccupant
- getVehicleOccupants
- getVehicleOverrideLights
- getVehiclePaintjob
- getVehiclePanelState
- getVehiclePlateText
- getVehicleSirenParams
- getVehicleSirens
- getVehicleSirensOn
- getVehicleTowedByVehicle
- getVehicleTowingVehicle
- getVehicleTurretPosition
- getVehicleType
- getVehicleUpgradeOnSlot
- getVehicleUpgradeSlotName
- getVehicleUpgrades
- getVehicleVariant
- getVehicleWheelStates
- isTrainDerailable
- isTrainDerailed
- isVehicleBlown
- isVehicleDamageProof
- isVehicleFuelTankExplodable
- isVehicleLocked
- isVehicleOnGround
- isVehicleTaxiLightOn
- removeVehicleUpgrade
- setTrainDerailable
- setTrainDerailed
- setTrainDirection
- setTrainPosition
- setTrainSpeed
- setTrainTrack
- setVehicleColor
- setVehicleDamageProof
- setVehicleDoorOpenRatio
- setVehicleDoorState
- setVehicleDoorsUndamageable
- setVehicleEngineState
- setVehicleFuelTankExplodable
- setVehicleHandling
- setVehicleHeadLightColor
- setVehicleLandingGearDown
- setVehicleLightState
- setVehicleLocked
- setVehicleOverrideLights
- setVehiclePaintjob
- setVehiclePanelState
- setVehiclePlateText
- setVehicleSirens
- setVehicleSirensOn
- setVehicleTaxiLightOn
- setVehicleTurretPosition
- setVehicleVariant
- setVehicleWheelStates