Tutorial · Spielsysteme

Einen Teleporter in Roblox Studio erstellen

Ein Teleporter in Roblox ist eins von zwei Dingen: einen Charakter an eine andere Stelle im selben Server bewegen oder den Spieler in einen anderen Place deines Spiels schicken. Dieser Guide baut beides aus einem einzigen Server-Script: Pads, die dich zu einem Partner-Pad schicken, ein Teleport-Menü, dessen gesperrte Spots sich mit Wins öffnen, und Portale zu einem anderen Place, die es erneut versuchen, wenn der Teleport von Roblox fehlschlägt.

Aktualisiert am 12. November 202623 Min. LesezeitGeschrieben von

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.Position zu 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. Nimm TeleportAsync auf dem Server, pack es in pcall, versuch es erneut und behandle TeleportInitFailed.
Auf dieser Seite
  1. So funktioniert es
  2. 1. Teleport-Pads
  3. 2. Teleport-Skript
  4. 3. Teleport-Menü
  5. 4. Andere Places
  6. Ältere Tutorials
  7. Grenzen für Exploits
  8. 5. Testen
  9. Erweitern
  10. Häufige Fehler
  11. Mit RoCode
  12. Häufige Fragen
  13. Quellen und weiterführende Links

Zwei Arten von Teleport

IllustrationPadA zu berühren setzt dich direkt vor PadB ab, sodass PadB dich nicht direkt zurückschickt, und der Server lehnt das gesperrte Castle ab, bringt dich aber zu Lake.

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.

Die zwei Arten von Teleport
Innerhalb desselben ServersIn einen anderen Place deines Spiels
Der Aufrufcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Genutzt fürTeleport-Pads, ein Teleport-Menü, Spieler aus der Lobby in eine Arena bringenPortale in ein anderes Level, eine Lobby, die Spieler in einen eigenen Dungeon- oder Match-Place schickt
Läuft inEinem Server-ScriptNur einem Server-Script. Das clientseitige Teleport() ist veraltet.
Funktioniert im Studio-PlaytestJaNein. Der TeleportService von Roblox unterstützt keine Playtests in Studio, also testest du im veröffentlichten Spiel.
Was der Spieler siehtEinen Sprung über die Map, der bis zu 2 Sekunden dauern kann, wenn dieser Bereich erst laden mussDen Ladebildschirm von Roblox, dann den anderen Place
Coins, Items und andere DatenBleiben, wie sie sindRoblox 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.

Die Bausteine des Teleporters
BausteinWo er liegtWas er macht
Folder TeleportPads mit PadA und PadBWorkspaceZwei Pads. Das Attribut Destination jedes Pads nennt das Pad, zu dem es Spieler schickt.
Folder TeleportSpotsWorkspaceEin Part für jeden Spot, den das Menü auflistet. Ein Attribut WinsNeeded sperrt einen Spot.
Folder PlacePortalsWorkspacePortal-Parts. Das Attribut PlaceId jedes Portals ist der Place, zu dem es Spieler schickt.
Script TeleportersServerScriptServiceFührt alle drei Arten von Teleport aus und erstellt die beiden Remotes. Der einzige Ort, an dem ein Teleport passieren kann.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsZeichnet den Teleport-Button und die Liste der Spots und schickt den Namen des Spots, den der Spieler wählt.
RemoteFunction GetTeleportSpots und RemoteEvent TeleportRequestReplicatedStorage (Teleporters erstellt sie)Die erste gibt dem Menü die Liste der Spots zurück. Das zweite trägt den gewählten Namen zum Server.
Der Explorer, wenn der Teleporter fertig ist. Teleporters fügt GetTeleportSpots und TeleportRequest zu ReplicatedStorage hinzu, wenn das Spiel läuft.
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

  1. 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.
  2. Füge zwei Parts in den Ordner ein und nenn sie PadA und PadB. 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.
  3. Wähl PadA aus, scroll im Properties-Fenster zum Abschnitt Attributes und klick auf +. Gib den Namen Destination ein, wähl den Typ String und klick auf Save, dann setz den Wert auf PadB. Mach dasselbe bei PadB mit dem Wert PadA.
  4. 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
-- 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.

Was jeder Teil von Teleporters macht
TeilWas er machtWarum
playerFromHitFindet 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.
onCooldownVergleicht 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.
rootHeightBerechnet, 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 teleportToKehrt 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 AnkunftspunktDie 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.
RequestStreamAroundAsyncBittet 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üfungWenn 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 SeatWeldWenn 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 lastTeleportStartet 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.
MovementCheckSkipSetzt 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.
Die Einstellungen oben in Teleporters
EinstellungWert hierWas sie ändert
PAD_COOLDOWN_SECONDS2Wie lange Pads und Portale einen Spieler nach jedem Teleport ignorieren.
MENU_COOLDOWN_SECONDS3Der 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_GAP3Wie viele Studs vor der Vorderseite eines Ziel-Pads Spieler ankommen, damit sie neben dem Pad landen, nicht darauf.
PLACE_ATTEMPTS3Wie 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.

  1. 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.
  2. 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.
  3. 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.
  4. Füge zurück in deinem ersten Place einen Folder namens PlacePortals in Workspace ein und darin einen verankerten Part namens DungeonPortal. Füge ein Number-Attribut namens PlaceId hinzu und füge die ID als Wert ein.
  5. Drück auf Play und berühr das Portal. Output gibt eine Zeile aus, die mit Teleporters: would send beginnt: Mehr macht ein Portal in Studio nicht.
  6. 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:

Die drei Einstellungen von Access Control for Places
EinstellungWer einem Place beitreten kann, der nicht der Start-Place ist
Fully openJeder, über Teleports aus jedem Spiel, Deep Links, Spieleinladungen und das Beitreten zu einem Freund.
Limited to same universeNur Spieler, die sich aus deinen Spielen heraus teleportieren. Teleports von Client und Server sind beide erlaubt.
Secure within universe onlyNur 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.

Häufige Muster in Teleporter-Tutorials und was dieser Guide stattdessen macht
Das TutorialDas ProblemDieser Guide
Setzt hit.Parent.HumanoidRootPart.Position = target.PositionDie 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.CFrameDie 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 PadWä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 aufRoblox 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 VersuchDie 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 schickenEin 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 werdenRoblox 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.

Was ein Cheater versuchen kann und was Teleporters dagegen tut
Ein Cheater versuchtErgebnisWarum
Eine Position oder eine CFrame über das Menü-Remote zu schickenWird ignoriertTeleportRequest liest einen String, einen Spot-Namen mit höchstens 50 Zeichen. Alles andere wird verworfen.
Castle ohne 3 Wins anzufragenAbgelehntDer Server liest die Wins aus seiner eigenen Kopie von leaderstats. Der graue Button ist nur ein Hinweis.
Einen Spot anzufragen, den es nicht gibtWird ignoriertDer Server schlägt den Namen in TeleportSpots nach und tut nichts, wenn kein Part so heißt.
Das Menü-Remote immer wieder zu feuernHöchstens ein Menü-Teleport alle 3 SekundenDer Cooldown wird auf dem Server gehalten, pro Spieler.
Ein Pad auszulösen, ohne hinzulaufenEr erreicht das Partner-Pad, zu dem er sowieso laufen könnteRoblox 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 beizutretenMöglich, außer Access Control for Places steht auf Secure within universe onlySiehe Wer deinen anderen Places beitreten kann.
Seinen eigenen Charakter überallhin zu bewegen, auch zu einem gesperrten SpotMöglichJedes 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

  1. 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.
  2. 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.
  3. 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, Wins und 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.
  4. Berühr DungeonPortal. Output gibt eine Zeile aus, die mit Teleporters: would send beginnt, 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.
  5. 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.
  6. 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.

Du schreibst

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.

RoCode macht
  • 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

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.

Probier RoCode in deinem eigenen Spiel aus.

Jeden Tag kostenlose Credits, ohne Karte. Installiere das Plugin, beschreibe das Feature und prüfe, was in Studio ankommt.