Kurz gesagt
Für ein Teleport-Pad legst du ein Script in ServerScriptService an, das auf das Event Touched des Pads hört, mit Players:GetPlayerFromCharacter den Spieler findet und den ganzen Charakter mit character:PivotTo() an eine Stelle direkt vor dem Ziel-Pad bewegt, mit dem Rücken zum Pad, und mit einem Cooldown von ein paar Sekunden pro Spieler, damit das Ziel-Pad ihn nicht direkt zurückschickt. Um Spieler in einen anderen Place deines Spiels zu schicken, ruf TeleportService:TeleportAsync(placeId, { player }) aus einem Server-Script in einem pcall auf; das funktioniert nur im veröffentlichten Spiel, nicht in Studio.
- Beweg den ganzen Charakter mit
PivotTo.HumanoidRootPart.Positionzu setzen bewegt den Root-Part vom Rest des Körpers weg, weil Roblox die Gelenke aktualisiert, wenn Position gesetzt wird. - Ein Teleport-Menü sollte dem Server einen Namen für das Ziel schicken, nie eine Position. Der Server prüft den Namen, den Cooldown und jede Freischalt-Regel, bevor er jemanden bewegt.
TeleportService:Teleport()ist veraltet und läuft auf dem Client. NimmTeleportAsyncauf dem Server, pack es inpcall, versuch es erneut und behandleTeleportInitFailed.
Auf dieser Seite
Zwei Arten von Teleport
Ein Teleporter kann in einem Roblox-Spiel drei Dinge bedeuten: ein Pad, das dich quer über die Map schickt, ein Menü mit Spots zum Hinspringen oder ein Portal in ein anderes Level. Die ersten beiden bewegen einen Charakter innerhalb des Servers, in dem der Spieler schon ist. Das dritte schickt den Spieler in einen anderen Place deines Spiels, der auf eigenen Servern läuft. Sie nutzen verschiedene APIs, also hilft es zu wissen, welche du brauchst.
| Innerhalb desselben Servers | In einen anderen Place deines Spiels | |
|---|---|---|
| Der Aufruf | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Genutzt für | Teleport-Pads, ein Teleport-Menü, Spieler aus der Lobby in eine Arena bringen | Portale in ein anderes Level, eine Lobby, die Spieler in einen eigenen Dungeon- oder Match-Place schickt |
| Läuft in | Einem Server-Script | Nur einem Server-Script. Das clientseitige Teleport() ist veraltet. |
| Funktioniert im Studio-Playtest | Ja | Nein. Der TeleportService von Roblox unterstützt keine Playtests in Studio, also testest du im veröffentlichten Spiel. |
| Was der Spieler sieht | Einen Sprung über die Map, der bis zu 2 Sekunden dauern kann, wenn dieser Bereich erst laden muss | Den Ladebildschirm von Roblox, dann den anderen Place |
| Coins, Items und andere Daten | Bleiben, wie sie sind | Roblox verwirft die lokalen Daten des Spielers, also muss alles Wichtige im anderen Place aus einem Data Store kommen |
Dieser Guide baut alle drei Arten in einem einzigen Server-Script, also gilt ein Regelwerk für jeden Teleport in deinem Spiel: Der Server entscheidet, jeder Spieler hat seinen eigenen Cooldown, und das Gerät des Spielers sagt immer nur, zu welchem Spot es gern möchte.
| Baustein | Wo er liegt | Was er macht |
|---|---|---|
Folder TeleportPads mit PadA und PadB | Workspace | Zwei Pads. Das Attribut Destination jedes Pads nennt das Pad, zu dem es Spieler schickt. |
Folder TeleportSpots | Workspace | Ein Part für jeden Spot, den das Menü auflistet. Ein Attribut WinsNeeded sperrt einen Spot. |
Folder PlacePortals | Workspace | Portal-Parts. Das Attribut PlaceId jedes Portals ist der Place, zu dem es Spieler schickt. |
Script Teleporters | ServerScriptService | Führt alle drei Arten von Teleport aus und erstellt die beiden Remotes. Der einzige Ort, an dem ein Teleport passieren kann. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Zeichnet den Teleport-Button und die Liste der Spots und schickt den Namen des Spots, den der Spieler wählt. |
RemoteFunction GetTeleportSpots und RemoteEvent TeleportRequest | ReplicatedStorage (Teleporters erstellt sie) | Die erste gibt dem Menü die Liste der Spots zurück. Das zweite trägt den gewählten Namen zum Server. |
Workspace
TeleportPads Folder new
PadA Part new
PadB Part new
TeleportSpots Folder new
Spawn Part new
Lake Part new
Castle Part new
PlacePortals Folder new
DungeonPortal Part new
ServerScriptService
Teleporters Script new
StarterPlayer
StarterPlayerScripts
TeleportMenu LocalScript new
Schritt 1: Zwei Teleport-Pads bauen
- Fahr im Explorer mit der Maus über Workspace, klick auf den Button + und füge einen Folder ein. Nenn ihn
TeleportPads. Das Skript sucht genau diesen Namen. - Füge zwei Parts in den Ordner ein und nenn sie
PadAundPadB. Mach aus jedem eine flache Platte, zum Beispiel 6 mal 1 mal 6 Studs, und leg sie mit etwas Abstand auf den Boden. Hak im Properties-Fenster Anchored an, lass CanCollide und CanTouch an und gib ihnen eine kräftige Farbe und das Material Neon, damit Spieler sie erkennen. - Wähl PadA aus, scroll im Properties-Fenster zum Abschnitt Attributes und klick auf +. Gib den Namen
Destinationein, wähl den Typ String und klick auf Save, dann setz den Wert aufPadB. Mach dasselbe bei PadB mit dem WertPadA. - Dreh jedes Pad so, dass seine Vorderseite auf freien Boden zeigt. Spieler kommen 3 Studs vor der Vorderseite des Ziel-Pads an, mit dem Rücken dazu, also lass dort ein paar Studs Boden frei. Um zu sehen, welche Seite die Vorderseite ist, klick mit rechts auf das Pad und wähl Show Orientation Indicator: Eine blaue Linie markiert die Vorderseite. Dreh das Pad mit dem Rotate-Tool, bis diese Linie dorthin zeigt, wo Spieler loslaufen sollen.
Spieler landen mit Absicht neben dem Pad, nicht darauf. Die Debounce-Seite von Roblox merkt an, dass Touched bei einem Kontakt viele Male kurz hintereinander feuert, also würde ein Spieler, der auf dem anderen Pad ankommt, es wieder auslösen, sobald sein Cooldown abläuft, und quer über die Map zurückspringen.
Du bist nicht auf zwei Pads beschränkt. Die Destination eines Pads kann jeden Part in TeleportPads nennen, also können drei Pads Spieler im Kreis schicken. Für ein Pad in nur eine Richtung richtest du es auf einen Part in TeleportPads, der selbst keine Destination hat: Dieser Part empfängt Spieler und schickt niemanden irgendwohin.
Schritt 2: Das Teleport-Skript hinzufügen
Fahr mit der Maus über ServerScriptService, füge ein Script ein, nenn es Teleporters und füge den Code unten ein. Es steuert jetzt die Pads und später das Menü und die Portale aus den nächsten Schritten, also fügst du es nur einmal hinzu. Die Einstellungen oben sind die Zeilen, die du ändern sollst.
-- Script in ServerScriptService namens Teleporters.
-- Jeder Teleport wird hier entschieden, auf dem Server:
-- 1. Pads: einen Part in Workspace.TeleportPads zu berühren bringt dich zu dem Part, der
-- in seinem Attribut Destination steht.
-- 2. Ein Menü: das LocalScript TeleportMenu fragt per Name nach einem Spot in Workspace.TeleportSpots.
-- Der Server prüft den Namen, den Cooldown und die Wins, die der Spot braucht.
-- 3. Portale: einen Part in Workspace.PlacePortals zu berühren schickt dich zu dem Place
-- in seinem Attribut PlaceId (ein anderer Place in diesem Spiel).
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 -- so lange ignorieren Pads einen Spieler nach jedem Teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- Studs vor einem Ziel-Pad, damit Spieler daneben landen
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Dieses Skript erstellt beide Remotes selbst, also füge sie nicht von Hand hinzu
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
-- Wie hoch der Root-Part eines stehenden Charakters über dem Boden sitzt.
-- Die Formel stammt aus der Roblox-Referenz zu Humanoid.HipHeight (R6-Rigs addieren die Beinhöhe).
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() -- vor dem Warten gesetzt, damit eine zweite Berührung keinen zweiten Teleport startet
-- In die Richtung schauen, in die die Vorderseite des Ziels zeigt (waagerecht, nie gekippt)
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
-- Auf seiner Oberseite stehen: der Pivot eines Charakters ist sein Root-Part, also auf Stehhöhe anheben.
-- Ein Pad setzt Spieler stattdessen ein paar Studs vor sich ab, weil ein Spieler, der auf einem
-- Pad steht, es mit dem nächsten Schritt wieder auslösen würde.
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)
-- Mit Instance Streaming zuerst den Bereich um das Ziel laden (bis zu 2 Sekunden)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- gegangen, respawnt oder gestorben, während der Bereich lud
end
-- Ein sitzender Charakter ist an seinen Sitz geschweißt, und ihn zu bewegen würde den Sitz mitnehmen.
-- Den SeatWeld zu zerstören holt den Charakter zuerst aus dem Sitz.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Den Cooldown bei der Ankunft neu starten: das Vorladen oben kann bis zu 2 Sekunden dauern,
-- und das Pad, neben dem er landet, darf ihn nicht direkt zurückschicken
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- für ein Skript zur Tempo-Prüfung, falls du eins hast
end
-- 1. Pads
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 -- einmal warnen, nicht bei jeder Berührung
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Das Menü: die Liste der Spots, dann eine Anfrage per Name
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 -- gleiche Wins: alphabetisch, damit sich die Reihenfolge nie ändert
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Der Client schickt nur einen Namen. Nimm nie eine Position oder eine CFrame von einem Client an.
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 -- für diesen Spieler gesperrt
end
teleportTo(player, spot, false)
end)
-- 3. Portale zu einem anderen Place in diesem Spiel
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- schon unterwegs, oder hat gerade erst einen Teleporter berührt
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 -- aufgeben; das Portal noch mal zu berühren versucht es erneut
end
-- Ein Teleport kann auch nach dem Start scheitern. Der Spieler bleibt hier und darf es noch mal versuchen.
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 erstellt die RemoteFunction GetTeleportSpots und das RemoteEvent TeleportRequest selbst, also musst du nichts von Hand in ReplicatedStorage einfügen. Es verbindet die Pads in TeleportPads und die Portale in PlacePortals einmal, wenn der Server startet, also tun Pads und Portale, die im laufenden Spiel dazukommen, nichts. Ein fehlender Ordner schaltet diese Art von Teleport einfach ab.
| Teil | Was er macht | Warum |
|---|---|---|
playerFromHit | Findet das Charakter-Model, zu dem der berührende Part gehört, und fragt Players:GetPlayerFromCharacter, wem es gehört. | Ein Pad wird von Füßen, Hüten und losen Parts berührt. Alles, was nicht zum Charakter eines Spielers gehört, ergibt nil und wird ignoriert. |
onCooldown | Vergleicht os.clock() mit dem Zeitpunkt des letzten Teleports des Spielers. | Ein Cooldown pro Spieler, also blockiert ein Spieler, der nahe an einem Pad steht, nie jemand anderen. Nichts wartet oder schläft. |
rootHeight | Berechnet, wie hoch der Root-Part eines stehenden Charakters über dem Boden sitzt: die halbe Höhe des Root-Parts plus die HipHeight des Humanoid, bei R6-Rigs plus die Beinlänge. | Das ist die Formel aus der Roblox-Referenz zu Humanoid.HipHeight. Der Pivot eines Charakters ist sein Root-Part, also stellt das Anheben des Pivots um diesen Wert die Füße auf die Oberfläche, bei kleinen, großen und R6-Avataren gleichermaßen. |
Die Prüfungen am Anfang von teleportTo | Kehrt zurück, außer der Spieler hat einen lebenden Charakter mit Root-Part, und speichert dann sofort den Zeitpunkt. | Die Streaming-Anfrage weiter unten kann das Skript warten lassen. Den Zeitpunkt zuerst zu speichern bedeutet, dass die vielen Touched-Events in diesem Moment keinen zweiten Teleport starten können. |
| Der Ankunftspunkt | Die Oberseite des Ziels, um rootHeight angehoben, mit Blick in die Richtung seiner Vorderseite, ohne jede Neigung. Bei einem Pad rückt er außerdem 3 Studs vor die Vorderseite des Pads. | Der Charakter kommt aufrecht an, nicht im Ziel-Part. Neben einem Pad starten seine Füße auf Höhe der Pad-Oberseite, also fällt er die Dicke des Pads auf den Boden. CFrame.lookAlong baut eine CFrame an einer Position, die in eine Richtung schaut. |
RequestStreamAroundAsync | Bittet Roblox, diesem Spieler zuerst den Bereich um den Ankunftspunkt zu schicken, und wartet höchstens 2 Sekunden. | Instance Streaming ist bei neuen Places standardmäßig an, also ist ein weit entfernter Teil der Map auf dem Gerät des Spielers vielleicht noch nicht geladen. Roblox empfiehlt diesen Server-Aufruf, bevor ein Charakter weit weg bewegt wird, garantiert aber nicht, was ankommt. |
| Die zweite Prüfung | Wenn der Spieler gegangen ist oder der Charakter während des Wartens respawnt oder gestorben ist, bewegt sich nichts. | Der Spieler kann sich zurückgesetzt oder das Spiel verlassen haben, während der Bereich lud. Auch das Roblox-eigene Beispiel zum Vorladen prüft, ob der Charakter noch im Spiel ist, bevor es ihn bewegt. |
Die Zeilen mit SeatWeld | Wenn der Charakter sitzt, wird der Weld zerstört, der ihn am Sitz hält. | Roblox schweißt einen sitzenden Charakter an seinen Sitz. PivotTo bewegt Parts, indem es ihre CFrame ändert, und die Referenz von Roblox sagt, dass das Setzen der CFrame eines Parts auch die damit verbundenen Parts bewegt, also würde ohne das der Sitz, und alles daran Geschweißte, mit dem Spieler ankommen. SeatWeld zu zerstören ist der Weg, auf dem die Seat-Referenz von Roblox einen Charakter per Skript aus einem Sitz holt. |
character:PivotTo(target) | Bewegt den ganzen Charakter, jedes Körperteil und Accessoire gemeinsam, zum Ankunftspunkt. | Roblox nennt PivotTo die wichtigste Funktion, um Models per Skript zu bewegen. |
Die zweite Zeile mit lastTeleport | Startet den Cooldown bei der Ankunft neu. | Die Streaming-Anfrage kann bis zu 2 Sekunden dauern, so lange wie der Pad-Cooldown selbst, also könnte ein Spieler ohne diese Zeile ganz ohne verbleibenden Cooldown ankommen. |
MovementCheckSkip | Setzt nach jeder Bewegung ein Attribut am Player. | Eine serverseitige Tempo-Prüfung würde den Sprung als Cheat sehen. Der MovementCheck aus dem Sprint-Guide liest dieses Attribut und misst von der neuen Position aus neu. Ohne so ein Skript bewirkt das Attribut nichts. |
| Einstellung | Wert hier | Was sie ändert |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Wie lange Pads und Portale einen Spieler nach jedem Teleport ignorieren. |
MENU_COOLDOWN_SECONDS | 3 | Der kürzeste Abstand zwischen zwei Menü-Teleports eines Spielers. Pads und Menü teilen sich eine Uhr pro Spieler, also wird auch eine Menü-Anfrage innerhalb von 3 Sekunden nach einem Pad-Teleport ignoriert. |
PAD_ARRIVAL_GAP | 3 | Wie viele Studs vor der Vorderseite eines Ziel-Pads Spieler ankommen, damit sie neben dem Pad landen, nicht darauf. |
PLACE_ATTEMPTS | 3 | Wie oft ein Portal TeleportAsync versucht, im Abstand von 2 Sekunden, bevor es aufgibt. |
Drück jetzt auf Play und tritt auf PadA: Du erscheinst vor PadB. Das Menü und die Portale brauchen die nächsten beiden Schritte, aber das Skript läuft schon ohne sie.
Schritt 4: In einen anderen Place teleportieren
Ein Place ist eine eigene Welt in deinem Spiel, mit eigenen Servern: eine Lobby und ein Dungeon, oder ein Hub und eine Reihe von Levels. Spieler wechseln mit TeleportService zwischen Places, und Roblox führt ihn nur im veröffentlichten Spiel aus, also endet dieser Schritt in der Roblox-App statt in Studio.
- Wenn das Spiel noch nicht veröffentlicht ist, wähl File > Publish. Neue Spiele sind nur für dich, Leute mit Edit-Zugriff von dir und Gruppenmitglieder mit den richtigen Rollen offen, bis du sie freigibst, und mehr brauchst du nicht, um Teleports selbst zu testen.
- Leg den zweiten Place an: Öffne einen neuen Place aus einer beliebigen Studio-Vorlage, bau deinen Dungeon, wähl dann File > Publish As, klick auf die Kachel deines Spiels, wähl Add as a new place und klick auf Create.
- Kopier die ID des neuen Places. Öffne den Asset Manager über das Menü Window oder den Tab Home, geh zu Places In Experience, klick mit rechts auf den Place und wähl Copy Asset ID, was seine Place-ID kopiert.
- Füge zurück in deinem ersten Place einen Folder namens
PlacePortalsin Workspace ein und darin einen verankerten Part namensDungeonPortal. Füge ein Number-Attribut namensPlaceIdhinzu und füge die ID als Wert ein. - Drück auf Play und berühr das Portal. Output gibt eine Zeile aus, die mit
Teleporters: would sendbeginnt: Mehr macht ein Portal in Studio nicht. - Veröffentliche noch einmal mit File > Publish, damit das veröffentlichte Spiel das Portal hat, und teste es aus der Roblox-App wie in Schritt 5.
Teleporters ruft TeleportAsync in einem pcall auf, bis zu 3 Mal mit 2 Sekunden zwischen den Versuchen, weil die Teleport-Seite von Roblox sagt, dass Teleports scheitern und einen Fehler werfen können, und erneute Versuche empfiehlt. Ein Teleport kann auch starten und dann im letzten Moment ohne Fehler scheitern, sodass der Spieler bleibt, wo er war. Dafür feuert Roblox TeleportInitFailed, und das Skript löscht das Flag des Spielers, dass er unterwegs ist, also versucht es eine erneute Berührung des Portals noch einmal.
Um Spieler zurückzubringen, mach dasselbe im anderen Place: Leg eine Kopie von Teleporters in dessen ServerScriptService und füge ein Portal hinzu, dessen PlaceId die ID deines ersten Places ist, auf dieselbe Weise aus dem Asset Manager kopiert.
Wer deinen anderen Places beitreten kann
Die Security-Doku von Roblox warnt: Sobald ein Client in einem Place deines Spiels ist, kann er sich in jeden anderen Place darin teleportieren, egal welchen Weg du vorgesehen hast, und Direct Access eines Places abzuschalten entfernt nur den Join-Button auf der Website. Die Einstellung, die das ändert, ist Access Control for Places, unter Audience > Access Settings im Creator Dashboard:
| Einstellung | Wer einem Place beitreten kann, der nicht der Start-Place ist |
|---|---|
| Fully open | Jeder, über Teleports aus jedem Spiel, Deep Links, Spieleinladungen und das Beitreten zu einem Freund. |
| Limited to same universe | Nur Spieler, die sich aus deinen Spielen heraus teleportieren. Teleports von Client und Server sind beide erlaubt. |
| Secure within universe only | Nur Spieler, die deine Server-Skripte aus diesem Spiel heraus teleportieren. |
Wenn Spieler einen Place nur über dein Portal erreichen sollen, zum Beispiel einen Dungeon, wähl Secure within universe only. Jeder Teleport in diesem Guide startet auf dem Server, also funktioniert er weiter. Roblox sagt auch, dass viele Spiele keine sicheren Teleports brauchen, also kann ein Spiel, dessen Places alle für jeden offen sind, es lassen, wie es ist.
Was ältere Teleporter-Tutorials falsch machen
Wenn du diesen Guide mit einem Video oder einem Forenbeitrag vergleichst: Das sind die Unterschiede, die zählen, mit dem Grund, warum jedes Muster ein Problem ist.
| Das Tutorial | Das Problem | Dieser Guide |
|---|---|---|
Setzt hit.Parent.HumanoidRootPart.Position = target.Position | Die Referenz von Roblox sagt, dass das Setzen von Position die Gelenke des Parts aktualisiert, sodass er sich relativ zu den verbundenen Parts bewegt: Der Root-Part bewegt sich ohne den Körper. | Bewegt den ganzen Charakter mit PivotTo. |
Setzt HumanoidRootPart.CFrame = target.CFrame | Die Mitte des Charakters landet in der Mitte des Ziel-Parts, teilweise in ihm, und übernimmt die Neigung des Parts. | Kommt auf Stehhöhe über der Oberseite an, neben einem Pad, waagerecht gehalten. |
Nutzt eine einzige debounce-Variable für das ganze Pad | Während ein Spieler teleportiert, ignoriert das Pad alle anderen. Ganz ohne Debounce wird ein Spieler, der auf dem anderen Pad landet, direkt zurückgeschickt. | Ein Cooldown pro Spieler, gespeichert, bevor irgendetwas wartet, und Spieler landen neben dem Pad. |
Ruft TeleportService:Teleport(placeId, player) aus einem LocalScript auf | Roblox markiert Teleport() als veraltet, sagt, es nicht für neue Arbeit zu nutzen, und erlaubt TeleportAsync nur aus Server-Skripten. | Ruft TeleportAsync im Server-Script auf. |
Kein pcall, kein erneuter Versuch | Die Teleport-Seite von Roblox sagt, dass Teleports scheitern und einen Fehler werfen können und auch nach dem Start noch scheitern können. | Bis zu 3 Versuche in pcall, und TeleportInitFailed lässt den Spieler es noch einmal versuchen. |
| Gibt auf, weil es in Studio „nicht funktioniert“ | TeleportService unterstützt keine Playtests in Studio. | RunService:IsStudio() gibt stattdessen aus, was das Portal getan hätte. |
| Ein Teleport-GUI, dessen Buttons eine Position schicken | Ein Cheater kann dasselbe Remote mit jeder Position feuern. | Die Buttons schicken einen Spot-Namen, und der Server schlägt ihn nach. |
| Coins, die in den Teleport-Daten mitgegeben werden | Roblox sagt, dass Teleport-Daten für den Client sichtbar und unverschlüsselt sind. | Rät dir, Coins und Wins in einem Data Store zu halten und im anderen Place zu laden (siehe Daten in den anderen Place mitnehmen). |
Was Spieler fälschen können und was nicht
Geh davon aus, dass ein Cheater alles auf seinem eigenen Gerät kontrolliert: Er kann TeleportMenu bearbeiten, beide Remotes so oft feuern, wie er will, mit beliebigen Argumenten, und seinen eigenen Charakter bewegen. Das bringt es ihm bei diesem Teleporter.
| Ein Cheater versucht | Ergebnis | Warum |
|---|---|---|
| Eine Position oder eine CFrame über das Menü-Remote zu schicken | Wird ignoriert | TeleportRequest liest einen String, einen Spot-Namen mit höchstens 50 Zeichen. Alles andere wird verworfen. |
| Castle ohne 3 Wins anzufragen | Abgelehnt | Der Server liest die Wins aus seiner eigenen Kopie von leaderstats. Der graue Button ist nur ein Hinweis. |
| Einen Spot anzufragen, den es nicht gibt | Wird ignoriert | Der Server schlägt den Namen in TeleportSpots nach und tut nichts, wenn kein Part so heißt. |
| Das Menü-Remote immer wieder zu feuern | Höchstens ein Menü-Teleport alle 3 Sekunden | Der Cooldown wird auf dem Server gehalten, pro Spieler. |
| Ein Pad auszulösen, ohne hinzulaufen | Er erreicht das Partner-Pad, zu dem er sowieso laufen könnte | Roblox nennt das Teleportieren an jede Position und das Manipulieren von Touched-Events unter den Dingen, die ein Client mit seinem eigenen Charakter tun kann. |
| Einem anderen Place deines Spiels direkt beizutreten | Möglich, außer Access Control for Places steht auf Secure within universe only | Siehe Wer deinen anderen Places beitreten kann. |
| Seinen eigenen Charakter überallhin zu bewegen, auch zu einem gesperrten Spot | Möglich | Jedes Gerät steuert die Bewegung seines eigenen Charakters. Ein gesperrter Spot ist eine Annehmlichkeit, kein Tresor, also prüf auf dem Server, bevor du dort etwas Wertvolles vergibst. |
Die letzte Zeile ist die ehrliche Grenze jedes Teleporters. Für ein kompetitives Spiel füge eine serverseitige Bewegungsprüfung hinzu wie die im Sprint-Guide. Teleporters setzt bereits das Attribut MovementCheckSkip, das diese Prüfung liest, also werden seine eigenen Teleports nicht gemeldet: Die Security-Doku von Roblox sagt, dass Spiele mit legitimen Teleports genau diese Art von Ausnahme in ihren Bewegungsprüfungen brauchen.
Schritt 5: Testen
- Drück auf Play. Tritt auf PadA: Du erscheinst direkt vor PadB, mit dem Rücken dazu. Dreh dich um und tritt direkt zurück auf PadB: Nichts passiert, weil Pads dich nach der Ankunft 2 Sekunden lang ignorieren. Geh runter, warte 2 Sekunden und lauf wieder auf PadB: Du erscheinst vor PadA.
- Warte ein paar Sekunden und klick dann links am Bildschirm auf Teleport. Die Liste zeigt Lake, Spawn und "Castle (needs 3 wins)" in Grau. Wähl Lake: Du erscheinst darauf. Öffne das Menü wieder und wähl Castle: Nichts passiert, und Output bleibt still.
- Gib dir 3 Wins (das braucht ein leaderstats-Skript mit einem IntValue Wins, etwa das aus dem Leaderboard-Guide). Klick auf den Umschalter Client/Server, um zum Server zu wechseln, such im Explorer
Players, deinen Namen,leaderstats,Winsund setz im Properties-Fenster seinen Value auf 3. Wechsel zurück zum Client und öffne das Menü wieder: Castle ist lila und bringt dich hin. - Berühr DungeonPortal. Output gibt eine Zeile aus, die mit
Teleporters: would sendbeginnt, mit deinem Namen und der Place-ID. Das ist in Studio so gewollt, und sie erscheint höchstens einmal alle 2 Sekunden, egal wie lange du auf dem Portal stehst. - Wähl im Dropdown für den Testmodus Server & Clients, stell 2 Clients ein und drück auf Play. Beide Spieler können die Pads gleichzeitig nutzen, und der Cooldown des einen blockiert nie den anderen.
- Stopp den Test, veröffentliche und spiel das Spiel aus der Roblox-App. Berühr das Portal: Der Ladebildschirm von Roblox erscheint, und du kommst im anderen Place an. Wenn du bleibst, wo du bist, öffne mit F9 die Developer Console, stell ihr Log auf die Ansicht Server, die nur der Besitzer des Spiels und Gruppenmitglieder mit Bearbeitungsrecht sehen, und such nach den Warnungen mit
Teleporters:, die den Grund enthalten, den Roblox genannt hat.
Lass das Output-Fenster während der Studio-Schritte offen (Menü Window, dann Output). Teleporters gibt nichts aus, wenn es funktioniert, abgesehen von der Portal-Zeile in Schritt 4, also lohnt es sich, jede Warnung und jeden roten Fehler zu lesen. Siehe Häufige Fehler.
Den Teleporter erweitern
Ein Team oder eine Party zusammen teleportieren
TeleportAsync nimmt eine Liste von Spielern, also kann ein Portal eine ganze Gruppe in denselben Place schicken. Die Teleport-Seite von Roblox schlägt vor, vom Spieler auszugehen, der das Portal berührt hat: player.Team und Team:GetPlayers() für ein Team, oder SocialService:GetPlayersByPartyId() mit player.PartyId für eine Party. Übergib diese Liste statt { player } und setz das Flag leavingForPlace für jeden Spieler darin.
Eine Gruppe auf einen eigenen Server schicken
Standardmäßig treten teleportierte Spieler einem öffentlichen Server des anderen Places bei. Um eine Gruppe stattdessen auf einen neuen reservierten Server zu schicken, zum Beispiel für ein Match, erstell TeleportOptions, setz ShouldReserveServer auf true und übergib sie als drittes Argument: TeleportService:TeleportAsync(placeId, players, options). Roblox merkt an, dass gerade Fehlschläge mit reservierten Servern von erneuten Versuchen profitieren, und die macht das Skript bereits.
Daten in den anderen Place mitnehmen
Ein Teleport verwirft alle lokalen Daten dieses Spielers. Die Teleport-Daten von Roblox, gesetzt mit TeleportOptions:SetTeleportData() und im anderen Place gelesen mit player:GetJoinData(), sind für den Client sichtbar und unverschlüsselt, also nutz sie nur für harmlose Entscheidungen wie die Map, die geladen werden soll. Halt Coins, Wins und Items in einem Data Store, wie im DataStore-Tutorial, und lad sie neu, wenn der Spieler im anderen Place ankommt.
Ein eigener Ladebildschirm
Während ein Place-Teleport lädt, sehen Spieler den Standard-Ladebildschirm von Roblox. Um deinen eigenen zu zeigen, ruf auf dem Client TeleportService:SetTeleportGui() mit einem ScreenGui auf, zum Beispiel einem, das in ReplicatedStorage liegt. Die Teleports in diesem Guide starten auf dem Server, also muss der Client es im Voraus aufrufen, zum Beispiel sobald der Spieler beitritt. Roblox sagt, dass der Bildschirm vor jedem Teleport neu gesetzt werden muss und für einen Place in einem anderen Spiel nicht genutzt wird. Außerdem laufen Skripte in diesem ScreenGui nicht, also gestalte es als Standbild.
Runden-Teleports und Checkpoints
Das Rundensystem bewegt zu Beginn jeder Runde jeden Spieler mit derselben Art von PivotTo-Aufruf in die Arena, und PivotTo oder SpawnLocations (auf Englisch) im Obby-Guide vergleicht diesen Ansatz mit den Spawn-Punkten von Roblox. Wenn sich ein Spot erst nach einer Runde öffnen soll: Das Rundensystem vergibt bereits die Wins, die WinsNeeded liest.
Häufige Fehler und Lösungen
Öffne das Output-Fenster (Menü Window, dann Output), bevor du auf Play drückst. Teleporters nennt das Pad, wenn eine Destination ins Leere zeigt, also zeigen sich die meisten Probleme dort.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu wartet auf das Remote, das Teleporters erstellt, also läuft Teleporters nicht. Prüf, dass es ein Script ist, kein LocalScript, direkt in ServerScriptService, dass es nicht deaktiviert ist und dass Output keinen roten Fehler davon zeigt. Der Guide zu Skriptfehlern erklärt diese Warnung im Detail.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Das Attribut Destination des Pads nennt etwas, das kein Part direkt im Ordner TeleportPads ist. Prüf Schreibweise und Großbuchstaben des Attributwerts und des Namens des Ziel-Pads. Die Warnung erscheint einmal pro Pad, wenn ein Spieler es zum ersten Mal berührt.
Auf ein Pad zu treten bewirkt nichts
Prüf, dass der Ordner exakt TeleportPads heißt und beim Spielstart direkt in Workspace liegt, dass das Attribut Destination des Pads ein String ist (ein Number-Attribut wird ignoriert) und dass du seit deinem letzten Teleport 2 Sekunden gewartet hast. Prüf auch, dass CanTouch am Pad an ist: Roblox sagt, dass das Verbinden von Touched mit einem Part ohne CanTouch einen Fehler wirft, was das Skript stoppt.
Ich lande in einer Wand oder falle über die Kante
Spieler kommen 3 Studs vor der Vorderseite des Ziel-Pads an. Klick mit rechts auf das Pad, wähl Show Orientation Indicator und dreh das Pad, bis die blaue Linie auf freien Boden zeigt. Menü-Spots setzen Spieler oben auf den Part, also lass jeden Spot auf einem Boden liegen.
Der Button Castle bleibt grau, obwohl ich 3 Wins verdient habe
Die Liste wird gezeichnet, wenn sich das Menü öffnet, also schließ das Menü und öffne es wieder. Wenn er immer noch grau ist, prüf, dass leaderstats einen IntValue hat, der exakt Wins heißt, und dass sich die Wins auf dem Server geändert haben, nicht nur im Client-Modus.
Das Portal tut im veröffentlichten Spiel nichts
Öffne mit F9 die Developer Console, stell ihr Log auf die Ansicht Server (nur der Besitzer des Spiels und Gruppenmitglieder mit Bearbeitungsrecht sehen sie, weil Teleporters ein Server-Script ist) und lies die Warnungen mit Teleporters:, die den Grund enthalten, den Roblox genannt hat. Prüf, dass das Attribut PlaceId des Portals ein Number-Attribut mit der ID aus dem Asset Manager ist und dass du den Place nach dem Hinzufügen des Portals neu veröffentlicht hast.
Mit RoCode bauen
Wenn du das nicht von Hand verdrahten willst, kann RoCode es in dem Spiel bauen, das du offen hast. RoCode ist ein unabhängiger KI-Agent für Roblox Studio und stammt nicht von Roblox: Du beschreibst das Feature in seinem Webchat, und sein Studio-Plugin erstellt die Parts und die Skripte in deinem Explorer, also kopierst du keinen Code aus einem Chatfenster. Prompts kannst du auf Deutsch schreiben.
Füge Teleporter hinzu: Pads in Workspace.TeleportPads, die Spieler zu dem Pad schicken, das in ihrem Attribut Destination steht, mit 2 Sekunden Cooldown, ein Teleport-Menü für die Spots in Workspace.TeleportSpots, bei dem Castle 3 Wins braucht, auf dem Server geprüft, und Portale in Workspace.PlacePortals, die Spieler mit erneuten Versuchen zu der Place-ID in ihrem Attribut PlaceId schicken.
- Kann dein Spiel durchsuchen, wenn ein Schritt es braucht, mit Search Game und Search Scripts, und so auf Items, Remotes oder Speichercode aufbauen, die du schon hast, statt ein zweites System hinzuzufügen
- Erstellt die Ordner und die Pad-Parts mit Create Instance, setzt ihre Eigenschaften mit Set Property und schreibt Teleporters und TeleportMenu mit Create Script
- Ist angewiesen, jedes Skript, das es schreibt, mit Check Script auf Kompilierfehler zu prüfen; das kompiliert es in Studio, ohne es auszuführen
- Schickt seine Änderungen in Runden, und jede Runde ist ein Undo-Punkt im Verlauf von Studio
Place-Teleports laufen nur im veröffentlichten Spiel, also teste sie selbst in der Roblox-App. Mit Plugin 3.9 oder neuer kann RoCode einen kurzen Playtest machen und die Fehler lesen, und mit Plugin 3.9.15 oder neuer kann sein Test-Charakter auf Pads treten und Menü-Buttons anklicken, aber es prüft nur, was es selbst zum Testen ausgewählt hat, also tritt selbst auf die Pads und öffne das Menü. Ein Teleporter ist ein System unter vielen in einem Spiel; ein ganzes Spiel mit RoCode bauen läuft genauso, ein System pro Prompt. Wie sich RoCode mit Studio verbindet.
Häufige Fragen
Wie baue ich ein Teleport-Pad in Roblox Studio?
Gib zwei Parts ein Attribut Destination, das den jeweils anderen nennt, und lass dann ein Server-Script jeden, der ein Pad berührt, mit character:PivotTo an eine Stelle direkt vor dem anderen Pad bewegen, mit einem kurzen Cooldown pro Spieler. Schritt 1 und Schritt 2 bauen genau das.
Warum funktioniert mein Teleporter in Studio nicht?
Pads und Menüs funktionieren in Studio. Teleports in einen anderen Place nicht: Der TeleportService von Roblox unterstützt keine Playtests in Studio, also veröffentliche das Spiel und teste in der Roblox-App. Das Skript in diesem Guide gibt stattdessen aus, was ein Portal getan hätte, sodass du trotzdem prüfen kannst, ob es auslöst.
Wie teleportiere ich Spieler in einen anderen Place meines Spiels?
Füge den Place mit File > Publish As (Add as a new place) hinzu, kopier seine Place-ID aus dem Asset Manager und ruf TeleportService:TeleportAsync(placeId, { player }) aus einem Server-Script in einem pcall auf, mit erneutem Versuch, wenn es scheitert. Schritt 4 führt dich hindurch.
Wie baue ich ein Teleport-GUI?
Bau die Buttons in einem LocalScript und schick dem Server nur den Namen des Spots, den der Spieler gewählt hat. Der Server schlägt den Namen in einem Ordner nach, prüft den Cooldown und jede Freischalt-Regel und bewegt dann den Charakter. Schick nie eine Position vom Client: Ein Cheater kann jede beliebige Position schicken.
Warum bleibt mein Charakter nach dem Teleport stecken oder fällt auseinander?
Die Position des Root-Parts zu setzen bewegt nur diesen Part, nicht den damit verbundenen Körper, und die CFrame eines Pads zu kopieren setzt die Mitte des Charakters in das Pad. Nimm character:PivotTo mit einem Punkt auf Stehhöhe über dem Boden, berechnet aus der HipHeight des Humanoid.
Kann ich Coins oder Items mit einem Teleport mitschicken?
Nicht sicher. Roblox sagt, dass Teleport-Daten für den Client sichtbar und unverschlüsselt sind, also taugen sie für so etwas wie eine gewählte Map, nicht für Coins. Speichere Coins und Items in einem Data Store und lad sie im anderen Place.
Quellen und weiterführende Links
- Roblox Creator Docs: Teleport between places (auf Englisch). TeleportAsync, Studio-Playtests, Access Control for Places, Teleport-Bildschirme, Teleport-Daten und gescheiterte Teleports
- Roblox Creator Docs: TeleportService (auf Englisch). das veraltete Teleport, TeleportAsync nur auf dem Server und TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (auf Englisch). die wichtigste Funktion, um Models per Skript zu bewegen
- Roblox Creator Docs: BasePart.Position (auf Englisch). warum das Setzen von Position an einem verbundenen Part ihn relativ zu den anderen bewegt
- Roblox Creator Docs: Humanoid.HipHeight (auf Englisch). wie hoch der Root-Part eines stehenden Charakters sitzt, für R15- und R6-Rigs
- Roblox Creator Docs: Seat (auf Englisch). der SeatWeld, der einen sitzenden Charakter hält, und ihn zerstören, damit der Charakter aufsteht
- Roblox Creator Docs: Player:RequestStreamAroundAsync (auf Englisch). einen Bereich anfordern, bevor ein Charakter dorthin wechselt, ohne Garantie, was ankommt
- Roblox Creator Docs: Streaming techniques and conversion (auf Englisch). vorausschauendes Streaming vor einem Teleport
- Roblox Creator Docs: Access control and confidentiality (auf Englisch). warum Clients jeden Place eines Spiels erreichen können, solange Teleports nicht abgesichert sind
- Roblox Creator Docs: Network ownership, movement validation, and physics (auf Englisch). was ein Client mit seinem eigenen Charakter tun kann, und Teleport-Ausnahmen in Bewegungsprüfungen
- Roblox Creator Docs: Create and publish games and places (auf Englisch). Veröffentlichen, wer ein neues Spiel öffnen kann, und einen Place mit Publish As hinzufügen
- Roblox Creator Docs: Asset Manager (auf Englisch). eine Place-ID kopieren
- Roblox Creator Docs: Developer Console (auf Englisch). die Server-Ansicht des Logs und wer sie sehen kann
- Roblox Creator Docs: Debounce patterns (auf Englisch). warum Touched bei einem Kontakt mehrmals feuert
So wurde der Code geprüft: Jedes Skript auf dieser Seite besteht die strikte Typprüfung von Luau mit den Roblox API-Definitionen (luau-lsp, 12. November 2026). Eine Typprüfung findet falsch geschriebene APIs und falsche Typen, aber keine Fehler in der Spiellogik. Teste also in Studio, bevor du veröffentlichst.