SetPlayerLocation

Description

Set the specified client's location.

Syntax

SetPlayerLocation(player, x, y, z)

Parameters

• player
  The client identifier
• x
  The X coordinate of position to put the player at.
• y
  The Y coordinate of position to put the player at.
• z
  The Z coordinate of position to put the player at.

Return Value

• Returns true on success.

Example

AddCommand("town", function(player)
	SetPlayerLocation(player, -182821.00, -41675.00, 1160.00)
	AddPlayerChat(player, "Teleported to town.")
end)

(server) Teleport function example:

function TeleportTo(player, x, y, z, h)
	-- if the player is in a vehicle it will teleport the vehicle with them.
	-- h = player heading
	h = h or -1.0

	if (GetPlayerVehicleSeat(player) == 1) then
		local vehicle = GetPlayerVehicle(player)
		SetVehicleLocation(vehicle, x, y, z)
		if (h ~= -1.0) then
			SetVehicleHeading(vehicle, h)
		end

		-- Reset velocity
		SetVehicleLinearVelocity(vehicle, 0.0, 0.0, 0.0, true)
		SetVehicleAngularVelocity(vehicle, 0.0, 0.0, 0.0, true)
		local rx, ry, rz = GetVehicleRotation(vehicle)
		-- Reset pitch and roll, leave yaw alone
		SetVehicleRotation(vehicle, 0.0, ry, 0.0)
	else
		SetPlayerLocation(player, x, y, z)
		if (h ~= -1.0) then
			SetPlayerHeading(player, h)
		end
	end
	--ResetPlayerCamera(player)
end

See also

• GetPlayerLocation