CreateVehicle
From SA-MP Wiki
(Redirected from Function:CreateVehicle)
Description:
Creates a vehicle in the world. Can be used in place of AddStaticVehicleEx at any time in the script.
 Important | Trains can only be added with AddStaticVehicle and AddStaticVehicleEx. |
(vehicletype, Float:x, Float:y, Float:z, Float:rotation, color1, color2, respawn_delay, addsiren=0)
| vehicletype | The model for the vehicle. |
| Float:X | The X coordinate for the vehicle. |
| Float:Y | The Y coordinate for the vehicle. |
| Float:Z | The Z coordinate for the vehicle. |
| Float:rotation | The facing angle for the vehicle. |
| color1 | The primary color ID. |
| color2 | The secondary color ID. |
| respawn_delay | The delay until the car is respawned without a driver in seconds. Using -1 will prevent the vehicle from respawning. |
| addsiren | Added in 0.3.7; will not work in earlier versions. Has a default value 0. Enables the vehicle to have a siren, providing the vehicle has a horn. |
Return Values:
- 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).
Example Usage:
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; }
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- 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.
Related Callbacks
The following callbacks might be useful, as they're related to this function in one way or another.
- OnVehicleSpawn: Called when a vehicle respawns.
- OnVehicleSirenStateChange: Called when a vehicle's siren is toggled on/off.
