I korthet
För en teleportplatta, lägg ett Script i ServerScriptService som lyssnar på plattans händelse Touched, hittar spelaren via Players:GetPlayerFromCharacter och flyttar hela karaktären med character:PivotTo() till en punkt precis framför målplattan, med ryggen mot den, med en väntetid på ett par sekunder per spelare så att målplattan inte skickar tillbaka spelaren direkt. För att skicka spelare till en annan place i ditt spel, anropa TeleportService:TeleportAsync(placeId, { player }) från ett Script på servern inuti pcall; det fungerar bara i ett publicerat spel, inte i Studio.
- Flytta hela karaktären med
PivotTo. Att sättaHumanoidRootPart.Positionflyttar rotparten bort från resten av kroppen, eftersom Roblox uppdaterar fogarna när Position sätts. - En teleportmeny ska skicka målpunktens namn till servern, inte en position. Servern kontrollerar namnet, väntetiden och eventuella upplåsningsregler innan någon flyttas.
TeleportService:Teleport()är föråldrad och körs på klienten. AnvändTeleportAsyncpå servern, linda in den ipcall, försök igen och hanteraTeleportInitFailed.
På den här sidan
Två sorters teleport
En teleport i ett Roblox-spel kan betyda tre saker: en platta som flyttar dig tvärs över kartan, en meny med punkter att hoppa till, eller en portal till en annan nivå. De två första flyttar karaktären inom servern som spelaren redan är på. Den tredje skickar spelaren till en annan place i ditt spel, som körs på egna servrar. De använder olika API:er, så det är bra att veta vilken du behöver.
| Inom samma server | Till en annan place i ditt spel | |
|---|---|---|
| Anrop | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Till vad | Teleportplattor, teleportmenyer, flytta spelare från lobbyn till arenan | Portaler till en annan nivå, en lobby som skickar spelare till en separat place med en dungeon eller en match |
| Var det körs | Ett Script på servern | Bara ett Script på servern. Klientens Teleport() är föråldrad. |
| Fungerar i ett speltest i Studio | Ja | Nej. TeleportService i Roblox stöder inte speltester i Studio, så du testar i det publicerade spelet. |
| Vad spelaren ser | Ett hopp tvärs över kartan, som kan ta upp till 2 sekunder om området först måste laddas | Roblox laddningsskärm, sedan den andra placen |
| Mynt, föremål och annan data | Stannar som de är | Roblox nollställer spelarens lokala data, så allt viktigt måste komma från en datalagring i den andra placen |
I den här guiden samlas alla tre sorterna i ett enda Script på servern, så att en uppsättning regler täcker varje teleport i ditt spel: servern bestämmer, varje spelare har en egen väntetid, och spelarens enhet säger bara vilken punkt hen skulle vilja komma till.
| Del | Var den finns | Vad den gör |
|---|---|---|
Folder TeleportPads med PadA och PadB | Workspace | Två plattor. Varje plattas attribut Destination anger plattan som den skickar spelare till. |
Folder TeleportSpots | Workspace | En part för varje punkt i menyns lista. Attributet WinsNeeded låser en punkt. |
Folder PlacePortals | Workspace | Portal-parts. Varje portals attribut PlaceId är den place som den skickar spelare till. |
Script Teleporters | ServerScriptService | Styr alla tre sorters teleport och skapar två remotes. Det enda stället där en teleport kan ske. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Ritar Teleport-knappen och listan med punkter och skickar namnet på den punkt som spelaren valde. |
RemoteFunction GetTeleportSpots och RemoteEvent TeleportRequest | ReplicatedStorage (Teleporters skapar dem) | Den första ger menyn listan med punkter. Den andra bär det valda namnet till servern. |
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 två teleportplattor
- I Explorer, håll muspekaren över Workspace, klicka på knappen + och lägg till en Folder. Döp mappen till
TeleportPads. Skriptet letar efter exakt det namnet. - Lägg till två Part i mappen och döp dem till
PadAochPadB. Gör var och en till en platt platta, till exempel 6 gånger 1 gånger 6 studs, och placera dem på golvet en bit ifrån varandra. I fönstret Properties, bocka i Anchored, låt CanCollide och CanTouch vara påslagna och ge dem en klar färg och materialet Neon, så att spelarna lägger märke till dem. - Markera PadA, scrolla ner i fönstret Properties till avsnittet Attributes och klicka på +. Skriv namnet
Destination, välj typen String och klicka på Save, och sätt sedan värdet tillPadB. Gör samma sak på PadB med värdetPadA. - Vrid varje platta så att dess framsida pekar mot fritt golv. Spelarna dyker upp 3 studs framför målplattans framsida, med ryggen mot den, så lämna några studs fritt golv där. För att se vilken sida som är framsidan, högerklicka på plattan och välj Show Orientation Indicator: framsidan markeras av en blå linje. Vrid plattan med verktyget Rotate tills linjen pekar dit spelarna ska gå.
Att spelarna hamnar bredvid plattan och inte på den är med avsikt. Roblox sida om debounce påpekar att Touched utlöses många gånger i rad vid en enda beröring, så en spelare som dök upp direkt på den andra plattan skulle utlösa den igen så fort väntetiden tog slut och flyga tillbaka tvärs över kartan.
Du är inte begränsad till två plattor. En plattas Destination kan namnge vilken part som helst i TeleportPads, så tre plattor kan skicka spelare runt i en cirkel. För en enkelriktad platta, peka den mot en part i TeleportPads som inte har något eget Destination: en sådan part tar emot spelare och skickar inte iväg någon.
Steg 2: lägg till teleportskriptet
Håll muspekaren över ServerScriptService, lägg till ett Script, döp det till Teleporters och klistra in koden nedan. Just nu sköter det plattorna, och efter de följande stegen även menyn och portalerna, så du lägger bara till det en gång. Inställningarna högst upp är raderna som du är tänkt att ändra.
-- Script i ServerScriptService med namnet Teleporters.
-- Varje teleport avgörs här, på servern:
-- 1. Plattor: att röra vid en part i Workspace.TeleportPads flyttar dig till parten som namnges
-- i dess attribut Destination.
-- 2. Meny: LocalScript TeleportMenu ber om en punkt från Workspace.TeleportSpots
-- via namn. Servern kontrollerar namnet, väntetiden och de Wins som punkten kräver.
-- 3. Portaler: att röra vid en part i Workspace.PlacePortals skickar dig till den place
-- som står i dess attribut PlaceId (en annan place i det här spelet).
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 ignorerar plattorna en spelare efter varje teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs framför målplattan, så att spelarna hamnar bredvid den
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Det här skriptet skapar båda remotes självt, så lägg inte till dem för hand
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
-- Hur högt över golvet rotparten på en stående karaktär befinner sig.
-- Formeln från Roblox referens för Humanoid.HipHeight (för R6-riggar läggs benets höjd till).
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ätts före väntan, så att en andra beröring inte startar en andra teleport
-- Titta dit målpunktens framsida pekar (rakt, utan lutning)
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äll dig på dess översida: karaktärens pivot är dess rotpart, så vi lyfter den till ståhöjd.
-- En platta ställer däremot spelarna några studs framför sig, eftersom en spelare som står
-- på plattan skulle utlösa den igen med nästa steg.
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åslaget laddar vi först området runt målet (upp till 2 sekunder)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- lämnade, respawnade eller dog medan området laddades
end
-- En sittande karaktär är svetsad fast vid sätet, och att flytta den skulle dra med sig sätet.
-- Att förstöra SeatWeld frigör först karaktären från sätet.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Starta om väntetiden vid ankomsten: förladdningen ovan kan ta upp till 2 sekunder,
-- och plattan som spelaren hamnade vid ska inte skicka tillbaka hen direkt
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- för ett skript som kontrollerar hastighet, om du har ett
end
-- 1. Plattor
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 -- varna en gång, inte vid varje beröring
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Meny: listan med punkter, sedan en förfrågan via namn
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 -- samma antal Wins: i bokstavsordning, så att ordningen aldrig ändras
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Klienten skickar bara namnet. Ta aldrig emot en position eller CFrame från 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 för den här spelaren
end
teleportTo(player, spot, false)
end)
-- 3. Portaler till en annan place i det här spelet
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- redan på väg, eller rörde vid en teleport för en sekund sedan
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 ger upp; en ny beröring av portalen försöker igen
end
-- En teleport kan misslyckas även efter att den startat. Spelaren stannar här och kan försöka 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 skapar själv RemoteFunction GetTeleportSpots och RemoteEvent TeleportRequest, så du behöver inte lägga till något i ReplicatedStorage för hand. Det ansluter plattorna i TeleportPads och portalerna i PlacePortals en gång, när servern startar, så plattor och portaler som läggs till under spelet gör ingenting. Om någon mapp saknas är den sortens teleport helt enkelt avstängd.
| Del | Vad den gör | Varför |
|---|---|---|
playerFromHit | Hittar karaktärsmodellen som den berörande parten tillhör och frågar Players:GetPlayerFromCharacter vems den är. | Plattor blir berörda av ben, hattar och lösa parts. Allt som inte är en del av en spelares karaktär ger nil och ignoreras. |
onCooldown | Jämför os.clock() med tiden för spelarens senaste teleport. | En väntetid per spelare, så en spelare som står vid en platta blockerar aldrig de andra. Inget väntar eller sover. |
rootHeight | Räknar ut hur högt över golvet rotparten på en stående karaktär befinner sig: halva rotpartens höjd plus Humanoids HipHeight, plus benets längd för R6-riggar. | Det är formeln från Roblox referens för Humanoid.HipHeight. Karaktärens pivot är dess rotpart, så när pivoten lyfts så mycket hamnar fötterna på ytan, både för små och stora avatarer och för R6. |
Kontrollerna i början av teleportTo | Avslutar om spelaren inte har en levande karaktär med en rotpart, och sparar sedan tiden direkt. | Streamingförfrågan nedan kan få skriptet att vänta. Om tiden sparas i förväg startar de många Touched-händelserna i det ögonblicket ingen andra teleport. |
| Ankomstpunkten | Målpunktens översida, lyft med rootHeight, med blicken dit dess framsida pekar, utan lutning. För en platta flyttas punkten dessutom 3 studs från dess framsida. | Karaktären dyker upp stående, inte inuti målparten. Bredvid en platta börjar fötterna i höjd med dess översida, så karaktären sjunker ner till golvet med plattans tjocklek. CFrame.lookAlong bygger en CFrame på en position med en given blickriktning. |
RequestStreamAroundAsync | Ber Roblox att först skicka området runt ankomstpunkten till den här spelaren och väntar högst 2 sekunder. | Instance streaming är påslaget som standard i nya places, så en avlägsen del av kartan kanske ännu inte har laddats på spelarens enhet. Roblox rekommenderar det här serveranropet innan en karaktär flyttas långt, även om det inte garanterar exakt vad som kommer fram. |
| Den andra kontrollen | Om spelaren har lämnat, eller karaktären har respawnat eller dött under väntan, flyttas ingenting. | Spelaren kan ha gjort reset eller lämnat spelet medan området laddades. Roblox eget exempel på förladdning kontrollerar också att karaktären fortfarande finns i spelet innan den flyttas. |
Raderna med SeatWeld | Om karaktären sitter förstörs den Weld som håller den på sätet. | Roblox svetsar fast en sittande karaktär vid sätet. PivotTo flyttar parts genom att ändra deras CFrame, och Roblox referens säger att när en parts CFrame sätts flyttas även parts som är fogade med den, så utan detta skulle sätet och allt som är svetsat vid det följa med spelaren. Att förstöra SeatWeld är det sätt som Roblox referens för Seat använder för att resa en karaktär från ett säte med ett skript. |
character:PivotTo(target) | Flyttar hela karaktären, alla lemmar och accessoarer tillsammans, till ankomstpunkten. | Roblox kallar PivotTo den huvudsakliga funktionen för att flytta modeller från skript. |
Den andra raden med lastTeleport | Startar om väntetiden vid ankomsten. | Streamingförfrågan kan ta upp till 2 sekunder, lika länge som själva plattans väntetid, så utan den här raden kunde spelaren komma fram med en väntetid som redan har gått ut. |
MovementCheckSkip | Sätter ett attribut på Player efter varje flytt. | En hastighetskontroll på servern skulle tro att hoppet var fusk. MovementCheck från sprintguiden läser det här attributet och börjar mäta om från den nya positionen. Utan ett sådant skript gör attributet ingenting. |
| Inställning | Värde här | Vad den ändrar |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Hur länge plattor och portaler ignorerar en spelare efter varje teleport. |
MENU_COOLDOWN_SECONDS | 3 | Den kortaste tiden mellan två teleporter via menyn för samma spelare. Plattor och menyn delar samma klocka per spelare, så en förfrågan från menyn inom 3 sekunder efter en teleport från en platta ignoreras också. |
PAD_ARRIVAL_GAP | 3 | Hur många studs från målplattans framsida spelarna dyker upp, så att de hamnar bredvid plattan och inte på den. |
PLACE_ATTEMPTS | 3 | Hur många gånger en portal försöker med TeleportAsync, med 2 sekunders mellanrum, innan den ger upp. |
Tryck på Play redan nu och kliv på PadA: du dyker upp framför PadB. Menyn och portalerna behöver de två följande stegen, men skriptet fungerar redan utan dem.
Steg 4: teleportera till en annan place
En place är en separat värld inuti ditt spel, med egna servrar: en lobby och en dungeon, eller en hubb och en samling nivåer. Spelare flyttas mellan places via TeleportService, och Roblox kör den bara i ett publicerat spel, så det här steget slutar i Roblox-appen, inte i Studio.
- Om spelet inte är publicerat än, välj File > Publish. Nya spel är, tills du släpper dem, bara öppna för dig, för personer som du gett Edit-åtkomst och för gruppmedlemmar med rätt roller, och för ditt eget test av teleporter räcker det.
- Skapa en andra place: öppna en ny place från valfri mall i Studio, bygg din dungeon och välj sedan File > Publish As, klicka på ditt spels ruta, välj Add as a new place och klicka på Create.
- Kopiera den nya placens ID. Öppna Asset Manager från menyn Window eller fliken Home, gå till Places In Experience, högerklicka på placen och välj Copy Asset ID, som kopierar dess place-ID.
- Tillbaka i den första placen, lägg till en Folder med namnet
PlacePortalsi Workspace, och inuti den en förankrad Part med namnetDungeonPortal. Lägg till ett attribut av typen Number med namnetPlaceIdoch klistra in ID:t som dess värde. - Tryck på Play och rör vid portalen. Output skriver ut en rad som börjar med
Teleporters: would send: i Studio gör portalen inget mer än så. - Publicera spelet igen via File > Publish så att portalen finns i det publicerade spelet, och testa den från Roblox-appen som i steg 5.
Teleporters anropar TeleportAsync inuti pcall, upp till 3 gånger med 2 sekunders paus mellan försöken, eftersom Roblox sida om teleporter säger att teleporter kan misslyckas och ge ett fel, och rekommenderar att man försöker igen. En teleport kan också starta och misslyckas i sista stund utan fel, så att spelaren blir kvar där hen var. För det fallet anropar Roblox TeleportInitFailed, och skriptet tar bort flaggan "på väg" från spelaren, så att en ny beröring av portalen försöker igen.
För att få spelarna tillbaka, gör samma sak i den andra placen: lägg en kopia av Teleporters i dess ServerScriptService och lägg till en portal vars PlaceId är ID:t för din första place, kopierat från Asset Manager på samma sätt.
Vem som kan komma in i dina andra places
Roblox säkerhetsdokumentation varnar: så fort en klient är i en place i ditt spel kan den teleportera till vilken annan place i spelet som helst, vilken väg du än har tänkt dig, och att stänga av Direct Access för en place tar bara bort knappen Join på webbplatsen. Det som ändrar detta är inställningen Access Control for Places under Audience > Access Settings i Creator Dashboard:
| Inställning | Vem som kan komma in i en place som inte är startplacen |
|---|---|
| Fully open | Vem som helst, via teleporter från vilket spel som helst, deep links, spelinbjudningar och att ansluta till en vän. |
| Limited to same universe | Bara spelare som teleporteras inifrån dina spel. Teleporter från både klienten och servern är tillåtna. |
| Secure within universe only | Bara spelare som dina serverskript teleporterar inifrån det här spelet. |
Om spelarna bara ska komma in i en place via din portal, till exempel en dungeon, välj Secure within universe only. Varje teleport i den här guiden startar på servern, så den fortsätter att fungera. Roblox säger också att många spel inte behöver säkra teleporter, så ett spel vars alla places är öppna för alla kan låta inställningen vara som den är.
Vad gamla guider om teleporter gör fel
Om du jämför den här guiden med en video eller ett foruminlägg, här är de viktiga skillnaderna och anledningen till att varje knep skapar problem.
| Guide | Problem | Den här guiden |
|---|---|---|
Sätter hit.Parent.HumanoidRootPart.Position = target.Position | Roblox referens säger att när Position sätts uppdateras partens fogar och den förskjuts i förhållande till de parts den är fogad med: rotparten åker iväg utan kroppen. | Flyttar hela karaktären med PivotTo. |
Sätter HumanoidRootPart.CFrame = target.CFrame | Karaktärens mitt hamnar i målpartens mitt, delvis inuti den, och tar över partens lutning. | Karaktären dyker upp i ståhöjd över översidan, bredvid plattan, utan lutning. |
Använder en enda debounce-variabel för hela plattan | Medan en spelare teleporteras ignorerar plattan alla andra. Och helt utan debounce skickas en spelare som dyker upp på den andra plattan direkt tillbaka. | En väntetid per spelare, sparad före varje väntan, och spelarna dyker upp bredvid plattan. |
Anropar TeleportService:Teleport(placeId, player) från ett LocalScript | Roblox markerar Teleport() som föråldrad, avråder från att använda den i nya projekt och tillåter TeleportAsync bara från serverskript. | Anropar TeleportAsync i ett serverskript. |
Ingen pcall, inga nya försök | Roblox sida om teleporter säger att de kan misslyckas och ge ett fel, och även misslyckas efter att de startat. | Upp till 3 försök i pcall, och TeleportInitFailed låter spelaren försöka igen. |
| Ger upp eftersom det "inte fungerar" i Studio | TeleportService stöder inte speltester i Studio. | RunService:IsStudio() skriver i stället ut vad portalen skulle ha gjort. |
| Ett teleport-GUI vars knappar skickar en position | En fuskare kan anropa samma remote med vilken position som helst. | Knapparna skickar punktens namn, och servern letar upp det. |
| Mynt skickas med i teleport data | Roblox säger att teleport data syns för klienten och inte är krypterad. | Rekommenderar att mynt och Wins sparas i en datalagring och laddas i den andra placen (se Så tar du med data till en annan place). |
Vad spelare kan och inte kan förfalska
Räkna med att en fuskare styr allt på sin egen enhet: hen kan ändra TeleportMenu, anropa båda remotes hur många gånger som helst med vilka argument som helst och flytta sin karaktär. Här är vad det ger hen med den här teleporten.
| Fuskaren försöker | Resultat | Varför |
|---|---|---|
| Skicka en position eller CFrame via menyns remote | Ignoreras | TeleportRequest läser en enda sträng, punktens namn på upp till 50 tecken. Allt annat kastas. |
| Begära Castle utan 3 Wins | Nekas | Servern läser Wins från sin egen kopia av leaderstats. Den grå knappen är bara en ledtråd. |
| Begära en punkt som inte finns | Ignoreras | Servern letar upp namnet i TeleportSpots och gör ingenting om det inte finns någon part med det namnet. |
| Anropa menyns remote om och om igen | Högst en teleport via menyn per 3 sekunder | Väntetiden lagras på servern, för varje spelare. |
| Utlösa en platta utan att gå fram till den | Hen hamnar vid partnerplattan, som hen ändå kunde ha gått till | Roblox räknar upp att teleportera till vilken punkt som helst och att manipulera Touched-händelser bland det som en klient kan göra med sin karaktär. |
| Gå direkt in i en annan place i ditt spel | Möjligt, om Access Control for Places inte är Secure within universe only | Se Vem som kan komma in i dina andra places. |
| Flytta sin karaktär vart som helst, även till en låst punkt | Möjligt | Varje enhet styr rörelsen för sin egen karaktär. En låst punkt är en bekvämlighet, inte ett kassaskåp, så kontrollera på servern innan du delar ut något värdefullt där. |
Den sista raden är den ärliga gränsen för varje teleport. För ett tävlingsspel, lägg till en rörelsekontroll på servern, som i sprintguiden. Teleporters sätter redan attributet MovementCheckSkip, som den kontrollen läser, så dess egna teleporter flaggas inte som överträdelser: Roblox säkerhetsdokumentation säger att spel med legitima teleporter behöver just ett sådant undantag i sina rörelsekontroller.
Steg 5: testa
- Tryck på Play. Kliv på PadA: du dyker upp precis framför PadB, med ryggen mot den. Vänd dig om och kliv direkt på PadB: inget händer, eftersom plattorna ignorerar dig i 2 sekunder efter ankomsten. Kliv av, vänta 2 sekunder och kliv på PadB igen: du dyker upp framför PadA.
- Vänta några sekunder och klicka sedan på Teleport på vänstra sidan av skärmen. Listan visar Lake, Spawn och en grå "Castle (needs 3 wins)". Välj Lake: du dyker upp på den. Öppna menyn igen och välj Castle: inget händer, och det är tyst i Output.
- Ge dig själv 3 Wins (för det behövs ett leaderstats-skript med ett IntValue Wins, till exempel från guiden om topplistan). Klicka på växlingsknappen Client/Server för att byta till Server, leta i Explorer upp
Players, ditt namn,leaderstats,Winsoch sätt dess Value till 3 i fönstret Properties. Byt tillbaka till Client och öppna menyn igen: Castle har blivit lila och flyttar dig dit. - Rör vid DungeonPortal. Output skriver ut en rad som börjar med
Teleporters: would send, med ditt namn och place-ID:t. I Studio är det så det ska vara, och raden skrivs ut högst en gång per 2 sekunder, hur länge du än står på portalen. - Välj Server & Clients i rullgardinslistan för testlägen, ställ in 2 klienter och tryck på Play. Båda spelarna kan använda plattorna samtidigt, och den enas väntetid blockerar aldrig den andra.
- Stoppa testet, publicera spelet och starta det från Roblox-appen. Rör vid portalen: Roblox laddningsskärm visas och du hamnar i den andra placen. Om du blev kvar på samma ställe, öppna Developer Console med F9, byt loggen till vyn Server, som bara spelets ägare och gruppmedlemmar med redigeringsrätt ser, och leta efter varningar som börjar med
Teleporters:, där står orsaken som Roblox angav.
Ha fönstret Output öppet under stegen i Studio (menyn Window, sedan Output). När Teleporters fungerar skriver det inte ut något annat än portalens rad från steg 4, så varje varning eller rött fel är värt att läsa. Se Vanliga fel.
Så bygger du vidare
Teleportera ett lag eller en party tillsammans
TeleportAsync tar en lista med spelare, så en portal kan skicka en hel grupp till samma place. Roblox sida om teleporter föreslår att man utgår från spelaren som rörde vid portalen: player.Team och Team:GetPlayers() för ett lag, eller SocialService:GetPlayersByPartyId() med player.PartyId för en party. Skicka in den listan i stället för { player } och sätt flaggan leavingForPlace för varje spelare i den.
Skicka en grupp till en egen server
Som standard hamnar teleporterade spelare på en offentlig server i den andra placen. För att skicka en grupp till en ny reserverad server, till exempel för en match, skapa TeleportOptions, sätt dess ShouldReserveServer till true och skicka in den som tredje argument: TeleportService:TeleportAsync(placeId, players, options). Roblox påpekar att nya försök är särskilt användbara vid fel som gäller just reserverade servrar, och det gör skriptet redan.
Så tar du med data till en annan place
En teleport nollställer all lokal data för spelaren. Teleport data i Roblox, som sätts med TeleportOptions:SetTeleportData() och läses i den andra placen med player:GetJoinData(), syns för klienten och är inte krypterad, så använd den bara för ofarliga val, till exempel vilken karta som ska laddas. Spara mynt, Wins och föremål i en datalagring, som i guiden om DataStore, och ladda dem igen när spelaren kommer fram till den andra placen.
Egen laddningsskärm
Medan en teleport till en place laddas ser spelarna Roblox standardladdningsskärm. För att visa din egen, anropa TeleportService:SetTeleportGui() på klienten med en ScreenGui, till exempel en som ligger i ReplicatedStorage. Teleporterna i den här guiden startar på servern, så klienten måste anropa den i förväg, till exempel så fort spelaren har anslutit. Roblox säger att skärmen måste sättas på nytt före varje teleport och att den inte används för en place i ett annat spel. Där står också att skript inuti den ScreenGui inte körs, så gör den statisk.
Teleporter för rundor och checkpoints
Rundsystemet flyttar i början av varje runda alla spelare till arenan med samma sorts PivotTo-anrop, och avsnittet PivotTo eller SpawnLocation i obby-guiden jämför det sättet med Roblox spawnpunkter. Om en punkt bara ska låsas upp efter en runda delar rundsystemet redan ut de Wins som WinsNeeded läser.
Vanliga fel och lösningar
Öppna fönstret Output (menyn Window, sedan Output) innan du trycker på Play. Teleporters namnger plattan när Destination pekar ingenstans, så de flesta problem syns där.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu väntar på en remote som Teleporters skapar, alltså körs inte Teleporters. Kontrollera att det är ett Script, inte ett LocalScript, att det ligger direkt i ServerScriptService, inte är avstängt och att det inte finns något rött fel från det i Output. Guiden om skriptfel förklarar den här varningen i detalj.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Plattans attribut Destination namnger något som inte är en part direkt inuti mappen TeleportPads. Kontrollera stavning och versaler i attributets värde och i målplattans namn. Varningen visas en gång per platta, första gången en spelare rör vid den.
Jag kliver på plattan och inget händer
Kontrollera att mappen heter exakt TeleportPads och ligger direkt i Workspace när spelet startar, att plattans attribut Destination har typen String (ett attribut av typen Number ignoreras) och att 2 sekunder har gått sedan din senaste teleport. Kontrollera också att CanTouch är påslaget på plattan: Roblox säger att det ger ett fel att ansluta Touched till en part med CanTouch avstängt, och felet stoppar skriptet.
Jag dyker upp inuti en vägg eller faller över kanten
Spelarna dyker upp 3 studs framför målplattans framsida. Högerklicka på plattan, välj Show Orientation Indicator och vrid plattan tills den blå linjen pekar mot fritt golv. Menyns punkter ställer spelarna ovanpå parten, så håll varje punkt på golvet.
Castle-knappen förblir grå efter att jag fått 3 Wins
Listan ritas när menyn öppnas, så stäng menyn och öppna den igen. Om knappen fortfarande är grå, kontrollera att leaderstats har ett IntValue som heter exakt Wins och att Wins ändrades på servern, inte bara i läget Client.
Portalen gör ingenting i det publicerade spelet
Öppna Developer Console med F9, byt loggen till vyn Server (den ser bara spelets ägare och gruppmedlemmar med redigeringsrätt, eftersom Teleporters är ett Script på servern) och läs varningarna som börjar med Teleporters:, där står orsaken som Roblox angav. Kontrollera att portalens attribut PlaceId har typen Number och innehåller ID:t från Asset Manager, och att du publicerade placen igen efter att du lagt till portalen.
Gör det med RoCode
Om du inte vill bygga allt det här för hand kan RoCode göra det i din öppna place. RoCode är en oberoende AI-agent för Roblox Studio, inte från Roblox: du beskriver funktionen i webbchatten, och dess Studio-plugin skapar parts och skript i din Explorer, så att du slipper kopiera kod från chattfönstret.
Lägg till teleporter: plattor i Workspace.TeleportPads som skickar spelare till plattan i sitt attribut Destination med en väntetid på 2 sekunder, en Teleport-meny för punkterna i Workspace.TeleportSpots där Castle kräver 3 Wins som kontrolleras på servern, och portaler i Workspace.PlacePortals som skickar spelare till den place vars ID står i deras attribut PlaceId, med nya försök.
- Kan gå igenom din place när ett steg kräver det, med Search Game och Search Scripts, för att bygga vidare på föremål, remotes eller sparkod som redan finns i stället för att lägga till ett andra system
- Skapar mapparna och plattornas parts med Create Instance, sätter deras egenskaper med Set Property och skriver Teleporters och TeleportMenu med Create Script
- Den är instruerad att kontrollera att varje skript den skrivit kompilerar med Check Script, som kompilerar det i Studio utan att köra det
- Skickar ändringarna i omgångar, och varje omgång är en ångrapunkt i Studios historik
Teleporter mellan places fungerar bara i ett publicerat spel, så dem testar du själv i Roblox-appen. Med plugin 3.9 eller senare kan RoCode köra ett kort speltest och läsa felen, och med plugin 3.9.15 eller senare kan dess testkaraktär kliva på plattor och trycka på menyknappar, men den kontrollerar bara det som den själv har bestämt sig för att testa, så kliv på plattorna och öppna menyn själv. En teleport är ett av många system i ett spel; att skapa ett helt spel med RoCode går till på samma sätt, ett system per prompt. Så ansluter RoCode till Studio.
Vanliga frågor
Hur gör man en teleportplatta i Roblox Studio?
Ge två parts attributet Destination med varandras namn, och låt ett enda serverskript flytta den som rör vid en platta med character:PivotTo till en punkt precis framför den andra plattan, med en kort väntetid per spelare. Steg 1 och steg 2 bygger just det.
Varför fungerar inte min teleport i Studio?
Plattor och menyer fungerar i Studio. Teleporter till en annan place gör det inte: TeleportService i Roblox stöder inte speltester i Studio, så publicera spelet och testa i Roblox-appen. Skriptet i den här guiden skriver i stället för en teleport ut vad portalen skulle ha gjort, så att du ändå kan kontrollera att den utlöses.
Hur teleporterar man spelare till en annan place i mitt spel?
Lägg till placen via File > Publish As (Add as a new place), kopiera dess place-ID från Asset Manager och anropa TeleportService:TeleportAsync(placeId, { player }) från ett Script på servern inuti pcall, och försök igen om det misslyckas. Steg 4 går igenom allt detta.
Hur gör man ett teleport-GUI?
Bygg knapparna i ett LocalScript och skicka bara namnet på punkten som spelaren valde till servern. Servern letar upp namnet i en mapp, kontrollerar väntetiden och eventuella upplåsningsregler och flyttar sedan karaktären. Skicka aldrig en position från klienten: en fuskare kan skicka vilken som helst.
Varför fastnar eller faller min karaktär isär efter en teleport?
Att sätta rotpartens Position flyttar bara den parten, utan kroppen som är fogad med den, och att kopiera plattans CFrame ställer karaktärens mitt inuti plattan. Använd character:PivotTo med en punkt i ståhöjd över golvet, uträknad från Humanoids HipHeight.
Kan man skicka med mynt eller föremål i en teleport?
Inte på ett säkert sätt. Roblox säger att teleport data syns för klienten och inte är krypterad, så den passar för något som den valda kartan, men inte för mynt. Spara mynt och föremål i en datalagring och ladda dem i den andra placen.
Källor och vidare läsning
- Roblox Creator Docs: Teleport between places (på engelska). TeleportAsync, speltester i Studio, Access Control for Places, teleportskärmar, teleport data och misslyckade teleporter
- Roblox Creator Docs: TeleportService (på engelska). föråldrade Teleport, TeleportAsync bara på servern och TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (på engelska). den huvudsakliga funktionen för att flytta modeller från skript
- Roblox Creator Docs: BasePart.Position (på engelska). varför en fogad part förskjuts i förhållande till de andra när Position sätts
- Roblox Creator Docs: Humanoid.HipHeight (på engelska). hur högt rotparten på en stående karaktär befinner sig, för R15- och R6-riggar
- Roblox Creator Docs: Seat (på engelska). SeatWeld som håller en sittande karaktär, och att förstöra den för att resa karaktären
- Roblox Creator Docs: Player:RequestStreamAroundAsync (på engelska). begära ett område innan karaktären flyttas dit, utan garanti för vad som kommer fram
- Roblox Creator Docs: Streaming techniques and conversion (på engelska). förebyggande streaming före en teleport
- Roblox Creator Docs: Access control and confidentiality (på engelska). varför klienter kan komma in i vilken place som helst i spelet om teleporterna inte är säkrade
- Roblox Creator Docs: Network ownership, movement validation, and physics (på engelska). vad en klient kan göra med sin karaktär och undantag för teleporter i rörelsekontroller
- Roblox Creator Docs: Create and publish games and places (på engelska). publicering, vem som kan öppna ett nytt spel och att lägga till en place via Publish As
- Roblox Creator Docs: Asset Manager (på engelska). så kopierar du ett place-ID
- Roblox Creator Docs: Developer Console (på engelska). vyn Server i loggen och vem som ser den
- Roblox Creator Docs: Debounce patterns (på engelska). varför Touched utlöses flera gånger för en enda beröring
Så kontrollerades koden: varje skript på den här sidan klarar strikt Luau-typkontroll mot Roblox API-definitionerna (luau-lsp, 20 november 2026). Typkontrollen fångar felstavade API-namn och fel typer, men inte fel i spellogiken, så testa allt i Studio innan du publicerar.