Tutorial · Gamesystemen

Hoe maak je een teleporter in Roblox Studio

Een teleport in Roblox is een van twee dingen: een personage naar een andere plek op dezelfde server verplaatsen, of een speler naar een andere place van je game sturen. In deze handleiding bouwen we allebei vanuit één serverscript: pads die je naar hun partnerpad sturen, een menu Teleport waarin plekken op slot pas opengaan met Wins, en portalen naar een andere place die het opnieuw proberen als een teleport van Roblox mislukt.

Bijgewerkt 20 november 202624 min lezenAuteur:

In het kort

Zet voor een teleport pad een Script in ServerScriptService dat luistert naar het event Touched van de pad, de speler vindt met Players:GetPlayerFromCharacter en het hele personage met character:PivotTo() verplaatst naar een punt vlak voor de bestemmingspad, met de rug ernaartoe, met een cooldown van een paar seconden per speler zodat de bestemmingspad hem niet meteen terugstuurt. Om spelers naar een andere place van je game te sturen, roep je TeleportService:TeleportAsync(placeId, { player }) aan vanuit een server-Script binnen pcall; dat werkt alleen in de gepubliceerde game, niet in Studio.

  • Verplaats het hele personage met PivotTo. HumanoidRootPart.Position instellen trekt de root part weg van de rest van het lichaam, omdat Roblox bij het instellen van Position de joints bijwerkt.
  • Een teleportmenu moet de naam van de bestemming naar de server sturen, niet een positie. De server controleert de naam, de cooldown en elke regel voor vrijspelen voordat hij iemand verplaatst.
  • TeleportService:Teleport() is verouderd en werkt op de client. Gebruik TeleportAsync op de server, verpak het in pcall, probeer het opnieuw en behandel TeleportInitFailed.
Op deze pagina
  1. Hoe het werkt
  2. 1. Pads
  3. 2. Teleport script
  4. 3. Teleportmenu
  5. 4. Andere places
  6. Oudere tutorials
  7. Grenzen van de beveiliging
  8. 5. Testen
  9. Uitbreidingen
  10. Common errors
  11. Met RoCode
  12. Veelgestelde vragen
  13. Bronnen en verder lezen

Twee soorten teleports

IllustratiePadA aanraken zet je vlak voor PadB, zodat PadB je niet meteen terugstuurt, en de server weigert de plek Castle die op slot zit, maar brengt je wel naar Lake.

Een teleport in een Roblox-game kan drie dingen betekenen: een pad die je over de map verplaatst, een menu met plekken waar je naartoe kunt springen, of een portaal naar een ander level. De eerste twee verplaatsen het personage binnen de server waar de speler al op zit. De derde stuurt de speler naar een andere place van je game, die op eigen servers draait. Ze gebruiken verschillende API's, dus het helpt om te weten welke je nodig hebt.

Twee soorten teleports
Binnen dezelfde serverNaar een andere place van je game
Aanroepcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
WaarvoorTeleport pads, teleportmenu's, spelers van de lobby naar de arena brengenPortalen naar een ander level, een lobby die spelers naar een aparte place met een dungeon of match stuurt
Waar het draaitServer-ScriptAlleen een server-Script. De client-versie Teleport() is verouderd.
Werkt in een playtest in StudioJaNee. TeleportService in Roblox ondersteunt geen playtests in Studio, dus je test in de gepubliceerde game.
Wat de speler zietEen sprong over de map die tot 2 seconden kan duren als dat gebied eerst geladen moet wordenHet laadscherm van Roblox, daarna de andere place
Munten, items en andere dataBlijven zoals ze zijnRoblox wist de lokale data van de speler, dus alles wat belangrijk is moet in de andere place uit een DataStore komen

In deze handleiding zitten alle drie de soorten in één server-Script, dus één set regels dekt elke teleport in je game: de server beslist, elke speler heeft een eigen cooldown en het apparaat van de speler meldt alleen naar welke plek hij zou willen.

Waaruit de teleporter bestaat
OnderdeelWaar het staatWat het doet
Folder TeleportPads met PadA en PadBWorkspaceTwee pads. Het attribuut Destination van elke pad noemt de pad waar hij spelers naartoe stuurt.
Folder TeleportSpotsWorkspaceEén part per plek in de lijst van het menu. Het attribuut WinsNeeded zet een plek op slot.
Folder PlacePortalsWorkspacePortaal-parts. Het attribuut PlaceId van elk portaal is de place waar het spelers naartoe stuurt.
Script TeleportersServerScriptServiceRegelt alle drie de soorten teleports en maakt twee remotes aan. De enige plek waar een teleport kan gebeuren.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsTekent de knop Teleport en de lijst met plekken en stuurt de naam van de plek die de speler kiest.
RemoteFunction GetTeleportSpots en RemoteEvent TeleportRequestReplicatedStorage (Teleporters maakt ze aan)De eerste geeft het menu de lijst met plekken. De tweede brengt de gekozen naam naar de server.
Explorer als de teleporter klaar is. Teleporters voegt GetTeleportSpots en TeleportRequest toe aan ReplicatedStorage als de game draait.
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

Stap 1: bouw twee teleport pads

  1. Houd in Explorer de muis boven Workspace, klik op de knop + en voeg een Folder in. Noem de map TeleportPads. Het script zoekt precies deze naam.
  2. Voeg twee Parts in de map in en noem ze PadA en PadB. Maak van elk een platte plaat, bijvoorbeeld 6 bij 1 bij 6 studs, en zet ze op enige afstand van elkaar op de vloer. Vink in het venster Properties Anchored aan, laat CanCollide en CanTouch aan staan en geef ze een felle kleur en het materiaal Neon, zodat spelers ze opmerken.
  3. Selecteer PadA, scrol in het venster Properties naar het deel Attributes en klik op +. Typ de naam Destination, kies het type String en klik op Save, en stel de waarde in op PadB. Doe hetzelfde bij PadB met de waarde PadA.
  4. Draai elke pad zodat zijn voorkant naar vrije vloer wijst. Spelers verschijnen 3 studs voor de voorkant van de bestemmingspad, met de rug ernaartoe, dus laat daar een paar studs vrije vloer. Om te zien welke kant de voorkant is, klik je met de rechtermuisknop op de pad en kies je Show Orientation Indicator: een blauwe lijn markeert de voorkant. Draai de pad met de tool Rotate tot die lijn wijst waar spelers heen moeten lopen.

Spelers komen naast de pad uit, niet erop, en dat is met opzet. De Roblox-pagina over debounce merkt op dat Touched vele keren achter elkaar afgaat bij één aanraking, dus een speler die direct op de andere pad verschijnt, zou die opnieuw activeren zodra zijn cooldown voorbij is en weer terugvliegen over de map.

Je bent niet beperkt tot twee pads. De Destination van een pad kan elke part in TeleportPads noemen, dus drie pads kunnen spelers in een rondje sturen. Voor een pad in één richting laat je hem wijzen naar een part in TeleportPads zonder eigen Destination: zo'n part ontvangt spelers en stuurt niemand ergens heen.

Stap 2: voeg het teleport script toe

Houd de muis boven ServerScriptService, voeg een Script in, noem het Teleporters en plak de code hieronder erin. Nu bedient het de pads, en na de volgende stappen ook het menu en de portalen, dus je voegt het maar één keer toe. De instellingen bovenaan zijn de regels die je hoort aan te passen.

Script in ServerScriptService met de naam Teleporters
-- Script in ServerScriptService met de naam Teleporters.
-- Elke teleport wordt hier beslist, op de server:
--   1. Pads: een part in Workspace.TeleportPads aanraken brengt je naar de part die genoemd
--      wordt in zijn attribuut Destination.
--   2. Menu: het LocalScript TeleportMenu vraagt een plek uit Workspace.TeleportSpots
--      op naam. De server controleert de naam, de cooldown en de Wins die de plek nodig heeft.
--   3. Portalen: een part in Workspace.PlacePortals aanraken stuurt je naar de place
--      uit zijn attribuut PlaceId (een andere place van deze game).

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 -- zo lang negeren pads een speler na elke teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs voor de bestemmingspad, zodat spelers ernaast uitkomen
local PLACE_ATTEMPTS = 3

local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")

-- Dit script maakt beide remotes zelf aan, dus voeg ze niet met de hand toe
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

-- Hoe hoog boven de vloer de root part van een staand personage zit.
-- Formule uit de Roblox-referentie voor Humanoid.HipHeight (bij R6-rigs komt de beenlengte erbij).
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() -- ingesteld vóór het wachten, zodat een tweede aanraking geen tweede teleport start

	-- Kijk in de richting van de voorkant van de bestemming (vlak, zonder kanteling)
	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
	-- Ga op de bovenkant staan: de pivot van een personage is zijn root part, dus til die op tot stahoogte.
	-- Een pad zet spelers echter een paar studs voor zich neer, omdat een speler die
	-- op de pad staat, hem met de volgende stap opnieuw zou activeren.
	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)

	-- Met instance streaming aan laden we eerst het gebied rond de bestemming (tot 2 seconden)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- vertrokken, gerespawnd of doodgegaan terwijl het gebied laadde
	end
	-- Een zittend personage is aan de stoel gelast, en het verplaatsen zou de stoel meenemen.
	-- SeatWeld vernietigen maakt het personage eerst los van de stoel.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Start de cooldown opnieuw bij aankomst: het vooraf laden hierboven kan tot 2 seconden duren,
	-- en de pad waar de speler bij uitkomt, mag hem niet meteen terugsturen
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- voor een script dat de snelheid controleert, als je er een hebt
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 -- één keer waarschuwen, niet bij elke aanraking
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Menu: de lijst met plekken, daarna een verzoek op naam
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 -- gelijke Wins: alfabetisch, zodat de volgorde nooit verandert
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- De client stuurt alleen een naam. Accepteer nooit een positie of CFrame van de client.
	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 -- op slot voor deze speler
	end
	teleportTo(player, spot, false)
end)

-- 3. Portalen naar een andere place van deze game
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- al onderweg of raakte een seconde geleden een teleport aan
	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 -- opgeven; een nieuwe aanraking van het portaal probeert het opnieuw
end

-- Een teleport kan ook na de start mislukken. De speler blijft hier en kan het opnieuw proberen.
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 maakt zelf de RemoteFunction GetTeleportSpots en het RemoteEvent TeleportRequest aan, dus je hoeft niets met de hand in ReplicatedStorage te zetten. Het verbindt de pads uit TeleportPads en de portalen uit PlacePortals één keer, bij de start van de server, dus pads en portalen die tijdens het spelen worden toegevoegd doen niets. Ontbreekt een map, dan staat die soort teleport gewoon uit.

Wat elk onderdeel van Teleporters doet
OnderdeelWat het doetWaarom
playerFromHitVindt het personagemodel waar de aanrakende part bij hoort en vraagt Players:GetPlayerFromCharacter van wie het is.Pads worden geraakt door voeten, hoeden en losse parts. Alles wat geen deel is van het personage van een speler geeft nil en wordt genegeerd.
onCooldownVergelijkt os.clock() met het tijdstip van de laatste teleport van de speler.Eén cooldown per speler, dus een speler die bij een pad staat blokkeert nooit de anderen. Niets wacht of slaapt.
rootHeightBerekent hoe hoog boven de vloer de root part van een staand personage zit: de halve hoogte van de root part plus de HipHeight van de Humanoid, plus de beenlengte bij R6-rigs.Dit is de formule uit de Roblox-referentie voor Humanoid.HipHeight. De pivot van een personage is zijn root part, dus de pivot zoveel optillen zet de voeten op het oppervlak, bij kleine en grote avatars en bij R6.
Controles aan het begin van teleportToStopt als de speler geen levend personage met een root part heeft en noteert dan meteen de tijd.Het streamingverzoek verderop kan het script laten wachten. Door de tijd vooraf te noteren, starten de vele Touched-events op dat moment geen tweede teleport.
AankomstpuntDe bovenkant van de bestemming, opgetild met rootHeight, kijkend in de richting van de voorkant, zonder kanteling. Bij een pad wordt het punt ook nog 3 studs van de voorkant verschoven.Het personage verschijnt staand, niet in de bestemmings-part. Naast een pad beginnen zijn voeten op de hoogte van de bovenkant, dus zakt hij de dikte van de pad naar de vloer. CFrame.lookAlong bouwt een CFrame op een positie met een gegeven kijkrichting.
RequestStreamAroundAsyncVraagt Roblox het gebied rond het aankomstpunt eerst naar deze speler te sturen en wacht maximaal 2 seconden.Instance streaming staat standaard aan in nieuwe places, dus een ver deel van de map is misschien nog niet geladen op het apparaat van de speler. Roblox raadt deze serveraanroep aan voordat je een personage ver verplaatst, al garandeert het niet wat er precies aankomt.
Tweede controleIs de speler vertrokken, of is het personage gerespawnd of doodgegaan tijdens het wachten, dan beweegt er niets.De speler kan gereset hebben of de game hebben verlaten terwijl het gebied laadde. Het eigen voorbeeld van Roblox voor vooraf laden controleert ook of het personage nog in de game is voordat het wordt verplaatst.
Regels met SeatWeldZit het personage, dan vernietigt het de Weld die het op de stoel houdt.Roblox last een zittend personage aan de stoel. PivotTo verplaatst parts door hun CFrame te veranderen, en de Roblox-referentie zegt dat het instellen van de CFrame van een part ook de parts verplaatst die eraan vastzitten, dus zonder dit zouden de stoel en alles wat eraan gelast is met de speler meekomen. SeatWeld vernietigen is de manier waarop de Roblox-referentie over Seat een personage vanuit een script van een stoel haalt.
character:PivotTo(target)Verplaatst het hele personage, alle ledematen en accessoires samen, naar het aankomstpunt.Roblox noemt PivotTo de belangrijkste functie om modellen vanuit scripts te verplaatsen.
Tweede regel met lastTeleportStart de cooldown opnieuw bij aankomst.Het streamingverzoek kan tot 2 seconden duren, net zo lang als de cooldown van de pad zelf, dus zonder deze regel zou een speler kunnen aankomen met een cooldown die al verlopen is.
MovementCheckSkipZet na elke verplaatsing een attribuut op Player.Een snelheidscontrole op de server zou de sprong voor valsspelen aanzien. De MovementCheck uit de handleiding over sprinten leest dit attribuut en begint opnieuw te meten vanaf de nieuwe positie. Zonder zo'n script doet het attribuut niets.
Instellingen bovenaan Teleporters
InstellingWaarde hierWat het verandert
PAD_COOLDOWN_SECONDS2Hoe lang pads en portalen een speler negeren na elke teleport.
MENU_COOLDOWN_SECONDS3De kortste tijd tussen twee teleports via het menu voor één speler. Pads en het menu delen één klok per speler, dus een verzoek uit het menu binnen 3 seconden na een teleport via een pad wordt ook genegeerd.
PAD_ARRIVAL_GAP3Hoeveel studs van de voorkant van de bestemmingspad spelers verschijnen, zodat ze naast de pad uitkomen en niet erop.
PLACE_ATTEMPTS3Hoe vaak een portaal TeleportAsync probeert, met 2 seconden ertussen, voordat het opgeeft.

Klik nu meteen op Play en stap op PadA: je verschijnt voor PadB. Het menu en de portalen hebben de volgende twee stappen nodig, maar het script werkt ook zonder.

Stap 4: teleporteren naar een andere place

Een place is een aparte wereld binnen je game, met eigen servers: een lobby en een dungeon, of een hub en een reeks levels. Spelers gaan van place naar place via TeleportService, en Roblox draait dat alleen in de gepubliceerde game, dus deze stap eindigt in de Roblox-app, niet in Studio.

  1. Is je game nog niet gepubliceerd, kies dan File > Publish. Nieuwe games zijn, totdat je ze uitbrengt, alleen open voor jou, voor mensen aan wie je Edit-toegang hebt gegeven en voor groepsleden met de juiste rollen, en voor je eigen test van teleports is dat genoeg.
  2. Maak een tweede place: open een nieuwe place vanuit een willekeurig sjabloon van Studio, bouw je dungeon, kies dan File > Publish As, klik op de tegel van je game, kies Add as a new place en klik op Create.
  3. Kopieer de ID van de nieuwe place. Open Asset Manager via het menu Window of het tabblad Home, ga naar Places In Experience, klik met de rechtermuisknop op de place en kies Copy Asset ID; dat kopieert de place ID.
  4. Voeg terug in de eerste place in Workspace een Folder in met de naam PlacePortals, en daarin een verankerde Part met de naam DungeonPortal. Voeg een attribuut van het type Number toe met de naam PlaceId en plak de ID als waarde.
  5. Klik op Play en raak het portaal aan. Output print een regel die begint met Teleporters: would send: in Studio doet het portaal verder niets.
  6. Publiceer de game opnieuw met File > Publish, zodat het portaal in de gepubliceerde game staat, en test het vanuit de Roblox-app zoals in stap 5.

Teleporters roept TeleportAsync aan binnen pcall, tot 3 keer met 2 seconden pauze tussen de pogingen, omdat de Roblox-pagina over teleports zegt dat teleports kunnen mislukken met een fout, en aanraadt het opnieuw te proberen. Een teleport kan ook beginnen en op het laatste moment zonder fout mislukken, waardoor de speler blijft waar hij was. Voor dat geval roept Roblox TeleportInitFailed aan, en het script haalt de vlag "vertrekt" van de speler af, zodat een nieuwe aanraking van het portaal het opnieuw probeert.

Om spelers terug te brengen, doe je hetzelfde in de andere place: zet een kopie van Teleporters in de ServerScriptService daarvan en voeg een portaal toe waarvan de PlaceId de ID van je eerste place is, op dezelfde manier gekopieerd uit Asset Manager.

Wie in je andere places kan komen

De beveiligingsdocumentatie van Roblox waarschuwt: zodra een client in één place van je game is, kan hij naar elke andere place ervan teleporteren, welke route je ook hebt bedacht, en Direct Access van een place uitzetten haalt alleen de knop Join op de website weg. Dat verander je met de instelling Access Control for Places onder Audience > Access Settings in het Creator Dashboard:

De drie waarden van Access Control for Places
InstellingWie in een place kan komen die niet de startplace is
Fully openIedereen, via teleports vanuit elke game, deep links, game-uitnodigingen en meedoen met een vriend.
Limited to same universeAlleen spelers die vanuit je eigen games teleporteren. Teleports vanaf de client en vanaf de server zijn allebei toegestaan.
Secure within universe onlyAlleen spelers die door je serverscripts vanuit deze game worden geteleporteerd.

Moeten spelers alleen via je portaal in een place komen, bijvoorbeeld een dungeon, kies dan Secure within universe only. Elke teleport in deze handleiding begint op de server, dus die blijft werken. Roblox zegt ook dat veel games geen beveiligde teleports nodig hebben, dus een game waarvan alle places voor iedereen open zijn, kan de instelling laten zoals hij is.

Wat oudere teleport tutorials fout doen

Vergelijk je deze handleiding met een video of forumpost, dan zijn dit de belangrijke verschillen en de reden waarom elke truc een probleem veroorzaakt.

Veelvoorkomende trucs in teleport tutorials en wat deze handleiding in plaats daarvan doet
TutorialProbleemDeze handleiding
Stelt hit.Parent.HumanoidRootPart.Position = target.Position inDe Roblox-referentie zegt dat het instellen van Position de joints van de part bijwerkt, en hij verschuift ten opzichte van de parts waarmee hij verbonden is: de root part schuift weg zonder het lichaam.Verplaatst het hele personage met PivotTo.
Stelt HumanoidRootPart.CFrame = target.CFrame inHet midden van het personage komt in het midden van de doel-part, er gedeeltelijk in, en neemt de kanteling van de part over.Het personage verschijnt op stahoogte boven de bovenkant, naast de pad, zonder kanteling.
Gebruikt één variabele debounce voor de hele padTerwijl één speler teleporteert, negeert de pad alle anderen. En helemaal zonder debounce wordt een speler die op de andere pad verschijnt meteen teruggestuurd.Eén cooldown per speler, genoteerd vóór elk wachten, en spelers verschijnen naast de pad.
Roept TeleportService:Teleport(placeId, player) aan vanuit een LocalScriptRoblox markeert Teleport() als verouderd, raadt het af voor nieuwe projecten en staat TeleportAsync alleen toe vanuit serverscripts.Roept TeleportAsync aan in een serverscript.
Geen pcall, geen nieuwe pogingenDe Roblox-pagina over teleports zegt dat ze kunnen mislukken met een fout, en ook nog na de start kunnen mislukken.Tot 3 pogingen in pcall, en TeleportInitFailed laat de speler het opnieuw proberen.
Geeft op omdat het in Studio "niet werkt"TeleportService ondersteunt geen playtests in Studio.RunService:IsStudio() print in plaats daarvan wat het portaal zou doen.
Een teleport-GUI waarvan de knoppen een positie sturenEen cheater kan dezelfde remote met elke positie aanroepen.De knoppen sturen de naam van de plek, en de server zoekt die op.
Munten worden meegegeven in teleport dataRoblox zegt dat teleport data zichtbaar is voor de client en niet versleuteld.Raadt aan munten en Wins in een DataStore te bewaren en ze in de andere place te laden (zie Data meenemen naar een andere place).

Wat spelers wel en niet kunnen vervalsen

Ga ervan uit dat een cheater alles op zijn eigen apparaat bestuurt: hij kan TeleportMenu aanpassen, beide remotes zo vaak hij wil met elk argument aanroepen en zijn personage verplaatsen. Dit is wat hem dat oplevert bij deze teleporter.

Wat een cheater kan proberen en wat Teleporters ermee doet
De cheater probeertResultaatWaarom
Een positie of CFrame sturen via de remote van het menuGenegeerdTeleportRequest leest één string, de naam van een plek van maximaal 50 tekens. Al het andere wordt weggegooid.
Castle aanvragen zonder 3 WinsGeweigerdDe server leest de Wins uit zijn eigen kopie van leaderstats. De grijze knop is alleen een hint.
Een plek aanvragen die niet bestaatGenegeerdDe server zoekt de naam op in TeleportSpots en doet niets als er geen part met die naam is.
De remote van het menu steeds opnieuw aanroepenNiet meer dan één teleport via het menu per 3 secondenDe cooldown staat op de server, per speler.
Een pad activeren zonder ernaartoe te lopenHij komt bij de partnerpad uit, waar hij ook zelf naartoe had kunnen lopenRoblox noemt teleporteren naar elke plek en het manipuleren van Touched-events onder de dingen die een client met zijn eigen personage kan doen.
Direct in een andere place van je game komenMogelijk, als Access Control for Places niet op Secure within universe only staatZie Wie in je andere places kan komen.
Zijn personage overal heen verplaatsen, ook naar een plek op slotMogelijkElk apparaat bestuurt de beweging van zijn eigen personage. Een plek op slot is een gemak, geen kluis, dus controleer op de server voordat je daar iets waardevols uitdeelt.

De laatste regel is de eerlijke grens van elke teleporter. Voeg voor een competitieve game een bewegingscontrole op de server toe, zoals in de handleiding over sprinten. Teleporters zet al het attribuut MovementCheckSkip dat die controle leest, zodat zijn eigen teleports niet als overtreding worden gemarkeerd: de beveiligingsdocumentatie van Roblox zegt dat games met legitieme teleports precies zo'n uitzondering nodig hebben in hun bewegingscontroles.

Stap 5: test het

  1. Klik op Play. Stap op PadA: je verschijnt vlak voor PadB, met je rug ernaartoe. Draai je om en stap meteen op PadB: er gebeurt niets, omdat pads je 2 seconden na aankomst negeren. Stap eraf, wacht 2 seconden en stap weer op PadB: je verschijnt voor PadA.
  2. Wacht een paar seconden en klik dan op Teleport aan de linkerkant van het scherm. In de lijst staan Lake, Spawn en een grijze "Castle (needs 3 wins)". Kies Lake: je verschijnt daar. Open het menu opnieuw en kies Castle: er gebeurt niets, en Output blijft stil.
  3. Geef jezelf 3 Wins (daarvoor heb je een leaderstats-script met een IntValue Wins nodig, bijvoorbeeld uit de handleiding over het leaderboard). Klik op de schakelaar Client/Server om naar Server te gaan, zoek in Explorer Players, je naam, leaderstats, Wins en zet de Value ervan op 3 in het venster Properties. Schakel terug naar Client en open het menu opnieuw: Castle is paars geworden en brengt je erheen.
  4. Raak DungeonPortal aan. Output print een regel die begint met Teleporters: would send, met je naam en de place ID. In Studio hoort dat zo, en hij wordt niet vaker dan eens per 2 seconden geprint, hoe lang je ook op het portaal staat.
  5. Kies Server & Clients in het dropdownmenu met testmodi, stel 2 clients in en klik op Play. Beide spelers kunnen de pads tegelijk gebruiken, en de cooldown van de een blokkeert nooit de ander.
  6. Stop de test, publiceer de game en start hem vanuit de Roblox-app. Raak het portaal aan: het laadscherm van Roblox verschijnt en je komt in de andere place. Blijf je waar je was, open dan de Developer Console met F9, zet de log op de weergave Server, die alleen de eigenaar van de game en groepsleden met bewerkrechten zien, en zoek de waarschuwingen Teleporters:; daarin staat de reden die Roblox gaf.

Houd tijdens de stappen in Studio het venster Output open (menu Window, dan Output). Als Teleporters werkt, print het niets behalve de regel van het portaal uit stap 4, dus elke waarschuwing of rode fout is het lezen waard. Zie Veelvoorkomende fouten.

Uitbreiden

Een team of party samen teleporteren

TeleportAsync accepteert een lijst spelers, dus één portaal kan een hele groep naar één place sturen. De Roblox-pagina over teleports stelt voor uit te gaan van de speler die het portaal aanraakte: player.Team en Team:GetPlayers() voor een team, of SocialService:GetPlayersByPartyId() met player.PartyId voor een party. Geef die lijst mee in plaats van { player } en zet de vlag leavingForPlace voor elke speler daaruit.

Een groep naar een eigen server sturen

Standaard komen geteleporteerde spelers op een openbare server van de andere place. Om een groep naar een nieuwe gereserveerde server te sturen, bijvoorbeeld voor een match, maak je TeleportOptions aan, zet je ShouldReserveServer daarvan op true en geef je het mee als derde argument: TeleportService:TeleportAsync(placeId, players, options). Roblox merkt op dat nieuwe pogingen vooral nuttig zijn bij storingen die specifiek met gereserveerde servers te maken hebben, en het script doet die al.

Data meenemen naar een andere place

Teleporteren wist alle lokale data van die speler. Teleport data in Roblox, ingesteld met TeleportOptions:SetTeleportData() en in de andere place gelezen met player:GetJoinData(), is zichtbaar voor de client en niet versleuteld, dus gebruik het alleen voor onschuldige keuzes, zoals welke map er geladen moet worden. Bewaar munten, Wins en items in een DataStore, zoals in de tutorial over DataStore, en laad ze opnieuw als de speler in de andere place aankomt.

Een eigen laadscherm

Terwijl een teleport naar een place laadt, zien spelers het standaard laadscherm van Roblox. Om een eigen scherm te tonen, roep je op de client TeleportService:SetTeleportGui() aan met een ScreenGui, bijvoorbeeld een die in ReplicatedStorage staat. De teleports in deze handleiding beginnen op de server, dus de client moet het vooraf aanroepen, bijvoorbeeld zodra de speler binnenkomt. Roblox zegt dat je het scherm voor elke teleport opnieuw moet instellen en dat het niet wordt gebruikt voor een place in een andere game. Er staat ook dat scripts in die ScreenGui niet draaien, dus maak hem statisch.

Teleports voor rondes en checkpoints

Het rondesysteem verplaatst aan het begin van elke ronde alle spelers naar de arena met dezelfde aanroep PivotTo, en het deel PivotTo of SpawnLocation in de handleiding over obby's vergelijkt die aanpak met de spawnpunten van Roblox. Moet een plek pas na een ronde opengaan, dan kent het rondesysteem al de Wins toe die WinsNeeded leest.

Veelvoorkomende fouten en oplossingen

Open het venster Output (menu Window, dan Output) voordat je op Play klikt. Teleporters noemt de pad als Destination nergens naartoe wijst, dus de meeste problemen zie je daar.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'

TeleportMenu wacht op een remote die Teleporters aanmaakt, dus Teleporters draait niet. Controleer of het een Script is en geen LocalScript, of het direct in ServerScriptService staat, niet is uitgeschakeld en of er geen rode fout van in Output staat. De handleiding over scriptfouten legt deze waarschuwing uitgebreid uit.

Teleporters: PadA points to PadC, which is not a part in TeleportPads

Het attribuut Destination van een pad noemt iets dat geen part is direct in de map TeleportPads. Controleer spelling en hoofdletters in de waarde van het attribuut en in de naam van de bestemmingspad. De waarschuwing verschijnt één keer per pad, wanneer een speler hem voor het eerst aanraakt.

Ik stap op een pad en er gebeurt niets

Controleer of de map precies TeleportPads heet en bij de start van de game direct in Workspace staat, of het attribuut Destination van de pad van het type String is (een attribuut van het type Number wordt genegeerd) en of er 2 seconden voorbij zijn sinds je laatste teleport. Controleer ook of CanTouch aan staat bij de pad: Roblox zegt dat Touched verbinden met een part waarbij CanTouch uit staat een fout geeft, en die stopt het script.

Ik verschijn in een muur of val van een rand

Spelers verschijnen 3 studs voor de voorkant van de bestemmingspad. Klik met de rechtermuisknop op de pad, kies Show Orientation Indicator en draai de pad tot de blauwe lijn naar vrije vloer wijst. Plekken in het menu zetten spelers boven op de part, dus houd elke plek op de vloer.

De knop Castle blijft grijs nadat ik 3 Wins heb verdiend

De lijst wordt getekend als het menu opengaat, dus sluit het menu en open het opnieuw. Is de knop nog steeds grijs, controleer dan of leaderstats een IntValue heeft die precies Wins heet en of de Wins op de server zijn veranderd, niet alleen in de modus Client.

Het portaal doet niets in de gepubliceerde game

Open de Developer Console met F9, zet de log op de weergave Server (alleen de eigenaar van de game en groepsleden met bewerkrechten zien die, omdat Teleporters een server-Script is) en lees de waarschuwingen Teleporters:; daarin staat de reden die Roblox gaf. Controleer of het attribuut PlaceId van het portaal van het type Number is en de ID uit Asset Manager bevat, en of je de place opnieuw hebt gepubliceerd nadat je het portaal hebt toegevoegd.

Maken met RoCode

Heb je geen zin om dit allemaal met de hand te bouwen, dan kan RoCode het doen in de place die je open hebt. RoCode is een onafhankelijke AI-agent voor Roblox Studio, niet van Roblox: je beschrijft een functie in zijn webchat en zijn plugin voor Studio maakt parts en scripts in je Explorer, zodat je geen code uit een chatvenster hoeft te kopiëren.

Jij typt

Voeg teleports toe: pads in Workspace.TeleportPads die spelers naar de pad uit hun attribuut Destination sturen met een cooldown van 2 seconden, een menu Teleport voor de plekken in Workspace.TeleportSpots waarbij Castle 3 Wins nodig heeft met controle op de server, en portalen in Workspace.PlacePortals die spelers naar de place met de ID uit hun attribuut PlaceId sturen, met nieuwe pogingen.

RoCode doet
  • Kan je place bekijken als een stap dat nodig heeft, met Search Game en Search Scripts, om voort te bouwen op items, remotes of opslagcode die er al zijn in plaats van een tweede systeem toe te voegen
  • Maakt de mappen en parts van de pads met Create Instance, stelt hun eigenschappen in met Set Property en schrijft Teleporters en TeleportMenu met Create Script
  • Heeft de opdracht elk script dat hij schrijft te controleren met Check Script, dat het in Studio compileert zonder het uit te voeren
  • Stuurt wijzigingen in groepen, en elke groep is een ongedaan-maakpunt in de geschiedenis van Studio

Teleports tussen places werken alleen in de gepubliceerde game, dus test die zelf in de Roblox-app. Met plugin 3.9 of nieuwer kan RoCode een korte playtest draaien en de fouten lezen, en met plugin 3.9.15 of nieuwer kan zijn testpersonage op pads stappen en op knoppen in het menu drukken, maar hij controleert alleen wat hij zelf heeft besloten te testen, dus stap zelf op de pads en open zelf het menu. Een teleporter is één systeem van de vele in een game; een hele game maken met RoCode gaat op dezelfde manier, één systeem per prompt. Hoe RoCode verbindt met Studio.

Veelgestelde vragen

Hoe maak je een teleport pad in Roblox Studio?

Geef twee parts een attribuut Destination met elkaars naam en laat één serverscript iedereen die een pad aanraakt met character:PivotTo verplaatsen naar een punt vlak voor de andere pad, met een korte cooldown per speler. Stap 1 en stap 2 bouwen precies dat.

Waarom werkt mijn teleport niet in Studio?

Pads en het menu werken in Studio. Teleports naar een andere place niet: TeleportService in Roblox ondersteunt geen playtests in Studio, dus publiceer de game en test in de Roblox-app. Het script uit deze handleiding print in plaats van te teleporteren wat het portaal zou doen, zodat je toch kunt controleren dat het afgaat.

Hoe teleporteer je spelers naar een andere place van mijn game?

Voeg een place toe via File > Publish As (Add as a new place), kopieer de place ID uit Asset Manager en roep TeleportService:TeleportAsync(placeId, { player }) aan vanuit een server-Script binnen pcall, en probeer het opnieuw als het mislukt. Stap 4 loopt dit allemaal door.

Hoe maak je een teleport-GUI?

Bouw de knoppen in een LocalScript en stuur de server alleen de naam van de plek die de speler koos. De server zoekt de naam op in een map, controleert de cooldown en elke regel voor vrijspelen en verplaatst dan het personage. Stuur nooit een positie vanaf de client: een cheater kan er een willekeurige sturen.

Waarom blijft mijn personage vastzitten of valt het uit elkaar na een teleport?

De Position van de root part instellen verplaatst alleen die part, zonder het lichaam dat eraan vastzit, en de CFrame van de pad kopiëren zet het midden van het personage in de pad. Gebruik character:PivotTo met een punt op stahoogte boven de vloer, berekend uit de HipHeight van de Humanoid.

Kun je munten of items meegeven met een teleport?

Niet veilig. Roblox zegt dat teleport data zichtbaar is voor de client en niet versleuteld, dus het is geschikt voor iets als de gekozen map, maar niet voor munten. Sla munten en items op in een DataStore en laad ze in de andere place.

Bronnen en verder lezen

Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.