Kort fortalt
Til en teleportplade lægger du et Script i ServerScriptService, der lytter efter pladens Touched-event, finder spilleren med Players:GetPlayerFromCharacter og flytter hele karakteren med character:PivotTo() til et punkt lige foran destinationspladen, med ryggen til den, med en cooldown på et par sekunder pr. spiller, så destinationspladen ikke straks sender spilleren tilbage. For at sende spillere til et andet place i dit spil kalder du TeleportService:TeleportAsync(placeId, { player }) fra et server-Script inde i pcall; det virker kun i et udgivet spil, ikke i Studio.
- Flyt hele karakteren med
PivotTo. At tildeleHumanoidRootPart.Positionflytter rodparten væk fra resten af kroppen, fordi Roblox opdaterer samlingerne, når Position sættes. - En teleportmenu skal sende destinationens navn til serveren, ikke en position. Serveren tjekker navnet, cooldown og enhver oplåsningsregel, før den flytter nogen.
TeleportService:Teleport()er forældet og kører på klienten. BrugTeleportAsyncpå serveren, pak den ind ipcall, prøv igen, og håndtérTeleportInitFailed.
På denne side
To slags teleport
En teleport i et Roblox-spil kan betyde tre ting: en plade, der flytter dig på tværs af kortet, en menu med steder, du kan hoppe til, eller en portal til en anden bane. De to første flytter karakteren inden for den server, spilleren allerede er på. Den tredje sender spilleren til et andet place i dit spil, som kører på sine egne servere. De bruger forskellige API'er, så det er nyttigt at vide, hvilken du har brug for.
| Inden for samme server | Til et andet place i dit spil | |
|---|---|---|
| Kald | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Til hvad | Teleportplader, teleportmenuer, at flytte spillere fra lobbyen til arenaen | Portaler til en anden bane, en lobby, der sender spillere til et separat place med et dungeon eller en kamp |
| Hvor det kører | Server-Script | Kun server-Script. Klientens Teleport() er forældet. |
| Virker i en playtest i Studio | Ja | Nej. TeleportService i Roblox understøtter ikke playtest i Studio, så man tester i det udgivne spil. |
| Hvad spilleren ser | Et hop på tværs af kortet, der kan tage op til 2 sekunder, hvis området først skal indlæses | Robloxs loading-skærm, derefter det andet place |
| Mønter, genstande og andre data | Forbliver som de er | Roblox nulstiller spillerens lokale data, så alt vigtigt skal komme fra et datalager i det andet place |
I denne guide er alle tre slags samlet i ét server-Script, så ét sæt regler dækker hver teleport i dit spil: serveren afgør, hver spiller har sin egen cooldown, og spillerens enhed melder kun, hvilket sted den gerne vil hen til.
| Element | Hvor det ligger | Hvad det gør |
|---|---|---|
Folder TeleportPads med PadA og PadB | Workspace | To plader. Attributten Destination på hver nævner den plade, den sender spillere til. |
Folder TeleportSpots | Workspace | Én part pr. sted i menuens liste. Attributten WinsNeeded låser et sted. |
Folder PlacePortals | Workspace | Portal-parts. Attributten PlaceId på hver portal er det place, den sender spillere til. |
Script Teleporters | ServerScriptService | Styrer alle tre slags teleport og opretter to remotes. Det eneste sted, hvor en teleport kan ske. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Tegner Teleport-knappen og listen over steder og sender navnet på det sted, spilleren valgte. |
RemoteFunction GetTeleportSpots og RemoteEvent TeleportRequest | ReplicatedStorage (oprettes af Teleporters) | Den første giver menuen listen over steder. Den anden bærer det valgte navn 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
Trin 1: byg to teleportplader
- Hold musen over Workspace i Explorer, klik på knappen +, og indsæt en Folder. Kald mappen
TeleportPads. Scriptet leder efter netop det navn. - Indsæt to Part i mappen, og kald dem
PadAogPadB. Gør hver til en flad plade, for eksempel 6 gange 1 gange 6 studs, og stil dem på gulvet et stykke fra hinanden. I Properties-vinduet sætter du flueben i Anchored, lader CanCollide og CanTouch være slået til og giver dem en klar farve og materialet Neon, så spillerne lægger mærke til dem. - Markér PadA, rul Properties-vinduet ned til afsnittet Attributes, og klik på +. Skriv navnet
Destination, vælg typen String, og klik på Save, og sæt derefter værdien tilPadB. Gør det samme på PadB med værdienPadA. - Drej hver plade, så dens forside vender mod fri gulvplads. Spillere dukker op 3 studs foran destinationspladens forside med ryggen til den, så lad der være nogle studs fri gulvplads. For at se, hvilken side der er forsiden, højreklikker du på pladen og vælger Show Orientation Indicator: forsiden markeres af en blå linje. Drej pladen med Rotate-værktøjet, indtil linjen peger derhen, hvor spillerne skal gå væk.
At spillere lander ved siden af pladen og ikke på den, er med vilje. Roblox-siden om debounce nævner, at Touched udløses mange gange i træk for én berøring, så en spiller, der dukkede op direkte på den anden plade, ville udløse den igen, så snart cooldown var slut, og flyve tilbage på tværs af kortet.
Du er ikke begrænset til to plader. En plades Destination kan nævne en hvilken som helst part i TeleportPads, så tre plader kan sende spillere rundt i en ring. Til en envejsplade peger du den på en part i TeleportPads, der ikke har sin egen Destination: sådan en part tager imod spillere og sender ingen nogen steder hen.
Trin 2: tilføj teleport-scriptet
Hold musen over ServerScriptService, indsæt et Script, kald det Teleporters, og indsæt koden nedenfor i det. Lige nu håndterer det pladerne, og efter de næste trin også menuen og portalerne, så du tilføjer det kun én gang. Indstillingerne øverst er de linjer, du er beregnet til at ændre.
-- Script i ServerScriptService med navnet Teleporters.
-- Hver teleport afgøres her, på serveren:
-- 1. Plader: berøring af en part i Workspace.TeleportPads flytter dig til den part, der nævnes
-- i dens attribut Destination.
-- 2. Menu: LocalScriptet TeleportMenu beder om et sted fra Workspace.TeleportSpots
-- ved navn. Serveren tjekker navnet, cooldown og de Wins, stedet kræver.
-- 3. Portaler: berøring af en part i Workspace.PlacePortals sender dig til det place,
-- der står i dens attribut PlaceId (et andet place i dette spil).
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å længe ignorerer pladerne en spiller efter enhver teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs foran destinationspladen, så spillere lander ved siden af den
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Dette script opretter selv begge remotes, så tilføj dem ikke i hånden
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øjt over gulvet rodparten på en stående karakter befinder sig.
-- Formlen fra Roblox-referencen for Humanoid.HipHeight (på R6-rigs lægges benets højde 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() -- sættes før ventetiden, så en anden berøring ikke starter en anden teleport
-- Kig derhen, hvor destinationens forside peger (vandret, uden hældning)
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
-- Stil dig på dens overside: karakterens pivot er dens rodpart, så vi løfter den til ståhøjde.
-- En plade placerer derimod spillere nogle studs foran sig, fordi en spiller, der står
-- på pladen, ville udløse den igen ved næste skridt.
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 slået til indlæser vi først området omkring destinationen (op til 2 sekunder)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- gik ud, genopstod eller døde, mens området blev indlæst
end
-- En siddende karakter er svejset til sædet, og at flytte den ville trække sædet med.
-- At destruere SeatWeld frigør først karakteren fra sædet.
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 cooldown forfra: forindlæsningen ovenfor kan tage op til 2 sekunder,
-- og den plade, spilleren landede ved, må ikke straks sende spilleren tilbage
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- til et script med hastighedstjek, hvis du har et
end
-- 1. Plader
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. Menu: listen over steder, derefter en forespørgsel ved 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 antal Wins: alfabetisk, så rækkefølgen aldrig ændrer sig
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Klienten sender kun navnet. Accepter aldrig en position 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 spiller
end
teleportTo(player, spot, false)
end)
-- 3. Portaler til et andet place i dette spil
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- allerede på vej eller rørte en teleport for et sekund 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 giver op; en ny berøring af portalen prøver igen
end
-- En teleport kan også fejle efter start. Spilleren bliver her og kan prøve igen.
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 opretter selv RemoteFunction GetTeleportSpots og RemoteEvent TeleportRequest, så du behøver ikke at indsætte noget i ReplicatedStorage i hånden. Det forbinder pladerne fra TeleportPads og portalerne fra PlacePortals én gang, når serveren starter, så plader og portaler, der tilføjes under spillet, gør ingenting. Hvis en af mapperne mangler, er den slags teleport bare slået fra.
| Del | Hvad den gør | Hvorfor |
|---|---|---|
playerFromHit | Finder den karaktermodel, som den rørende part tilhører, og spørger Players:GetPlayerFromCharacter, hvis den er. | Plader bliver rørt af fødder, hatte og løse parts. Alt, der ikke er en del af en spillers karakter, giver nil og ignoreres. |
onCooldown | Sammenligner os.clock() med tidspunktet for spillerens seneste teleport. | Én cooldown pr. spiller, så en spiller, der står ved en plade, aldrig blokerer de andre. Intet venter eller sover. |
rootHeight | Beregner, hvor højt over gulvet rodparten på en stående karakter er: halvdelen af rodpartens højde plus HipHeight på Humanoid, plus benlængden på R6-rigs. | Det er formlen fra Roblox-referencen for Humanoid.HipHeight. En karakters pivot er dens rodpart, så når pivot løftes med denne værdi, står fødderne på overfladen, både for små og store avatarer og for R6. |
Tjekkene i starten af teleportTo | Afslutter, hvis spilleren ikke har en levende karakter med en rodpart, og noterer derefter straks tidspunktet. | Streaming-forespørgslen nedenfor kan få scriptet til at vente. Når tidspunktet noteres på forhånd, starter de mange Touched-events i det øjeblik ikke en anden teleport. |
| Ankomstpunkt | Destinationens overside, løftet med rootHeight, med blikket rettet derhen, hvor dens forside vender, uden hældning. For en plade er punktet desuden flyttet 3 studs fra dens forside. | Karakteren dukker op stående, ikke inde i destinationsparten. Ved siden af en plade starter fødderne i højde med pladens overside, så karakteren falder ned på gulvet med pladens tykkelse. CFrame.lookAlong bygger en CFrame på en position med en given blikretning. |
RequestStreamAroundAsync | Beder Roblox om først at sende området omkring ankomstpunktet til denne spiller og venter højst 2 sekunder. | Instance streaming er slået til som standard i nye places, så en fjern del af kortet er måske endnu ikke indlæst på spillerens enhed. Roblox anbefaler dette serverkald, før en karakter flyttes langt, selv om det ikke garanterer, hvad der præcis når frem. |
| Andet tjek | Hvis spilleren gik ud, eller karakteren genopstod eller døde under ventetiden, flytter intet sig. | Spilleren kan have lavet reset eller forladt spillet, mens området blev indlæst. Robloxs eget forindlæsningseksempel tjekker også, at karakteren stadig er i spillet, før den flyttes. |
Linjerne med SeatWeld | Hvis karakteren sidder, destrueres den Weld, der holder den på sædet. | Roblox svejser en siddende karakter til sædet. PivotTo flytter parts ved at ændre deres CFrame, og i Roblox-referencen står der, at når en parts CFrame sættes, flyttes de parts, der er samlet med den, også, så uden dette ville sædet og alt, der er svejset til det, ankomme sammen med spilleren. At destruere SeatWeld er den måde, Roblox-referencen for Seat løfter en karakter op fra et sæde fra et script. |
character:PivotTo(target) | Flytter hele karakteren, alle lemmer og accessories samlet, til ankomstpunktet. | Roblox kalder PivotTo den primære funktion til at flytte modeller fra scripts. |
Den anden linje med lastTeleport | Starter cooldown forfra ved ankomst. | Streaming-forespørgslen kan tage op til 2 sekunder, lige så længe som selve pladens cooldown, så uden denne linje kunne spilleren ankomme med en cooldown, der allerede var udløbet. |
MovementCheckSkip | Sætter en attribut på Player efter hver flytning. | Et hastighedstjek på serveren ville tage hoppet for snyd. MovementCheck fra sprint-guiden læser denne attribut og begynder at måle forfra fra den nye position. Uden et sådant script gør attributten ingenting. |
| Indstilling | Værdi her | Hvad den ændrer |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Hvor længe plader og portaler ignorerer en spiller efter enhver teleport. |
MENU_COOLDOWN_SECONDS | 3 | Det korteste mellemrum mellem to teleporter via menuen for én spiller. Plader og menu deler ur pr. spiller, så en menuforespørgsel inden for 3 sekunder efter en teleport fra en plade ignoreres også. |
PAD_ARRIVAL_GAP | 3 | Hvor mange studs fra destinationspladens forside spillere dukker op, så de lander ved siden af pladen og ikke på den. |
PLACE_ATTEMPTS | 3 | Hvor mange gange en portal prøver TeleportAsync med 2 sekunders mellemrum, før den giver op. |
Tryk på Play nu, og træd op på PadA: du dukker op foran PadB. Menuen og portalerne kræver de næste to trin, men scriptet virker allerede uden dem.
Trin 4: teleport til et andet place
Et place er en separat verden inde i dit spil med sine egne servere: en lobby og et dungeon eller en hub og et sæt baner. Spillere flytter mellem places via TeleportService, og Roblox kører den kun i et udgivet spil, så dette trin slutter i Roblox-appen, ikke i Studio.
- Hvis spillet endnu ikke er udgivet, så vælg File > Publish. Nye spil er, indtil du frigiver dem, kun åbne for dig, for folk, du har givet Edit-adgang, og for gruppemedlemmer med de rette roller, og det er nok til at du selv kan teste teleporter.
- Opret et andet place: åbn et nyt place fra en hvilken som helst Studio-skabelon, byg dit dungeon, og vælg derefter File > Publish As, klik på dit spils flise, vælg Add as a new place, og klik på Create.
- Kopiér det nye places ID. Åbn Asset Manager fra menuen Window eller fra fanen Home, gå til Places In Experience, højreklik på dit place, og vælg Copy Asset ID, som kopierer dets place ID.
- Tilbage i det første place indsætter du en Folder med navnet
PlacePortalsi Workspace og indeni en ankret Part med navnetDungeonPortal. Tilføj en attribut af typen Number med navnetPlaceId, og indsæt ID som dens værdi. - Tryk på Play, og rør portalen. Output skriver en linje, der starter med
Teleporters: would send: i Studio gør portalen ikke mere end det. - Udgiv spillet igen med File > Publish, så portalen kommer med i det udgivne spil, og test den fra Roblox-appen, som i trin 5.
Teleporters kalder TeleportAsync inde i pcall, op til 3 gange med 2 sekunders pause mellem forsøgene, fordi Roblox-siden om teleporter siger, at teleporter kan fejle og give en fejl, og anbefaler at prøve igen. En teleport kan også starte og fejle i sidste øjeblik uden en fejl og efterlade spilleren, hvor den var. Til det tilfælde udløser Roblox TeleportInitFailed, og scriptet fjerner flaget "på vej væk" fra spilleren, så en ny berøring af portalen prøver igen.
For at sende spillere tilbage gør du det samme i det andet place: læg en kopi af Teleporters i dets ServerScriptService, og tilføj en portal, hvis PlaceId er ID for dit første place, kopieret fra Asset Manager på samme måde.
Hvem kan komme ind i dine andre places
Robloxs sikkerhedsdokumentation advarer: så snart en klient er i ét place i dit spil, kan den teleportere til et hvilket som helst andet place i spillet, uanset hvilken rute du havde tænkt dig, og at slå Direct Access fra på et place fjerner kun Join-knappen på hjemmesiden. Det ændres med indstillingen Access Control for Places under Audience > Access Settings i Creator Dashboard:
| Indstilling | Hvem kan komme ind i et place, der ikke er startplacet |
|---|---|
| Fully open | Alle, via teleporter fra ethvert spil, deep links, spilinvitationer og ved at joine en ven. |
| Limited to same universe | Kun spillere, der teleporterer inde fra dine spil. Teleporter fra både klient og server er tilladt. |
| Secure within universe only | Kun spillere, som dine server-scripts teleporterer inde fra dette spil. |
Hvis spillere kun skal kunne komme ind i et place via din portal, for eksempel et dungeon, så vælg Secure within universe only. Hver teleport i denne guide starter på serveren, så den bliver ved med at virke. Roblox siger også, at mange spil ikke har brug for sikre teleporter, så et spil, hvor alle places er åbne for alle, kan lade indstillingen være.
Hvad gamle teleport-tutorials tager fejl af
Hvis du sammenligner denne guide med en video eller et forumindlæg, er her de vigtige forskelle og grunden til, at hvert trick skaber et problem.
| Tutorial | Problem | Denne guide |
|---|---|---|
Sætter hit.Parent.HumanoidRootPart.Position = target.Position | I Roblox-referencen står der, at når Position sættes, opdateres partens samlinger, og den forskydes i forhold til de parts, den er samlet med: rodparten kører væk uden kroppen. | Flytter hele karakteren med PivotTo. |
Sætter HumanoidRootPart.CFrame = target.CFrame | Karakterens midte havner i midten af målparten, delvist inde i den, og overtager partens hældning. | Karakteren dukker op i ståhøjde over oversiden, ved siden af pladen, uden hældning. |
Bruger én debounce-variabel for hele pladen | Mens én spiller teleporteres, ignorerer pladen alle andre. Og helt uden debounce bliver en spiller, der dukker op på den anden plade, straks sendt tilbage. | Én cooldown pr. spiller, noteret før enhver ventetid, og spillere dukker op ved siden af pladen. |
Kalder TeleportService:Teleport(placeId, player) fra et LocalScript | Roblox markerer Teleport() som forældet, fraråder at bruge den i nye projekter og tillader kun TeleportAsync fra server-scripts. | Kalder TeleportAsync i et server-script. |
Ingen pcall, ingen nye forsøg | Roblox-siden om teleporter siger, at de kan fejle og give en fejl og også fejle efter start. | Op til 3 forsøg i pcall, og TeleportInitFailed lader spilleren prøve igen. |
| Giver op, fordi det "ikke virker" i Studio | TeleportService understøtter ikke playtest i Studio. | RunService:IsStudio() skriver i stedet, hvad portalen ville have gjort. |
| En teleport-GUI, hvis knapper sender en position | En snyder kan kalde den samme remote med en hvilken som helst position. | Knapperne sender stedets navn, og serveren slår det op. |
| Mønter sendes med i teleport data | Roblox siger, at teleport data kan ses af klienten og ikke er krypteret. | Anbefaler at gemme mønter og Wins i et datalager og indlæse dem i det andet place (se Sådan flytter du data til et andet place). |
Hvad spillere kan og ikke kan forfalske
Gå ud fra, at en snyder styrer alt på sin egen enhed: den kan rette i TeleportMenu, kalde begge remotes så mange gange, den vil, med alle mulige argumenter og flytte sin karakter. Her er, hvad det giver den med denne teleport.
| Snyderen prøver | Resultat | Hvorfor |
|---|---|---|
| Sende en position eller CFrame via menuens remote | Ignoreres | TeleportRequest læser én streng, stedets navn på op til 50 tegn. Alt andet kasseres. |
| Bede om Castle uden 3 Wins | Afvist | Serveren læser Wins fra sin egen kopi af leaderstats. Den grå knap er kun et hint. |
| Bede om et sted, der ikke findes | Ignoreres | Serveren slår navnet op i TeleportSpots og gør ingenting, hvis der ikke er en part med det navn. |
| Kalde menuens remote igen og igen | Højst én teleport via menuen hvert 3. sekund | Cooldown gemmes på serveren, for hver spiller. |
| Udløse en plade uden at gå hen til den | Den lander ved den parrede plade, som den alligevel kunne gå hen til | Roblox nævner teleportering til et hvilket som helst punkt og manipulation af Touched-events blandt de ting, klienten kan gøre med sin karakter. |
| Gå direkte ind i et andet place i dit spil | Muligt, hvis Access Control for Places ikke er sat til Secure within universe only | Se Hvem kan komme ind i dine andre places. |
| Flytte sin karakter hvor som helst hen, også til et låst sted | Muligt | Hver enhed styrer sin karakters bevægelse. Et låst sted er en bekvemmelighed, ikke et pengeskab, så tjek på serveren, før du giver noget værdifuldt der. |
Den sidste række er den ærlige grænse for enhver teleport. Til et konkurrencespil tilføjer du et bevægelsestjek på serveren, som i sprint-guiden. Teleporters sætter allerede attributten MovementCheckSkip, som det tjek læser, så dets egne teleporter ikke markeres som en overtrædelse: i Robloxs sikkerhedsdokumentation står der, at spil med legitime teleporter har brug for netop sådan en undtagelse i bevægelsestjek.
Trin 5: test det
- Tryk på Play. Træd op på PadA: du dukker op lige foran PadB med ryggen til den. Vend dig om, og træd straks op på PadB: der sker ingenting, fordi pladerne ignorerer dig i 2 sekunder efter ankomst. Træd ned, vent 2 sekunder, og gå op på PadB igen: du dukker op foran PadA.
- Vent nogle sekunder, og klik derefter på Teleport i venstre side af skærmen. Listen viser Lake, Spawn og en grå "Castle (needs 3 wins)". Vælg Lake: du dukker op på den. Åbn menuen igen, og vælg Castle: der sker ingenting, og Output er stille.
- Giv dig selv 3 Wins (det kræver et leaderstats-script med en IntValue Wins, for eksempel fra guiden til leaderboards). Klik på kontakten Client/Server for at skifte til Server, find i Explorer
Players, dit navn,leaderstats,Wins, og sæt dens Value til 3 i Properties-vinduet. Skift tilbage til Client, og åbn menuen igen: Castle er blevet lilla og flytter dig derhen. - Rør DungeonPortal. Output skriver en linje, der starter med
Teleporters: would send, med dit navn og place ID. I Studio er det, som det skal være, og den skrives højst én gang hvert 2. sekund, uanset hvor længe du står på portalen. - Vælg Server & Clients i rullemenuen med testtilstande, sæt 2 klienter, og tryk på Play. Begge spillere kan bruge pladerne på samme tid, og den enes cooldown blokerer aldrig den anden.
- Stop testen, udgiv spillet, og start det fra Roblox-appen. Rør portalen: Robloxs loading-skærm vises, og du havner i det andet place. Hvis du blev stående, så åbn Developer Console med F9, skift loggen til visningen Server, som kun spillets ejer og gruppemedlemmer med redigeringsret kan se, og find advarslerne
Teleporters:, de angiver den årsag, Roblox gav.
Hold Output-vinduet åbent under trinene i Studio (menuen Window, derefter Output). Når Teleporters virker, skriver det ingenting ud over portallinjen fra trin 4, så enhver advarsel eller rød fejl er værd at læse. Se Almindelige fejl.
Sådan udvider du
Teleportér et hold eller en party samlet
TeleportAsync tager en liste af spillere, så én portal kan sende en hel gruppe til samme place. Roblox-siden om teleporter foreslår at tage udgangspunkt i den spiller, der rørte portalen: player.Team og Team:GetPlayers() til et hold eller SocialService:GetPlayersByPartyId() med player.PartyId til en party. Send den liste i stedet for { player }, og sæt flaget leavingForPlace på hver spiller i den.
Send en gruppe til sin egen server
Som standard havner teleporterede spillere på en offentlig server i det andet place. For at sende en gruppe til en ny reserveret server, for eksempel til en kamp, opretter du TeleportOptions, sætter dens ShouldReserveServer til true og sender den som tredje argument: TeleportService:TeleportAsync(placeId, players, options). Roblox nævner, at nye forsøg er særligt nyttige ved fejl, der netop har med reserverede servere at gøre, og scriptet laver dem allerede.
Sådan flytter du data til et andet place
Teleportering nulstiller alle lokale data for den spiller. Teleport data i Roblox, som sættes med TeleportOptions:SetTeleportData() og læses i det andet place med player:GetJoinData(), kan ses af klienten og er ikke krypteret, så brug dem kun til harmløse valg, for eksempel hvilket kort der skal indlæses. Mønter, Wins og genstande gemmer du i et datalager, som i DataStore-tutorialen, og indlæser dem igen, når spilleren ankommer til det andet place.
Din egen loading-skærm
Mens en teleport til et place indlæses, ser spillerne Robloxs standard-loading-skærm. For at vise din egen kalder du TeleportService:SetTeleportGui() på klienten med en ScreenGui, for eksempel en, der ligger i ReplicatedStorage. Teleporterne i denne guide starter på serveren, så klienten skal kalde den på forhånd, for eksempel så snart spilleren er kommet ind. Roblox siger, at skærmen skal sættes igen før hver teleport, og at den ikke bruges til et place i et andet spil. Der står også, at scripts inde i denne ScreenGui ikke kører, så gør den statisk.
Teleporter i runder og checkpoints
Rundesystemet flytter i starten af hver runde alle spillere til arenaen med det samme PivotTo-kald, og afsnittet PivotTo eller SpawnLocation i obby-guiden sammenligner den tilgang med Robloxs spawnpunkter. Hvis et sted kun skal åbnes efter en runde, giver rundesystemet allerede de Wins, som WinsNeeded læser.
Almindelige fejl og løsninger
Åbn Output-vinduet (menuen Window, derefter Output), før du trykker på Play. Teleporters nævner pladen, når Destination peger ud i ingenting, så de fleste problemer kan ses der.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu venter på den remote, som Teleporters opretter, så Teleporters kører ikke. Tjek, at det er et Script og ikke et LocalScript, at det ligger direkte i ServerScriptService, ikke er slået fra, og at der ikke er nogen rød fejl fra det i Output. Guiden til script-fejl forklarer denne advarsel i detaljer.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Pladens attribut Destination nævner noget, der ikke er en part direkte inde i mappen TeleportPads. Tjek stavning og store bogstaver i attributtens værdi og i destinationspladens navn. Advarslen vises én gang pr. plade, første gang en spiller rører den.
Jeg træder op på pladen, og der sker ingenting
Tjek, at mappen hedder præcis TeleportPads og ligger direkte i Workspace, når spillet starter, at pladens attribut Destination er af typen String (en attribut af typen Number ignoreres), og at der er gået 2 sekunder siden din seneste teleport. Tjek også, at CanTouch er slået til på pladen: Roblox siger, at forbindelse af Touched til en part med CanTouch slået fra giver en fejl, og den stopper scriptet.
Jeg dukker op inde i en væg eller falder ud over kanten
Spillere dukker op 3 studs foran destinationspladens forside. Højreklik på pladen, vælg Show Orientation Indicator, og drej pladen, indtil den blå linje peger mod fri gulvplads. Menuens steder placerer spillere oven på parten, så hold hvert sted på gulvet.
Castle-knappen forbliver grå, efter at jeg har tjent 3 Wins
Listen tegnes, når menuen åbnes, så luk menuen, og åbn den igen. Hvis knappen stadig er grå, så tjek, at leaderstats har en IntValue med navnet præcis Wins, og at Wins er ændret på serveren og ikke kun i Client-tilstand.
Portalen gør ingenting i det udgivne spil
Åbn Developer Console med F9, skift loggen til visningen Server (den kan kun ses af spillets ejer og gruppemedlemmer med redigeringsret, fordi Teleporters er et server-Script), og læs advarslerne Teleporters:, de angiver den årsag, Roblox gav. Tjek, at portalens attribut PlaceId er af typen Number og indeholder ID fra Asset Manager, og at du har udgivet dit place igen efter at have tilføjet portalen.
Lav det med RoCode
Hvis du ikke har lyst til at bygge alt det her i hånden, kan RoCode gøre det i det place, du har åbent. RoCode er en uafhængig AI-agent til Roblox Studio, ikke fra Roblox: du beskriver funktionen i dens webchat, og dens Studio-plugin opretter parts og scripts i din Explorer, så du ikke behøver at kopiere kode fra et chatvindue.
Tilføj teleporter: plader i Workspace.TeleportPads, der sender spillere til pladen fra deres attribut Destination med en cooldown på 2 sekunder, en Teleport-menu til steder i Workspace.TeleportSpots, hvor Castle kræver 3 Wins med tjek på serveren, og portaler i Workspace.PlacePortals, der sender spillere til det place, hvis ID står i deres attribut PlaceId, med nye forsøg.
- Kan gennemse dit place, når et trin kræver det, med Search Game og Search Scripts for at bygge på eksisterende genstande, remotes eller gemmekode i stedet for at tilføje et ekstra system
- Opretter mapper og pladernes parts med Create Instance, sætter deres egenskaber med Set Property og skriver Teleporters og TeleportMenu med Create Script
- Den er instrueret i at tjekke kompileringen af hvert script, den skriver, med Check Script, som kompilerer det i Studio uden at køre det
- Sender ændringerne i pakker, og hver pakke er et fortrydelsespunkt i Studios historik
Teleporter mellem places virker kun i et udgivet spil, så dem tester du selv i Roblox-appen. Med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejlene, og med plugin 3.9.15 eller nyere kan dens testfigur træde op på plader og trykke på menuknapper, men den tjekker kun det, den selv har besluttet at teste, så træd selv op på pladerne, og åbn menuen. En teleport er ét system blandt mange i et spil; at lave et helt spil med RoCode foregår på samme måde, ét system pr. prompt. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvordan laver jeg en teleportplade i Roblox Studio?
Giv to parts attributten Destination med hinandens navne, og lad ét server-script flytte den, der rørte pladen, med character:PivotTo til et punkt lige foran den anden plade, med en kort cooldown pr. spiller. Trin 1 og trin 2 bygger netop det.
Hvorfor virker min teleport ikke i Studio?
Plader og menuer virker i Studio. Teleporter til et andet place gør ikke: TeleportService i Roblox understøtter ikke playtest i Studio, så udgiv spillet, og test i Roblox-appen. Scriptet fra denne guide skriver i stedet for teleporten, hvad portalen ville have gjort, så du kan stadig tjekke, at den udløses.
Hvordan teleporterer jeg spillere til et andet place i mit spil?
Tilføj et place med File > Publish As (Add as a new place), kopiér dets place ID fra Asset Manager, og kald TeleportService:TeleportAsync(placeId, { player }) fra et server-Script inde i pcall, og prøv igen ved fejl. Trin 4 fører dig gennem det hele.
Hvordan laver jeg en teleport-GUI?
Byg knapperne i et LocalScript, og send kun navnet på det sted, spilleren valgte, til serveren. Serveren slår navnet op i en mappe, tjekker cooldown og enhver oplåsningsregel og flytter derefter karakteren. Send aldrig en position fra klienten: en snyder kan sende hvilken som helst.
Hvorfor sidder min karakter fast eller falder fra hinanden efter en teleport?
At tildele rodpartens Position flytter kun den part, uden kroppen, der er samlet med den, og at kopiere pladens CFrame placerer karakterens midte inde i pladen. Brug character:PivotTo med et punkt i ståhøjde over gulvet, beregnet ud fra HipHeight på Humanoid.
Kan jeg sende mønter eller genstande med en teleport?
Ikke sikkert. Roblox siger, at teleport data kan ses af klienten og ikke er krypteret, så de egner sig til noget som det valgte kort, men ikke til mønter. Gem mønter og genstande i et datalager, og indlæs dem i det andet place.
Kilder og videre læsning
- Roblox Creator Docs: Teleport between places (på engelsk). TeleportAsync, playtests i Studio, Access Control for Places, teleport-skærme, teleport data og mislykkede teleporter
- Roblox Creator Docs: TeleportService (på engelsk). den forældede Teleport, TeleportAsync kun på serveren og TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (på engelsk). den primære funktion til at flytte modeller fra scripts
- Roblox Creator Docs: BasePart.Position (på engelsk). hvorfor det at sætte Position på en samlet part forskyder den i forhold til de andre
- Roblox Creator Docs: Humanoid.HipHeight (på engelsk). hvor højt rodparten på en stående karakter befinder sig, for R15- og R6-rigs
- Roblox Creator Docs: Seat (på engelsk). den SeatWeld, der holder en siddende karakter, og at destruere den for at løfte karakteren op
- Roblox Creator Docs: Player:RequestStreamAroundAsync (på engelsk). at bede om et område, før karakteren flyttes derhen, uden garanti for, hvad der når 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 ind i ethvert place i spillet, hvis teleporter ikke er sikret
- Roblox Creator Docs: Network ownership, movement validation, and physics (på engelsk). hvad klienten kan gøre med sin karakter, og undtagelser for teleporter i bevægelsestjek
- Roblox Creator Docs: Create and publish games and places (på engelsk). udgivelse, hvem der kan åbne et nyt spil, og at tilføje et place med Publish As
- Roblox Creator Docs: Asset Manager (på engelsk). sådan kopierer du et place ID
- Roblox Creator Docs: Developer Console (på engelsk). visningen Server i loggen, og hvem der kan se den
- Roblox Creator Docs: Debounce patterns (på engelsk). hvorfor Touched udløses flere gange for én berøring
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.