Tutoriál · Herní systémy

Jak udělat teleport v Roblox Studiu

Teleport v Robloxu je jedno ze dvou: přesun postavy na jiné místo na stejném serveru, nebo poslání hráče do jiného place vaší hry. V tomto návodu postavíme obě varianty z jednoho serverového skriptu: plošiny, které vás pošlou k párové plošině, menu Teleport, kde se zamčená místa odemykají za Wins, a portály do jiného place, které to zkusí znovu, když teleport Robloxu selže.

Aktualizováno 20. listopadu 202620 min čteníAutor:

Ve zkratce

Pro teleportační plošinu dejte Script do ServerScriptService, který poslouchá událost Touched plošiny, najde hráče přes Players:GetPlayerFromCharacter a přenese celou postavu přes character:PivotTo() na místo přímo před cílovou plošinou, zády k ní, s cooldownem pár sekund na hráče, aby ho cílová plošina hned neposlala zpátky. Pokud chcete hráče poslat do jiného place vaší hry, zavolejte TeleportService:TeleportAsync(placeId, { player }) ze serverového Scriptu uvnitř pcall; funguje to jen v publikované hře, ne ve Studiu.

  • Přenášejte celou postavu přes PivotTo. Přiřazení do HumanoidRootPart.Position odsune kořenový part od zbytku těla, protože při nastavení Position Roblox aktualizuje spoje.
  • Menu teleportu má serveru posílat název cíle, ne pozici. Server zkontroluje název, cooldown a jakékoli pravidlo odemčení dřív, než kohokoli přesune.
  • TeleportService:Teleport() je zastaralý a běží na klientovi. Používejte TeleportAsync na serveru, obalte ho do pcall, zkoušejte to znovu a obsluhujte TeleportInitFailed.
Na této stránce
  1. Jak to funguje
  2. 1. Plošiny
  3. 2. Skript teleportu
  4. 3. Menu teleportu
  5. 4. Jiné place
  6. Starší tutoriály
  7. Meze ochrany
  8. 5. Kontrola
  9. Rozšíření
  10. Common errors
  11. S RoCode
  12. Časté otázky
  13. Zdroje a další čtení

Dva druhy teleportu

IlustraceDotek PadA vás postaví přímo před PadB, takže vás PadB hned nepošle zpátky, a server odmítne zamčené místo Castle, ale přenese vás na Lake.

Teleport ve hře Roblox může znamenat tři věci: plošinu, která vás přenese přes mapu, menu míst, kam lze skočit, nebo portál do jiné úrovně. První dvě přesouvají postavu v rámci serveru, na kterém už hráč je. Třetí posílá hráče do jiného place vaší hry, který běží na vlastních serverech. Používají různá API, takže je dobré vědět, který potřebujete.

Dva druhy teleportu
V rámci stejného serveruDo jiného place vaší hry
Volánícharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
K čemuTeleportační plošiny, menu teleportu, přesun hráčů z lobby do arényPortály do jiné úrovně, lobby, které posílá hráče do samostatného place s dungeonem nebo zápasem
Kde běžíServerový ScriptJen serverový Script. Klientský Teleport() je zastaralý.
Funguje v playtestu ve StudiuAnoNe. TeleportService v Robloxu playtest ve Studiu nepodporuje, takže se testuje v publikované hře.
Co hráč vidíSkok přes mapu, který může trvat až 2 sekundy, pokud se ta oblast musí nejdřív načístNačítací obrazovku Robloxu, pak jiný place
Mince, předměty a další dataZůstanou, jak jsouRoblox lokální data hráče vymaže, takže vše důležité musí v jiném place přijít z datového úložiště

V tomto návodu jsou všechny tři druhy v jednom serverovém Scriptu, takže jedna sada pravidel pokrývá každý teleport ve vaší hře: rozhoduje server, každý hráč má vlastní cooldown a zařízení hráče jen hlásí, na které místo by se chtěl dostat.

Z čeho se teleport skládá
PrvekKde jeCo dělá
Folder TeleportPads s PadA a PadBWorkspaceDvě plošiny. Atribut Destination každé z nich jmenuje plošinu, ke které posílá hráče.
Folder TeleportSpotsWorkspaceJeden part na každé místo v seznamu menu. Atribut WinsNeeded místo zamkne.
Folder PlacePortalsWorkspaceParty portálů. Atribut PlaceId každého portálu je place, do kterého posílá hráče.
Script TeleportersServerScriptServiceŘídí všechny tři druhy teleportu a vytváří dva remoty. Jediné místo, kde může k teleportu dojít.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsKreslí tlačítko Teleport a seznam míst a posílá název místa, které hráč vybral.
RemoteFunction GetTeleportSpots a RemoteEvent TeleportRequestReplicatedStorage (vytváří je Teleporters)První vrací menu seznam míst. Druhý nese vybraný název na server.
Explorer, když je teleport hotový. Teleporters přidá GetTeleportSpots a TeleportRequest do ReplicatedStorage, když hra běží.
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

Krok 1: postavte dvě teleportační plošiny

  1. V Exploreru najeďte na Workspace, klikněte na tlačítko + a vložte Folder. Pojmenujte složku TeleportPads. Skript hledá právě tento název.
  2. Vložte do složky dva Party a pojmenujte je PadA a PadB. Udělejte z každého plochou desku, například 6 na 1 na 6 studů, a postavte je na podlahu v určité vzdálenosti od sebe. V okně Properties zaškrtněte Anchored, nechte zapnuté CanCollide a CanTouch a nastavte výraznou barvu a materiál Neon, aby si jich hráči všimli.
  3. Vyberte PadA, sjeďte v okně Properties k oddílu Attributes a klikněte na +. Zadejte název Destination, vyberte typ String a klikněte na Save, pak nastavte hodnotu PadB. Totéž udělejte na PadB s hodnotou PadA.
  4. Otočte každou plošinu tak, aby její přední stěna mířila na volnou podlahu. Hráči se objevují 3 study před přední stěnou cílové plošiny, zády k ní, takže tam nechte pár studů volné podlahy. Abyste viděli, která stěna je přední, klikněte na plošinu pravým tlačítkem a zvolte Show Orientation Indicator: přední stěnu označuje modrá čára. Otáčejte plošinu nástrojem Rotate, dokud čára neukáže tam, kam mají hráči odcházet.

Hráči končí vedle plošiny, ne na ní, záměrně. Stránka Robloxu o debounce uvádí, že Touched se při jednom doteku spustí mnohokrát po sobě, takže hráč, který by se objevil přímo na druhé plošině, by ji spustil znovu, jakmile skončí jeho cooldown, a odletěl by zpátky přes mapu.

Nejste omezení na dvě plošiny. Destination plošiny může jmenovat jakýkoli part v TeleportPads, takže tři plošiny mohou posílat hráče dokola. Pro jednosměrnou plošinu ji namiřte na part v TeleportPads, který nemá vlastní Destination: takový part hráče přijímá a nikoho nikam neposílá.

Krok 2: přidejte skript teleportu

Najeďte na ServerScriptService, vložte Script, pojmenujte ho Teleporters a vložte do něj kód níže. Teď obsluhuje plošiny a po dalších krocích i menu a portály, takže ho přidáváte jednou. Nastavení na začátku jsou řádky, které máte měnit.

Script v ServerScriptService s názvem Teleporters
-- Script ve ServerScriptService s názvem Teleporters.
-- Každý teleport se rozhoduje tady, na serveru:
--   1. Plošiny: dotek partu ve Workspace.TeleportPads vás přenese k partu, který je uvedený
--      v jeho atributu Destination.
--   2. Menu: LocalScript TeleportMenu žádá o místo z Workspace.TeleportSpots
--      podle názvu. Server zkontroluje název, cooldown a Wins, které místo vyžaduje.
--   3. Portály: dotek partu ve Workspace.PlacePortals vás pošle do place
--      z jeho atributu PlaceId (jiný place této hry).

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 -- tak dlouho plošiny ignorují hráče po jakémkoli teleportu
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studů před cílovou plošinou, aby hráči skončili vedle ní
local PLACE_ATTEMPTS = 3

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

-- Tento skript si oba remoty vytváří sám, tak je nepřidávejte ručně
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

-- V jaké výšce nad podlahou je kořenový part stojící postavy.
-- Vzorec z reference Robloxu k Humanoid.HipHeight (u rigů R6 se přičítá výška nohy).
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() -- nastavíme před čekáním, aby druhý dotek nespustil druhý teleport

	-- Díváme se tam, kam míří přední stěna cíle (rovně, bez náklonu)
	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
	-- Postavíme se na její horní stěnu: pivot postavy je její kořenový part, takže ho zvedneme na výšku vstoje.
	-- Plošina ale staví hráče pár studů před sebe, protože hráč stojící
	-- na plošině by ji dalším krokem znovu spustil.
	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)

	-- Se zapnutým instance streaming nejdřív načteme oblast kolem cíle (až 2 sekundy)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- odešel, respawnul se nebo zemřel, zatímco se oblast načítala
	end
	-- Sedící postava je přivařená k sedadlu a její přesun by sedadlo vzal s sebou.
	-- Zničení SeatWeld nejdřív postavu ze sedadla uvolní.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Po příchodu spustíme cooldown znovu: předběžné načtení výše může trvat až 2 sekundy
	-- a plošina, u které hráč skončil, ho nemá hned poslat zpátky
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- pro skript kontroly rychlosti, pokud ho máte
end

-- 1. Plošiny
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 -- varujeme jednou, ne při každém doteku
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Menu: seznam míst, pak požadavek podle názvu
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 -- stejné Wins: abecedně, aby se pořadí nikdy neměnilo
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- Klient posílá jen název. Nikdy od klienta nepřijímejte pozici ani CFrame.
	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 -- pro tohoto hráče zamčeno
	end
	teleportTo(player, spot, false)
end)

-- 3. Portály do jiného place této hry
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- už je na cestě nebo se teleportu dotkl před sekundou
	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 -- vzdáváme to; nový dotek portálu to zkusí znovu
end

-- Teleport může selhat i po startu. Hráč zůstane tady a může to zkusit znovu.
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 si sám vytvoří RemoteFunction GetTeleportSpots a RemoteEvent TeleportRequest, takže do ReplicatedStorage nemusíte nic vkládat ručně. Plošiny z TeleportPads a portály z PlacePortals připojí jednou, při startu serveru, takže plošiny a portály přidané během hry nic nedělají. Pokud některá složka chybí, ten druh teleportu je prostě vypnutý.

Co dělá každá část Teleporters
ČástCo děláProč
playerFromHitNajde model postavy, které patří part, jenž se dotkl, a zeptá se Players:GetPlayerFromCharacter, čí je.Plošin se dotýkají nohy, klobouky i volné party. Vše, co není součástí postavy hráče, dá nil a ignoruje se.
onCooldownPorovná os.clock() s časem posledního teleportu hráče.Jeden cooldown na hráče, takže hráč stojící u plošiny nikdy neblokuje ostatní. Nic nečeká ani nespí.
rootHeightSpočítá, v jaké výšce nad podlahou je kořenový part stojící postavy: polovina výšky kořenového partu plus HipHeight u Humanoidu, plus délka nohy u rigů R6.To je vzorec z reference Robloxu k Humanoid.HipHeight. Pivot postavy je její kořenový part, takže zvednutí pivotu o tuto hodnotu postaví nohy na povrch u malých i velkých avatarů i u R6.
Kontroly na začátku teleportToSkončí, pokud hráč nemá živou postavu s kořenovým partem, a pak hned zapíše čas.Požadavek streamingu níže může skript přimět čekat. Když se čas zapíše předem, četné události Touched v tu chvíli nespustí druhý teleport.
Bod příchoduHorní stěna cíle zvednutá o rootHeight, s pohledem tam, kam míří její přední stěna, bez náklonu. U plošiny je bod navíc posunutý o 3 study od její přední stěny.Postava se objeví vstoje, ne uvnitř cílového partu. Vedle plošiny začínají její nohy na úrovni horní stěny plošiny, takže klesne na podlahu o tloušťku plošiny. CFrame.lookAlong sestaví CFrame na pozici se zadaným směrem pohledu.
RequestStreamAroundAsyncPožádá Roblox, aby tomuto hráči nejdřív poslal oblast kolem bodu příchodu, a čeká nanejvýš 2 sekundy.Instance streaming je v nových place zapnutý ve výchozím stavu, takže vzdálená část mapy ještě nemusí být na zařízení hráče načtená. Roblox doporučuje toto serverové volání před přesunem postavy daleko, i když nezaručuje, co přesně dorazí.
Druhá kontrolaPokud hráč odešel nebo se postava během čekání respawnula či zemřela, nic se nepohne.Hráč mohl udělat reset nebo odejít ze hry, zatímco se oblast načítala. Vlastní příklad předběžného načtení od Robloxu také ověřuje, že postava je stále ve hře, než s ní pohne.
Řádky se SeatWeldPokud postava sedí, zničí Weld, který ji drží na sedadle.Roblox přivaří sedící postavu k sedadlu. PivotTo posouvá party změnou jejich CFrame a reference Robloxu říká, že nastavení CFrame partu posune i party s ním spojené, takže bez toho by sedadlo a vše k němu přivařené dorazilo spolu s hráčem. Zničení SeatWeld je způsob, jakým reference Robloxu k Seat zvedá postavu ze sedadla ze skriptu.
character:PivotTo(target)Přenese celou postavu, všechny končetiny a doplňky dohromady, do bodu příchodu.Roblox označuje PivotTo za hlavní funkci pro přesouvání modelů ze skriptů.
Druhý řádek s lastTeleportPo příchodu spustí cooldown znovu.Požadavek streamingu může trvat až 2 sekundy, stejně dlouho jako samotný cooldown plošiny, takže bez tohoto řádku by hráč mohl dorazit s už vypršelým cooldownem.
MovementCheckSkipNastaví atribut na Player po každém přesunu.Serverová kontrola rychlosti by skok považovala za cheat. MovementCheck z návodu ke sprintu tento atribut čte a začne měřit znovu z nové pozice. Bez takového skriptu atribut nic nedělá.
Nastavení na začátku Teleporters
NastaveníHodnota tadyCo mění
PAD_COOLDOWN_SECONDS2Jak dlouho plošiny a portály ignorují hráče po jakémkoli teleportu.
MENU_COOLDOWN_SECONDS3Nejkratší odstup mezi dvěma teleporty přes menu pro jednoho hráče. Plošiny a menu mají společné hodiny na hráče, takže požadavek z menu do 3 sekund po teleportu z plošiny se také ignoruje.
PAD_ARRIVAL_GAP3Kolik studů od přední stěny cílové plošiny se hráči objeví, aby skončili vedle plošiny, ne na ní.
PLACE_ATTEMPTS3Kolikrát portál zkusí TeleportAsync s odstupem 2 sekund, než to vzdá.

Stiskněte Play hned teď a šlápněte na PadA: objevíte se před PadB. Menu a portály potřebují další dva kroky, ale skript funguje už i bez nich.

Krok 4: teleport do jiného place

Place je samostatný svět uvnitř vaší hry s vlastními servery: lobby a dungeon, nebo hub a sada úrovní. Hráči se mezi place přesouvají přes TeleportService a Roblox ho spouští jen v publikované hře, takže tento krok končí v aplikaci Roblox, ne ve Studiu.

  1. Pokud hra ještě není publikovaná, zvolte File > Publish. Nové hry jsou, dokud je nevydáte, otevřené jen vám, lidem, kterým jste dali přístup Edit, a členům skupiny s potřebnými rolemi, a pro vlastní test teleportů to stačí.
  2. Vytvořte druhý place: otevřete nový place z jakékoli šablony Studia, postavte svůj dungeon, pak zvolte File > Publish As, klikněte na dlaždici své hry, zvolte Add as a new place a klikněte na Create.
  3. Zkopírujte ID nového place. Otevřete Asset Manager z nabídky Window nebo z karty Home, přejděte do Places In Experience, klikněte na place pravým tlačítkem a zvolte Copy Asset ID, čímž se zkopíruje jeho place ID.
  4. Zpátky v prvním place vložte do Workspace Folder s názvem PlacePortals a do něj ukotvený Part s názvem DungeonPortal. Přidejte atribut typu Number s názvem PlaceId a vložte ID jako jeho hodnotu.
  5. Stiskněte Play a dotkněte se portálu. Output vypíše řádek začínající Teleporters: would send: ve Studiu portál nic dalšího nedělá.
  6. Publikujte hru znovu přes File > Publish, aby se portál objevil v publikované hře, a vyzkoušejte ho z aplikace Roblox jako v kroku 5.

Teleporters volá TeleportAsync uvnitř pcall, až 3krát s pauzou 2 sekundy mezi pokusy, protože stránka Robloxu o teleportech říká, že teleporty mohou selhávat a vyhazovat chybu, a doporučuje to zkoušet znovu. Teleport může také začít a selhat na poslední chvíli bez chyby, takže hráč zůstane tam, kde byl. Pro tento případ Roblox vyvolá TeleportInitFailed a skript z hráče sejme příznak „odchází“, takže nový dotek portálu to zkusí znovu.

Pokud chcete hráče vracet, udělejte totéž v druhém place: dejte kopii Teleporters do jeho ServerScriptService a přidejte portál, jehož PlaceId je ID vašeho prvního place, zkopírované z Asset Manageru stejným způsobem.

Kdo se dostane do vašich dalších place

Dokumentace Robloxu k bezpečnosti varuje: jakmile je klient v jednom place vaší hry, může se teleportovat do kteréhokoli jiného jejího place, ať jste zamýšleli jakoukoli trasu, a vypnutí Direct Access u place odstraní jen tlačítko Join na webu. Mění to nastavení Access Control for Places v oddílu Audience > Access Settings v Creator Dashboard:

Tři hodnoty Access Control for Places
NastaveníKdo se dostane do place, který není startovní
Fully openKdokoli, přes teleporty z jakékoli hry, deep linky, pozvánky do hry a připojení ke kamarádovi.
Limited to same universeJen hráči, kteří se teleportují zevnitř vašich her. Povolené jsou teleporty z klienta i ze serveru.
Secure within universe onlyJen hráči, které teleportují vaše serverové skripty zevnitř této hry.

Pokud se hráči mají do place dostat jen přes váš portál, například do dungeonu, zvolte Secure within universe only. Každý teleport v tomto návodu začíná na serveru, takže bude fungovat dál. Roblox také říká, že mnoho her zabezpečené teleporty nepotřebuje, takže hra, jejíž všechny place jsou otevřené všem, může nastavení nechat, jak je.

V čem se mýlí starší tutoriály k teleportům

Pokud tento návod srovnáváte s videem nebo příspěvkem na fóru, tady jsou důležité rozdíly a důvod, proč každý postup způsobuje problém.

Časté postupy v tutoriálech k teleportům a co místo nich dělá tento návod
TutoriálProblémTento návod
Nastavuje hit.Parent.HumanoidRootPart.Position = target.PositionReference Robloxu říká, že nastavení Position aktualizuje spoje partu a ten se posune vůči partům, se kterými je spojený: kořenový part odjede bez těla.Přenáší celou postavu přes PivotTo.
Nastavuje HumanoidRootPart.CFrame = target.CFrameStřed postavy skončí ve středu cílového partu, částečně uvnitř něj, a převezme náklon partu.Postava se objeví ve výšce vstoje nad horní stěnou, vedle plošiny, bez náklonu.
Používá jednu proměnnou debounce pro celou plošinuZatímco se teleportuje jeden hráč, plošina ignoruje všechny ostatní. A úplně bez debounce se hráč, který se objevil na druhé plošině, hned pošle zpátky.Jeden cooldown na hráče, zapsaný před jakýmkoli čekáním, a hráči se objevují vedle plošiny.
Volá TeleportService:Teleport(placeId, player) z LocalScriptuRoblox označuje Teleport() za zastaralý, radí ho v nových projektech nepoužívat a TeleportAsync povoluje jen ze serverových skriptů.Volá TeleportAsync v serverovém skriptu.
Žádný pcall, žádné opakované pokusyStránka Robloxu o teleportech říká, že mohou selhávat a vyhazovat chybu, a také selhat až po startu.Až 3 pokusy v pcall a TeleportInitFailed hráči umožní zkusit to znovu.
Vzdává to, protože ve Studiu to „nefunguje“TeleportService playtest ve Studiu nepodporuje.RunService:IsStudio() místo toho vypíše, co by portál udělal.
GUI teleportu, jehož tlačítka posílají poziciPodvodník může zavolat stejný remote s libovolnou pozicí.Tlačítka posílají název místa a server ho vyhledá.
Mince se předávají v teleport dataRoblox říká, že teleport data jsou viditelná pro klienta a nejsou šifrovaná.Radí držet mince a Wins v datovém úložišti a načítat je v jiném place (viz Jak přenést data do jiného place).

Co hráči mohou a nemohou podvrhnout

Počítejte s tím, že podvodník ovládá vše na svém zařízení: může upravit TeleportMenu, volat oba remoty kolikrát chce s jakýmikoli argumenty a pohybovat svou postavou. Tady je, co mu to s tímto teleportem dá.

Co může podvodník zkusit a co s tím dělá Teleporters
Podvodník zkoušíVýsledekProč
Poslat pozici nebo CFrame přes remote menuIgnorovánoTeleportRequest čte jeden řetězec, název místa o délce do 50 znaků. Vše ostatní se zahodí.
Vyžádat si Castle bez 3 WinsOdmítnutoServer čte Wins ze své kopie leaderstats. Šedé tlačítko je jen nápověda.
Vyžádat si místo, které neexistujeIgnorovánoServer hledá název v TeleportSpots a nic neudělá, pokud part s takovým názvem není.
Volat remote menu pořád dokolaNanejvýš jeden teleport přes menu jednou za 3 sekundyCooldown se drží na serveru, pro každého hráče.
Spustit plošinu, aniž by k ní došelDostane se k párové plošině, ke které by stejně mohl dojítRoblox uvádí teleport na jakékoli místo a manipulaci s událostmi Touched mezi tím, co klient se svou postavou může dělat.
Vstoupit do jiného place vaší hry přímoMožné, pokud Access Control for Places není Secure within universe onlyViz Kdo se dostane do vašich dalších place.
Přesunout svou postavu kamkoli, včetně zamčeného místaMožnéKaždé zařízení ovládá pohyb své postavy. Zamčené místo je pohodlí, ne trezor, takže než tam vydáte něco cenného, kontrolujte na serveru.

Poslední řádek je poctivá mez každého teleportu. Pro soutěžní hru přidejte serverovou kontrolu pohybu, jako v návodu ke sprintu. Teleporters už nastavuje atribut MovementCheckSkip, který ta kontrola čte, takže jeho vlastní teleporty se neoznačí jako porušení: dokumentace Robloxu k bezpečnosti říká, že hry s legitimními teleporty potřebují v kontrolách pohybu přesně takovou výjimku.

Krok 5: vyzkoušejte to

  1. Stiskněte Play. Šlápněte na PadA: objevíte se přímo před PadB, zády k ní. Otočte se a hned šlápněte na PadB: nic se nestane, protože plošiny vás 2 sekundy po příchodu ignorují. Sestupte, počkejte 2 sekundy a znovu vstupte na PadB: objevíte se před PadA.
  2. Počkejte pár sekund, pak klikněte na Teleport v levé části obrazovky. V seznamu jsou Lake, Spawn a šedé "Castle (needs 3 wins)". Zvolte Lake: objevíte se na něm. Otevřete menu znovu a zvolte Castle: nic se nestane a v Output je ticho.
  3. Dejte si 3 Wins (k tomu potřebujete skript leaderstats s IntValue Wins, například z návodu k žebříčku). Klikněte na přepínač Client/Server, abyste přešli na Server, najděte v Exploreru Players, své jméno, leaderstats, Wins a nastavte jeho Value na 3 v okně Properties. Přepněte zpátky na Client a znovu otevřete menu: Castle je teď fialový a přenese vás tam.
  4. Dotkněte se DungeonPortal. Output vypíše řádek začínající Teleporters: would send, s vaším jménem a place ID. Ve Studiu to tak má být a vypisuje se nanejvýš jednou za 2 sekundy, ať na portálu stojíte jakkoli dlouho.
  5. V rozbalovacím seznamu režimů testu zvolte Server & Clients, nastavte 2 klienty a stiskněte Play. Oba hráči mohou plošiny používat současně a cooldown jednoho nikdy neblokuje druhého.
  6. Zastavte test, publikujte hru a spusťte ji z aplikace Roblox. Dotkněte se portálu: objeví se načítací obrazovka Robloxu a ocitnete se v jiném place. Pokud jste zůstali na místě, otevřete Developer Console klávesou F9, přepněte log na zobrazení Server, které vidí jen majitel hry a členové skupiny s právem úprav, a najděte varování Teleporters:, je v nich uvedený důvod, který Roblox udal.

Během kroků ve Studiu mějte otevřené okno Output (nabídka Window, pak Output). Když Teleporters funguje, nevypisuje nic kromě řádku portálu z kroku 4, takže každé varování nebo červenou chybu stojí za to přečíst. Viz Časté chyby.

Jak to rozšířit

Teleport týmu nebo party najednou

TeleportAsync přijímá seznam hráčů, takže jeden portál může poslat do jednoho place celou skupinu. Stránka Robloxu o teleportech navrhuje vycházet z hráče, který se portálu dotkl: player.Team a Team:GetPlayers() pro tým nebo SocialService:GetPlayersByPartyId() s player.PartyId pro party. Předejte tento seznam místo { player } a nastavte příznak leavingForPlace každému hráči z něj.

Poslání skupiny na vlastní server

Ve výchozím stavu teleportovaní hráči skončí na veřejném serveru jiného place. Pokud chcete skupinu poslat na nový rezervovaný server, například kvůli zápasu, vytvořte TeleportOptions, nastavte jeho ShouldReserveServer na true a předejte ho jako třetí argument: TeleportService:TeleportAsync(placeId, players, options). Roblox poznamenává, že u selhání spojených právě s rezervovanými servery jsou opakované pokusy obzvlášť užitečné, a skript je už dělá.

Jak přenést data do jiného place

Teleport vymaže všechna lokální data tohoto hráče. Teleport data v Robloxu, která se nastavují přes TeleportOptions:SetTeleportData() a v jiném place se čtou přes player:GetJoinData(), jsou viditelná pro klienta a nejsou šifrovaná, takže je používejte jen pro neškodné volby, například kterou mapu načíst. Mince, Wins a předměty držte v datovém úložišti, jako v tutoriálu k DataStore, a načtěte je znovu, když hráč dorazí do jiného place.

Vlastní načítací obrazovka

Zatímco se teleport do place načítá, hráči vidí standardní načítací obrazovku Robloxu. Pokud chcete ukázat vlastní, zavolejte na klientovi TeleportService:SetTeleportGui() se ScreenGui, například s tím, který leží v ReplicatedStorage. Teleporty v tomto návodu začínají na serveru, takže klient ho musí zavolat předem, například hned jak hráč vstoupí. Roblox říká, že obrazovku je potřeba nastavit znovu před každým teleportem a že se nepoužije pro place v jiné hře. Stejně tak poznamenává, že skripty uvnitř tohoto ScreenGui se nespouštějí, takže ho dělejte statický.

Teleporty kol a checkpointy

Systém kol na začátku každého kola přenese všechny hráče do arény stejným voláním PivotTo a oddíl PivotTo nebo SpawnLocation v návodu k obby srovnává tento přístup se spawn body Robloxu. Pokud se má místo odemknout až po kole, systém kol už přiděluje Wins, které WinsNeeded čte.

Časté chyby a řešení

Před stisknutím Play otevřete okno Output (nabídka Window, pak Output). Teleporters jmenuje plošinu, když Destination ukazuje do prázdna, takže většinu problémů uvidíte tam.

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

TeleportMenu čeká na remote, který vytváří Teleporters, takže Teleporters neběží. Ověřte, že je to Script, ne LocalScript, že leží přímo ve ServerScriptService, není vypnutý a že v Output od něj není červená chyba. Návod k chybám ve skriptech toto varování podrobně vysvětluje.

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

Atribut Destination plošiny jmenuje něco, co není part přímo ve složce TeleportPads. Zkontrolujte pravopis a velká písmena v hodnotě atributu i v názvu cílové plošiny. Varování se objeví jednou na plošinu, když se jí hráč poprvé dotkne.

Šlápnu na plošinu a nic se nestane

Ověřte, že složka se jmenuje přesně TeleportPads a při startu hry leží přímo ve Workspace, že atribut Destination plošiny má typ String (atribut typu Number se ignoruje) a že od vašeho posledního teleportu uplynuly 2 sekundy. Ověřte také, že plošina má zapnuté CanTouch: Roblox říká, že připojení Touched k partu s vypnutým CanTouch vyhodí chybu, a ta skript zastaví.

Objevím se uvnitř zdi nebo spadnu z okraje

Hráči se objevují 3 study před přední stěnou cílové plošiny. Klikněte na plošinu pravým tlačítkem, zvolte Show Orientation Indicator a otáčejte plošinu, dokud modrá čára neukáže na volnou podlahu. Místa menu staví hráče navrch partu, takže držte každé místo na podlaze.

Tlačítko Castle zůstane šedé i poté, co jsem získal 3 Wins

Seznam se kreslí při otevření menu, takže menu zavřete a otevřete znovu. Pokud je tlačítko pořád šedé, ověřte, že v leaderstats je IntValue s názvem přesně Wins a že se Wins změnily na serveru, ne jen v režimu Client.

Portál v publikované hře nic nedělá

Otevřete Developer Console klávesou F9, přepněte log na zobrazení Server (vidí ho jen majitel hry a členové skupiny s právem úprav, protože Teleporters je serverový Script) a přečtěte varování Teleporters:, je v nich uvedený důvod, který Roblox udal. Ověřte, že atribut PlaceId portálu má typ Number a obsahuje ID z Asset Manageru a že jste place po přidání portálu znovu publikovali.

Udělat s RoCode

Pokud se vám nechce stavět tohle všechno ručně, RoCode to může udělat ve vašem otevřeném place. RoCode je nezávislý AI agent pro Roblox Studio, ne od Robloxu: funkci popíšete v jeho webovém chatu a jeho plugin pro Studio vytvoří party a skripty ve vašem Exploreru, takže nemusíte kopírovat kód z okna chatu.

Napíšete

Přidej teleporty: plošiny ve Workspace.TeleportPads, které posílají hráče k plošině ze svého atributu Destination s cooldownem 2 sekundy, menu Teleport pro místa ve Workspace.TeleportSpots, kde Castle vyžaduje 3 Wins s kontrolou na serveru, a portály ve Workspace.PlacePortals, které posílají hráče do place s ID ze svého atributu PlaceId, s opakovanými pokusy.

RoCode udělá
  • Může si prohlédnout váš place, když to krok potřebuje, přes Search Game a Search Scripts, aby navázal na už existující předměty, remoty nebo kód ukládání, místo aby přidával druhý systém
  • Vytvoří složky a party plošin přes Create Instance, nastaví jejich vlastnosti přes Set Property a napíše Teleporters a TeleportMenu přes Create Script
  • Má pokyn ověřit kompilaci každého napsaného skriptu přes Check Script, který ho ve Studiu zkompiluje bez spuštění
  • Posílá změny v dávkách a každá dávka je bod pro vrácení v historii Studia

Teleporty mezi place fungují jen v publikované hře, takže je vyzkoušejte v aplikaci Roblox sami. S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby, a s pluginem 3.9.15 nebo novějším jeho testovací postava může šlapat na plošiny a mačkat tlačítka menu, ale kontroluje jen to, co se sám rozhodl otestovat, takže na plošiny šlápněte a menu otevřete sami. Teleport je jeden systém z mnoha ve hře; vytvoření celé hry s RoCode jde stejně, po jednom systému na prompt. Jak se RoCode připojuje ke Studiu.

Časté otázky

Jak udělat teleportační plošinu v Roblox Studiu?

Dejte dvěma partům atribut Destination s názvy toho druhého a ať jeden serverový skript přenese toho, kdo se plošiny dotkl, přes character:PivotTo na místo přímo před druhou plošinou, s krátkým cooldownem na hráče. Krok 1 a krok 2 stavějí přesně tohle.

Proč můj teleport ve Studiu nefunguje?

Plošiny a menu ve Studiu fungují. Teleporty do jiného place ne: TeleportService v Robloxu playtest ve Studiu nepodporuje, takže hru publikujte a testujte v aplikaci Roblox. Skript z tohoto návodu místo teleportu vypíše, co by portál udělal, takže pořád můžete ověřit, že se spouští.

Jak teleportovat hráče do jiného place mé hry?

Přidejte place přes File > Publish As (Add as a new place), zkopírujte jeho place ID z Asset Manageru a zavolejte TeleportService:TeleportAsync(placeId, { player }) ze serverového Scriptu uvnitř pcall, s opakováním při selhání. Krok 4 vás tím vším provede.

Jak udělat GUI teleportu?

Postavte tlačítka v LocalScriptu a posílejte serveru jen název místa, které hráč vybral. Server název vyhledá ve složce, zkontroluje cooldown a jakékoli pravidlo odemčení a pak postavu přesune. Nikdy neposílejte pozici z klienta: podvodník může poslat jakoukoli.

Proč se moje postava po teleportu zasekne nebo rozpadne?

Přiřazení do Position kořenového partu posune jen tento part, bez těla s ním spojeného, a kopírování CFrame plošiny postaví střed postavy dovnitř plošiny. Použijte character:PivotTo s bodem ve výšce vstoje nad podlahou, spočítaným z HipHeight u Humanoidu.

Dají se s teleportem předat mince nebo předměty?

Bezpečně ne. Roblox říká, že teleport data jsou viditelná pro klienta a nejsou šifrovaná, takže se hodí pro něco jako vybranou mapu, ale ne pro mince. Ukládejte mince a předměty do datového úložiště a načítejte je v jiném place.

Zdroje a další čtení

Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.