GetVehicleID: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 2: | Line 2: | ||
__NOTOC__ | __NOTOC__ | ||
This | This function retrieves the ID of a vehicle as an integer value. | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
int getVehicleID ( vehicle | int getVehicleID ( vehicle theVehicle ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theVehicle:''' The vehicle you want to get the ID of. | ||
===Returns=== | ===Returns=== | ||
Returns ' | Returns an integer containing the requested vehicle's ID, or false if the vehicle passed to the function is invalid. | ||
==Example== | ==Example== | ||
This example | This example checks whether a player enters an AT-400 or a Shamal. If they do, it announces it to the chat specifying what vehicle was stolen. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | -- add the event to the event handler | ||
addEventHandler ( "onPlayerEnterVehicle", root, "onPlayerEnterVehicle" ) | |||
-- | function onPlayerEnterVehicle ( vehicle, seat, jacked ) --when someone enters a vehicle | ||
id = getVehicleID ( vehicle ) -- get the ID of the vehicle | |||
if id == 519 or 577 then --if the vehicle is one of these two planes | |||
vehiclename = getVehicleName ( vehicle ) -- define the vehicle name | |||
outputChatBox ( "Someone stole the "..vehiclename.."!" ) -- announce that someone stole the plane | |||
end | |||
end | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{IDs}} | ||
{{Vehicle_functions}} |
Revision as of 01:59, 30 July 2006
This function retrieves the ID of a vehicle as an integer value.
Syntax
int getVehicleID ( vehicle theVehicle )
Required Arguments
- theVehicle: The vehicle you want to get the ID of.
Returns
Returns an integer containing the requested vehicle's ID, or false if the vehicle passed to the function is invalid.
Example
This example checks whether a player enters an AT-400 or a Shamal. If they do, it announces it to the chat specifying what vehicle was stolen.
-- add the event to the event handler addEventHandler ( "onPlayerEnterVehicle", root, "onPlayerEnterVehicle" ) function onPlayerEnterVehicle ( vehicle, seat, jacked ) --when someone enters a vehicle id = getVehicleID ( vehicle ) -- get the ID of the vehicle if id == 519 or 577 then --if the vehicle is one of these two planes vehiclename = getVehicleName ( vehicle ) -- define the vehicle name outputChatBox ( "Someone stole the "..vehiclename.."!" ) -- announce that someone stole the plane end end
See Also
GTASA IDs (vehicles, weapons, weathers, characters, colors): http://info.vces.net/ (Special thanks to Brophy and Ratt for making these lists)
- 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