warning Not Translated

This page has not been translated into the language that your browser requested yet. The English content is being shown as a fallback.

If you want to contribute a translation for this page then please click here.

CreateVehicle

Description

Creates a vehicle in the world. Can be used in place of AddStaticVehicleEx at any time in the script.

Name	Description
modelid	The model for the vehicle.
Float:spawnX	The X coordinate for the vehicle.
Float:spawnY	The Y coordinate for the vehicle.
Float:spawnZ	The Z coordinate for the vehicle.
Float:angle	The facing angle for the vehicle.
colour1	The primary color ID.
colour2	The secondary color ID.
respawnDelay	The delay until the car is respawned without a driver in seconds. Using -1 will prevent the vehicle from respawning.
bool:addSiren	Has a default value 'false'. Enables the vehicle to have a siren, providing the vehicle has a horn.

Returns

The vehicle ID of the vehicle created (1 to MAX_VEHICLES).

INVALID_VEHICLE_ID (65535) if vehicle was not created (vehicle limit reached or invalid vehicle model ID passed).

0 if vehicle was not created (IDs 538 or 537 passed, which is trains).

Examples

public OnGameModeInit()
{
    // Add a Hydra (520) to the game with a respawn time of 60 seconds
    CreateVehicle(520, 2109.1763, 1503.0453, 32.2887, 82.2873, -1, -1, 60);
    return 1;
}

Notes

warning

Trains can only be added with AddStaticVehicle and AddStaticVehicleEx.

Related Functions

DestroyVehicle: Destroy a vehicle.
AddStaticVehicle: Add a static vehicle.
AddStaticVehicleEx: Add a static vehicle with custom respawn time.
GetVehicleParamsSirenState: Check whether a vehicle's siren is on or off.
SetVehicleSpawnInfo: Adjusts vehicle model, spawn location, colours, respawn delay and interior.
GetVehicleSpawnInfo: Gets the vehicle spawn location and colours.
ChangeVehicleColours: Change a vehicle's primary and secondary colors.
GetVehicleColours: Gets the vehicle colours.
SetVehicleRespawnDelay: Set the respawn delay of a vehicle.
GetVehicleRespawnDelay: Get the respawn delay of a vehicle.

Related Callbacks

OnVehicleSpawn: Called when a vehicle respawns.
OnVehicleSirenStateChange: Called when a vehicle's siren is toggled on/off.

Related Resources

Vehicle Models: Comprehensive list of all vehicle models available in game.
Vehicle Colour IDs: List of all vehicle colour IDs.