CreateVehicle

From Onset Developer Wiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
CreateVehicle

Type: Function
Context: Server
Introduced: v1.0

Description

This function creates a vehicle at a desired location. Vehicles automatically respawn after 5 minutes. Use SetVehicleRespawnParams to control this behavior.

Syntax

CreateVehicle(modelid, x, y, z [, heading])

Parameters

  • modelid
    The model identifier for which vehicle to spawn.
  • x, y, z
    The location/coordinates of where this vehicle is going to spawn.
  • heading (optional)
    The direction (yaw axis) in which this vehicle is going to be positioned.

Return Value

  • Returns an identifier to the new vehicle. false on error.

Example

function cmd_v(player, model)
	if (model == nil) then
		return AddPlayerChat(player, "Usage: /v <model>")
	end

	model = tonumber(model)

	local x, y, z = GetPlayerLocation(player)
	local h = GetPlayerHeading(player)

	local vehicle = CreateVehicle(model, x, y, z, h)
	if (vehicle == false) then
		return AddPlayerChat(player, "Failed to spawn your vehicle")
	end

	SetVehicleLicensePlate(vehicle, "ONSET")
	AttachVehicleNitro(vehicle, true)

	if (model == 8) then
		-- Set Ambulance blue color and license plate text
		SetVehicleColor(vehicle, RGB(0.0, 60.0, 240.0))
		SetVehicleLicensePlate(vehicle, "EMS-02")
	end

    -- Set us in the driver seat
	SetPlayerInVehicle(player, vehicle)

	AddPlayerChat(player, "Vehicle spawned! (New ID: "..vehicle..")")
end
AddCommand("v", cmd_v)

See also