SetVehicleVariant
Jump to navigation
Jump to search
Only available in MTA:SA v1.2 and onwards. This function sets the variant of a specified vehicle. In GTA SA some vehicles are different for example the labelling on trucks or the contents of a pick-up truck and the varying types of a motor bike. For the default GTA SA variant list see: Vehicle variants
Syntax
bool getVehicleVariant ( vehicle theVehicle, [ int variant1, int variant2 ] )
Required Arguments
- theVehicle: A handle to the vehicle that you want to get the variant of. Specifying no variant will result in random one being picked.
Optional Arguments
- variant1: An integer for the second vehicle variant see Vehicle variants
- variant2: An integer for the first vehicle variant see Vehicle variants
Returns
On success:
- bool: Returns true as the vehicle variants were successfully set.
On failure:
- bool: False because the specified vehicle didn't exist or specified variants were invalid.
Example
This example lets the vehicle driver set their vehicle variant with setvehvar
function setMyVehiclesVariant(theUser, command, var1, var2) local var1, var2 = tonumber(var1), tonumber(var2) -- If anything was passed make sure its number or nil local myVeh = getPedOccupiedVehicle(theUser) -- Get the vehicle that they're in if (myVeh and getVehicleController(myVeh) == theUser) then -- Make sure they're in control local wasSet = setVehicleVariant(myVeh, var1, var2) -- Set what they wanted if (wasSet) then outputChatBox("Vehicle variant successfully set!", theUser, 0, 255, 0) else outputChatBox("Vehicle variant unsuccessfully set.", theUser, 255, 255, 0) end end end addCommandHandler("setvehvar", setMyVehiclesVariant) -- Add the command
Requirements
This template will be deleted.
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