CreateVehicle

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This function creates a vehicle and returns a handle to the created vehicle. If it fails, it will return false. This can happen if you exceed the upper vehicle limit at 65535 or due to an another unspecified future reason.

Syntax

vehicle createVehicle ( model, x, y, z, [rx, ry, rz, string numberplate] )

Required Arguments

  • model: The Vehicle IDs|vehicle ID of the vehicle being created.
  • x: A floating point number representing the X coordinate on the map.
  • y: A floating point number representing the Y coordinate on the map.
  • z: A floating point number representing the Z coordinate on the map.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • rx: A floating point number representing the rotation about the X axis in Radians.
  • ry: A floating point number representing the rotation about the Y axis in Radians.
  • rz: A floating point number representing the rotation about the Z axis in Radians.
  • numberplate: A string that will go on the number plate of the car (max 8 letters). This is only applicable to cars.

Template:UsingRadians

Example

function onPlayerChat ( player, chat )
  if ( strtok ( chat, 1, 32 ) == "!createhydra" ) then
    x, y, z = getPlayerPosition ( player )
    createVehicle ( 520, x + 5, y, z, 0, 0, 0 )
    outputChatBox ( "You got a hydra", player )
  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)