La respuesta corta
Para una plataforma de teletransporte, pon un Script en ServerScriptService que escuche el evento Touched de la plataforma, encuentre al jugador con Players:GetPlayerFromCharacter y mueva el personaje entero con character:PivotTo() a un punto justo delante de la plataforma de destino, de espaldas a ella, con un tiempo de espera de un par de segundos por jugador para que la plataforma de destino no lo devuelva de inmediato. Para enviar jugadores a otro place de tu juego, llama a TeleportService:TeleportAsync(placeId, { player }) desde un Script del servidor dentro de pcall; solo funciona en el juego publicado, no en Studio.
- Mueve el personaje entero con
PivotTo. AsignarHumanoidRootPart.Positionsepara la parte raíz del resto del cuerpo, porque Roblox actualiza las uniones cuando se asigna Position. - Un menú de teletransporte debe enviar al servidor el nombre de un destino, nunca una posición. El servidor comprueba el nombre, el tiempo de espera y cualquier regla de desbloqueo antes de mover a nadie.
TeleportService:Teleport()está obsoleto y es del cliente. UsaTeleportAsyncen el servidor, envuélvelo enpcall, reintenta y manejaTeleportInitFailed.
En esta página
Dos tipos de teletransporte
Un teletransportador puede ser tres cosas en un juego de Roblox: una plataforma que te envía al otro lado del mapa, un menú de puntos a los que saltar, o un portal a otro nivel. Las dos primeras mueven un personaje dentro del servidor en el que ya está el jugador. La tercera envía al jugador a un place distinto de tu juego, que se ejecuta en sus propios servidores. Usan APIs distintas, así que ayuda saber cuál necesitas.
| Dentro del mismo servidor | A otro place de tu juego | |
|---|---|---|
| La llamada | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Se usa para | Plataformas de teletransporte, un menú de teletransporte, mover jugadores del lobby a una arena | Portales a otro nivel, un lobby que envía a los jugadores a un place aparte de mazmorra o de partida |
| Se ejecuta en | Un Script del servidor | Solo un Script del servidor. El Teleport() del cliente está obsoleto. |
| Funciona en una prueba en Studio | Sí | No. El TeleportService de Roblox no admite pruebas de juego en Studio, así que se prueba en el juego publicado. |
| Qué ve el jugador | Un salto por el mapa, que puede tardar hasta 2 segundos si esa zona tiene que cargar primero | La pantalla de carga de Roblox, y luego el otro place |
| Monedas, objetos y otros datos | Se quedan como están | Roblox descarta los datos locales del jugador, así que todo lo que importa tiene que salir de un data store en el otro place |
Esta guía construye los tres tipos en un solo Script del servidor, así que un mismo conjunto de reglas cubre todos los teletransportes de tu juego: el servidor decide, cada jugador tiene su propio tiempo de espera, y el dispositivo del jugador solo dice a qué punto le gustaría ir.
| Pieza | Dónde va | Qué hace |
|---|---|---|
Folder TeleportPads con PadA y PadB | Workspace | Dos plataformas. El atributo Destination de cada una nombra la plataforma a la que envía a los jugadores. |
Folder TeleportSpots | Workspace | Una parte por cada punto que muestra el menú. Un atributo WinsNeeded bloquea un punto. |
Folder PlacePortals | Workspace | Partes portal. El atributo PlaceId de cada portal es el place al que envía a los jugadores. |
Script Teleporters | ServerScriptService | Maneja los tres tipos de teletransporte y crea los dos remotes. Es el único lugar donde puede ocurrir un teletransporte. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Dibuja el botón Teleport y la lista de puntos, y envía el nombre del punto que elige el jugador. |
RemoteFunction GetTeleportSpots y RemoteEvent TeleportRequest | ReplicatedStorage (los crea Teleporters) | La primera devuelve la lista de puntos al menú. El segundo lleva al servidor el nombre elegido. |
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
Paso 1: construye dos plataformas de teletransporte
- En el Explorer, pasa el ratón sobre Workspace, haz clic en el botón + e inserta una Folder. Llámala
TeleportPads. El script busca este nombre exacto. - Inserta dos Parts en la carpeta y llámalas
PadAyPadB. Haz que cada una sea una losa plana, por ejemplo de 6 por 1 por 6 studs, y colócalas en el suelo a cierta distancia una de otra. En la ventana Properties, marca Anchored, deja CanCollide y CanTouch activados, y dales un color vivo y el material Neon para que los jugadores las vean. - Selecciona PadA, baja hasta la sección Attributes de la ventana Properties y haz clic en +. Escribe el nombre
Destination, elige el tipo String y haz clic en Save; luego pon su valor enPadB. Haz lo mismo en PadB con el valorPadA. - Gira cada plataforma para que su cara frontal apunte a suelo libre. Los jugadores llegan 3 studs por delante de la cara frontal de la plataforma de destino, de espaldas a ella, así que deja unos studs de suelo libre ahí. Para ver cuál es la cara frontal, haz clic derecho en la plataforma y elige Show Orientation Indicator: una línea azul marca la cara frontal. Gira la plataforma con la herramienta Rotate hasta que esa línea apunte hacia donde deben salir caminando los jugadores.
Los jugadores caen al lado de la plataforma, no encima, a propósito. La página de debounce de Roblox indica que Touched se dispara muchas veces seguidas por un solo contacto, así que un jugador que llegara encima de la otra plataforma la activaría otra vez en cuanto se acabara su tiempo de espera, y rebotaría de vuelta al otro lado del mapa.
No estás limitado a dos plataformas. El Destination de una plataforma puede nombrar cualquier parte de TeleportPads, así que tres plataformas pueden enviar a los jugadores en círculo. Para una plataforma de un solo sentido, apúntala a una parte de TeleportPads que no tenga Destination propio: esa parte recibe jugadores y no envía a nadie a ningún lado.
Paso 2: añade el script de teletransporte
Pasa el ratón sobre ServerScriptService, inserta un Script, llámalo Teleporters y pega el código de abajo. Maneja las plataformas ahora, y el menú y los portales de los pasos siguientes, así que lo añades una sola vez. Los ajustes del principio son las líneas pensadas para que las cambies.
-- Script en ServerScriptService llamado Teleporters.
-- Todos los teletransportes se deciden aquí, en el servidor:
-- 1. Plataformas: tocar una parte de Workspace.TeleportPads te lleva a la parte que nombra
-- su atributo Destination.
-- 2. Un menú: el LocalScript TeleportMenu pide un punto de Workspace.TeleportSpots
-- por su nombre. El servidor comprueba el nombre, el tiempo de espera y las Wins que pide el punto.
-- 3. Portales: tocar una parte de Workspace.PlacePortals te envía al place
-- de su atributo PlaceId (otro place de este juego).
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 -- las plataformas ignoran a un jugador este tiempo después de cualquier teletransporte
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs por delante de una plataforma de destino, para que los jugadores caigan a su lado
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Este script crea los dos remotes por su cuenta, así que no los añadas a mano
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 qué altura sobre el suelo queda la parte raíz de un personaje de pie.
-- La fórmula es de la referencia de Humanoid.HipHeight de Roblox (los rigs R6 suman la altura de la pierna).
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() -- se pone antes de esperar, para que un segundo toque no pueda empezar un segundo teletransporte
-- Mira hacia donde apunta la cara frontal del destino (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
-- De pie sobre su cara superior: el pivote de un personaje es su parte raíz, así que súbelo a la altura de estar de pie.
-- Una plataforma pone a los jugadores unos studs por delante de ella, porque un jugador parado
-- sobre una plataforma la activaría otra vez con el siguiente paso.
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)
-- Con el streaming de instancias activado, carga primero la zona alrededor del destino (hasta 2 segundos)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- se fue, reapareció o murió mientras cargaba la zona
end
-- Un personaje sentado está soldado a su asiento, y moverlo se llevaría el asiento.
-- Destruir el SeatWeld saca primero al personaje del asiento.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Empieza otra vez el tiempo de espera al llegar: la carga previa de arriba puede tardar hasta 2 segundos,
-- y la plataforma donde cae no debe devolverlo de inmediato
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- para un script de control de velocidad, si tienes uno
end
-- 1. Plataformas
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 una vez, no en cada toque
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. El menú: la lista de puntos, y luego una petición por nombre
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 -- mismas Wins: orden alfabético, para que el orden nunca cambie
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- El cliente envía solo un nombre. Nunca aceptes una posición o un CFrame de un 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 jugador
end
teleportTo(player, spot, false)
end)
-- 3. Portales a otro place de este juego
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- ya va en camino, o tocó un teletransportador hace un momento
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 -- se rinde; tocar el portal otra vez lo intenta de nuevo
end
-- Un teletransporte también puede fallar después de empezar. El jugador se queda aquí y puede intentarlo otra vez.
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)
Teleporters crea la RemoteFunction GetTeleportSpots y el RemoteEvent TeleportRequest por su cuenta, así que no hay nada que insertar a mano en ReplicatedStorage. Conecta las plataformas de TeleportPads y los portales de PlacePortals una sola vez, cuando empieza el servidor, así que las plataformas y los portales que se añaden con el juego en marcha no hacen nada. Si falta una carpeta, simplemente se desactiva ese tipo de teletransporte.
| Parte | Qué hace | Por qué |
|---|---|---|
playerFromHit | Encuentra el modelo de personaje al que pertenece la parte que tocó y le pregunta a Players:GetPlayerFromCharacter de quién es. | A una plataforma la tocan pies, sombreros y partes sueltas. Todo lo que no es parte del personaje de un jugador da nil y se ignora. |
onCooldown | Compara os.clock() con la hora del último teletransporte del jugador. | Un tiempo de espera por jugador, así que un jugador parado cerca de una plataforma nunca bloquea a los demás. Nada espera ni se duerme. |
rootHeight | Calcula a qué altura sobre el suelo queda la parte raíz de un personaje de pie: la mitad de la altura de la parte raíz más el HipHeight del Humanoid, más el largo de la pierna en los rigs R6. | Es la fórmula de la referencia de Humanoid.HipHeight de Roblox. El pivote de un personaje es su parte raíz, así que subir el pivote esa cantidad pone los pies sobre la superficie tanto en avatares pequeños como grandes y R6. |
Las comprobaciones del principio de teleportTo | Hace return a menos que el jugador tenga un personaje vivo con parte raíz, y luego registra la hora de inmediato. | La petición de streaming de abajo puede hacer esperar al script. Registrar la hora primero hace que los muchos eventos Touched de ese momento no puedan empezar un segundo teletransporte. |
| El punto de llegada | La cara superior del destino, elevada por rootHeight, mirando hacia donde apunta su cara frontal y sin ninguna inclinación. En una plataforma, además se desplaza 3 studs más allá de su cara frontal. | El personaje llega erguido, no dentro de la parte de destino. Al lado de una plataforma sus pies empiezan a la altura de la cara superior de la plataforma, así que cae el grosor de la plataforma hasta el suelo. CFrame.lookAlong construye un CFrame en una posición, mirando en una dirección. |
RequestStreamAroundAsync | Le pide a Roblox que envíe primero a ese jugador la zona alrededor del punto de llegada, esperando como máximo 2 segundos. | El streaming de instancias viene activado por defecto en los places nuevos, así que una parte lejana del mapa puede no estar cargada todavía en el dispositivo del jugador. Roblox recomienda esta llamada del servidor antes de mover un personaje a un lugar lejano, aunque no garantiza qué llega. |
| La segunda comprobación | Si el jugador se fue, o el personaje reapareció o murió durante la espera, nada se mueve. | El jugador pudo haberse reiniciado o haber salido del juego mientras cargaba la zona. El propio ejemplo de carga previa de Roblox también comprueba que el personaje sigue en el juego antes de moverlo. |
Las líneas de SeatWeld | Si el personaje está sentado, destruye el weld que lo sujeta al asiento. | Roblox suelda un personaje sentado a su asiento. PivotTo mueve las partes cambiando su CFrame, y la referencia de Roblox dice que asignar el CFrame de una parte también mueve las partes unidas a ella, así que sin esto el asiento, y todo lo que tenga soldado, llegaría con el jugador. Destruir el SeatWeld es la forma en que la referencia de Seat de Roblox saca a un personaje de un asiento desde un script. |
character:PivotTo(target) | Mueve el personaje entero, con todas sus extremidades y accesorios juntos, al punto de llegada. | Roblox describe PivotTo como la función principal para mover modelos desde scripts. |
La segunda línea de lastTeleport | Empieza otra vez el tiempo de espera al llegar. | La petición de streaming puede tardar hasta 2 segundos, lo mismo que el propio tiempo de espera de las plataformas, así que sin esta línea un jugador podría llegar sin tiempo de espera restante. |
MovementCheckSkip | Pone un atributo en el Player después de cada movimiento. | Un control de velocidad en el servidor vería el salto como una trampa. El MovementCheck de la guía de sprint lee este atributo y empieza a medir otra vez desde la nueva posición. Sin un script así, el atributo no hace nada. |
| Ajuste | Valor aquí | Qué cambia |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Cuánto tiempo ignoran las plataformas y los portales a un jugador después de cualquier teletransporte. |
MENU_COOLDOWN_SECONDS | 3 | El intervalo mínimo entre dos teletransportes del menú para un jugador. Las plataformas y el menú comparten un reloj por jugador, así que una petición del menú hecha menos de 3 segundos después de un teletransporte de plataforma también se ignora. |
PAD_ARRIVAL_GAP | 3 | Cuántos studs más allá de la cara frontal de una plataforma de destino llegan los jugadores, para que caigan al lado de la plataforma y no encima. |
PLACE_ATTEMPTS | 3 | Cuántas veces intenta un portal TeleportAsync, con 2 segundos entre intentos, antes de rendirse. |
Pulsa Play ahora y pisa PadA: apareces delante de PadB. El menú y los portales necesitan los dos pasos siguientes, pero el script ya funciona sin ellos.
Paso 4: teletransporta a otro place
Un place es un mundo aparte dentro de tu juego, con sus propios servidores: un lobby y una mazmorra, o un hub y un conjunto de niveles. Los jugadores pasan de un place a otro con TeleportService, y Roblox lo ejecuta solo en el juego publicado, así que este paso termina en la app de Roblox y no en Studio.
- Si el juego todavía no está publicado, elige File > Publish. Los juegos nuevos están abiertos solo para ti, para las personas a las que les das acceso Edit y para los miembros del grupo con los roles adecuados hasta que los lanzas, que es todo lo que necesitas para probar los teletransportes tú mismo.
- Crea el segundo place: abre un place nuevo desde cualquier plantilla de Studio, construye tu mazmorra, luego elige File > Publish As, haz clic en la tarjeta de tu juego, selecciona Add as a new place y haz clic en Create.
- Copia el ID del place nuevo. Abre el Asset Manager desde el menú Window o la pestaña Home, ve a Places In Experience, haz clic derecho en el place y elige Copy Asset ID, que copia su place ID.
- De vuelta en tu primer place, inserta en Workspace una Folder llamada
PlacePortals, y dentro una Part anclada llamadaDungeonPortal. Añade un atributo Number llamadoPlaceIdy pega el ID como su valor. - Pulsa Play y toca el portal. Output imprime una línea que empieza por
Teleporters: would send: eso es todo lo que hace un portal en Studio. - Publica otra vez con File > Publish, para que el juego publicado tenga el portal, y pruébalo desde la app de Roblox como en el paso 5.
Teleporters llama a TeleportAsync dentro de pcall, hasta 3 veces con 2 segundos entre intentos, porque la página de teletransportes de Roblox dice que los teletransportes pueden fallar y lanzar un error, y recomienda reintentar. Un teletransporte también puede empezar y luego fallar en el último momento sin error, dejando al jugador donde estaba. Roblox dispara TeleportInitFailed para eso, y el script limpia la marca de "saliendo" del jugador, así que tocar el portal otra vez lo intenta de nuevo.
Para traer de vuelta a los jugadores, haz lo mismo en el otro place: pon una copia de Teleporters en su ServerScriptService y añade un portal cuyo PlaceId sea el ID de tu primer place, copiado del Asset Manager de la misma forma.
Quién puede entrar a tus otros places
La documentación de seguridad de Roblox advierte que, una vez que un cliente está dentro de un place de tu juego, puede teletransportarse a cualquier otro place del juego, sea cual sea la ruta que tenías pensada, y que desactivar el Direct Access de un place solo quita el botón Join del sitio web. El ajuste que cambia esto es Access Control for Places, en Audience > Access Settings del Creator Dashboard:
| Ajuste | Quién puede entrar a un place que no es el place inicial |
|---|---|
| Fully open | Cualquiera, mediante teletransportes desde cualquier juego, enlaces directos, invitaciones al juego y unirse a un amigo. |
| Limited to same universe | Solo los jugadores que se teletransportan desde dentro de tus juegos. Se permiten los teletransportes tanto del cliente como del servidor. |
| Secure within universe only | Solo los jugadores que tus scripts del servidor teletransportan desde dentro de este juego. |
Si los jugadores solo deben llegar a un place por tu portal, una mazmorra por ejemplo, elige Secure within universe only. Todos los teletransportes de esta guía empiezan en el servidor, así que siguen funcionando. Roblox también dice que muchos juegos no necesitan teletransportes seguros, así que un juego cuyos places están todos abiertos para todo el mundo puede dejarlo como está.
En qué fallan los tutoriales de teletransporte antiguos
Si estás comparando esta guía con un video o una publicación de un foro, estas son las diferencias que importan, con la razón por la que cada patrón es un problema.
| El tutorial | El problema | Esta guía |
|---|---|---|
Hace hit.Parent.HumanoidRootPart.Position = target.Position | La referencia de Roblox dice que asignar Position actualiza las uniones de la parte para que se mueva respecto a las partes a las que está unida: la parte raíz se mueve sin el cuerpo. | Mueve el personaje entero con PivotTo. |
Hace HumanoidRootPart.CFrame = target.CFrame | El centro del personaje cae en el centro de la parte de destino, en parte dentro de ella, y toma la inclinación de la parte. | Llega a la altura de estar de pie sobre la cara superior, al lado de una plataforma, y nivelado. |
Usa una sola variable debounce para toda la plataforma | Mientras un jugador se teletransporta, la plataforma ignora a todos los demás. Sin ningún debounce, un jugador que cae sobre la otra plataforma vuelve de inmediato. | Un tiempo de espera por jugador, registrado antes de que nada espere, y los jugadores caen al lado de la plataforma. |
Llama a TeleportService:Teleport(placeId, player) desde un LocalScript | Roblox marca Teleport() como obsoleto, dice que no se use en trabajo nuevo, y permite TeleportAsync solo desde scripts del servidor. | Llama a TeleportAsync en el script del servidor. |
Sin pcall, sin reintentos | La página de teletransportes de Roblox dice que los teletransportes pueden fallar y lanzar un error, y que también pueden fallar después de empezar. | Hasta 3 intentos dentro de pcall, y TeleportInitFailed deja que el jugador lo intente otra vez. |
| Se rinde porque "no funciona" en Studio | TeleportService no admite pruebas de juego en Studio. | RunService:IsStudio() imprime lo que habría hecho el portal. |
| Una GUI de teletransporte cuyos botones envían una posición | Un tramposo puede disparar el mismo remote con cualquier posición. | Los botones envían el nombre de un punto, y el servidor lo busca. |
| Monedas enviadas en los datos del teletransporte | Roblox dice que los datos del teletransporte son visibles para el cliente y no están cifrados. | Te dice que guardes las monedas y las Wins en un data store y las cargues en el otro place (consulta Lleva datos al otro place). |
Qué pueden y qué no pueden falsificar los jugadores
Da por hecho que un tramposo controla todo en su propio dispositivo: puede editar TeleportMenu, disparar los dos remotes tantas veces como quiera con cualquier argumento, y mover su propio personaje. Esto es lo que consigue con este teletransportador.
| El tramposo intenta | Resultado | Por qué |
|---|---|---|
| Enviar una posición o un CFrame por el remote del menú | Se ignora | TeleportRequest lee un solo string, el nombre de un punto de hasta 50 caracteres. Todo lo demás se descarta. |
| Pedir Castle sin 3 Wins | Rechazado | El servidor lee las Wins de su propia copia de leaderstats. El botón gris es solo una pista. |
| Pedir un punto que no existe | Se ignora | El servidor busca el nombre en TeleportSpots y no hace nada si ninguna parte tiene ese nombre. |
| Disparar el remote del menú una y otra vez | Como máximo un teletransporte del menú cada 3 segundos | El tiempo de espera se guarda en el servidor, por jugador. |
| Activar una plataforma sin caminar hasta ella | Llega a la plataforma pareja, a la que podría ir caminando de todos modos | Roblox incluye teletransportarse a cualquier posición y manipular los eventos Touched entre las cosas que un cliente puede hacer con su propio personaje. |
| Entrar directamente a otro place de tu juego | Posible a menos que Access Control for Places esté en Secure within universe only | Consulta Quién puede entrar a tus otros places. |
| Mover su propio personaje a cualquier lugar, incluido un punto bloqueado | Posible | Cada dispositivo controla el movimiento de su propio personaje. Un punto bloqueado es una comodidad, no una caja fuerte, así que comprueba en el servidor antes de entregar ahí cualquier cosa valiosa. |
La última fila es el límite real de cualquier teletransportador. Para un juego competitivo, añade una comprobación de movimiento en el servidor como la de la guía de sprint. Teleporters ya pone el atributo MovementCheckSkip que lee esa comprobación, así que sus propios teletransportes no se marcan: la documentación de seguridad de Roblox dice que los juegos con teletransportes legítimos necesitan justo este tipo de excepción en sus comprobaciones de movimiento.
Paso 5: pruébalo
- Pulsa Play. Pisa PadA: apareces justo delante de PadB, de espaldas a ella. Date la vuelta y vuelve a pisar PadB de inmediato: no pasa nada, porque las plataformas te ignoran durante 2 segundos después de llegar. Bájate, espera 2 segundos y camina otra vez sobre PadB: apareces delante de PadA.
- Espera unos segundos y haz clic en Teleport a la izquierda de la pantalla. La lista muestra Lake, Spawn y "Castle (needs 3 wins)" en gris. Elige Lake: apareces encima. Abre el menú otra vez y elige Castle: no pasa nada, y Output sigue en silencio.
- Date 3 Wins (esto necesita un script de leaderstats con un IntValue Wins, como el de la guía del leaderboard). Haz clic en el conmutador Client/Server para cambiar a Server, busca
Players, tu nombre,leaderstats,Winsen el Explorer y pon su Value en 3 en la ventana Properties. Vuelve a Client y abre el menú otra vez: Castle está en morado y te lleva ahí. - Toca DungeonPortal. Output imprime una línea que empieza por
Teleporters: would sendcon tu nombre y el place ID. Eso es lo esperado en Studio, y se imprime como máximo una vez cada 2 segundos por mucho que te quedes sobre el portal. - Elige Server & Clients en el desplegable del modo de prueba, pon 2 clientes y pulsa Play. Los dos jugadores pueden usar las plataformas a la vez, y el tiempo de espera de un jugador nunca bloquea al otro.
- Detén la prueba, publica y juega el juego desde la app de Roblox. Toca el portal: aparece la pantalla de carga de Roblox y llegas al otro place. Si te quedas donde estás, abre la Developer Console con F9, cambia su registro a la vista Server, que solo pueden ver el dueño del juego y los miembros del grupo con permiso de edición, y busca las advertencias de
Teleporters:, que incluyen el motivo que dio Roblox.
Deja abierta la ventana Output (menú Window y luego Output) durante los pasos en Studio. Teleporters no imprime nada cuando funciona, aparte de la línea del portal del paso 4, así que vale la pena leer cualquier advertencia o error en rojo. Consulta Errores comunes.
Cómo ampliarlo
Teletransporta a un equipo o a un grupo juntos
TeleportAsync acepta una lista de jugadores, así que un portal puede enviar a un grupo entero al mismo place. La página de teletransportes de Roblox sugiere partir del jugador que tocó el portal: player.Team y Team:GetPlayers() para un equipo, o SocialService:GetPlayersByPartyId() con player.PartyId para una party. Pasa esa lista en vez de { player }, y pon la marca leavingForPlace para cada jugador de la lista.
Envía a un grupo a su propio servidor
Por defecto, los jugadores teletransportados entran a un servidor público del otro place. Para enviar a un grupo a un servidor reservado nuevo, por ejemplo para una partida, crea un TeleportOptions, pon su ShouldReserveServer en true y pásalo como tercer argumento: TeleportService:TeleportAsync(placeId, players, options). Roblox indica que los fallos con servidores reservados en particular se benefician de los reintentos, cosa que el script ya hace.
Lleva datos al otro place
Teletransportar descarta todos los datos locales de ese jugador. Los datos de teletransporte de Roblox, que se ponen con TeleportOptions:SetTeleportData() y se leen en el otro place con player:GetJoinData(), son visibles para el cliente y no están cifrados, así que úsalos solo para elecciones inofensivas como qué mapa cargar. Guarda las monedas, las Wins y los objetos en un data store, como en el tutorial de DataStore, y cárgalos otra vez cuando el jugador llegue al otro place.
Una pantalla de carga personalizada
Mientras carga un teletransporte a otro place, los jugadores ven la pantalla de carga estándar de Roblox. Para mostrar la tuya, llama a TeleportService:SetTeleportGui() en el cliente con un ScreenGui, por ejemplo uno guardado en ReplicatedStorage. Los teletransportes de esta guía empiezan en el servidor, así que el cliente tiene que llamarlo con antelación, por ejemplo en cuanto entra el jugador. Roblox dice que la pantalla hay que ponerla otra vez antes de cada teletransporte y que no se usa para un place de otro juego. También indica que los scripts dentro de ese ScreenGui no se ejecutan, así que diséñala como una pantalla fija.
Teletransportes de ronda y checkpoints
El sistema de rondas mueve a todos los jugadores a la arena con el mismo tipo de llamada a PivotTo al principio de cada ronda, y PivotTo o SpawnLocations (en inglés), en la guía de checkpoints de obby, compara este enfoque con los puntos de aparición de Roblox. Si un punto solo debe abrirse después de una ronda, el sistema de rondas ya entrega las Wins que lee WinsNeeded.
Errores comunes y soluciones
Abre la ventana Output (menú Window y luego Output) antes de pulsar Play. Teleporters nombra la plataforma cuando un Destination no apunta a nada, así que la mayoría de los problemas aparecen ahí.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu está esperando el remote que crea Teleporters, así que Teleporters no se está ejecutando. Comprueba que es un Script, no un LocalScript, directamente dentro de ServerScriptService, que no está desactivado y que Output no muestra ningún error en rojo suyo. La guía de errores de scripts explica esta advertencia en detalle.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
El atributo Destination de la plataforma nombra algo que no es una parte directamente dentro de la carpeta TeleportPads. Revisa cómo están escritos, mayúsculas incluidas, el valor del atributo y el nombre de la plataforma de destino. La advertencia aparece una vez por plataforma, la primera vez que un jugador la toca.
Pisar una plataforma no hace nada
Comprueba que la carpeta se llama exactamente TeleportPads y está directamente en Workspace cuando empieza el juego, que el atributo Destination de la plataforma es un String (un atributo Number se ignora), y que esperaste 2 segundos desde tu último teletransporte. Comprueba también que CanTouch está activado en la plataforma: Roblox dice que conectar Touched a una parte con CanTouch desactivado lanza un error, lo cual detiene el script.
Caigo dentro de una pared o me caigo por el borde
Los jugadores llegan 3 studs por delante de la cara frontal de la plataforma de destino. Haz clic derecho en la plataforma, elige Show Orientation Indicator y gira la plataforma hasta que la línea azul apunte a suelo libre. Los puntos del menú ponen a los jugadores encima de la parte, así que deja cada punto sobre un suelo.
El botón Castle sigue gris después de ganar 3 Wins
La lista se dibuja cuando se abre el menú, así que cierra el menú y ábrelo otra vez. Si sigue gris, comprueba que leaderstats tiene un IntValue llamado exactamente Wins, y que las Wins cambiaron en el servidor, no solo en el modo Client.
El portal no hace nada en el juego publicado
Abre la Developer Console con F9, cambia su registro a la vista Server (solo la ven el dueño del juego y los miembros del grupo con permiso de edición, porque Teleporters es un Script del servidor) y lee las advertencias de Teleporters:, que incluyen el motivo que dio Roblox. Comprueba que el atributo PlaceId del portal es un Number con el ID del Asset Manager, y que publicaste el place otra vez después de añadir el portal.
Constrúyelo con RoCode
Si prefieres no montar todo esto a mano, RoCode puede construirlo en el place que tienes abierto. RoCode es un agente de IA independiente para Roblox Studio, no lo hace Roblox: describes la función en su chat web y su plugin de Studio crea las partes y los scripts en tu Explorer, así que no copias código desde una ventana de chat.
Añade teletransportadores: plataformas en Workspace.TeleportPads que envíen a los jugadores a la plataforma que nombra su atributo Destination con 2 segundos de espera, un menú Teleport para los puntos de Workspace.TeleportSpots donde Castle necesita 3 Wins, comprobado en el servidor, y portales en Workspace.PlacePortals que envíen a los jugadores al place ID de su atributo PlaceId con reintentos.
- Puede revisar tu place cuando un paso lo necesita, con Search Game y Search Scripts, para construir sobre los objetos, remotes o código de guardado que ya tienes en vez de añadir un segundo sistema
- Crea las carpetas y las partes de las plataformas con Create Instance y pone sus propiedades con Set Property, y escribe Teleporters y TeleportMenu con Create Script
- Tiene la instrucción de comprobar que cada script que escribe compila con Check Script, que lo compila en Studio sin ejecutarlo
- Envía sus cambios por lotes, y cada lote es un punto de deshacer en el historial de Studio
Los teletransportes entre places solo funcionan en el juego publicado, así que pruébalos tú mismo en la app de Roblox. Con el plugin 3.9 o posterior RoCode puede hacer una prueba corta y leer los errores, y con el plugin 3.9.15 o posterior su personaje de prueba puede pisar plataformas y hacer clic en botones de menús, pero solo comprueba lo que eligió probar, así que pisa las plataformas y abre el menú tú mismo. Un teletransportador es un sistema entre muchos de un juego; construir un juego entero con RoCode funciona así, un sistema por prompt. Cómo se conecta RoCode a Studio.
Preguntas frecuentes
¿Cómo hago una plataforma de teletransporte en Roblox Studio?
Dale a dos partes un atributo Destination en el que cada una nombre a la otra, y deja que un script del servidor mueva a quien toque una plataforma con character:PivotTo a un punto justo delante de la otra, con un tiempo de espera corto por jugador. El paso 1 y el paso 2 construyen exactamente eso.
¿Por qué mi teletransportador no funciona en Studio?
Las plataformas y los menús sí funcionan en Studio. Los teletransportes a otro place no: el TeleportService de Roblox no admite pruebas de juego en Studio, así que publica el juego y prueba en la app de Roblox. El script de esta guía imprime lo que habría hecho un portal, así que igual puedes comprobar que se dispara.
¿Cómo teletransporto jugadores a otro place de mi juego?
Añade el place con File > Publish As (Add as a new place), copia su place ID desde el Asset Manager y llama a TeleportService:TeleportAsync(placeId, { player }) desde un Script del servidor dentro de pcall, reintentando si falla. El paso 4 lo explica entero.
¿Cómo hago una GUI de teletransporte?
Construye los botones en un LocalScript y envía al servidor solo el nombre del punto que eligió el jugador. El servidor busca el nombre en una carpeta, comprueba el tiempo de espera y cualquier regla de desbloqueo, y luego mueve el personaje. Nunca envíes una posición desde el cliente: un tramposo puede enviar la posición que quiera.
¿Por qué mi personaje se atasca o se desarma después de teletransportarse?
Asignar el Position de la parte raíz mueve solo esa parte, no el cuerpo unido a ella, y copiar el CFrame de una plataforma pone el centro del personaje dentro de la plataforma. Usa character:PivotTo con un punto a la altura de estar de pie sobre el suelo, calculado a partir del HipHeight del Humanoid.
¿Puedo enviar monedas u objetos con un teletransporte?
No de forma segura. Roblox dice que los datos del teletransporte son visibles para el cliente y no están cifrados, así que sirven para algo como el mapa elegido, no para monedas. Guarda las monedas y los objetos en un data store y cárgalos en el otro place.
Fuentes y lecturas
- Roblox Creator Docs: Teleport between places (en inglés). TeleportAsync, pruebas en Studio, Access Control for Places, pantallas de teletransporte, datos de teletransporte y teletransportes fallidos
- Roblox Creator Docs: TeleportService (en inglés). el Teleport obsoleto, TeleportAsync solo en el servidor y TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (en inglés). la función principal para mover modelos desde scripts
- Roblox Creator Docs: BasePart.Position (en inglés). por qué asignar Position en una parte unida la mueve respecto a las demás
- Roblox Creator Docs: Humanoid.HipHeight (en inglés). a qué altura queda la parte raíz de un personaje de pie, en rigs R15 y R6
- Roblox Creator Docs: Seat (en inglés). el SeatWeld que sujeta a un personaje sentado, y destruirlo para levantarlo
- Roblox Creator Docs: Player:RequestStreamAroundAsync (en inglés). pedir una zona antes de que un personaje se mueva ahí, sin garantía de qué llega
- Roblox Creator Docs: Streaming techniques and conversion (en inglés). streaming proactivo antes de un teletransporte
- Roblox Creator Docs: Access control and confidentiality (en inglés). por qué los clientes pueden llegar a cualquier place de un juego a menos que los teletransportes sean seguros
- Roblox Creator Docs: Network ownership, movement validation, and physics (en inglés). qué puede hacer un cliente con su propio personaje, y las excepciones para teletransportes en las comprobaciones de movimiento
- Roblox Creator Docs: Create and publish games and places (en inglés). publicar, quién puede abrir un juego nuevo, y añadir un place con Publish As
- Roblox Creator Docs: Asset Manager (en inglés). copiar un place ID
- Roblox Creator Docs: Developer Console (en inglés). la vista Server del registro, y quién puede verla
- Roblox Creator Docs: Debounce patterns (en inglés). por qué Touched se dispara varias veces por un solo contacto
Cómo se comprobó el código: cada script de esta página pasa el verificador de tipos estricto de Luau con las definiciones de la API de Roblox (luau-lsp, 12 de noviembre de 2026). Una verificación de tipos detecta APIs mal escritas y tipos incorrectos, no la lógica del juego, así que pruébalo en Studio antes de publicar.