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í doHumanoidRootPart.Positionodsune 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žívejteTeleportAsyncna serveru, obalte ho dopcall, zkoušejte to znovu a obsluhujteTeleportInitFailed.
Na této stránce
Dva druhy teleportu
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.
| V rámci stejného serveru | Do jiného place vaší hry | |
|---|---|---|
| Volání | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| K čemu | Teleportační plošiny, menu teleportu, přesun hráčů z lobby do arény | Portály do jiné úrovně, lobby, které posílá hráče do samostatného place s dungeonem nebo zápasem |
| Kde běží | Serverový Script | Jen serverový Script. Klientský Teleport() je zastaralý. |
| Funguje v playtestu ve Studiu | Ano | Ne. 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číst | Načítací obrazovku Robloxu, pak jiný place |
| Mince, předměty a další data | Zůstanou, jak jsou | Roblox 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.
| Prvek | Kde je | Co dělá |
|---|---|---|
Folder TeleportPads s PadA a PadB | Workspace | Dvě plošiny. Atribut Destination každé z nich jmenuje plošinu, ke které posílá hráče. |
Folder TeleportSpots | Workspace | Jeden part na každé místo v seznamu menu. Atribut WinsNeeded místo zamkne. |
Folder PlacePortals | Workspace | Party portálů. Atribut PlaceId každého portálu je place, do kterého posílá hráče. |
Script Teleporters | ServerScriptService | Řídí všechny tři druhy teleportu a vytváří dva remoty. Jediné místo, kde může k teleportu dojít. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Kreslí tlačítko Teleport a seznam míst a posílá název místa, které hráč vybral. |
RemoteFunction GetTeleportSpots a RemoteEvent TeleportRequest | ReplicatedStorage (vytváří je Teleporters) | První vrací menu seznam míst. Druhý nese vybraný název na server. |
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
- 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. - Vložte do složky dva Party a pojmenujte je
PadAaPadB. 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. - 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 hodnotuPadB. Totéž udělejte na PadB s hodnotouPadA. - 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 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ý.
| Část | Co dělá | Proč |
|---|---|---|
playerFromHit | Najde 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. |
onCooldown | Porovná 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í. |
rootHeight | Spočí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 teleportTo | Skončí, 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říchodu | Horní 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. |
RequestStreamAroundAsync | Požá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á kontrola | Pokud 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 SeatWeld | Pokud 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 lastTeleport | Po 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. |
MovementCheckSkip | Nastaví 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í | Hodnota tady | Co mění |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Jak dlouho plošiny a portály ignorují hráče po jakémkoli teleportu. |
MENU_COOLDOWN_SECONDS | 3 | Nejkratší 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_GAP | 3 | Kolik studů od přední stěny cílové plošiny se hráči objeví, aby skončili vedle plošiny, ne na ní. |
PLACE_ATTEMPTS | 3 | Kolikrá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.
- 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čí.
- 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.
- 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.
- Zpátky v prvním place vložte do Workspace Folder s názvem
PlacePortalsa do něj ukotvený Part s názvemDungeonPortal. Přidejte atribut typu Number s názvemPlaceIda vložte ID jako jeho hodnotu. - 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á. - 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:
| Nastavení | Kdo se dostane do place, který není startovní |
|---|---|
| Fully open | Kdokoli, přes teleporty z jakékoli hry, deep linky, pozvánky do hry a připojení ke kamarádovi. |
| Limited to same universe | Jen hráči, kteří se teleportují zevnitř vašich her. Povolené jsou teleporty z klienta i ze serveru. |
| Secure within universe only | Jen 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.
| Tutoriál | Problém | Tento návod |
|---|---|---|
Nastavuje hit.Parent.HumanoidRootPart.Position = target.Position | Reference 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.CFrame | Stř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šinu | Zatí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 LocalScriptu | Roblox 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é pokusy | Strá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í pozici | Podvodní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 data | Roblox ří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á.
| Podvodník zkouší | Výsledek | Proč |
|---|---|---|
| Poslat pozici nebo CFrame přes remote menu | Ignorováno | TeleportRequest č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 Wins | Odmítnuto | Server čte Wins ze své kopie leaderstats. Šedé tlačítko je jen nápověda. |
| Vyžádat si místo, které neexistuje | Ignorováno | Server hledá název v TeleportSpots a nic neudělá, pokud part s takovým názvem není. |
| Volat remote menu pořád dokola | Nanejvýš jeden teleport přes menu jednou za 3 sekundy | Cooldown se drží na serveru, pro každého hráče. |
| Spustit plošinu, aniž by k ní došel | Dostane se k párové plošině, ke které by stejně mohl dojít | Roblox 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římo | Možné, pokud Access Control for Places není Secure within universe only | Viz Kdo se dostane do vašich dalších place. |
| Přesunout svou postavu kamkoli, včetně zamčeného místa | Mož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
- 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.
- 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.
- 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,Winsa 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. - 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. - 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.
- 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.
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.
- 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í
- Roblox Creator Docs: Teleport between places (anglicky). TeleportAsync, playtesty ve Studiu, Access Control for Places, obrazovky teleportu, teleport data a selhané teleporty
- Roblox Creator Docs: TeleportService (anglicky). zastaralý Teleport, TeleportAsync jen na serveru a TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (anglicky). hlavní funkce pro přesouvání modelů ze skriptů
- Roblox Creator Docs: BasePart.Position (anglicky). proč nastavení Position u spojeného partu ho posune vůči ostatním
- Roblox Creator Docs: Humanoid.HipHeight (anglicky). v jaké výšce je kořenový part stojící postavy, pro rigy R15 a R6
- Roblox Creator Docs: Seat (anglicky). SeatWeld, který drží sedící postavu, a jeho zničení, aby se postava zvedla
- Roblox Creator Docs: Player:RequestStreamAroundAsync (anglicky). vyžádání oblasti dřív, než se tam postava přesune, bez záruky toho, co dorazí
- Roblox Creator Docs: Streaming techniques and conversion (anglicky). předběžný streaming před teleportem
- Roblox Creator Docs: Access control and confidentiality (anglicky). proč se klienti dostanou do jakéhokoli place hry, pokud teleporty nejsou zabezpečené
- Roblox Creator Docs: Network ownership, movement validation, and physics (anglicky). co klient může dělat se svou postavou a výjimky pro teleporty v kontrolách pohybu
- Roblox Creator Docs: Create and publish games and places (anglicky). publikování, kdo může otevřít novou hru, a přidání place přes Publish As
- Roblox Creator Docs: Asset Manager (anglicky). jak zkopírovat place ID
- Roblox Creator Docs: Developer Console (anglicky). zobrazení Server v logu a kdo ho vidí
- Roblox Creator Docs: Debounce patterns (anglicky). proč se Touched při jednom doteku spustí několikrát
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.