CreateVehicle: Difference between revisions

From Onset Developer Wiki
← Older edit
No edit summary
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Info|Function|Server|1.0}}
{{Info|Function|Server|1.0}}


{{FuncDescription|__EDIT_ME__}}
{{FuncDescription|This function creates a vehicle at a desired location.
 
'''Vehicles automatically respawn after 5 minutes. Use [[SetVehicleRespawnParams]] to control this behavior.'''}}
{{FuncSyntax|CreateVehicle(modelid, x, y, z [, h])}}


{{FuncSyntax|CreateVehicle(modelid, x, y, z [, heading])}}
<div class="noprint" style="float:right;">
[[File:vehicle_spawn.gif]]
</div>
{{FuncParameters}}
{{FuncParameters}}
{{FuncParam|modelid|__EDIT_ME__}}
{{FuncParam|modelid|The [[Vehicles|model identifier]] for which vehicle to spawn.}}
{{FuncParam|x|__EDIT_ME__}}
{{FuncParam|x, y, z|The location/coordinates of where this vehicle is going to spawn.}}
{{FuncParam|y|__EDIT_ME__}}
{{FuncParamOptional|heading|The direction (yaw axis) in which this vehicle is going to be positioned.}}
{{FuncParam|z |__EDIT_ME__}}
{{FuncParamOptional|h|__EDIT_ME__}}


{{FuncReturnValue|__EDIT_ME__}}
{{FuncReturnValue|Returns an identifier to the new vehicle. '''false''' on error.}}


== Example ==
== Example ==
__EDIT_ME__
<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>


{{RelatedFunctions}}
{{RelatedFunctions}}
__EDIT_ME__
{{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"