Kort fortalt
For en teleportplate legger du et Script i ServerScriptService som lytter etter platens Touched-event, finner spilleren med Players:GetPlayerFromCharacter og flytter hele karakteren med character:PivotTo() til et punkt rett foran målplaten, med ryggen mot den, med en nedkjøling på et par sekunder per spiller, så målplaten ikke sender spilleren tilbake med en gang. For å sende spillere til et annet place i spillet ditt kaller du TeleportService:TeleportAsync(placeId, { player }) fra et server-Script inne i pcall; det virker bare i et publisert spill, ikke i Studio.
- Flytt hele karakteren med
PivotTo. Å setteHumanoidRootPart.Positionflytter rotparten bort fra resten av kroppen, fordi Roblox oppdaterer leddene når Position settes. - En teleportmeny skal sende navnet på målet til serveren, ikke en posisjon. Serveren sjekker navnet, nedkjølingen og eventuelle opplåsingsregler før den flytter noen.
TeleportService:Teleport()er utdatert og kjører på klienten. BrukTeleportAsyncpå serveren, pakk den inn ipcall, prøv på nytt og håndterTeleportInitFailed.
På denne siden
To typer teleport
En teleport i et Roblox-spill kan bety tre ting: en plate som flytter deg over kartet, en meny med steder du kan hoppe til, eller en portal til en annen bane. De to første flytter karakteren innenfor serveren spilleren allerede er på. Den tredje sender spilleren til et annet place i spillet ditt, som kjører på sine egne servere. De bruker forskjellige API-er, så det er nyttig å vite hvilken du trenger.
| Innenfor samme server | Til et annet place i spillet ditt | |
|---|---|---|
| Kall | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Til hva | Teleportplater, teleportmenyer, å flytte spillere fra lobbyen til arenaen | Portaler til en annen bane, en lobby som sender spillere til et eget place med en dungeon eller en kamp |
| Hvor det kjører | Server-Script | Bare server-Script. Klientens Teleport() er utdatert. |
| Virker i playtest i Studio | Ja | Nei. TeleportService i Roblox støtter ikke playtest i Studio, så du tester i det publiserte spillet. |
| Hva spilleren ser | Et hopp over kartet som kan ta opptil 2 sekunder hvis området først må lastes inn | Lasteskjermen til Roblox, deretter det andre placet |
| Mynter, gjenstander og andre data | Blir som de er | Roblox nullstiller spillerens lokale data, så alt viktig må komme fra et datalager i det andre placet |
I denne guiden er alle tre typene samlet i ett server-Script, så ett sett regler dekker hver teleport i spillet ditt: serveren bestemmer, hver spiller har sin egen nedkjøling, og spillerens enhet sier bare hvilket sted den vil til.
| Element | Hvor det ligger | Hva det gjør |
|---|---|---|
Folder TeleportPads med PadA og PadB | Workspace | To plater. Attributten Destination på hver nevner platen den sender spillere til. |
Folder TeleportSpots | Workspace | Én part per sted i menylisten. Attributten WinsNeeded låser et sted. |
Folder PlacePortals | Workspace | Portal-parts. Attributten PlaceId på hver portal er placet den sender spillere til. |
Script Teleporters | ServerScriptService | Styrer alle tre typene teleport og lager to remoter. Det eneste stedet der en teleport kan skje. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Tegner Teleport-knappen og listen over steder og sender navnet på stedet spilleren valgte. |
RemoteFunction GetTeleportSpots og RemoteEvent TeleportRequest | ReplicatedStorage (lages av Teleporters) | Den første gir menyen listen over steder. Den andre bærer det valgte navnet til serveren. |
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
Steg 1: bygg to teleportplater
- Hold musepekeren over Workspace i Explorer, klikk på knappen + og sett inn en Folder. Kall mappen
TeleportPads. Skriptet ser etter akkurat det navnet. - Sett inn to Part i mappen og kall dem
PadAogPadB. Gjør hver til en flat plate, for eksempel 6 ganger 1 ganger 6 studs, og sett dem på gulvet et stykke fra hverandre. I Properties-vinduet huker du av Anchored, lar CanCollide og CanTouch være på, og gir dem en tydelig farge og materialet Neon, så spillerne legger merke til dem. - Marker PadA, rull Properties-vinduet ned til delen Attributes og klikk på +. Skriv navnet
Destination, velg typen String, klikk på Save og sett så verdien tilPadB. Gjør det samme på PadB med verdienPadA. - Drei hver plate så forsiden vender mot ledig gulv. Spillere dukker opp 3 studs foran forsiden til målplaten med ryggen mot den, så la det være noen studs med ledig gulv. For å se hvilken side som er forsiden, høyreklikker du på platen og velger Show Orientation Indicator: forsiden markeres med en blå linje. Drei platen med Rotate-verktøyet til linjen peker dit spillerne skal gå bort.
At spillere lander ved siden av platen og ikke på den, er med vilje. Roblox-siden om debounce nevner at Touched utløses mange ganger på rad for én berøring, så en spiller som dukket opp rett på den andre platen, ville utløse den igjen så snart nedkjølingen var over, og fly tilbake over kartet.
Du er ikke begrenset til to plater. Destination på en plate kan nevne hvilken som helst part i TeleportPads, så tre plater kan sende spillere rundt i en ring. For en enveisplate peker du den mot en part i TeleportPads som ikke har sin egen Destination: en slik part tar imot spillere og sender ingen noe sted.
Steg 2: legg til teleportskriptet
Hold musepekeren over ServerScriptService, sett inn et Script, kall det Teleporters og lim inn koden nedenfor. Akkurat nå håndterer det platene, og etter de neste stegene også menyen og portalene, så du legger det til bare én gang. Innstillingene øverst er linjene som er ment for å endres.
-- Script i ServerScriptService med navnet Teleporters.
-- Hver teleport avgjøres her, på serveren:
-- 1. Plater: når noen berører en part i Workspace.TeleportPads, flyttes de til parten som nevnes
-- i attributten Destination.
-- 2. Meny: LocalScriptet TeleportMenu ber om et sted fra Workspace.TeleportSpots
-- med navn. Serveren sjekker navnet, nedkjølingen og Wins som stedet krever.
-- 3. Portaler: når noen berører en part i Workspace.PlacePortals, sendes de til placet
-- som står i attributten PlaceId (et annet place i dette spillet).
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 -- så lenge ignorerer platene en spiller etter hver teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs foran målplaten, så spillere lander ved siden av den
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Dette skriptet lager begge remotene selv, så ikke legg dem til for hånd
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
-- Hvor høyt over gulvet rotparten til en stående karakter er.
-- Formelen fra Roblox-referansen for Humanoid.HipHeight (på R6-rigger legges beinets høyde til).
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() -- settes før ventingen, så en ny berøring ikke starter en ny teleport
-- Se dit forsiden av målet peker (vannrett, uten helning)
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
-- Stå på oversiden: pivot til karakteren er rotparten, så vi løfter den til ståhøyde.
-- En plate plasserer derimot spillere noen studs foran seg, fordi en spiller som står
-- på platen, ville utløse den igjen ved neste skritt.
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)
-- Med instance streaming på laster vi først inn området rundt målet (opptil 2 sekunder)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- gikk ut, respawnet eller døde mens området ble lastet inn
end
-- En sittende karakter er sveiset til setet, og å flytte den ville dra setet med.
-- Å ødelegge SeatWeld løsner først karakteren fra setet.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Ved ankomst starter vi nedkjølingen på nytt: forhåndslastingen ovenfor kan ta opptil 2 sekunder,
-- og platen spilleren landet ved, må ikke sende spilleren tilbake med en gang
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- for et skript med fartssjekk, hvis du har et
end
-- 1. Plater
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 -- advar én gang, ikke ved hver berøring
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Meny: listen over steder, deretter en forespørsel med navn
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 -- samme antall Wins: alfabetisk, så rekkefølgen aldri endrer seg
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Klienten sender bare navnet. Godta aldri en posisjon eller CFrame fra klienten.
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 -- låst for denne spilleren
end
teleportTo(player, spot, false)
end)
-- 3. Portaler til et annet place i dette spillet
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- allerede på vei, eller berørte en teleport for et øyeblikk siden
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 -- vi gir opp; en ny berøring av portalen prøver igjen
end
-- En teleport kan også feile etter at den har startet. Spilleren blir her og kan prøve igjen.
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 lager selv RemoteFunction GetTeleportSpots og RemoteEvent TeleportRequest, så du trenger ikke å sette inn noe i ReplicatedStorage for hånd. Det kobler til platene fra TeleportPads og portalene fra PlacePortals én gang når serveren starter, så plater og portaler som legges til mens spillet kjører, gjør ingenting. Hvis en av mappene mangler, er den typen teleport ganske enkelt slått av.
| Del | Hva den gjør | Hvorfor |
|---|---|---|
playerFromHit | Finner karaktermodellen som den berørende parten tilhører, og spør Players:GetPlayerFromCharacter hvis den finnes. | Plater blir berørt av føtter, hatter og løse parts. Alt som ikke er en del av en spillers karakter, gir nil og ignoreres. |
onCooldown | Sammenligner os.clock() med tidspunktet for spillerens siste teleport. | Én nedkjøling per spiller, så en spiller som står ved en plate, aldri blokkerer de andre. Ingenting venter eller sover. |
rootHeight | Regner ut hvor høyt over gulvet rotparten til en stående karakter er: halvparten av rotpartens høyde pluss HipHeight på Humanoid, pluss beinlengden på R6-rigger. | Det er formelen fra Roblox-referansen for Humanoid.HipHeight. Pivot til en karakter er rotparten, så når pivot løftes med denne verdien, står føttene på overflaten, både for små og store avatarer og for R6. |
Sjekkene i starten av teleportTo | Avslutter hvis spilleren ikke har en levende karakter med en rotpart, og noterer så tidspunktet med en gang. | Streaming-forespørselen nedenfor kan få skriptet til å vente. Når tidspunktet noteres på forhånd, starter ikke de mange Touched-eventene i det øyeblikket en ny teleport. |
| Ankomstpunkt | Oversiden av målet, løftet med rootHeight, med blikket dit forsiden vender, uten helning. For en plate er punktet i tillegg flyttet 3 studs fra forsiden. | Karakteren dukker opp stående, ikke inni målparten. Ved siden av en plate starter føttene i høyde med oversiden av platen, så karakteren faller ned på gulvet med platens tykkelse. CFrame.lookAlong bygger en CFrame på en posisjon med en gitt blikkretning. |
RequestStreamAroundAsync | Ber Roblox om først å sende området rundt ankomstpunktet til denne spilleren, og venter høyst 2 sekunder. | Instance streaming er på som standard i nye places, så en fjern del av kartet er kanskje ikke lastet inn på spillerens enhet ennå. Roblox anbefaler dette serverkallet før en karakter flyttes langt, selv om det ikke garanterer hva som faktisk kommer frem. |
| Andre sjekk | Hvis spilleren gikk ut, eller karakteren respawnet eller døde under ventingen, flytter ingenting seg. | Spilleren kan ha tatt reset eller forlatt spillet mens området ble lastet inn. Roblox sitt eget eksempel på forhåndslasting sjekker også at karakteren fortsatt er i spillet før den flyttes. |
Linjene med SeatWeld | Hvis karakteren sitter, ødelegges Weld-en som holder den fast i setet. | Roblox sveiser en sittende karakter til setet. PivotTo flytter parts ved å endre CFrame, og Roblox-referansen sier at når CFrame på en part settes, flyttes også partene som er koblet til den, så uten dette ville setet og alt som er sveiset til det, komme frem sammen med spilleren. Å ødelegge SeatWeld er måten Roblox-referansen for Seat løfter en karakter opp fra et sete fra et skript på. |
character:PivotTo(target) | Flytter hele karakteren, alle lemmer og accessories samlet, til ankomstpunktet. | Roblox kaller PivotTo hovedfunksjonen for å flytte modeller fra skript. |
Den andre linjen med lastTeleport | Starter nedkjølingen på nytt ved ankomst. | Streaming-forespørselen kan ta opptil 2 sekunder, like lenge som nedkjølingen til selve platen, så uten denne linjen kunne spilleren komme frem med en nedkjøling som allerede var over. |
MovementCheckSkip | Setter en attributt på Player etter hver flytting. | En fartssjekk på serveren ville tatt hoppet for juks. MovementCheck fra sprint-guiden leser denne attributten og begynner å måle på nytt fra den nye posisjonen. Uten et slikt skript gjør attributten ingenting. |
| Innstilling | Verdi her | Hva den endrer |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Hvor lenge plater og portaler ignorerer en spiller etter hver teleport. |
MENU_COOLDOWN_SECONDS | 3 | Korteste tid mellom to teleporter via menyen for én spiller. Plater og meny deler klokke per spiller, så en menyforespørsel innen 3 sekunder etter en teleport fra en plate ignoreres også. |
PAD_ARRIVAL_GAP | 3 | Hvor mange studs fra forsiden av målplaten spillere dukker opp, så de lander ved siden av platen og ikke på den. |
PLACE_ATTEMPTS | 3 | Hvor mange ganger en portal prøver TeleportAsync med 2 sekunders mellomrom før den gir opp. |
Trykk på Play nå og gå opp på PadA: du dukker opp foran PadB. Menyen og portalene krever de neste to stegene, men skriptet virker allerede uten dem.
Steg 4: teleport til et annet place
Et place er en egen verden inne i spillet ditt med sine egne servere: en lobby og en dungeon, eller en hub og et sett baner. Spillere flytter mellom places via TeleportService, og Roblox kjører den bare i et publisert spill, så dette steget slutter i Roblox-appen, ikke i Studio.
- Hvis spillet ikke er publisert ennå, velger du File > Publish. Nye spill er, til du slipper dem, bare åpne for deg, for folk du har gitt Edit-tilgang, og for gruppemedlemmer med de riktige rollene, og det holder for at du selv kan teste teleporter.
- Lag et andre place: åpne et nytt place fra hvilken som helst Studio-mal, bygg dungeonen din, og velg så File > Publish As, klikk på flisen til spillet ditt, velg Add as a new place og klikk på Create.
- Kopier ID-en til det nye placet. Åpne Asset Manager fra menyen Window eller fra fanen Home, gå til Places In Experience, høyreklikk på placet ditt og velg Copy Asset ID, som kopierer place-ID-en.
- Tilbake i det første placet setter du inn en Folder med navnet
PlacePortalsi Workspace og inni den en anchored Part med navnetDungeonPortal. Legg til en attributt av typen Number med navnetPlaceIdog lim inn ID-en som verdi. - Trykk på Play og berør portalen. Output skriver en linje som begynner med
Teleporters: would send: i Studio gjør portalen ikke mer enn det. - Publiser spillet på nytt med File > Publish, så portalen kommer med i det publiserte spillet, og test den fra Roblox-appen, som i steg 5.
Teleporters kaller TeleportAsync inne i pcall, opptil 3 ganger med 2 sekunders pause mellom forsøkene, fordi Roblox-siden om teleporter sier at teleporter kan feile og kaste en feil, og anbefaler å prøve på nytt. En teleport kan også starte og feile i siste øyeblikk uten en feil, og la spilleren bli der den var. For det tilfellet utløser Roblox TeleportInitFailed, og skriptet fjerner flagget "på vei bort" fra spilleren, så en ny berøring av portalen prøver igjen.
For å sende spillere tilbake gjør du det samme i det andre placet: legg en kopi av Teleporters i ServerScriptService der, og legg til en portal der PlaceId er ID-en til det første placet ditt, kopiert fra Asset Manager på samme måte.
Hvem kan komme inn i de andre placene dine
Sikkerhetsdokumentasjonen til Roblox advarer: så snart en klient er i ett place i spillet ditt, kan den teleportere til hvilket som helst annet place i spillet, uansett hvilken rute du hadde tenkt, og å slå av Direct Access på et place fjerner bare Join-knappen på nettsiden. Dette endres med innstillingen Access Control for Places under Audience > Access Settings i Creator Dashboard:
| Innstilling | Hvem kan komme inn i et place som ikke er startplacet |
|---|---|
| Fully open | Alle, via teleporter fra hvilket som helst spill, deep links, spillinvitasjoner og ved å bli med en venn. |
| Limited to same universe | Bare spillere som teleporterer fra inne i spillene dine. Teleporter fra både klient og server er tillatt. |
| Secure within universe only | Bare spillere som serverskriptene dine teleporterer fra inne i dette spillet. |
Hvis spillere bare skal kunne komme inn i et place via portalen din, for eksempel en dungeon, velger du Secure within universe only. Hver teleport i denne guiden starter på serveren, så den fortsetter å virke. Roblox sier også at mange spill ikke trenger sikre teleporter, så et spill der alle places er åpne for alle, kan la innstillingen være.
Hva gamle teleportguider tar feil i
Hvis du sammenligner denne guiden med en video eller et foruminnlegg, er dette de viktige forskjellene og grunnen til at hvert triks skaper et problem.
| Guide | Problem | Denne guiden |
|---|---|---|
Setter hit.Parent.HumanoidRootPart.Position = target.Position | Roblox-referansen sier at når Position settes, oppdateres leddene til parten, og den forskyves i forhold til partene den er koblet sammen med: rotparten farer av gårde uten kroppen. | Flytter hele karakteren med PivotTo. |
Setter HumanoidRootPart.CFrame = target.CFrame | Midten av karakteren havner i midten av målparten, delvis inni den, og tar over helningen til parten. | Karakteren dukker opp i ståhøyde over oversiden, ved siden av platen, uten helning. |
Bruker én debounce-variabel for hele platen | Mens én spiller teleporteres, ignorerer platen alle andre. Og helt uten debounce blir en spiller som dukker opp på den andre platen, sendt tilbake med en gang. | Én nedkjøling per spiller, notert før all venting, og spillere dukker opp ved siden av platen. |
Kaller TeleportService:Teleport(placeId, player) fra et LocalScript | Roblox merker Teleport() som utdatert, fraråder å bruke den i nye prosjekter og tillater TeleportAsync bare fra serverskript. | Kaller TeleportAsync i et serverskript. |
Ingen pcall, ingen nye forsøk | Roblox-siden om teleporter sier at de kan feile og kaste en feil, og også feile etter at de har startet. | Opptil 3 forsøk i pcall, og TeleportInitFailed lar spilleren prøve igjen. |
| Gir opp fordi det "ikke virker" i Studio | TeleportService støtter ikke playtest i Studio. | RunService:IsStudio() skriver i stedet hva portalen ville ha gjort. |
| En teleport-GUI der knappene sender en posisjon | En jukser kan kalle den samme remoten med hvilken som helst posisjon. | Knappene sender navnet på stedet, og serveren slår det opp. |
| Mynter sendes med i teleport data | Roblox sier at teleport data kan ses av klienten og ikke er kryptert. | Anbefaler å lagre mynter og Wins i et datalager og laste dem inn i det andre placet (se Slik flytter du data til et annet place). |
Hva spillere kan og ikke kan forfalske
Gå ut fra at en jukser styrer alt på sin egen enhet: den kan endre TeleportMenu, kalle begge remotene så mange ganger den vil med alle mulige argumenter, og flytte karakteren sin. Her er hva det gir den med denne teleporten.
| Jukseren prøver | Resultat | Hvorfor |
|---|---|---|
| Sende en posisjon eller CFrame via menyens remote | Ignoreres | TeleportRequest leser én streng, navnet på stedet på opptil 50 tegn. Alt annet kastes. |
| Be om Castle uten 3 Wins | Avvist | Serveren leser Wins fra sin egen kopi av leaderstats. Den grå knappen er bare et hint. |
| Be om et sted som ikke finnes | Ignoreres | Serveren slår opp navnet i TeleportSpots og gjør ingenting hvis det ikke finnes en part med det navnet. |
| Kalle menyens remote igjen og igjen | Høyst én teleport via menyen hvert 3. sekund | Nedkjølingen lagres på serveren, for hver spiller. |
| Utløse en plate uten å gå bort til den | Den lander ved platen den er paret med, som den uansett kunne gått til | Roblox nevner teleportering til hvilket som helst punkt og manipulering av Touched-eventer blant det klienten kan gjøre med karakteren sin. |
| Gå rett inn i et annet place i spillet ditt | Mulig hvis Access Control for Places ikke er satt til Secure within universe only | Se Hvem kan komme inn i de andre placene dine. |
| Flytte karakteren sin hvor som helst, også til et låst sted | Mulig | Hver enhet styrer bevegelsen til sin egen karakter. Et låst sted er en bekvemmelighet, ikke en safe, så sjekk på serveren før du gir noe verdifullt der. |
Den siste raden er den ærlige grensen for enhver teleport. For et konkurransespill legger du til en bevegelsessjekk på serveren, som i sprint-guiden. Teleporters setter allerede attributten MovementCheckSkip som den sjekken leser, så dens egne teleporter ikke merkes som brudd: sikkerhetsdokumentasjonen til Roblox sier at spill med legitime teleporter trenger nettopp et slikt unntak i bevegelsessjekker.
Steg 5: test det
- Trykk på Play. Gå opp på PadA: du dukker opp rett foran PadB med ryggen mot den. Snu deg og gå opp på PadB med en gang: ingenting skjer, fordi platene ignorerer deg i 2 sekunder etter ankomst. Gå ned, vent 2 sekunder og gå opp på PadB igjen: du dukker opp foran PadA.
- Vent noen sekunder og klikk så på Teleport på venstre side av skjermen. Listen viser Lake, Spawn og en grå "Castle (needs 3 wins)". Velg Lake: du dukker opp på den. Åpne menyen igjen og velg Castle: ingenting skjer, og Output er stille.
- Gi deg selv 3 Wins (det krever et leaderstats-skript med en IntValue Wins, for eksempel fra guiden om leaderboards). Klikk på bryteren Client/Server for å bytte til Server, finn
Players, navnet ditt,leaderstats,Winsi Explorer og sett Value til 3 i Properties-vinduet. Bytt tilbake til Client og åpne menyen igjen: Castle har blitt lilla og flytter deg dit. - Berør DungeonPortal. Output skriver en linje som begynner med
Teleporters: would send, med navnet ditt og place-ID-en. I Studio er det som det skal være, og den skrives høyst én gang hvert 2. sekund, uansett hvor lenge du står på portalen. - Velg Server & Clients i nedtrekksmenyen med testmoduser, sett 2 klienter og trykk på Play. Begge spillerne kan bruke platene samtidig, og nedkjølingen til den ene blokkerer aldri den andre.
- Stopp testen, publiser spillet og start det fra Roblox-appen. Berør portalen: lasteskjermen til Roblox vises, og du havner i det andre placet. Hvis du ble stående, åpner du Developer Console med F9, bytter loggen til visningen Server, som bare eieren av spillet og gruppemedlemmer med redigeringstilgang kan se, og finner advarslene
Teleporters:, som oppgir årsaken Roblox ga.
Ha Output-vinduet åpent under stegene i Studio (menyen Window, så Output). Når Teleporters virker, skriver det ingenting utenom portallinjen fra steg 4, så hver advarsel eller rød feil er verdt å lese. Se Vanlige feil.
Slik utvider du det
Teleporter et lag eller en party samlet
TeleportAsync tar en liste med spillere, så én portal kan sende en hel gruppe til samme place. Roblox-siden om teleporter foreslår å ta utgangspunkt i spilleren som berørte portalen: player.Team og Team:GetPlayers() for et lag, eller SocialService:GetPlayersByPartyId() med player.PartyId for en party. Send den listen i stedet for { player }, og sett flagget leavingForPlace på hver spiller i den.
Send en gruppe til sin egen server
Som standard havner teleporterte spillere på en offentlig server i det andre placet. For å sende en gruppe til en ny reservert server, for eksempel til en kamp, lager du TeleportOptions, setter ShouldReserveServer til true og sender den som tredje argument: TeleportService:TeleportAsync(placeId, players, options). Roblox nevner at nye forsøk er spesielt nyttige ved feil som gjelder nettopp reserverte servere, og skriptet gjør dem allerede.
Slik flytter du data til et annet place
Teleportering nullstiller alle lokale data for den spilleren. Teleport data i Roblox, som settes med TeleportOptions:SetTeleportData() og leses i det andre placet med player:GetJoinData(), kan ses av klienten og er ikke kryptert, så bruk dem bare til ufarlige valg, for eksempel hvilket kart som skal lastes inn. Mynter, Wins og gjenstander lagrer du i et datalager, som i guiden om DataStore, og laster dem inn igjen når spilleren kommer til det andre placet.
Din egen lasteskjerm
Mens en teleport til et place lastes inn, ser spillerne standard lasteskjerm fra Roblox. For å vise din egen kaller du TeleportService:SetTeleportGui() på klienten med en ScreenGui, for eksempel en som ligger i ReplicatedStorage. Teleportene i denne guiden starter på serveren, så klienten må kalle den på forhånd, for eksempel så snart spilleren har kommet inn. Roblox sier at skjermen må settes på nytt før hver teleport, og at den ikke brukes for et place i et annet spill. Der står det også at skript inne i denne ScreenGui-en ikke kjører, så gjør den statisk.
Teleporter i runder og sjekkpunkter
Rundesystemet flytter alle spillere til arenaen i starten av hver runde med det samme PivotTo-kallet, og delen PivotTo eller SpawnLocation i obby-guiden sammenligner den fremgangsmåten med spawnpunktene til Roblox. Hvis et sted bare skal åpnes etter en runde, gir rundesystemet allerede de Wins som WinsNeeded leser.
Vanlige feil og løsninger
Åpne Output-vinduet (menyen Window, så Output) før du trykker på Play. Teleporters nevner platen når Destination peker ut i ingenting, så de fleste problemer kan ses der.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu venter på remoten som Teleporters lager, så Teleporters kjører ikke. Sjekk at det er et Script og ikke et LocalScript, at det ligger rett i ServerScriptService, ikke er slått av, og at det ikke er noen rød feil fra det i Output. Guiden om skriptfeil forklarer denne advarselen i detalj.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Attributten Destination på platen nevner noe som ikke er en part rett inne i mappen TeleportPads. Sjekk stavemåte og store bokstaver i verdien til attributten og i navnet på målplaten. Advarselen vises én gang per plate, første gang en spiller berører den.
Jeg går opp på platen, og ingenting skjer
Sjekk at mappen heter nøyaktig TeleportPads og ligger rett i Workspace når spillet starter, at attributten Destination på platen er av typen String (en attributt av typen Number ignoreres), og at det har gått 2 sekunder siden din siste teleport. Sjekk også at CanTouch er på for platen: Roblox sier at å koble Touched til en part med CanTouch av gir en feil, og den stopper skriptet.
Jeg dukker opp inni en vegg eller faller utfor kanten
Spillere dukker opp 3 studs foran forsiden av målplaten. Høyreklikk på platen, velg Show Orientation Indicator og drei platen til den blå linjen peker mot ledig gulv. Menyens steder plasserer spillere oppå parten, så hold hvert sted på gulvet.
Castle-knappen forblir grå etter at jeg har tjent 3 Wins
Listen tegnes når menyen åpnes, så lukk menyen og åpne den igjen. Hvis knappen fortsatt er grå, sjekk at leaderstats har en IntValue med navnet nøyaktig Wins, og at Wins er endret på serveren og ikke bare i Client-modus.
Portalen gjør ingenting i det publiserte spillet
Åpne Developer Console med F9, bytt loggen til visningen Server (den kan bare ses av eieren av spillet og gruppemedlemmer med redigeringstilgang, fordi Teleporters er et server-Script), og les advarslene Teleporters:, som oppgir årsaken Roblox ga. Sjekk at attributten PlaceId på portalen er av typen Number og inneholder ID-en fra Asset Manager, og at du har publisert placet ditt på nytt etter at du la til portalen.
Lag det med RoCode
Hvis du ikke har lyst til å bygge alt dette for hånd, kan RoCode gjøre det i placen du har åpen. RoCode er en uavhengig AI-agent for Roblox Studio, ikke fra Roblox: du beskriver funksjonen i webchatten, og Studio-pluginen lager parts og skript i Explorer, så du slipper å kopiere kode fra et chatvindu.
Legg til teleporter: plater i Workspace.TeleportPads som sender spillere til platen fra attributten Destination med en nedkjøling på 2 sekunder, en Teleport-meny for steder i Workspace.TeleportSpots der Castle krever 3 Wins med sjekk på serveren, og portaler i Workspace.PlacePortals som sender spillere til placet med ID-en i attributten PlaceId, med nye forsøk.
- Kan gå gjennom placen din når et steg krever det, med Search Game og Search Scripts, for å bygge videre på eksisterende gjenstander, remoter eller lagringskode i stedet for å legge til et ekstra system
- Lager mapper og parts til platene med Create Instance, setter egenskapene deres med Set Property og skriver Teleporters og TeleportMenu med Create Script
- Den er instruert til å sjekke at hvert skript den skriver, kompilerer med Check Script, som kompilerer det i Studio uten å kjøre det
- Sender endringene i pakker, og hver pakke er et angrepunkt i historikken i Studio
Teleporter mellom places virker bare i et publisert spill, så dem tester du selv i Roblox-appen. Med plugin 3.9 eller nyere kan RoCode kjøre en kort playtest og lese feilene, og med plugin 3.9.15 eller nyere kan testfiguren gå opp på plater og trykke på menyknapper, men den sjekker bare det den selv har bestemt seg for å teste, så gå opp på platene og åpne menyen selv. En teleport er ett system av mange i et spill; å lage et helt spill med RoCode foregår på samme måte, ett system per prompt. Slik kobler RoCode seg til Studio.
Ofte stilte spørsmål
Hvordan lager jeg en teleportplate i Roblox Studio?
Gi to parts attributten Destination med navnet på hverandre, og la ett serverskript flytte den som berørte platen, med character:PivotTo til et punkt rett foran den andre platen, med en kort nedkjøling per spiller. Steg 1 og steg 2 bygger akkurat dette.
Hvorfor virker ikke teleporten min i Studio?
Plater og menyer virker i Studio. Teleporter til et annet place gjør ikke det: TeleportService i Roblox støtter ikke playtest i Studio, så publiser spillet og test i Roblox-appen. Skriptet fra denne guiden skriver i stedet for teleporten hva portalen ville ha gjort, så du kan fortsatt sjekke at den utløses.
Hvordan teleporterer jeg spillere til et annet place i spillet mitt?
Legg til et place med File > Publish As (Add as a new place), kopier place-ID-en fra Asset Manager, og kall TeleportService:TeleportAsync(placeId, { player }) fra et server-Script inne i pcall, og prøv på nytt ved feil. Steg 4 tar deg gjennom alt.
Hvordan lager jeg en teleport-GUI?
Bygg knappene i et LocalScript, og send bare navnet på stedet spilleren valgte, til serveren. Serveren slår opp navnet i en mappe, sjekker nedkjølingen og eventuelle opplåsingsregler, og flytter så karakteren. Send aldri en posisjon fra klienten: en jukser kan sende hvilken som helst.
Hvorfor sitter karakteren min fast eller faller fra hverandre etter en teleport?
Å sette Position på rotparten flytter bare den parten, uten kroppen som er koblet til den, og å kopiere CFrame-en til platen plasserer midten av karakteren inni platen. Bruk character:PivotTo med et punkt i ståhøyde over gulvet, regnet ut fra HipHeight på Humanoid.
Kan jeg sende mynter eller gjenstander med en teleport?
Ikke trygt. Roblox sier at teleport data kan ses av klienten og ikke er kryptert, så de passer for noe som det valgte kartet, men ikke for mynter. Lagre mynter og gjenstander i et datalager, og last dem inn i det andre placet.
Kilder og videre lesing
- Roblox Creator Docs: Teleport between places (på engelsk). TeleportAsync, playtest i Studio, Access Control for Places, teleportskjermer, teleport data og mislykkede teleporter
- Roblox Creator Docs: TeleportService (på engelsk). den utdaterte Teleport, TeleportAsync bare på serveren og TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (på engelsk). hovedfunksjonen for å flytte modeller fra skript
- Roblox Creator Docs: BasePart.Position (på engelsk). hvorfor det å sette Position på en sammenkoblet part forskyver den i forhold til de andre
- Roblox Creator Docs: Humanoid.HipHeight (på engelsk). hvor høyt rotparten til en stående karakter er, for R15- og R6-rigger
- Roblox Creator Docs: Seat (på engelsk). SeatWeld-en som holder en sittende karakter, og å ødelegge den for å løfte karakteren opp
- Roblox Creator Docs: Player:RequestStreamAroundAsync (på engelsk). å be om et område før karakteren flyttes dit, uten garanti for hva som kommer frem
- Roblox Creator Docs: Streaming techniques and conversion (på engelsk). streaming på forhånd før en teleport
- Roblox Creator Docs: Access control and confidentiality (på engelsk). hvorfor klienter kan komme inn i hvilket som helst place i spillet hvis teleporter ikke er sikret
- Roblox Creator Docs: Network ownership, movement validation, and physics (på engelsk). hva klienten kan gjøre med karakteren sin, og unntak for teleporter i bevegelsessjekker
- Roblox Creator Docs: Create and publish games and places (på engelsk). publisering, hvem som kan åpne et nytt spill, og å legge til et place med Publish As
- Roblox Creator Docs: Asset Manager (på engelsk). slik kopierer du en place-ID
- Roblox Creator Docs: Developer Console (på engelsk). visningen Server i loggen, og hvem som kan se den
- Roblox Creator Docs: Debounce patterns (på engelsk). hvorfor Touched utløses flere ganger for én berøring
Slik ble koden sjekket: hvert skript på denne siden går gjennom streng Luau-typesjekk med Roblox API-definisjonene (luau-lsp, 20. november 2026). Typesjekken fanger feil i API-navn og feil typer, men ikke feil i spillogikken, så test alt i Studio før du publiserer.