V skratke
Na teleportovaciu plošinu dajte Script do ServerScriptService, ktorý počúva udalosť Touched plošiny, nájde hráča cez Players:GetPlayerFromCharacter a prenesie celú postavu cez character:PivotTo() na miesto tesne pred cieľovou plošinou, chrbtom k nej, s cooldownom pár sekúnd pre každého hráča, aby ho cieľová plošina hneď neposlala späť. Ak chcete poslať hráčov do iného place vašej hry, zavolajte TeleportService:TeleportAsync(placeId, { player }) zo serverového Scriptu vnútri pcall; funguje to len v publikovanej hre, nie v Studiu.
- Prenášajte celú postavu cez
PivotTo. PriradenieHumanoidRootPart.Positionodsunie koreňový part od zvyšku tela, pretože pri nastavení Position Roblox aktualizuje spoje. - Menu teleportu má serveru posielať názov cieľa, nie pozíciu. Server overí názov, cooldown a akékoľvek pravidlo odomknutia, kým niekoho prenesie.
TeleportService:Teleport()je zastaraný a beží na klientovi. PoužívajteTeleportAsyncna serveri, obaľte ho dopcall, skúšajte znova a spracujteTeleportInitFailed.
Na tejto stránke
Dva druhy teleportu
Teleport v hre v Robloxe môže znamenať tri veci: plošinu, ktorá vás prenesie cez mapu, menu bodov, kam sa dá skočiť, alebo portál na inú úroveň. Prvé dve presúvajú postavu vnútri servera, na ktorom hráč už je. Tretia pošle hráča do iného place vašej hry, ktorý beží na vlastných serveroch. Používajú rôzne API, preto je dobré vedieť, ktorý potrebujete.
| Vnútri toho istého servera | Do iného place vašej hry | |
|---|---|---|
| Volanie | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Na čo | Teleportovacie plošiny, menu teleportu, presun hráčov z lobby do arény | Portály na inú úroveň, lobby, ktoré posiela hráčov do samostatného place s dungeonom alebo zápasom |
| Kde beží | Serverový Script | Len serverový Script. Klientsky Teleport() je zastaraný. |
| Funguje v playteste v Studiu | Áno | Nie. TeleportService v Robloxe nepodporuje playtest v Studiu, preto sa testuje v publikovanej hre. |
| Čo vidí hráč | Skok cez mapu, ktorý môže trvať až 2 sekundy, ak sa daná oblasť musí najprv načítať | Načítavaciu obrazovku Robloxu, potom iný place |
| Mince, predmety a iné dáta | Zostanú, ako sú | Roblox vynuluje lokálne dáta hráča, preto všetko dôležité musí prísť z úložiska dát v druhom place |
V tomto návode sú všetky tri druhy v jednom serverovom Scripte, takže jedna sada pravidiel pokrýva každý teleport vo vašej hre: rozhoduje server, každý hráč má vlastný cooldown a zariadenie hráča len oznamuje, na ktorý bod by sa chcel dostať.
| Prvok | Kde je | Čo robí |
|---|---|---|
Folder TeleportPads s PadA a PadB | Workspace | Dve plošiny. Atribút Destination každej uvádza plošinu, ku ktorej posiela hráčov. |
Folder TeleportSpots | Workspace | Jeden part na každý bod v zozname menu. Atribút WinsNeeded bod zamkne. |
Folder PlacePortals | Workspace | Party portálov. Atribút PlaceId každého portálu je place, do ktorého posiela hráčov. |
Script Teleporters | ServerScriptService | Riadi všetky tri druhy teleportu a vytvára dva remoty. Jediné miesto, kde môže teleport nastať. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Nakreslí tlačidlo Teleport a zoznam bodov a pošle názov bodu, ktorý hráč vybral. |
RemoteFunction GetTeleportSpots a RemoteEvent TeleportRequest | ReplicatedStorage (vytvára ich Teleporters) | Prvá vracia menu zoznam bodov. Druhý nesie vybraný názov 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 dve teleportovacie plošiny
- V Explorer prejdite myšou na Workspace, kliknite na tlačidlo + a vložte Folder. Priečinok pomenujte
TeleportPads. Skript hľadá presne tento názov. - Do priečinka vložte dva Part a pomenujte ich
PadAaPadB. Z každého urobte plochú dosku, napríklad 6 na 1 na 6 studs, a postavte ich na podlahu v istej vzdialenosti od seba. V okne Properties zaškrtnite Anchored, nechajte zapnuté CanCollide a CanTouch a nastavte výraznú farbu a materiál Neon, aby si ich hráči všimli. - Vyberte PadA, v okne Properties prejdite do časti Attributes a kliknite na +. Zadajte názov
Destination, vyberte typ String a kliknite na Save, potom nastavte hodnotuPadB. To isté urobte na PadB s hodnotouPadA. - Otočte každú plošinu tak, aby jej predná stena smerovala na voľnú podlahu. Hráči sa objavia 3 studs pred prednou stenou cieľovej plošiny, chrbtom k nej, preto tam nechajte niekoľko studs voľnej podlahy. Ktorá stena je predná, zistíte tak, že na plošinu kliknete pravým tlačidlom a vyberiete Show Orientation Indicator: prednú stenu označuje modrá čiara. Otáčajte plošinu nástrojom Rotate, kým táto čiara neukazuje tam, kam majú hráči odchádzať.
Hráči skončia vedľa plošiny, nie na nej, a to zámerne. Stránka Robloxu o debounce uvádza, že Touched sa pri jednom dotyku spustí veľakrát za sebou, takže hráč, ktorý by sa objavil priamo na druhej plošine, by ju spustil znova, len čo mu skončí cooldown, a odletel by späť cez mapu.
Nie ste obmedzení na dve plošiny. Destination plošiny môže uvádzať akýkoľvek part v TeleportPads, takže tri plošiny môžu posielať hráčov dookola. Na jednosmernú plošinu ju nasmerujte na part v TeleportPads, ktorý nemá vlastný Destination: taký part hráčov prijíma a nikoho nikam neposiela.
Krok 2: pridajte skript na teleport
Prejdite myšou na ServerScriptService, vložte Script, pomenujte ho Teleporters a vložte doň kód nižšie. Zatiaľ obsluhuje plošiny a po ďalších krokoch aj menu a portály, takže ho pridávate len raz. Nastavenia na začiatku sú riadky, ktoré máte meniť.
-- Script v ServerScriptService s názvom Teleporters.
-- Každý teleport sa rozhoduje tu, na serveri:
-- 1. Plošiny: dotyk partu vo Workspace.TeleportPads vás prenesie k partu, ktorý je uvedený
-- v jeho atribúte Destination.
-- 2. Menu: LocalScript TeleportMenu žiada bod z Workspace.TeleportSpots
-- podľa názvu. Server overí názov, cooldown a Wins, ktoré bod vyžaduje.
-- 3. Portály: dotyk partu vo Workspace.PlacePortals vás pošle do place
-- z jeho atribútu PlaceId (iný place tejto 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 dlho plošiny ignorujú hráča po akomkoľvek teleporte
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs pred cieľovou plošinou, aby hráči skončili vedľa nej
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Tento skript sám vytvorí oba remoty, preto ich nepridávajte ručne
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 akej výške nad podlahou je koreňový part stojacej postavy.
-- Vzorec z referencie Robloxu k Humanoid.HipHeight (pri rigoch R6 sa pridáva 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 pred čakaním, aby druhý dotyk nespustil druhý teleport
-- Pozeráme tam, kam smeruje predná stena cieľa (rovno, 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 sa na jej hornú stenu: pivot postavy je jej koreňový part, preto ho zdvihneme do výšky v stoji.
-- Plošina však kladie hráčov niekoľko studs pred seba, pretože hráč, ktorý stojí
-- na plošine, by ju ďalším krokom spustil znova.
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)
-- Pri zapnutom instance streaming najprv načítame oblasť okolo cieľa (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 -- odišiel, oživil sa alebo zomrel, kým sa oblasť načítavala
end
-- Sediaca postava je privarená k sedadlu a jej presun by sedadlo stiahol so sebou.
-- Zničenie SeatWeld najprv uvoľní postavu zo sedadla.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Po príchode spustíme cooldown znova: prednačítanie vyššie môže trvať až 2 sekundy
-- a plošina, pri ktorej hráč skončil, ho nesmie hneď poslať späť
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- pre skript na kontrolu rýchlosti, ak 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 -- upozorníme raz, nie pri každom dotyku
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menu: zoznam bodov, potom požiadavka podľa 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 -- rovnaké Wins: podľa abecedy, aby sa poradie nikdy nemenilo
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Klient posiela len názov. Nikdy neprijímajte od klienta pozíciu 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 -- zamknuté pre tohto hráča
end
teleportTo(player, spot, false)
end)
-- 3. Portály do iného place tejto hry
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- už je na ceste alebo sa teleportu dotkol pred 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ávame to; nový dotyk portálu to skúsi znova
end
-- Teleport môže zlyhať aj po štarte. Hráč zostane tu a môže to skúsiť znova.
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 sám vytvorí RemoteFunction GetTeleportSpots a RemoteEvent TeleportRequest, takže do ReplicatedStorage netreba nič vkladať ručne. Plošiny z TeleportPads a portály z PlacePortals pripojí raz, pri štarte servera, takže plošiny a portály pridané počas hry nerobia nič. Ak niektorý priečinok chýba, tento druh teleportu je jednoducho vypnutý.
| Časť | Čo robí | Prečo |
|---|---|---|
playerFromHit | Nájde model postavy, ku ktorému patrí part, ktorý sa dotkol, a opýta sa Players:GetPlayerFromCharacter, čí je. | Plošín sa dotýkajú nohy, klobúky aj voľné party. Všetko, čo nie je časťou postavy hráča, vráti nil a ignoruje sa. |
onCooldown | Porovná os.clock() s časom posledného teleportu hráča. | Jeden cooldown na hráča, takže hráč stojaci pri plošine nikdy neblokuje ostatných. Nič nečaká ani nespí. |
rootHeight | Vypočíta, v akej výške nad podlahou je koreňový part stojacej postavy: polovica výšky koreňového partu plus HipHeight Humanoidu, plus dĺžka nohy pri rigoch R6. | Je to vzorec z referencie Robloxu k Humanoid.HipHeight. Pivot postavy je jej koreňový part, takže zdvihnutie pivotu o túto hodnotu postaví nohy na povrch pri malých aj veľkých avataroch aj pri R6. |
Kontroly na začiatku teleportTo | Skončí, ak hráč nemá živú postavu s koreňovým partom, a potom hneď zapíše čas. | Požiadavka na streaming nižšie môže skript prinútiť čakať. Ak sa čas zapíše vopred, množstvo udalostí Touched v tej chvíli nespustí druhý teleport. |
| Bod príchodu | Horná stena cieľa zdvihnutá o rootHeight, s pohľadom tam, kam smeruje jej predná stena, bez náklonu. Pri plošine je bod navyše posunutý o 3 studs od jej prednej steny. | Postava sa objaví v stoji, nie vnútri cieľového partu. Vedľa plošiny jej nohy začínajú na úrovni hornej steny plošiny, takže klesne na podlahu o hrúbku plošiny. CFrame.lookAlong postaví CFrame na pozícii so zadaným smerom pohľadu. |
RequestStreamAroundAsync | Požiada Roblox, aby tomuto hráčovi najprv poslal oblasť okolo bodu príchodu, a čaká najviac 2 sekundy. | Instance streaming je v nových place predvolene zapnutý, takže vzdialená časť mapy ešte nemusí byť na zariadení hráča načítaná. Roblox odporúča toto serverové volanie pred presunom postavy ďaleko, hoci nezaručuje, čo presne dorazí. |
| Druhá kontrola | Ak hráč odišiel alebo sa postava počas čakania oživila či zomrela, nič sa nepohne. | Hráč mohol urobiť reset alebo odísť z hry, kým sa oblasť načítavala. Vlastný príklad prednačítania od Robloxu tiež overuje, že postava je stále v hre, kým ju presunie. |
Riadky so SeatWeld | Ak postava sedí, zničí Weld, ktorý ju drží na sedadle. | Roblox privarí sediacu postavu k sedadlu. PivotTo posúva party zmenou ich CFrame a referencia Robloxu uvádza, že nastavenie CFrame partu posúva aj party s ním spojené, takže bez tohto by sedadlo a všetko, čo je k nemu privarené, prišlo spolu s hráčom. Zničenie SeatWeld je spôsob, ktorým referencia Robloxu k Seat zdvihne postavu zo sedadla skriptom. |
character:PivotTo(target) | Prenesie celú postavu, všetky končatiny a doplnky naraz, na bod príchodu. | Roblox označuje PivotTo za hlavnú funkciu na presúvanie modelov zo skriptov. |
Druhý riadok s lastTeleport | Po príchode spustí cooldown znova. | Požiadavka na streaming môže trvať až 2 sekundy, rovnako dlho ako samotný cooldown plošiny, takže bez tohto riadku by hráč mohol prísť s už uplynutým cooldownom. |
MovementCheckSkip | Po každom presune nastaví atribút na Player. | Serverová kontrola rýchlosti by skok považovala za cheat. MovementCheck z návodu na šprint číta tento atribút a začne merať odznova z novej pozície. Bez takého skriptu atribút nerobí nič. |
| Nastavenie | Hodnota tu | Čo mení |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Ako dlho plošiny a portály ignorujú hráča po akomkoľvek teleporte. |
MENU_COOLDOWN_SECONDS | 3 | Najkratší odstup medzi dvoma teleportmi cez menu pre jedného hráča. Plošiny a menu majú spoločné hodiny pre každého hráča, takže požiadavka z menu do 3 sekúnd po teleporte z plošiny sa tiež ignoruje. |
PAD_ARRIVAL_GAP | 3 | Koľko studs od prednej steny cieľovej plošiny sa hráči objavia, aby skončili vedľa plošiny, nie na nej. |
PLACE_ATTEMPTS | 3 | Koľkokrát portál skúsi TeleportAsync s odstupom 2 sekúnd, kým to vzdá. |
Kliknite na Play hneď teraz a stúpnite na PadA: objavíte sa pred PadB. Menu a portály potrebujú ďalšie dva kroky, ale skript funguje už aj bez nich.
Krok 4: teleport do iného place
Place je samostatný svet vnútri vašej hry, s vlastnými servermi: lobby a dungeon alebo hub a sada úrovní. Hráči sa medzi place presúvajú cez TeleportService a Roblox ho spúšťa len v publikovanej hre, preto tento krok končí v aplikácii Roblox, nie v Studiu.
- Ak hra ešte nie je publikovaná, vyberte File > Publish. Nové hry sú, kým ich nevydáte, otvorené len vám, ľuďom, ktorým ste dali prístup Edit, a členom skupiny s potrebnými rolami, a na vlastný test teleportov to stačí.
- Vytvorte druhý place: otvorte nový place z ľubovoľnej šablóny Studia, postavte svoj dungeon, potom vyberte File > Publish As, kliknite na dlaždicu svojej hry, vyberte Add as a new place a kliknite na Create.
- Skopírujte ID nového place. Otvorte Asset Manager z ponuky Window alebo z karty Home, prejdite do Places In Experience, kliknite na place pravým tlačidlom a vyberte Copy Asset ID, čím skopírujete jeho place ID.
- Po návrate do prvého place vložte do Workspace Folder s názvom
PlacePortalsa doň ukotvený Part s názvomDungeonPortal. Pridajte atribút typu Number s názvomPlaceIda vložte ID ako jeho hodnotu. - Kliknite na Play a dotknite sa portálu. Output vypíše riadok, ktorý začína
Teleporters: would send: v Studiu portál nič viac nerobí. - Publikujte hru znova cez File > Publish, aby sa portál objavil v publikovanej hre, a otestujte ho z aplikácie Roblox ako v kroku 5.
Teleporters volá TeleportAsync vnútri pcall, najviac 3-krát s pauzou 2 sekundy medzi pokusmi, pretože stránka Robloxu o teleportoch uvádza, že teleporty môžu zlyhať a vyhodiť chybu, a odporúča skúšať znova. Teleport sa tiež môže začať a v poslednej chvíli zlyhať bez chyby, takže hráč zostane tam, kde bol. Pre tento prípad Roblox volá TeleportInitFailed a skript zruší hráčovi príznak „odchádza“, takže nový dotyk portálu to skúsi znova.
Ak chcete hráčov vracať, urobte to isté v druhom place: dajte kópiu Teleporters do jeho ServerScriptService a pridajte portál, ktorého PlaceId je ID vášho prvého place, skopírované z Asset Manager rovnakým spôsobom.
Kto sa môže dostať do vašich ďalších place
Bezpečnostná dokumentácia Robloxu upozorňuje: len čo je klient v jednom place vašej hry, môže sa teleportovať do ktoréhokoľvek iného jej place, nech ste zamýšľali akúkoľvek trasu, a vypnutie Direct Access pri place odstráni len tlačidlo Join na webe. Mení to nastavenie Access Control for Places v časti Audience > Access Settings v Creator Dashboard:
| Nastavenie | Kto sa môže dostať do place, ktorý nie je štartovací |
|---|---|
| Fully open | Ktokoľvek, cez teleporty z akejkoľvek hry, deep links, pozvánky do hry a pripojenie k priateľovi. |
| Limited to same universe | Len hráči, ktorí sa teleportujú zvnútra vašich hier. Povolené sú teleporty z klienta aj zo servera. |
| Secure within universe only | Len hráči, ktorých teleportujú vaše serverové skripty zvnútra tejto hry. |
Ak sa hráči majú do place dostať len cez váš portál, napríklad do dungeonu, vyberte Secure within universe only. Každý teleport v tomto návode začína na serveri, takže bude fungovať ďalej. Roblox tiež uvádza, že mnohé hry zabezpečené teleporty nepotrebujú, takže hra, ktorej všetky place sú otvorené všetkým, môže nastavenie nechať, ako je.
V čom sa staré návody na teleporty mýlia
Ak tento návod porovnávate s videom alebo príspevkom na fóre, tu sú dôležité rozdiely a dôvod, prečo každý z postupov spôsobuje problém.
| Návod | Problém | Tento návod |
|---|---|---|
Nastaví hit.Parent.HumanoidRootPart.Position = target.Position | Referencia Robloxu uvádza, že nastavenie Position aktualizuje spoje partu a ten sa posunie voči partom, s ktorými je spojený: koreňový part odíde bez tela. | Prenesie celú postavu cez PivotTo. |
Nastaví HumanoidRootPart.CFrame = target.CFrame | Stred postavy skončí v strede cieľového partu, čiastočne v jeho vnútri, a prevezme náklon partu. | Postava sa objaví vo výške v stoji nad hornou stenou, vedľa plošiny, bez náklonu. |
Používa jednu premennú debounce na celú plošinu | Kým sa teleportuje jeden hráč, plošina ignoruje všetkých ostatných. A úplne bez debounce sa hráč, ktorý sa objaví na druhej plošine, hneď pošle späť. | Jeden cooldown na hráča, zapísaný pred akýmkoľvek čakaním, a hráči sa objavujú vedľa plošiny. |
Volá TeleportService:Teleport(placeId, player) z LocalScriptu | Roblox označuje Teleport() za zastaraný, odporúča ho v nových projektoch nepoužívať a TeleportAsync povoľuje len zo serverových skriptov. | Volá TeleportAsync v serverovom skripte. |
Žiadny pcall, žiadne opakované pokusy | Stránka Robloxu o teleportoch uvádza, že môžu zlyhať a vyhodiť chybu a tiež zlyhať až po štarte. | Až 3 pokusy v pcall a TeleportInitFailed umožní hráčovi skúsiť to znova. |
| Vzdá to, pretože v Studiu to „nefunguje“ | TeleportService nepodporuje playtest v Studiu. | RunService:IsStudio() namiesto toho vypíše, čo by portál urobil. |
| GUI teleportu, ktorého tlačidlá posielajú pozíciu | Cheater môže zavolať ten istý remote s akoukoľvek pozíciou. | Tlačidlá posielajú názov bodu a server ho vyhľadá. |
| Mince sa posielajú v teleport data | Roblox uvádza, že teleport data sú viditeľné klientovi a nie sú šifrované. | Odporúča ukladať mince a Wins do úložiska dát a načítať ich v druhom place (pozrite Ako preniesť dáta do iného place). |
Čo hráči môžu a nemôžu sfalšovať
Počítajte s tým, že cheater ovláda všetko na svojom zariadení: môže upravovať TeleportMenu, volať oba remoty ľubovoľne veľakrát s akýmikoľvek argumentmi a hýbať svojou postavou. Toto mu to pri tomto teleporte dá.
| Cheater sa pokúsi | Výsledok | Prečo |
|---|---|---|
| Poslať pozíciu alebo CFrame cez remote menu | Ignoruje sa | TeleportRequest číta jeden reťazec, názov bodu dlhý najviac 50 znakov. Všetko ostatné sa zahodí. |
| Vyžiadať Castle bez 3 Wins | Odmietnutie | Server číta Wins zo svojej kópie leaderstats. Sivé tlačidlo je len nápoveda. |
| Vyžiadať bod, ktorý neexistuje | Ignoruje sa | Server hľadá názov v TeleportSpots a nerobí nič, ak part s takým názvom neexistuje. |
| Volať remote menu stále dokola | Najviac jeden teleport cez menu za 3 sekundy | Cooldown sa uchováva na serveri, pre každého hráča. |
| Spustiť plošinu bez toho, aby k nej prišiel | Dostane sa k spárovanej plošine, ku ktorej by aj tak mohol dôjsť | Roblox uvádza teleportovanie na akékoľvek miesto a manipuláciu s udalosťami Touched medzi tým, čo klient môže robiť so svojou postavou. |
| Dostať sa do iného place vašej hry priamo | Je to možné, ak Access Control for Places nie je Secure within universe only | Pozrite Kto sa môže dostať do vašich ďalších place. |
| Presunúť svoju postavu kamkoľvek, aj na zamknutý bod | Je to možné | Každé zariadenie riadi pohyb svojej postavy. Zamknutý bod je pohodlie, nie trezor, preto pred tým, než tam dáte niečo cenné, overujte na serveri. |
Posledný riadok je úprimná hranica akéhokoľvek teleportu. Do súťažnej hry pridajte serverovú kontrolu pohybu, ako v návode na šprint. Teleporters už nastavuje atribút MovementCheckSkip, ktorý tá kontrola číta, takže jeho vlastné teleporty sa neoznačia ako porušenie: bezpečnostná dokumentácia Robloxu uvádza, že hry s legitímnymi teleportmi potrebujú v kontrolách pohybu práve takú výnimku.
Krok 5: otestujte
- Kliknite na Play. Stúpnite na PadA: objavíte sa tesne pred PadB, chrbtom k nej. Otočte sa a hneď stúpnite na PadB: nič sa nestane, pretože plošiny vás 2 sekundy po príchode ignorujú. Zostúpte, počkajte 2 sekundy a znova vstúpte na PadB: objavíte sa pred PadA.
- Počkajte niekoľko sekúnd a potom kliknite na Teleport v ľavej časti obrazovky. V zozname vidíte Lake, Spawn a sivé "Castle (needs 3 wins)". Vyberte Lake: objavíte sa na ňom. Otvorte menu znova a vyberte Castle: nič sa nestane a v Output je ticho.
- Dajte si 3 Wins (na to potrebujete skript leaderstats s IntValue Wins, napríklad z návodu na leaderboard). Kliknite na prepínač Client/Server, aby ste prešli na Server, nájdite v Explorer
Players, svoje meno,leaderstats,Winsa v okne Properties nastavte jeho Value na 3. Prepnite späť na Client a znova otvorte menu: Castle je fialový a prenesie vás tam. - Dotknite sa DungeonPortal. Output vypíše riadok, ktorý začína
Teleporters: would send, s vaším menom a place ID. V Studiu je to tak správne a vypisuje sa najviac raz za 2 sekundy, nech na portáli stojíte akokoľvek dlho. - V rozbaľovacom zozname režimov testu vyberte Server & Clients, nastavte 2 klientov a kliknite na Play. Obaja hráči môžu používať plošiny súčasne a cooldown jedného nikdy neblokuje druhého.
- Zastavte test, publikujte hru a spustite ju z aplikácie Roblox. Dotknite sa portálu: objaví sa načítavacia obrazovka Robloxu a ocitnete sa v druhom place. Ak ste zostali na mieste, otvorte Developer Console klávesom F9, prepnite log na pohľad Server, ktorý vidí len vlastník hry a členovia skupiny s právom úprav, a nájdite upozornenia
Teleporters:, v ktorých je uvedený dôvod, ktorý Roblox uviedol.
Počas krokov v Studiu majte otvorené okno Output (ponuka Window, potom Output). Keď Teleporters funguje, nevypisuje nič okrem riadku portálu z kroku 4, preto si každé upozornenie alebo červenú chybu oplatí prečítať. Pozrite Časté chyby.
Ako to rozšíriť
Teleport tímu alebo party naraz
TeleportAsync prijíma zoznam hráčov, takže jeden portál môže poslať do jedného place celú skupinu. Stránka Robloxu o teleportoch navrhuje vychádzať z hráča, ktorý sa portálu dotkol: player.Team a Team:GetPlayers() pre tím alebo SocialService:GetPlayersByPartyId() s player.PartyId pre party. Odovzdajte tento zoznam namiesto { player } a nastavte príznak leavingForPlace každému hráčovi z neho.
Poslanie skupiny na vlastný server
Predvolene sa teleportovaní hráči dostanú na verejný server druhého place. Ak chcete poslať skupinu na nový rezervovaný server, napríklad na zápas, vytvorte TeleportOptions, nastavte jeho ShouldReserveServer na true a odovzdajte ho ako tretí argument: TeleportService:TeleportAsync(placeId, players, options). Roblox uvádza, že pri zlyhaniach súvisiacich práve s rezervovanými servermi sú opakované pokusy obzvlášť užitočné, a skript ich už robí.
Ako preniesť dáta do iného place
Teleportovanie vynuluje všetky lokálne dáta daného hráča. Teleport data v Robloxe, ktoré sa nastavujú cez TeleportOptions:SetTeleportData() a v druhom place čítajú cez player:GetJoinData(), sú viditeľné klientovi a nie sú šifrované, preto ich používajte len na neškodné voľby, napríklad ktorú mapu načítať. Mince, Wins a predmety ukladajte do úložiska dát, ako v návode na DataStore, a načítajte ich znova, keď hráč príde do druhého place.
Vlastná načítavacia obrazovka
Kým sa teleport do place načítava, hráči vidia štandardnú načítavaciu obrazovku Robloxu. Ak chcete ukázať vlastnú, zavolajte na klientovi TeleportService:SetTeleportGui() so ScreenGui, napríklad s tým, ktorý je v ReplicatedStorage. Teleporty v tomto návode začínajú na serveri, preto ho klient musí zavolať vopred, napríklad hneď po vstupe hráča. Roblox uvádza, že obrazovku treba nastaviť znova pred každým teleportom a že sa nepoužíva pre place v inej hre. Tiež uvádza, že skripty vnútri tohto ScreenGui sa nespúšťajú, preto ju urobte statickú.
Teleporty kôl a checkpointy
Systém kôl na začiatku každého kola prenesie všetkých hráčov do arény rovnakým volaním PivotTo a časť PivotTo alebo SpawnLocation v návode na obby porovnáva tento prístup so spawn bodmi Robloxu. Ak sa má bod odomknúť až po kole, systém kôl už pripisuje Wins, ktoré číta WinsNeeded.
Časté chyby a riešenia
Otvorte okno Output (ponuka Window, potom Output) skôr, než kliknete na Play. Teleporters uvedie plošinu, keď Destination ukazuje do prázdna, takže väčšinu problémov uvidíte tam.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu čaká na remote, ktorý vytvára Teleporters, teda Teleporters nebeží. Overte, že je to Script, nie LocalScript, že je priamo v ServerScriptService, nie je vypnutý a že v Output nie je od neho červená chyba. Návod na chyby v skriptoch toto upozornenie podrobne vysvetľuje.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Atribút Destination plošiny uvádza niečo, čo nie je part priamo v priečinku TeleportPads. Skontrolujte pravopis a veľké písmená v hodnote atribútu aj v názve cieľovej plošiny. Upozornenie sa objaví raz na plošinu, keď sa jej hráč prvýkrát dotkne.
Stúpim na plošinu a nič sa nestane
Overte, že priečinok sa volá presne TeleportPads a je priamo vo Workspace pri štarte hry, že atribút Destination plošiny má typ String (atribút typu Number sa ignoruje) a že od vášho posledného teleportu uplynuli 2 sekundy. Overte tiež, že plošina má zapnuté CanTouch: Roblox uvádza, že pripojenie Touched k partu s vypnutým CanTouch vyhodí chybu a tá skript zastaví.
Objavím sa v stene alebo spadnem z okraja
Hráči sa objavia 3 studs pred prednou stenou cieľovej plošiny. Kliknite na plošinu pravým tlačidlom, vyberte Show Orientation Indicator a otáčajte plošinu, kým modrá čiara neukazuje na voľnú podlahu. Body menu kladú hráčov navrch partu, preto majte každý bod na podlahe.
Tlačidlo Castle zostáva sivé, aj keď mám 3 Wins
Zoznam sa kreslí pri otvorení menu, preto menu zavrite a otvorte znova. Ak je tlačidlo stále sivé, overte, že v leaderstats je IntValue s názvom presne Wins a že Wins sa zmenili na serveri, nie len v režime Client.
Portál v publikovanej hre nič nerobí
Otvorte Developer Console klávesom F9, prepnite log na pohľad Server (vidí ho len vlastník hry a členovia skupiny s právom úprav, pretože Teleporters je serverový Script) a prečítajte si upozornenia Teleporters:, v ktorých je uvedený dôvod, ktorý Roblox uviedol. Overte, že atribút PlaceId portálu má typ Number a obsahuje ID z Asset Manager a že ste place po pridaní portálu publikovali znova.
Urobiť s RoCode
Ak sa vám nechce stavať to všetko ručne, RoCode to môže urobiť v place, ktorý máte otvorený. RoCode je nezávislý AI agent pre Roblox Studio, nie od Robloxu: funkciu opíšete v jeho webovom chate a jeho plugin pre Studio vytvorí party a skripty vo vašom Explorer, takže nemusíte kopírovať kód z okna chatu.
Pridaj teleporty: plošiny vo Workspace.TeleportPads, ktoré posielajú hráčov k plošine zo svojho atribútu Destination s cooldownom 2 sekundy, menu Teleport pre body vo Workspace.TeleportSpots, kde Castle vyžaduje 3 Wins s kontrolou na serveri, a portály vo Workspace.PlacePortals, ktoré posielajú hráčov do place s ID zo svojho atribútu PlaceId, s opakovanými pokusmi.
- Keď to krok potrebuje, môže si prezrieť váš place cez Search Game a Search Scripts, aby staval na predmety, remoty alebo kód ukladania, ktoré už máte, a nepridával druhý systém
- Vytvorí priečinky a party plošín cez Create Instance, nastaví ich vlastnosti cez Set Property a napíše Teleporters a TeleportMenu cez Create Script
- Má za úlohu overiť kompiláciu každého napísaného skriptu cez Check Script, ktorý ho v Studiu skompiluje bez spustenia
- Posiela zmeny v dávkach a každá dávka je bod na vrátenie v histórii Studia
Teleporty medzi place fungujú len v publikovanej hre, preto ich otestujte v aplikácii Roblox sami. S pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.15 alebo novším môže jeho testovacia postava stúpať na plošiny a stláčať tlačidlá menu, ale kontroluje len to, čo sa sám rozhodol otestovať, preto na plošiny stúpnite a menu otvorte sami. Teleport je jeden systém z mnohých v hre; tvorba celej hry s RoCode prebieha rovnako, jeden systém na prompt. Ako sa RoCode pripája k Studiu.
Časté otázky
Ako urobiť teleportovaciu plošinu v Roblox Studiu?
Dajte dvom partom atribút Destination s názvami toho druhého a nech jeden serverový skript prenesie toho, kto sa plošiny dotkol, cez character:PivotTo na miesto tesne pred druhou plošinou, s krátkym cooldownom pre každého hráča. Krok 1 a krok 2 stavajú presne toto.
Prečo môj teleport nefunguje v Studiu?
Plošiny a menu v Studiu fungujú. Teleporty do iného place nie: TeleportService v Robloxe nepodporuje playtest v Studiu, preto hru publikujte a testujte v aplikácii Roblox. Skript z tohto návodu namiesto teleportu vypíše, čo by portál urobil, takže stále môžete overiť, že sa spúšťa.
Ako teleportovať hráčov do iného place mojej hry?
Pridajte place cez File > Publish As (Add as a new place), skopírujte jeho place ID z Asset Manager a zavolajte TeleportService:TeleportAsync(placeId, { player }) zo serverového Scriptu vnútri pcall, s opakovaním pri zlyhaní. Krok 4 vás tým celým prevedie.
Ako urobiť GUI teleportu?
Postavte tlačidlá v LocalScripte a serveru posielajte len názov bodu, ktorý hráč vybral. Server vyhľadá názov v priečinku, overí cooldown a akékoľvek pravidlo odomknutia a potom postavu prenesie. Nikdy neposielajte pozíciu z klienta: cheater môže poslať akúkoľvek.
Prečo sa moja postava po teleporte zasekne alebo rozpadne?
Priradenie Position koreňového partu posunie len tento part, bez tela, ktoré je s ním spojené, a skopírovanie CFrame plošiny dá stred postavy do vnútra plošiny. Použite character:PivotTo s bodom vo výške v stoji nad podlahou, vypočítanej z HipHeight Humanoidu.
Dajú sa s teleportom preniesť mince alebo predmety?
Bezpečne nie. Roblox uvádza, že teleport data sú viditeľné klientovi a nie sú šifrované, takže sa hodia na niečo ako vybraná mapa, ale nie na mince. Mince a predmety ukladajte do úložiska dát a načítajte ich v druhom place.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: Teleport between places (po anglicky). TeleportAsync, playtesty v Studiu, Access Control for Places, obrazovky teleportu, teleport data a zlyhané teleporty
- Roblox Creator Docs: TeleportService (po anglicky). zastaraný Teleport, TeleportAsync len na serveri a TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (po anglicky). hlavná funkcia na presúvanie modelov zo skriptov
- Roblox Creator Docs: BasePart.Position (po anglicky). prečo nastavenie Position pri spojenom parte ho posunie voči ostatným
- Roblox Creator Docs: Humanoid.HipHeight (po anglicky). v akej výške je koreňový part stojacej postavy, pre rigy R15 a R6
- Roblox Creator Docs: Seat (po anglicky). SeatWeld, ktorý drží sediacu postavu, a jeho zničenie na zdvihnutie postavy
- Roblox Creator Docs: Player:RequestStreamAroundAsync (po anglicky). požiadavka na oblasť pred presunom postavy tam, bez záruky, čo dorazí
- Roblox Creator Docs: Streaming techniques and conversion (po anglicky). predbežný streaming pred teleportom
- Roblox Creator Docs: Access control and confidentiality (po anglicky). prečo sa klienti môžu dostať do akéhokoľvek place hry, ak teleporty nie sú zabezpečené
- Roblox Creator Docs: Network ownership, movement validation, and physics (po anglicky). čo môže klient robiť so svojou postavou a výnimky pre teleporty v kontrolách pohybu
- Roblox Creator Docs: Create and publish games and places (po anglicky). publikovanie, kto môže otvoriť novú hru, a pridanie place cez Publish As
- Roblox Creator Docs: Asset Manager (po anglicky). ako skopírovať place ID
- Roblox Creator Docs: Developer Console (po anglicky). pohľad Server v logu a kto ho vidí
- Roblox Creator Docs: Debounce patterns (po anglicky). prečo sa Touched pri jednom dotyku spustí niekoľkokrát
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.