CreateVehicle

From SA-MP Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 14:47, 15 February 2019
OstGot (Talk | contribs)
(Return 0 for trains 537 & 538)
← Previous diff
Revision as of 14:49, 15 February 2019
OstGot (Talk | contribs)
(Missing dot lol)
Next diff →
Line 19: Line 19:
* The vehicle ID of the vehicle created (1 to MAX_VEHICLES). * 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). * '''INVALID_VEHICLE_ID (65535)''' if vehicle was not created (vehicle limit reached or invalid vehicle model ID passed).
-* '''0''' if vehicle was not created (ID's 538 or 537 passed, which is trains)}}+* '''0''' if vehicle was not created (ID's 538 or 537 passed, which is trains).}}
{{Example}} {{Example}}

Revision as of 14:49, 15 February 2019



Description:

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


Image:32px-Circle-style-warning.png

Important
Note

Trains can only be added with AddStaticVehicle and AddStaticVehicleEx.


Parameters:
(vehicletype, Float:x, Float:y, Float:z, Float:rotation, color1, color2, respawn_delay, addsiren=0)
vehicletypeThe model for the vehicle.
Float:XThe X coordinate for the vehicle.
Float:YThe Y coordinate for the vehicle.
Float:ZThe Z coordinate for the vehicle.
Float:rotationThe facing angle for the vehicle.
color1The primary color ID.
color2The secondary color ID.
respawn_delayThe delay until the car is respawned without a driver in seconds. Using -1 will prevent the vehicle from respawning.
addsirenAdded 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 (ID's 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.


Related Callbacks

The following callbacks might be useful, as they're related to this function in one way or another.

Personal tools