CreateVehicle: Difference between revisions

From Onset Developer Wiki
Created page with "CreateVehicle <syntaxhighlight lang="Python" line='line'> def quickSort(arr): less = [] pivotList = [] more = [] if len(arr) <= 1: return arr else: pass </syntaxhigh..."
 
No edit summary
 
(44 intermediate revisions by 2 users not shown)
Line 1: Line 1:
CreateVehicle
{{Info|Function|Server|1.0}}


<syntaxhighlight lang="Python" line='line'>
{{FuncDescription|This function creates a vehicle at a desired location.
def quickSort(arr):
'''Vehicles automatically respawn after 5 minutes. Use [[SetVehicleRespawnParams]] to control this behavior.'''}}
less = []
 
pivotList = []
{{FuncSyntax|CreateVehicle(modelid, x, y, z [, heading])}}
more = []
<div class="noprint" style="float:right;">
if len(arr) <= 1:
[[File:vehicle_spawn.gif]]
return arr
</div>
else:
{{FuncParameters}}
pass
{{FuncParam|modelid|The [[Vehicles|model identifier]] for which vehicle to spawn.}}
{{FuncParam|x, y, z|The location/coordinates of where this vehicle is going to spawn.}}
{{FuncParamOptional|heading|The direction (yaw axis) in which this vehicle is going to be positioned.}}
 
{{FuncReturnValue|Returns an identifier to the new vehicle. '''false''' on error.}}
 
== Example ==
<syntaxhighlight lang="Lua">
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)
</syntaxhighlight>
</syntaxhighlight>
{{RelatedFunctions}}
{{VehicleFunctions}}

Latest revision as of 10:58, 4 November 2020

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

Retrieved from "https://dev.playonset.com/index.php?title=CreateVehicle&oldid=4512"