Tutorial · Sistemas de jogo

Como fazer um teleporte no Roblox Studio

Um teleporte no Roblox é uma de duas coisas: mover um personagem para outro lugar no mesmo servidor, ou mandar o jogador para outro place do seu jogo. Este guia monta as duas com um único script de servidor: pads que mandam você para um pad parceiro, um menu Teleport cujos pontos bloqueados abrem com Wins, e portais para outro place que tentam de novo quando o teleporte do Roblox falha.

Atualizado em 12 de novembro de 202625 min de leituraEscrito por

Resumo

Para um pad de teleporte, coloque um Script no ServerScriptService que escuta o evento Touched do pad, acha o jogador com Players:GetPlayerFromCharacter e move o personagem inteiro com character:PivotTo() para um ponto logo à frente do pad de destino, de costas para ele, com um cooldown de alguns segundos por jogador para o pad de destino não mandá-lo direto de volta. Para mandar jogadores para outro place do seu jogo, chame TeleportService:TeleportAsync(placeId, { player }) em um Script de servidor dentro de pcall; isso só funciona no jogo publicado, não no Studio.

  • Mova o personagem inteiro com PivotTo. Definir HumanoidRootPart.Position afasta a root part do resto do corpo, porque o Roblox atualiza as juntas quando a Position é definida.
  • Um menu de teleporte deve enviar ao servidor o nome de um destino, nunca uma posição. O servidor confere o nome, o cooldown e qualquer regra de desbloqueio antes de mover alguém.
  • TeleportService:Teleport() está obsoleto e roda no cliente. Use TeleportAsync no servidor, envolva em pcall, tente de novo e trate o TeleportInitFailed.
Nesta página
  1. Como funciona
  2. 1. Pads de teleporte
  3. 2. Script de teleporte
  4. 3. Menu de teleporte
  5. 4. Outros places
  6. Tutoriais antigos
  7. Limites contra exploits
  8. 5. Teste
  9. Indo além
  10. Erros comuns
  11. Com o RoCode
  12. Perguntas frequentes
  13. Fontes e leitura extra

Dois tipos de teleporte

IlustraçãoTocar no PadA põe você logo à frente do PadB, então o PadB não manda você direto de volta, e o servidor recusa o Castle bloqueado, mas leva você ao Lake.

Um teleporte pode ser três coisas em um jogo do Roblox: um pad que manda você para o outro lado do mapa, um menu de pontos para onde pular, ou um portal para outra fase. Os dois primeiros movem um personagem dentro do servidor em que o jogador já está. O terceiro manda o jogador para um place diferente do seu jogo, que roda nos próprios servidores. Eles usam APIs diferentes, então ajuda saber de qual você precisa.

Os dois tipos de teleporte
Dentro do mesmo servidorPara outro place do seu jogo
A chamadacharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Usado paraPads de teleporte, um menu de teleporte, levar jogadores do lobby para uma arenaPortais para outra fase, um lobby que manda os jogadores para um place separado de dungeon ou de partida
Roda emUm Script de servidorSó em um Script de servidor. O Teleport() do cliente está obsoleto.
Funciona em um teste no StudioSimNão. O TeleportService da Roblox não funciona em testes no Studio, então você testa no jogo publicado.
O que o jogador vêUm salto pelo mapa, que pode levar até 2 segundos se aquela área precisar carregar antesA tela de carregamento do Roblox, depois o outro place
Moedas, itens e outros dadosFicam como estãoO Roblox descarta os dados locais do jogador, então tudo o que importa precisa vir de um data store no outro place

Este guia monta os três tipos em um único Script de servidor, então um só conjunto de regras cobre todo teleporte do seu jogo: o servidor decide, cada jogador tem o próprio cooldown, e o dispositivo do jogador só diz para qual ponto ele gostaria de ir.

As peças do teleporte
PeçaOnde ficaO que faz
Folder TeleportPads com PadA e PadBWorkspaceDois pads. O atributo Destination de cada pad dá o nome do pad para onde ele manda os jogadores.
Folder TeleportSpotsWorkspaceUma part para cada ponto que o menu lista. Um atributo WinsNeeded bloqueia um ponto.
Folder PlacePortalsWorkspaceParts de portal. O atributo PlaceId de cada portal é o place para onde ele manda os jogadores.
Script TeleportersServerScriptServiceRoda os três tipos de teleporte e cria os dois remotes. O único lugar em que um teleporte pode acontecer.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsDesenha o botão Teleport e a lista de pontos, e envia o nome do ponto que o jogador escolhe.
RemoteFunction GetTeleportSpots e RemoteEvent TeleportRequestReplicatedStorage (o Teleporters cria)A primeira devolve a lista de pontos ao menu. O segundo leva o nome escolhido ao servidor.
O Explorer quando o teleporte está pronto. O Teleporters adiciona GetTeleportSpots e TeleportRequest ao ReplicatedStorage quando o jogo roda.
Workspace
  TeleportPads Folder new
    PadA Part new
    PadB Part new
  TeleportSpots Folder new
    Spawn Part new
    Lake Part new
    Castle Part new
  PlacePortals Folder new
    DungeonPortal Part new
ServerScriptService
  Teleporters Script new
StarterPlayer
  StarterPlayerScripts
    TeleportMenu LocalScript new

Passo 1: Monte dois pads de teleporte

  1. No Explorer, passe o mouse sobre Workspace, clique no botão + e insira uma Folder. Dê o nome TeleportPads. O script procura exatamente esse nome.
  2. Insira duas Parts na pasta e dê os nomes PadA e PadB. Faça de cada uma uma placa baixa, por exemplo 6 por 1 por 6 studs, e coloque as duas no chão a alguma distância uma da outra. Na janela Properties, marque Anchored, deixe CanCollide e CanTouch ligados, e dê a elas uma cor viva e o material Neon para os jogadores as verem.
  3. Selecione o PadA, role até a seção Attributes da janela Properties e clique em +. Digite o nome Destination, escolha o tipo String e clique em Save, depois defina o valor como PadB. Faça o mesmo no PadB com o valor PadA.
  4. Gire cada pad para a face da frente dele apontar para chão livre. Os jogadores chegam 3 studs à frente da face da frente do pad de destino, de costas para ele, então deixe alguns studs de chão livre ali. Para ver qual face é a da frente, clique com o botão direito no pad e escolha Show Orientation Indicator: uma linha azul marca a face da frente. Gire o pad com a ferramenta Rotate até essa linha apontar para onde os jogadores devem sair andando.

Os jogadores chegam ao lado do pad, não em cima dele, de propósito. A página de debounce da Roblox avisa que o Touched dispara muitas vezes seguidas em um único contato, então um jogador que chegasse em cima do outro pad o acionaria de novo assim que o cooldown acabasse, e voltaria para o outro lado do mapa.

Você não fica limitado a dois pads. O Destination de um pad pode apontar para qualquer part de TeleportPads, então três pads podem mandar os jogadores em círculo. Para um pad só de ida, aponte para uma part de TeleportPads que não tem Destination próprio: essa part recebe jogadores e não manda ninguém para lugar nenhum.

Passo 2: Adicione o script de teleporte

Passe o mouse sobre ServerScriptService, insira um Script, dê o nome Teleporters e cole o código abaixo. Ele cuida dos pads agora, e do menu e dos portais dos próximos passos, então você o adiciona uma vez só. As configurações no topo são as linhas feitas para você mudar.

Script em ServerScriptService chamado Teleporters
-- Script no ServerScriptService chamado Teleporters.
-- Todo teleporte é decidido aqui, no servidor:
--   1. Pads: tocar em uma part de Workspace.TeleportPads leva você à part cujo nome
--      está no atributo Destination dela.
--   2. Um menu: o LocalScript TeleportMenu pede um ponto de Workspace.TeleportSpots
--      pelo nome. O servidor confere o nome, o cooldown e as Wins que o ponto exige.
--   3. Portais: tocar em uma part de Workspace.PlacePortals manda você para o place
--      do atributo PlaceId dela (outro place deste jogo).

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local TeleportService = game:GetService("TeleportService")

local PAD_COOLDOWN_SECONDS = 2 -- os pads ignoram um jogador por este tempo depois de qualquer teleporte
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs à frente de um pad de destino, para os jogadores chegarem ao lado dele
local PLACE_ATTEMPTS = 3

local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")

-- Este script cria os dois remotes sozinho, então não adicione à mão
local getSpots = Instance.new("RemoteFunction")
getSpots.Name = "GetTeleportSpots"
getSpots.Parent = ReplicatedStorage
local teleportRequest = Instance.new("RemoteEvent")
teleportRequest.Name = "TeleportRequest"
teleportRequest.Parent = ReplicatedStorage

local lastTeleport: { [Player]: number } = {}
local warnedPads: { [Instance]: boolean } = {}
local leavingForPlace: { [Player]: boolean } = {}

local function playerFromHit(otherPart: BasePart): Player?
	local character = otherPart:FindFirstAncestorOfClass("Model")
	return if character then Players:GetPlayerFromCharacter(character) else nil
end

local function onCooldown(player: Player, seconds: number): boolean
	return os.clock() - (lastTeleport[player] or -math.huge) < seconds
end

-- A que altura do chão fica a root part de um personagem em pé.
-- A fórmula é da referência Humanoid.HipHeight da Roblox (rigs R6 somam a altura da perna).
local function rootHeight(character: Model, humanoid: Humanoid, rootPart: BasePart): number
	local height = rootPart.Size.Y / 2 + humanoid.HipHeight
	if humanoid.RigType == Enum.HumanoidRigType.R6 then
		local leg = character:FindFirstChild("Left Leg")
		if leg and leg:IsA("BasePart") then
			height += leg.Size.Y
		end
	end
	return height
end

local function teleportTo(player: Player, destination: BasePart, besidePad: boolean)
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	local rootPart = humanoid and humanoid.RootPart
	if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
		return
	end
	lastTeleport[player] = os.clock() -- definido antes de esperar, para um segundo toque não começar um segundo teleporte

	-- Olha para onde a face da frente do destino aponta (nivelado, nunca inclinado)
	local facing = destination.CFrame.LookVector * Vector3.new(1, 0, 1)
	if facing.Magnitude < 0.01 then
		facing = Vector3.new(0, 0, -1)
	end
	facing = facing.Unit
	-- Fica em pé na face de cima: o pivot de um personagem é a root part, então suba até a altura de ficar em pé.
	-- Um pad, em vez disso, põe os jogadores alguns studs à frente dele, porque um jogador em pé
	-- em cima de um pad o acionaria de novo no passo seguinte.
	local lift = destination.Size.Y / 2 + rootHeight(character, humanoid, rootPart)
	local top = destination.Position + destination.CFrame.UpVector * lift
	if besidePad then
		top += facing * (destination.Size.Z / 2 + PAD_ARRIVAL_GAP)
	end
	local target = CFrame.lookAlong(top, facing)

	-- Com o instance streaming ligado, carrega antes a área em volta do destino (até 2 segundos)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- saiu, renasceu ou morreu enquanto a área carregava
	end
	-- Um personagem sentado fica soldado ao assento, e movê-lo levaria o assento junto.
	-- Destruir o SeatWeld tira o personagem do assento antes.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Começa o cooldown de novo na chegada: o carregamento acima pode levar até 2 segundos,
	-- e o pad ao lado do qual ele chega não pode mandá-lo direto de volta
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- para um script de checagem de velocidade, se você tiver um
end

-- 1. Pads
if padFolder then
	for _, pad in padFolder:GetChildren() do
		if pad:IsA("BasePart") then
			pad.Touched:Connect(function(otherPart: BasePart)
				local player = playerFromHit(otherPart)
				local destinationName = pad:GetAttribute("Destination")
				if not player or typeof(destinationName) ~= "string" or onCooldown(player, PAD_COOLDOWN_SECONDS) then
					return
				end
				local destination = padFolder:FindFirstChild(destinationName)
				if destination and destination:IsA("BasePart") then
					teleportTo(player, destination, true)
				elseif not warnedPads[pad] then
					warnedPads[pad] = true -- avisa uma vez, não a cada toque
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. O menu: a lista de pontos, depois um pedido pelo nome
local function winsOf(player: Player): number
	local leaderstats = player:FindFirstChild("leaderstats")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	return if wins and wins:IsA("IntValue") then wins.Value else 0
end

local function winsNeeded(spot: Instance): number
	local value = spot:GetAttribute("WinsNeeded")
	return if typeof(value) == "number" then value else 0
end

getSpots.OnServerInvoke = function(_player: Player)
	local list = {}
	if spotFolder then
		for _, spot in spotFolder:GetChildren() do
			if spot:IsA("BasePart") then
				table.insert(list, { name = spot.Name, winsNeeded = winsNeeded(spot) })
			end
		end
	end
	table.sort(list, function(a, b)
		if a.winsNeeded ~= b.winsNeeded then
			return a.winsNeeded < b.winsNeeded
		end
		return a.name < b.name -- mesmas Wins: ordem alfabética, para a ordem nunca mudar
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- O cliente envia só um nome. Nunca aceite uma posição ou um CFrame de um cliente.
	if typeof(spotName) ~= "string" or #spotName > 50 or not spotFolder then
		return
	end
	if onCooldown(player, MENU_COOLDOWN_SECONDS) then
		return
	end
	local spot = spotFolder:FindFirstChild(spotName)
	if not (spot and spot:IsA("BasePart")) then
		return
	end
	if winsOf(player) < winsNeeded(spot) then
		return -- bloqueado para este jogador
	end
	teleportTo(player, spot, false)
end)

-- 3. Portais para outro place deste jogo
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- já está a caminho, ou tocou em um teleporte agora há pouco
	end
	lastTeleport[player] = os.clock()
	if RunService:IsStudio() then
		print(`Teleporters: would send {player.Name} to place {placeId}. Place teleports only work in the published game.`)
		return
	end
	leavingForPlace[player] = true
	for attempt = 1, PLACE_ATTEMPTS do
		local ok, err = pcall(function()
			TeleportService:TeleportAsync(placeId, { player })
		end)
		if ok then
			return
		end
		warn(`Teleporters: teleport attempt {attempt} for {player.Name} failed: {err}`)
		task.wait(2)
	end
	leavingForPlace[player] = nil -- desiste; tocar no portal de novo tenta de novo
end

-- Um teleporte também pode falhar depois de começar. O jogador fica aqui e pode tentar de novo.
TeleportService.TeleportInitFailed:Connect(function(player: Player, result: Enum.TeleportResult, message: string)
	warn(`Teleporters: {player.Name} could not leave ({result.Name}): {message}`)
	leavingForPlace[player] = nil
end)

if portalFolder then
	for _, portal in portalFolder:GetChildren() do
		if portal:IsA("BasePart") then
			portal.Touched:Connect(function(otherPart: BasePart)
				local player = playerFromHit(otherPart)
				local placeId = portal:GetAttribute("PlaceId")
				if player and typeof(placeId) == "number" and placeId > 0 then
					sendToPlace(player, placeId)
				end
			end)
		end
	end
end

Players.PlayerRemoving:Connect(function(player: Player)
	lastTeleport[player] = nil
	leavingForPlace[player] = nil
end)

O próprio Teleporters cria a RemoteFunction GetTeleportSpots e o RemoteEvent TeleportRequest, então não há nada para inserir à mão no ReplicatedStorage. Ele conecta os pads de TeleportPads e os portais de PlacePortals uma vez, quando o servidor começa, então pads e portais adicionados com o jogo rodando não fazem nada. Uma pasta que falta simplesmente desliga aquele tipo de teleporte.

O que cada parte do Teleporters faz
ParteO que fazPor quê
playerFromHitAcha o model do personagem a que a part que tocou pertence e pergunta ao Players:GetPlayerFromCharacter de quem ele é.Um pad é tocado por pés, chapéus e parts soltas. Tudo o que não faz parte do personagem de um jogador dá nil e é ignorado.
onCooldownCompara o os.clock() com a hora do último teleporte do jogador.Um cooldown por jogador, então um jogador parado perto de um pad nunca bloqueia mais ninguém. Nada espera nem dorme.
rootHeightCalcula a que altura do chão fica a root part de um personagem em pé: metade da altura da root part mais o HipHeight do Humanoid, mais o comprimento da perna em rigs R6.Esta é a fórmula da referência Humanoid.HipHeight da Roblox. O pivot de um personagem é a root part, então subir o pivot nessa medida põe os pés na superfície em avatares pequenos, grandes e R6.
As checagens no topo do teleportToRetorna, a não ser que o jogador tenha um personagem vivo com root part, e então registra a hora imediatamente.O pedido de streaming logo abaixo pode fazer o script esperar. Registrar a hora antes faz com que os muitos eventos Touched daquele instante não consigam começar um segundo teleporte.
O ponto de chegadaA face de cima do destino, elevada pelo rootHeight, olhando para onde a face da frente aponta, sem nenhuma inclinação. Em um pad, ele também anda 3 studs além da face da frente do pad.O personagem chega em pé, não dentro da part de destino. Ao lado de um pad, os pés começam na altura da face de cima do pad, então ele cai a espessura do pad até o chão. O CFrame.lookAlong monta um CFrame em uma posição, olhando em uma direção.
RequestStreamAroundAsyncPede ao Roblox para enviar antes àquele jogador a área em volta do ponto de chegada, esperando no máximo 2 segundos.O instance streaming vem ligado por padrão em places novos, então uma parte distante do mapa pode ainda não estar carregada no dispositivo do jogador. A Roblox recomenda esta chamada de servidor antes de mover um personagem para longe, embora ela não garanta o que chega.
A segunda checagemSe o jogador saiu, ou o personagem renasceu ou morreu durante a espera, nada se move.O jogador pode ter resetado ou saído do jogo enquanto a área carregava. O exemplo de carregamento antecipado da própria Roblox também confere se o personagem ainda está no jogo antes de movê-lo.
As linhas do SeatWeldSe o personagem está sentado, destrói o weld que o prende ao assento.O Roblox solda um personagem sentado ao assento. O PivotTo move as parts mudando o CFrame delas, e a referência da Roblox diz que definir o CFrame de uma part também move as parts unidas a ela, então sem isso o assento, e tudo o que estiver soldado a ele, chegaria junto com o jogador. Destruir o SeatWeld é como a referência do Seat da Roblox tira um personagem de um assento por script.
character:PivotTo(target)Move o personagem inteiro, todos os membros e acessórios juntos, até o ponto de chegada.A Roblox chama o PivotTo de a principal função para mover models por script.
A segunda linha do lastTeleportComeça o cooldown de novo na chegada.O pedido de streaming pode levar até 2 segundos, o mesmo que o próprio cooldown dos pads, então sem esta linha um jogador poderia chegar sem cooldown nenhum sobrando.
MovementCheckSkipDefine um atributo no Player depois de cada movimento.Uma checagem de velocidade no servidor veria o salto como trapaça. O MovementCheck do guia de corrida lê esse atributo e recomeça a medir a partir da posição nova. Sem um script desses, o atributo não faz nada.
As configurações no topo do Teleporters
ConfiguraçãoValor aquiO que muda
PAD_COOLDOWN_SECONDS2Por quanto tempo os pads e os portais ignoram um jogador depois de qualquer teleporte.
MENU_COOLDOWN_SECONDS3O menor intervalo entre dois teleportes de menu de um jogador. Os pads e o menu dividem um relógio por jogador, então um pedido do menu até 3 segundos depois de um teleporte de pad também é ignorado.
PAD_ARRIVAL_GAP3Quantos studs além da face da frente de um pad de destino os jogadores chegam, para ficarem ao lado do pad, não em cima dele.
PLACE_ATTEMPTS3Quantas vezes um portal tenta o TeleportAsync, com 2 segundos de intervalo, antes de desistir.

Aperte Play agora e pise no PadA: você aparece à frente do PadB. O menu e os portais precisam dos dois próximos passos, mas o script já roda sem eles.

Passo 4: Teleporte para outro place

Um place é um mundo separado dentro do seu jogo, com os próprios servidores: um lobby e uma dungeon, ou um hub e um conjunto de fases. Os jogadores passam de um place a outro com o TeleportService, e o Roblox só o roda no jogo publicado, então este passo termina no app do Roblox e não no Studio.

  1. Se o jogo ainda não foi publicado, escolha File > Publish. Jogos novos ficam abertos só para você, para quem você dá acesso de Edit e para membros do grupo com os cargos certos até você lançar, e isso é tudo o que você precisa para testar os teleportes por conta própria.
  2. Crie o segundo place: abra um place novo a partir de qualquer template do Studio, monte a sua dungeon, depois escolha File > Publish As, clique no bloco do seu jogo, selecione Add as a new place e clique em Create.
  3. Copie o ID do place novo. Abra o Asset Manager pelo menu Window ou pela aba Home, vá em Places In Experience, clique com o botão direito no place e escolha Copy Asset ID, que copia o place ID dele.
  4. De volta ao primeiro place, insira no Workspace uma Folder chamada PlacePortals, e dentro dela uma Part ancorada chamada DungeonPortal. Adicione um atributo Number chamado PlaceId e cole o ID como valor.
  5. Aperte Play e toque no portal. O Output imprime uma linha que começa com Teleporters: would send: é tudo o que um portal faz no Studio.
  6. Publique de novo com File > Publish, para o jogo publicado ter o portal, e teste pelo app do Roblox como no Passo 5.

O Teleporters chama o TeleportAsync dentro de pcall, até 3 vezes com 2 segundos entre as tentativas, porque a página de teleporte da Roblox diz que os teleportes podem falhar e lançar um erro, e recomenda tentar de novo. Um teleporte também pode começar e falhar no último momento sem erro, deixando o jogador onde estava. O Roblox dispara o TeleportInitFailed nesse caso, e o script limpa a marca de "saindo" do jogador, então tocar no portal de novo tenta de novo.

Para trazer os jogadores de volta, faça o mesmo no outro place: coloque uma cópia do Teleporters no ServerScriptService dele e adicione um portal cujo PlaceId é o ID do seu primeiro place, copiado do Asset Manager do mesmo jeito.

Quem pode entrar nos seus outros places

A documentação de segurança da Roblox avisa que, assim que um cliente está dentro de um place do seu jogo, ele pode se teleportar para qualquer outro place dele, seja qual for o caminho que você planejou, e que desligar o Direct Access de um place só remove o botão Join do site. A configuração que muda isso é Access Control for Places, em Audience > Access Settings no Creator Dashboard:

As três configurações de Access Control for Places
ConfiguraçãoQuem pode entrar em um place que não é o place inicial
Fully openQualquer um, por teleportes de qualquer jogo, deep links, convites de jogo e entrando com um amigo.
Limited to same universeSó jogadores que se teleportam de dentro dos seus jogos. Teleportes de cliente e de servidor são permitidos.
Secure within universe onlySó jogadores que os seus scripts de servidor teleportam de dentro deste jogo.

Se os jogadores só devem chegar a um place pelo seu portal, uma dungeon por exemplo, escolha Secure within universe only. Todo teleporte deste guia começa no servidor, então continua funcionando. A Roblox também diz que muitos jogos não precisam de teleportes seguros, então um jogo cujos places são todos abertos para todo mundo pode deixar como está.

O que os tutoriais antigos de teleporte erram

Se você está comparando este guia com um vídeo ou um post de fórum, estas são as diferenças que importam, com o motivo de cada padrão ser um problema.

Padrões comuns em tutoriais de teleporte, e o que este guia faz no lugar
O tutorialO problemaEste guia
Define hit.Parent.HumanoidRootPart.Position = target.PositionA referência da Roblox diz que definir a Position atualiza as juntas da part para ela se mover em relação às parts a que está unida: a root part se move sem o corpo.Move o personagem inteiro com PivotTo.
Define HumanoidRootPart.CFrame = target.CFrameO meio do personagem cai no meio da part de destino, em parte dentro dela, e assume a inclinação da part.Chega na altura de ficar em pé acima da face de cima, ao lado de um pad, mantido nivelado.
Usa uma variável debounce para o pad inteiroEnquanto um jogador se teleporta, o pad ignora todos os outros. Sem debounce nenhum, um jogador que cai no outro pad é mandado direto de volta.Um cooldown por jogador, registrado antes de qualquer espera, e os jogadores chegam ao lado do pad.
Chama TeleportService:Teleport(placeId, player) em um LocalScriptA Roblox marca o Teleport() como obsoleto, diz para não usar em trabalhos novos, e só permite o TeleportAsync em scripts de servidor.Chama o TeleportAsync no script de servidor.
Sem pcall, sem nova tentativaA página de teleporte da Roblox diz que os teleportes podem falhar e lançar um erro, e também podem falhar depois de começar.Até 3 tentativas em pcall, e o TeleportInitFailed deixa o jogador tentar de novo.
Desiste porque "não funciona" no StudioO TeleportService não funciona em testes no Studio.O RunService:IsStudio() imprime o que o portal teria feito.
Uma GUI de teleporte cujos botões enviam uma posiçãoUm trapaceiro pode disparar o mesmo remote com qualquer posição.Os botões enviam o nome de um ponto, e o servidor o procura.
Moedas passadas nos dados do teleporteA Roblox diz que os dados de teleporte são visíveis para o cliente e não são criptografados.Manda você guardar moedas e Wins em um data store e carregar no outro place (veja Leve dados para o outro place).

O que os jogadores conseguem e não conseguem falsificar

Parta do princípio de que um trapaceiro controla tudo no próprio dispositivo: ele pode editar o TeleportMenu, disparar os dois remotes quantas vezes quiser com quaisquer argumentos, e mover o próprio personagem. Veja o que isso rende a ele com este teleporte.

O que um trapaceiro pode tentar, e o que o Teleporters faz a respeito
O trapaceiro tentaResultadoPor quê
Enviar uma posição ou um CFrame pelo remote do menuIgnoradoO TeleportRequest lê uma string, o nome de um ponto com até 50 caracteres. Todo o resto é descartado.
Pedir o Castle sem 3 WinsRecusadoO servidor lê as Wins da própria cópia do leaderstats. O botão cinza é só uma dica.
Pedir um ponto que não existeIgnoradoO servidor procura o nome em TeleportSpots e não faz nada se nenhuma part tem esse nome.
Disparar o remote do menu sem pararNo máximo um teleporte de menu a cada 3 segundosO cooldown fica no servidor, por jogador.
Acionar um pad sem andar até eleEle chega ao pad parceiro, aonde poderia ir andando de qualquer jeitoA Roblox lista teleportar para qualquer posição e manipular eventos Touched entre as coisas que um cliente pode fazer com o próprio personagem.
Entrar direto em outro place do seu jogoPossível, a não ser que Access Control for Places esteja em Secure within universe onlyVeja Quem pode entrar nos seus outros places.
Mover o próprio personagem para qualquer lugar, inclusive um ponto bloqueadoPossívelCada dispositivo controla o movimento do próprio personagem. Um ponto bloqueado é uma conveniência, não um cofre, então confira no servidor antes de entregar ali qualquer coisa de valor.

A última linha é o limite honesto de qualquer teleporte. Em um jogo competitivo, adicione uma checagem de movimento no servidor como a do guia de corrida. O Teleporters já define o atributo MovementCheckSkip que essa checagem lê, então os teleportes dele não são sinalizados: a documentação de segurança da Roblox diz que jogos com teleportes legítimos precisam exatamente desse tipo de exceção nas checagens de movimento.

Passo 5: Teste

  1. Aperte Play. Pise no PadA: você aparece logo à frente do PadB, de costas para ele. Vire e pise direto de volta no PadB: nada acontece, porque os pads ignoram você por 2 segundos depois da chegada. Saia de cima, espere 2 segundos e ande para o PadB de novo: você aparece à frente do PadA.
  2. Espere alguns segundos, depois clique em Teleport à esquerda da tela. A lista mostra Lake, Spawn e "Castle (needs 3 wins)" em cinza. Escolha Lake: você aparece em cima dele. Abra o menu de novo e escolha Castle: nada acontece, e o Output fica quieto.
  3. Dê 3 Wins a você mesmo (isso precisa de um script de leaderstats com um IntValue Wins, como o do guia de leaderboard). Clique no botão Client/Server para mudar para Server, ache Players, o seu nome, leaderstats, Wins no Explorer e defina o Value como 3 na janela Properties. Volte para Client e abra o menu de novo: o Castle está roxo e leva você até lá.
  4. Toque no DungeonPortal. O Output imprime uma linha que começa com Teleporters: would send, com o seu nome e o place ID. Isso é o esperado no Studio, e ela é impressa no máximo uma vez a cada 2 segundos, não importa quanto tempo você fique em cima do portal.
  5. Escolha Server & Clients no menu de modo de teste, defina 2 clientes e aperte Play. Os dois jogadores conseguem usar os pads ao mesmo tempo, e o cooldown de um nunca bloqueia o outro.
  6. Pare o teste, publique e jogue pelo app do Roblox. Toque no portal: a tela de carregamento do Roblox aparece e você chega ao outro place. Se você ficar onde está, abra o Developer Console com F9, mude o log para a visão Server, que só o dono do jogo e membros do grupo com permissão de edição conseguem ver, e procure os avisos Teleporters:, que incluem o motivo que o Roblox deu.

Mantenha a janela Output aberta (menu Window, depois Output) durante os passos no Studio. O Teleporters não imprime nada quando funciona, fora a linha do portal do passo 4, então vale a pena ler qualquer aviso ou erro vermelho. Veja os Erros comuns.

Indo além

Teleporte um time ou um grupo junto

O TeleportAsync recebe uma lista de jogadores, então um portal pode mandar um grupo inteiro para o mesmo place. A página de teleporte da Roblox sugere partir do jogador que tocou no portal: player.Team e Team:GetPlayers() para um time, ou SocialService:GetPlayersByPartyId() com player.PartyId para uma party. Passe essa lista em vez de { player }, e defina a marca leavingForPlace para cada jogador dela.

Mande um grupo para o próprio servidor

Por padrão, os jogadores teleportados entram em um servidor público do outro place. Para mandar um grupo para um servidor reservado novo, por exemplo para uma partida, crie um TeleportOptions, defina o ShouldReserveServer dele como true e passe como terceiro argumento: TeleportService:TeleportAsync(placeId, players, options). A Roblox avisa que as falhas com servidores reservados em especial se beneficiam de novas tentativas, o que o script já faz.

Leve dados para o outro place

Teleportar descarta os dados locais daquele jogador. Os dados de teleporte da Roblox, definidos com TeleportOptions:SetTeleportData() e lidos no outro place com player:GetJoinData(), são visíveis para o cliente e não são criptografados, então use só para escolhas inofensivas, como qual mapa carregar. Guarde moedas, Wins e itens em um data store, como no tutorial de DataStore, e carregue de novo quando o jogador chegar ao outro place.

Uma tela de carregamento própria

Enquanto um teleporte de place carrega, os jogadores veem a tela de carregamento padrão do Roblox. Para mostrar a sua, chame TeleportService:SetTeleportGui() no cliente com um ScreenGui, por exemplo um guardado no ReplicatedStorage. Os teleportes deste guia começam no servidor, então o cliente precisa chamar com antecedência, por exemplo assim que o jogador entra. A Roblox diz que a tela precisa ser definida de novo antes de cada teleporte e não é usada para um place de outro jogo. Ela também avisa que os scripts dentro desse ScreenGui não rodam, então faça uma tela parada.

Teleportes de rodada e checkpoints

O sistema de rodadas leva todos os jogadores para a arena com o mesmo tipo de chamada PivotTo no começo de cada rodada, e PivotTo ou SpawnLocations (em inglês), no guia de obby, compara esta abordagem com os pontos de spawn do Roblox. Se um ponto só deve abrir depois de uma rodada, o sistema de rodadas já dá as Wins que o WinsNeeded lê.

Erros comuns e como resolver

Abra a janela Output (menu Window, depois Output) antes de apertar Play. O Teleporters diz o nome do pad quando um Destination não aponta para lugar nenhum, então a maioria dos problemas aparece ali.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'

O TeleportMenu está esperando o remote que o Teleporters cria, então o Teleporters não está rodando. Confira que ele é um Script, não um LocalScript, direto dentro do ServerScriptService, que não está desativado, e que o Output não mostra nenhum erro vermelho dele. O guia de erros de script explica esse aviso em detalhe.

Teleporters: PadA points to PadC, which is not a part in TeleportPads

O atributo Destination do pad aponta para algo que não é uma part direto dentro da pasta TeleportPads. Confira a grafia e as maiúsculas do valor do atributo e do nome do pad de destino. O aviso aparece uma vez por pad, na primeira vez que um jogador toca nele.

Pisar em um pad não faz nada

Confira que a pasta se chama exatamente TeleportPads e fica direto no Workspace quando o jogo começa, que o atributo Destination do pad é uma String (um atributo Number é ignorado), e que você esperou 2 segundos desde o último teleporte. Confira também que o CanTouch do pad está ligado: a Roblox diz que conectar o Touched a uma part com o CanTouch desligado lança um erro, o que para o script.

Eu caio dentro de uma parede ou para fora da borda

Os jogadores chegam 3 studs à frente da face da frente do pad de destino. Clique com o botão direito no pad, escolha Show Orientation Indicator e gire o pad até a linha azul apontar para chão livre. Os pontos do menu põem os jogadores em cima da part, então deixe cada ponto em um chão.

O botão Castle continua cinza depois que eu ganhei 3 Wins

A lista é desenhada quando o menu abre, então feche o menu e abra de novo. Se continuar cinza, confira que o leaderstats tem um IntValue chamado exatamente Wins, e que as Wins mudaram no servidor, não só no modo Client.

O portal não faz nada no jogo publicado

Abra o Developer Console com F9, mude o log para a visão Server (só o dono do jogo e membros do grupo com permissão de edição a veem, porque o Teleporters é um Script de servidor) e leia os avisos Teleporters:, que incluem o motivo que o Roblox deu. Confira que o atributo PlaceId do portal é um Number com o ID do Asset Manager, e que você publicou o place de novo depois de adicionar o portal.

Crie com o RoCode

Se você prefere não ligar tudo isso à mão, o RoCode pode construir no jogo que você tem aberto. O RoCode é um agente de IA independente para Roblox Studio, não feito pela Roblox: você descreve a funcionalidade no chat dele na web, e o plugin dele para o Studio cria as parts e os scripts no seu Explorer, então você não fica copiando código de uma janela de chat.

Você digita

Adicione teleportes: pads em Workspace.TeleportPads que mandam os jogadores para o pad com o nome que está no atributo Destination, com cooldown de 2 segundos, um menu Teleport para os pontos de Workspace.TeleportSpots em que o Castle exige 3 Wins, conferidas no servidor, e portais em Workspace.PlacePortals que mandam os jogadores para o place ID do atributo PlaceId, com novas tentativas.

O RoCode faz
  • Pode olhar o seu jogo quando um passo precisa, com Search Game e Search Scripts, para aproveitar itens, remotes ou código de salvamento que você já tem em vez de adicionar um segundo sistema
  • Cria as pastas e as parts dos pads com Create Instance e define as propriedades delas com Set Property, e escreve o Teleporters e o TeleportMenu com Create Script
  • É instruído a checar a compilação de cada script que escreve com Check Script, que compila o script no Studio sem rodá-lo
  • Envia as mudanças em lotes, e cada lote é um ponto de desfazer no histórico do Studio

Os teleportes de place só rodam no jogo publicado, então teste esses você mesmo no app do Roblox. Com o plugin 3.9 ou mais recente, o RoCode pode rodar um teste curto e ler os erros, e com o plugin 3.9.15 ou mais recente o personagem de teste dele consegue pisar em pads e clicar em botões de menu, mas ele confere só o que escolheu testar, então pise nos pads e abra o menu você mesmo. Um teleporte é um sistema entre muitos em um jogo; criar um jogo inteiro com o RoCode funciona assim, um sistema por prompt. Como o RoCode se conecta ao Studio.

Perguntas frequentes

Como fazer um pad de teleporte no Roblox Studio?

Dê a duas parts um atributo Destination com o nome uma da outra, depois deixe um script de servidor mover quem tocar em um pad com character:PivotTo para um ponto logo à frente do outro pad, com um cooldown curto por jogador. O Passo 1 e o Passo 2 montam exatamente isso.

Por que o meu teleporte não funciona no Studio?

Pads e menus funcionam no Studio. Teleportes para outro place, não: o TeleportService da Roblox não funciona em testes no Studio, então publique o jogo e teste no app do Roblox. O script deste guia imprime o que um portal teria feito, então você ainda consegue conferir que ele dispara.

Como teleportar jogadores para outro place do meu jogo?

Adicione o place com File > Publish As (Add as a new place), copie o place ID dele no Asset Manager e chame TeleportService:TeleportAsync(placeId, { player }) em um Script de servidor dentro de pcall, tentando de novo se falhar. O Passo 4 mostra o caminho todo.

Como fazer uma GUI de teleporte?

Monte os botões em um LocalScript e envie ao servidor só o nome do ponto que o jogador escolheu. O servidor procura o nome em uma pasta, confere o cooldown e qualquer regra de desbloqueio, depois move o personagem. Nunca envie uma posição do cliente: um trapaceiro pode enviar a posição que quiser.

Por que o meu personagem trava ou se desmonta depois de teleportar?

Definir a Position da root part move só aquela part, não o corpo unido a ela, e copiar o CFrame de um pad põe o meio do personagem dentro do pad. Use character:PivotTo com um ponto na altura de ficar em pé acima do chão, calculado a partir do HipHeight do Humanoid.

Dá para enviar moedas ou itens com um teleporte?

Não com segurança. A Roblox diz que os dados de teleporte são visíveis para o cliente e não são criptografados, então servem para algo como um mapa escolhido, não para moedas. Salve moedas e itens em um data store e carregue no outro place.

Fontes e leitura extra

Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 12 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.