Tutoriel · Systèmes de jeu

Comment faire un téléporteur sur Roblox Studio

Un téléporteur sur Roblox, c'est l'une de ces deux choses : déplacer un personnage ailleurs dans le même serveur, ou envoyer le joueur dans un autre emplacement (place) de ton jeu. Ce guide construit les deux à partir d'un seul script serveur : des pads qui t'envoient vers un pad partenaire, un menu Teleport dont les destinations verrouillées s'ouvrent avec des Wins, et des portails vers un autre emplacement qui réessaient quand la téléportation de Roblox échoue.

Mis à jour le 12 novembre 202625 min de lectureÉcrit par

En bref

Pour un pad de téléportation, mets un Script dans ServerScriptService qui écoute l'événement Touched du pad, trouve le joueur avec Players:GetPlayerFromCharacter, et déplace le personnage entier avec character:PivotTo() vers un point juste devant le pad de destination, dos à lui, avec un délai de quelques secondes par joueur pour que le pad de destination ne le renvoie pas aussitôt. Pour envoyer les joueurs dans un autre emplacement de ton jeu, appelle TeleportService:TeleportAsync(placeId, { player }) depuis un Script serveur dans un pcall ; ça ne marche que dans le jeu publié, pas dans Studio.

  • Déplace le personnage entier avec PivotTo. Régler HumanoidRootPart.Position éloigne la part racine du reste du corps, parce que Roblox met à jour les joints quand Position est réglée.
  • Un menu de téléportation doit envoyer au serveur un nom de destination, jamais une position. Le serveur vérifie le nom, le délai et toute règle de déverrouillage avant de déplacer qui que ce soit.
  • TeleportService:Teleport() est obsolète et côté client. Utilise TeleportAsync sur le serveur, entoure-le d'un pcall, réessaie, et gère TeleportInitFailed.
Sur cette page
  1. Fonctionnement
  2. 1. Pads de téléportation
  3. 2. Script de téléportation
  4. 3. Menu de téléportation
  5. 4. Autres emplacements
  6. Anciens tutoriels
  7. Limites face aux exploits
  8. 5. Tester
  9. Aller plus loin
  10. Problèmes courants
  11. Avec RoCode
  12. Questions fréquentes
  13. Sources et lectures

Deux types de téléportation

Illustration animéeToucher PadA te place juste devant PadB, donc PadB ne te renvoie pas aussitôt, et le serveur refuse Castle, verrouillé, mais te déplace vers Lake.

Un téléporteur peut vouloir dire trois choses dans un jeu Roblox : un pad qui t'envoie à l'autre bout de la carte, un menu de destinations où sauter, ou un portail vers un autre niveau. Les deux premiers déplacent un personnage à l'intérieur du serveur où le joueur se trouve déjà. Le troisième envoie le joueur dans un autre emplacement de ton jeu, qui tourne sur ses propres serveurs. Ils utilisent des API différentes, donc il est utile de savoir lequel il te faut.

Les deux types de téléportation
Dans le même serveurVers un autre emplacement de ton jeu
L'appelcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Sert àDes pads de téléportation, un menu de téléportation, déplacer les joueurs du lobby vers une arèneDes portails vers un autre niveau, un lobby qui envoie les joueurs dans un donjon ou un emplacement de match séparé
Tourne dansUn Script serveurUn Script serveur uniquement. Le Teleport() côté client est obsolète.
Marche dans un test StudioOuiNon. Le TeleportService de Roblox ne prend pas en charge les tests dans Studio, donc tu le testes dans le jeu publié.
Ce que voit le joueurUn saut à travers la carte, qui peut prendre jusqu'à 2 secondes si cette zone doit d'abord chargerL'écran de chargement de Roblox, puis l'autre emplacement
Pièces, objets et autres donnéesRestent tels quelsRoblox abandonne les données locales du joueur, donc tout ce qui compte doit venir d'un DataStore dans l'autre emplacement

Ce guide construit les trois types dans un seul Script serveur, donc un seul jeu de règles couvre toutes les téléportations de ton jeu : le serveur décide, chaque joueur a son propre délai, et l'appareil du joueur ne fait jamais que dire quelle destination il aimerait.

Les éléments du téléporteur
ÉlémentOù il se trouveCe qu'il fait
Le Folder TeleportPads avec PadA et PadBWorkspaceDeux pads. L'attribut Destination de chaque pad nomme le pad vers lequel il envoie les joueurs.
Le Folder TeleportSpotsWorkspaceUne part pour chaque destination que liste le menu. Un attribut WinsNeeded verrouille une destination.
Le Folder PlacePortalsWorkspaceLes parts des portails. L'attribut PlaceId de chaque portail est l'emplacement vers lequel il envoie les joueurs.
Le Script TeleportersServerScriptServiceGère les trois types de téléportation et crée les deux remotes. Le seul endroit où une téléportation peut avoir lieu.
Le LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsDessine le bouton Teleport et la liste des destinations, et envoie le nom de celle que le joueur choisit.
La RemoteFunction GetTeleportSpots et le RemoteEvent TeleportRequestReplicatedStorage (Teleporters les crée)La première renvoie la liste des destinations au menu. Le second transporte le nom choisi vers le serveur.
L'Explorer une fois le téléporteur terminé. Teleporters ajoute GetTeleportSpots et TeleportRequest dans ReplicatedStorage quand le jeu tourne.
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

Étape 1 : construire deux pads de téléportation

  1. Dans l'Explorer, survole Workspace, clique sur le bouton + et insère un Folder. Nomme-le TeleportPads. Le script cherche ce nom exact.
  2. Insère deux Parts dans le dossier et nomme-les PadA et PadB. Fais de chacune une dalle plate, par exemple 6 par 1 par 6 studs, et pose-les au sol à une certaine distance l'une de l'autre. Dans la fenêtre Properties, coche Anchored, laisse CanCollide et CanTouch activés, et donne-leur une couleur vive et le matériau Neon pour que les joueurs les repèrent.
  3. Sélectionne PadA, fais défiler jusqu'à la section Attributes de la fenêtre Properties et clique sur +. Saisis le nom Destination, choisis le type String et clique sur Save, puis règle sa valeur sur PadB. Fais pareil sur PadB avec la valeur PadA.
  4. Tourne chaque pad pour que sa face avant pointe vers du sol dégagé. Les joueurs arrivent 3 studs devant la face avant du pad de destination, dos à lui, donc laisse quelques studs de sol dégagé à cet endroit. Pour voir quelle face est l'avant, fais un clic droit sur le pad et choisis Show Orientation Indicator : une ligne bleue marque la face avant. Tourne le pad avec l'outil Rotate jusqu'à ce que cette ligne pointe là où les joueurs doivent repartir.

Les joueurs atterrissent à côté du pad, pas dessus, et c'est voulu. La page de Roblox sur le debounce note que Touched se déclenche plusieurs fois de suite très vite pour un seul contact, donc un joueur arrivé sur l'autre pad le redéclencherait dès la fin de son délai, et repartirait à l'autre bout de la carte.

Tu n'es pas limité à deux pads. La Destination d'un pad peut nommer n'importe quelle part de TeleportPads, donc trois pads peuvent faire tourner les joueurs en boucle. Pour un pad à sens unique, fais-le pointer vers une part de TeleportPads qui n'a pas de Destination à elle : cette part reçoit les joueurs et n'envoie personne nulle part.

Étape 2 : ajouter le script de téléportation

Survole ServerScriptService, insère un Script, nomme-le Teleporters et colle le code ci-dessous. Il gère les pads dès maintenant, et le menu et les portails des étapes suivantes, donc tu ne l'ajoutes qu'une fois. Les réglages du haut sont les lignes que tu es censé changer.

Script dans ServerScriptService nommé Teleporters
-- Script dans ServerScriptService nommé Teleporters.
-- Chaque téléportation est décidée ici, sur le serveur :
--   1. Pads : toucher une part de Workspace.TeleportPads t'emmène à la part nommée
--      dans son attribut Destination.
--   2. Un menu : le LocalScript TeleportMenu demande une destination de Workspace.TeleportSpots
--      par son nom. Le serveur vérifie le nom, le délai et les Wins que la destination demande.
--   3. Portails : toucher une part de Workspace.PlacePortals t'envoie vers l'emplacement
--      de son attribut PlaceId (un autre emplacement de ce jeu).

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 -- les pads ignorent un joueur pendant ce temps après une téléportation
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs devant un pad de destination, pour que les joueurs atterrissent à côté
local PLACE_ATTEMPTS = 3

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

-- Ce script crée lui-même les deux remotes, donc ne les ajoute pas à la main
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

-- À quelle hauteur au-dessus du sol se trouve la part racine d'un personnage debout.
-- La formule vient de la référence Humanoid.HipHeight de Roblox (les rigs R6 ajoutent la hauteur de la jambe).
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() -- réglé avant d'attendre, pour qu'un deuxième contact ne puisse pas lancer une deuxième téléportation

	-- Regarde dans le sens où pointe la face avant de la destination (à plat, jamais incliné)
	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
	-- Debout sur sa face du dessus : le pivot d'un personnage est sa part racine, donc lève-le à hauteur debout.
	-- Un pad place plutôt les joueurs quelques studs devant lui, parce qu'un joueur debout
	-- sur un pad le redéclencherait au pas suivant.
	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)

	-- Avec le streaming d'instances activé, charge d'abord la zone autour de la destination (jusqu'à 2 secondes)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- parti, réapparu ou mort pendant le chargement de la zone
	end
	-- Un personnage assis est soudé à son siège, et le déplacer emmènerait le siège avec lui.
	-- Détruire la SeatWeld fait d'abord sortir le personnage du siège.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Relance le délai à l'arrivée : le préchargement ci-dessus peut prendre jusqu'à 2 secondes,
	-- et le pad où il atterrit ne doit pas le renvoyer aussitôt
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- pour un script de vérification de vitesse, si tu en as un
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 -- avertit une fois, pas à chaque contact
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Le menu : la liste des destinations, puis une demande par nom
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 -- mêmes Wins : ordre alphabétique, pour que l'ordre ne change jamais
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- Le client n'envoie qu'un nom. N'accepte jamais une position ou un CFrame venant d'un 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 -- verrouillé pour ce joueur
	end
	teleportTo(player, spot, false)
end)

-- 3. Portails vers un autre emplacement de ce jeu
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- déjà en route, ou a touché un téléporteur il y a un instant
	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 -- abandonne ; toucher le portail de nouveau relance un essai
end

-- Une téléportation peut aussi échouer après avoir démarré. Le joueur reste ici et peut réessayer.
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 crée lui-même la RemoteFunction GetTeleportSpots et le RemoteEvent TeleportRequest, donc il n'y a rien à insérer à la main dans ReplicatedStorage. Il connecte les pads de TeleportPads et les portails de PlacePortals une seule fois, au démarrage du serveur, donc les pads et les portails ajoutés pendant que le jeu tourne ne font rien. Un dossier manquant désactive simplement ce type de téléportation.

Ce que fait chaque partie de Teleporters
PartieCe qu'elle faitPourquoi
playerFromHitTrouve le modèle de personnage auquel appartient la part qui touche et demande à Players:GetPlayerFromCharacter à qui il est.Un pad est touché par des pieds, des chapeaux et des parts qui traînent. Tout ce qui ne fait pas partie du personnage d'un joueur donne nil et est ignoré.
onCooldownCompare os.clock() avec l'heure de la dernière téléportation du joueur.Un délai par joueur, donc un joueur debout près d'un pad ne bloque jamais personne d'autre. Rien n'attend ni ne dort.
rootHeightCalcule à quelle hauteur au-dessus du sol se trouve la part racine d'un personnage debout : la moitié de la hauteur de la part racine plus le HipHeight du Humanoid, plus la longueur de la jambe sur les rigs R6.C'est la formule de la référence Humanoid.HipHeight de Roblox. Le pivot d'un personnage est sa part racine, donc lever le pivot d'autant pose les pieds sur la surface, pour les petits avatars, les grands et les R6.
Les vérifications en haut de teleportToFait un return sauf si le joueur a un personnage en vie avec une part racine, puis enregistre l'heure tout de suite.La demande de streaming plus bas peut faire attendre le script. Enregistrer l'heure d'abord fait que les nombreux événements Touched de ce moment ne peuvent pas lancer une deuxième téléportation.
Le point d'arrivéeLa face du dessus de la destination, relevée de rootHeight, orientée dans le sens où pointe sa face avant, sans aucune inclinaison. Pour un pad, il avance aussi de 3 studs au-delà de la face avant du pad.Le personnage arrive debout, pas à l'intérieur de la part de destination. À côté d'un pad, ses pieds partent au niveau de la face du dessus du pad, donc il descend de l'épaisseur du pad jusqu'au sol. CFrame.lookAlong construit un CFrame à une position, tourné dans une direction.
RequestStreamAroundAsyncDemande à Roblox d'envoyer d'abord à ce joueur la zone autour du point d'arrivée, en attendant 2 secondes au maximum.Le streaming d'instances est activé par défaut pour les nouveaux emplacements, donc une partie éloignée de la carte n'est peut-être pas encore chargée sur l'appareil du joueur. Roblox recommande cet appel serveur avant de déplacer un personnage loin, même s'il ne garantit pas ce qui arrive.
La deuxième vérificationSi le joueur est parti, ou si le personnage est réapparu ou mort pendant l'attente, rien ne bouge.Le joueur a pu se réinitialiser ou quitter le jeu pendant que la zone chargeait. L'exemple de préchargement de Roblox vérifie lui aussi que le personnage est toujours dans le jeu avant de le déplacer.
Les lignes SeatWeldSi le personnage est assis, détruit la soudure qui le tient au siège.Roblox soude un personnage assis à son siège. PivotTo déplace les parts en changeant leur CFrame, et la référence de Roblox dit que régler le CFrame d'une part déplace aussi les parts qui lui sont reliées, donc sans ça le siège, et tout ce qui y est soudé, arriverait avec le joueur. Détruire SeatWeld est la façon dont la référence Seat de Roblox fait sortir un personnage d'un siège par script.
character:PivotTo(target)Déplace le personnage entier, tous les membres et accessoires ensemble, vers le point d'arrivée.Roblox présente PivotTo comme la fonction principale pour déplacer des modèles par script.
La deuxième ligne lastTeleportRelance le délai à l'arrivée.La demande de streaming peut prendre jusqu'à 2 secondes, autant que le délai des pads lui-même, donc sans cette ligne un joueur pourrait arriver sans aucun délai restant.
MovementCheckSkipRègle un attribut sur le Player après chaque déplacement.Une vérification de vitesse côté serveur prendrait le saut pour de la triche. Le MovementCheck du guide du sprint lit cet attribut et recommence à mesurer depuis la nouvelle position. Sans un tel script, l'attribut ne fait rien.
Les réglages en haut de Teleporters
RéglageValeur iciCe qu'il change
PAD_COOLDOWN_SECONDS2Le temps pendant lequel les pads et les portails ignorent un joueur après une téléportation.
MENU_COOLDOWN_SECONDS3L'écart minimum entre deux téléportations par le menu pour un joueur. Les pads et le menu partagent une seule horloge par joueur, donc une demande du menu dans les 3 secondes qui suivent une téléportation par pad est ignorée aussi.
PAD_ARRIVAL_GAP3À combien de studs au-delà de la face avant d'un pad de destination les joueurs arrivent, pour atterrir à côté du pad et non dessus.
PLACE_ATTEMPTS3Combien de fois un portail essaie TeleportAsync, à 2 secondes d'intervalle, avant d'abandonner.

Appuie sur Play maintenant et marche sur PadA : tu apparais devant PadB. Le menu et les portails demandent les deux étapes suivantes, mais le script tourne déjà sans eux.

Étape 4 : téléporter vers un autre emplacement

Un emplacement (place) est un monde séparé à l'intérieur de ton jeu, avec ses propres serveurs : un lobby et un donjon, ou un hub et une série de niveaux. Les joueurs passent d'un emplacement à l'autre avec TeleportService, et Roblox ne le fait tourner que dans le jeu publié, donc cette étape se termine dans l'application Roblox plutôt que dans Studio.

  1. Si le jeu n'est pas encore publié, choisis File > Publish. Les nouveaux jeux ne sont ouverts qu'à toi, aux personnes à qui tu donnes l'accès Edit et aux membres du groupe qui ont les bons rôles tant que tu ne les as pas rendus publics, ce qui suffit pour tester les téléportations toi-même.
  2. Crée le deuxième emplacement : ouvre un nouveau place à partir de n'importe quel modèle de Studio, construis ton donjon, puis choisis File > Publish As, clique sur la vignette de ton jeu, sélectionne Add as a new place et clique sur Create.
  3. Copie l'ID du nouvel emplacement. Ouvre l'Asset Manager depuis le menu Window ou l'onglet Home, va dans Places In Experience, fais un clic droit sur l'emplacement et choisis Copy Asset ID, qui copie son place ID.
  4. De retour dans ton premier emplacement, insère un Folder nommé PlacePortals dans Workspace, et dedans une Part ancrée nommée DungeonPortal. Ajoute un attribut Number nommé PlaceId et colle l'ID comme valeur.
  5. Appuie sur Play et touche le portail. Output affiche une ligne qui commence par Teleporters: would send : c'est tout ce que fait un portail dans Studio.
  6. Publie de nouveau avec File > Publish, pour que le jeu publié ait le portail, et teste-le depuis l'application Roblox comme à l'étape 5.

Teleporters appelle TeleportAsync dans un pcall, jusqu'à 3 fois avec 2 secondes entre les essais, parce que la page de Roblox sur la téléportation dit que les téléportations peuvent échouer et lever une erreur, et recommande de réessayer. Une téléportation peut aussi démarrer puis échouer au dernier moment sans erreur, en laissant le joueur où il était. Roblox déclenche TeleportInitFailed dans ce cas, et le script efface l'indicateur de départ du joueur, donc toucher le portail de nouveau relance un essai.

Pour ramener les joueurs, fais pareil dans l'autre emplacement : mets une copie de Teleporters dans son ServerScriptService et ajoute un portail dont le PlaceId est l'ID de ton premier emplacement, copié depuis l'Asset Manager de la même façon.

Qui peut rejoindre tes autres emplacements

La documentation de sécurité de Roblox prévient qu'une fois qu'un client est dans un emplacement de ton jeu, il peut se téléporter vers n'importe quel autre emplacement du jeu, quel que soit le chemin que tu avais prévu, et que désactiver le Direct Access d'un emplacement ne fait que retirer le bouton Join du site. Le réglage qui change ça est Access Control for Places, sous Audience > Access Settings dans le Creator Dashboard :

Les trois réglages d'Access Control for Places
RéglageQui peut rejoindre un emplacement qui n'est pas celui de départ
Fully openN'importe qui, par des téléportations depuis n'importe quel jeu, des liens directs, des invitations et en rejoignant un ami.
Limited to same universeSeulement les joueurs qui se téléportent depuis tes jeux. Les téléportations client et serveur sont autorisées toutes les deux.
Secure within universe onlySeulement les joueurs que tes scripts serveur téléportent depuis ce jeu.

Si les joueurs ne doivent atteindre un emplacement que par ton portail, un donjon par exemple, choisis Secure within universe only. Chaque téléportation de ce guide part du serveur, donc elle continue de marcher. Roblox dit aussi que beaucoup de jeux n'ont pas besoin de téléportations sécurisées, donc un jeu dont tous les emplacements sont ouverts à tout le monde peut laisser le réglage tel quel.

Les erreurs des anciens tutoriels de téléporteur

Si tu compares ce guide avec une vidéo ou un message de forum, voici les différences qui comptent, avec la raison pour laquelle chaque méthode pose problème.

Méthodes courantes des tutoriels de téléporteur, et ce que ce guide fait à la place
Le tutorielLe problèmeCe guide
Règle hit.Parent.HumanoidRootPart.Position = target.PositionLa référence de Roblox dit que régler Position met à jour les joints de la part, si bien qu'elle bouge par rapport aux parts auxquelles elle est reliée : la part racine bouge sans le corps.Déplace le personnage entier avec PivotTo.
Règle HumanoidRootPart.CFrame = target.CFrameLe milieu du personnage atterrit au milieu de la part cible, en partie dedans, et prend l'inclinaison de la part.Arrive à hauteur debout au-dessus de la face du dessus, à côté d'un pad, bien à plat.
Utilise une seule variable debounce pour tout le padPendant qu'un joueur se téléporte, le pad ignore tous les autres. Sans aucun debounce, un joueur qui atterrit sur l'autre pad est renvoyé aussitôt.Un délai par joueur, enregistré avant toute attente, et les joueurs atterrissent à côté du pad.
Appelle TeleportService:Teleport(placeId, player) depuis un LocalScriptRoblox marque Teleport() comme obsolète, dit de ne pas l'utiliser pour du nouveau travail, et n'autorise TeleportAsync que depuis des scripts serveur.Appelle TeleportAsync dans le script serveur.
Pas de pcall, pas de nouvel essaiLa page de Roblox sur la téléportation dit que les téléportations peuvent échouer et lever une erreur, et peuvent aussi échouer après avoir démarré.Jusqu'à 3 essais dans un pcall, et TeleportInitFailed permet au joueur de réessayer.
Abandonne parce que "ça ne marche pas" dans StudioTeleportService ne prend pas en charge les tests dans Studio.RunService:IsStudio() affiche à la place ce que le portail aurait fait.
Une interface de téléportation dont les boutons envoient une positionUn tricheur peut déclencher le même remote avec n'importe quelle position.Les boutons envoient un nom de destination, et le serveur le cherche.
Des pièces transmises dans les données de téléportationRoblox dit que les données de téléportation sont visibles par le client et non chiffrées.Te dit de garder les pièces et les Wins dans un DataStore et de les charger dans l'autre emplacement (vois Emporter des données dans l'autre emplacement).

Ce que les joueurs peuvent falsifier et ce qu'ils ne peuvent pas

Pars du principe qu'un tricheur contrôle tout sur son propre appareil : il peut modifier TeleportMenu, déclencher les deux remotes aussi souvent qu'il veut avec n'importe quels arguments, et déplacer son propre personnage. Voici ce que ça lui rapporte avec ce téléporteur.

Ce qu'un tricheur peut tenter, et ce que Teleporters fait contre ça
Un tricheur essaie deRésultatPourquoi
Envoyer une position ou un CFrame par le remote du menuIgnoréTeleportRequest lit une seule chaîne, un nom de destination de 50 caractères au plus. Tout le reste est jeté.
Demander Castle sans 3 WinsRefuséLe serveur lit les Wins dans sa propre copie de leaderstats. Le bouton gris n'est qu'une indication.
Demander une destination qui n'existe pasIgnoréLe serveur cherche le nom dans TeleportSpots et ne fait rien si aucune part ne porte ce nom.
Déclencher le remote du menu encore et encoreAu plus une téléportation par le menu toutes les 3 secondesLe délai est gardé sur le serveur, par joueur.
Déclencher un pad sans marcher jusqu'à luiIl atteint le pad partenaire, où il pouvait aller à pied de toute façonRoblox cite la téléportation vers n'importe quelle position et la manipulation des événements Touched parmi ce qu'un client peut faire avec son propre personnage.
Rejoindre directement un autre emplacement de ton jeuPossible sauf si Access Control for Places est sur Secure within universe onlyVois Qui peut rejoindre tes autres emplacements.
Déplacer son propre personnage n'importe où, y compris sur une destination verrouilléePossibleChaque appareil contrôle les déplacements de son propre personnage. Une destination verrouillée est une commodité, pas un coffre-fort, donc vérifie sur le serveur avant d'y donner quoi que ce soit de valeur.

La dernière ligne est la limite honnête de n'importe quel téléporteur. Pour un jeu compétitif, ajoute une vérification des déplacements côté serveur comme celle du guide du sprint. Teleporters règle déjà l'attribut MovementCheckSkip que lit cette vérification, donc ses propres téléportations ne sont pas signalées : la documentation de sécurité de Roblox dit que les jeux avec des téléportations légitimes ont besoin exactement de ce genre d'exception dans leurs vérifications de déplacement.

Étape 5 : tester

  1. Appuie sur Play. Marche sur PadA : tu apparais juste devant PadB, dos à lui. Fais demi-tour et remonte tout de suite sur PadB : rien ne se passe, parce que les pads t'ignorent pendant 2 secondes après ton arrivée. Descends, attends 2 secondes et remonte sur PadB : tu apparais devant PadA.
  2. Attends quelques secondes, puis clique sur Teleport à gauche de l'écran. La liste affiche Lake, Spawn et "Castle (needs 3 wins)" en gris. Choisis Lake : tu apparais dessus. Rouvre le menu et choisis Castle : rien ne se passe, et Output reste silencieux.
  3. Donne-toi 3 Wins (il faut un script leaderstats avec une IntValue Wins, comme celui du guide du leaderboard). Clique sur le bouton Client/Server pour passer en Server, trouve Players, ton nom, leaderstats, Wins dans l'Explorer et règle sa Value sur 3 dans la fenêtre Properties. Repasse en Client et rouvre le menu : Castle est violet et t'y emmène.
  4. Touche DungeonPortal. Output affiche une ligne qui commence par Teleporters: would send avec ton nom et le place ID. C'est normal dans Studio, et elle s'affiche au plus une fois toutes les 2 secondes, quel que soit le temps que tu passes sur le portail.
  5. Choisis Server & Clients dans le menu déroulant du mode de test, règle 2 clients et appuie sur Play. Les deux joueurs peuvent utiliser les pads en même temps, et le délai d'un joueur ne bloque jamais l'autre.
  6. Arrête le test, publie, et joue au jeu depuis l'application Roblox. Touche le portail : l'écran de chargement de Roblox apparaît et tu arrives dans l'autre emplacement. Si tu restes où tu es, ouvre la Developer Console avec F9, passe son journal sur la vue Server, que seuls le propriétaire du jeu et les membres du groupe avec la permission de modifier peuvent voir, et cherche les avertissements Teleporters:, qui contiennent la raison donnée par Roblox.

Garde la fenêtre Output ouverte (menu Window, puis Output) pendant les étapes dans Studio. Teleporters n'affiche rien quand il marche, à part la ligne du portail du point 4, donc tout avertissement ou toute erreur rouge mérite d'être lu. Vois les problèmes courants.

Aller plus loin

Téléporter une équipe ou un groupe ensemble

TeleportAsync prend une liste de joueurs, donc un portail peut envoyer tout un groupe dans le même emplacement. La page de Roblox sur la téléportation conseille de partir du joueur qui a touché le portail : player.Team et Team:GetPlayers() pour une équipe, ou SocialService:GetPlayersByPartyId() avec player.PartyId pour un groupe (party). Passe cette liste à la place de { player }, et règle l'indicateur leavingForPlace pour chaque joueur qu'elle contient.

Envoyer un groupe sur son propre serveur

Par défaut, les joueurs téléportés rejoignent un serveur public de l'autre emplacement. Pour envoyer un groupe sur un nouveau serveur réservé, par exemple pour un match, crée un TeleportOptions, règle son ShouldReserveServer sur true et passe-le en troisième argument : TeleportService:TeleportAsync(placeId, players, options). Roblox note que les échecs liés aux serveurs réservés en particulier gagnent à être réessayés, ce que le script fait déjà.

Emporter des données dans l'autre emplacement

La téléportation abandonne toutes les données locales de ce joueur. Les données de téléportation de Roblox, réglées avec TeleportOptions:SetTeleportData() et lues dans l'autre emplacement avec player:GetJoinData(), sont visibles par le client et non chiffrées, donc ne t'en sers que pour des choix sans danger comme la carte à charger. Garde les pièces, les Wins et les objets dans un DataStore, comme dans le tutoriel DataStore, et recharge-les quand le joueur arrive dans l'autre emplacement.

Un écran de chargement personnalisé

Pendant le chargement d'une téléportation vers un autre emplacement, les joueurs voient l'écran de chargement standard de Roblox. Pour afficher le tien, appelle TeleportService:SetTeleportGui() sur le client avec un ScreenGui, par exemple un ScreenGui rangé dans ReplicatedStorage. Les téléportations de ce guide partent du serveur, donc le client doit l'appeler à l'avance, par exemple dès que le joueur arrive. Roblox dit que l'écran doit être réglé de nouveau avant chaque téléportation et qu'il n'est pas utilisé pour un emplacement d'un autre jeu. Il note aussi que les scripts à l'intérieur de ce ScreenGui ne tournent pas, donc conçois-le comme un écran fixe.

Téléportations de manche et checkpoints

Le système de manches déplace chaque joueur dans l'arène avec le même genre d'appel PivotTo au début de chaque manche, et PivotTo ou SpawnLocations (en anglais) dans le guide de l'obby compare cette méthode avec les points d'apparition de Roblox. Si une destination ne doit s'ouvrir qu'après une manche, le système de manches donne déjà les Wins que lit WinsNeeded.

Problèmes courants

Ouvre la fenêtre Output (menu Window, puis Output) avant d'appuyer sur Play. Teleporters nomme le pad quand une Destination ne pointe nulle part, donc la plupart des problèmes s'y voient.

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

TeleportMenu attend le remote que crée Teleporters, donc Teleporters ne tourne pas. Vérifie que c'est un Script, pas un LocalScript, directement dans ServerScriptService, qu'il n'est pas désactivé, et qu'Output n'affiche aucune erreur rouge venant de lui. Le guide des erreurs de script explique cet avertissement en détail.

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

L'attribut Destination du pad nomme quelque chose qui n'est pas une part placée directement dans le dossier TeleportPads. Vérifie l'orthographe et les majuscules de la valeur de l'attribut et du nom du pad de destination. L'avertissement apparaît une fois par pad, la première fois qu'un joueur le touche.

Marcher sur un pad ne fait rien

Vérifie que le dossier s'appelle exactement TeleportPads et se trouve directement dans Workspace au démarrage du jeu, que l'attribut Destination du pad est un String (un attribut Number est ignoré), et que tu as attendu 2 secondes depuis ta dernière téléportation. Vérifie aussi que CanTouch est activé sur le pad : Roblox dit que connecter Touched à une part dont CanTouch est désactivé lève une erreur, ce qui arrête le script.

J'atterris dans un mur ou je tombe du bord

Les joueurs arrivent 3 studs devant la face avant du pad de destination. Fais un clic droit sur le pad, choisis Show Orientation Indicator, et tourne le pad jusqu'à ce que la ligne bleue pointe vers du sol dégagé. Les destinations du menu placent les joueurs sur le dessus de la part, donc garde chaque destination sur un sol.

Le bouton Castle reste gris après avoir gagné 3 Wins

La liste est dessinée à l'ouverture du menu, donc ferme le menu et rouvre-le. S'il est toujours gris, vérifie que leaderstats a une IntValue nommée exactement Wins, et que les Wins ont changé sur le serveur, pas seulement en mode Client.

Le portail ne fait rien dans le jeu publié

Ouvre la Developer Console avec F9, passe son journal sur la vue Server (seuls le propriétaire du jeu et les membres du groupe avec la permission de modifier la voient, parce que Teleporters est un Script serveur) et lis les avertissements Teleporters:, qui contiennent la raison donnée par Roblox. Vérifie que l'attribut PlaceId du portail est un Number qui contient l'ID de l'Asset Manager, et que tu as publié l'emplacement de nouveau après avoir ajouté le portail.

Le faire avec RoCode

Si tu préfères ne pas brancher tout ça à la main, RoCode peut le construire dans le jeu que tu as ouvert. RoCode est un agent IA indépendant pour Roblox Studio, qui n'est pas fait par Roblox : tu décris la fonctionnalité dans son chat web, et son plugin pour Studio crée les parts et les scripts dans ton Explorer, donc tu ne copies pas de code depuis une fenêtre de chat.

Tu écris

Ajoute des téléporteurs : des pads dans Workspace.TeleportPads qui envoient les joueurs vers le pad nommé dans leur attribut Destination avec un délai de 2 secondes, un menu Teleport pour les destinations de Workspace.TeleportSpots où Castle demande 3 Wins, vérifiés sur le serveur, et des portails dans Workspace.PlacePortals qui envoient les joueurs vers le place ID de leur attribut PlaceId avec de nouveaux essais.

RoCode fait
  • Peut parcourir ton jeu quand une étape le demande, avec Search Game et Search Scripts, pour s'appuyer sur les objets, les remotes ou le code de sauvegarde que tu as déjà au lieu d'ajouter un deuxième système
  • Crée les dossiers et les parts des pads avec Create Instance et règle leurs propriétés avec Set Property, et écrit Teleporters et TeleportMenu avec Create Script
  • A pour consigne de vérifier la compilation de chaque script qu'il écrit avec Check Script, qui le compile dans Studio sans le lancer
  • Envoie ses changements par lots, et chaque lot est un point d'annulation dans l'historique de Studio

Les téléportations vers un autre emplacement ne tournent que dans le jeu publié, donc teste-les toi-même dans l'application Roblox. Avec le plugin 3.9 ou plus récent, RoCode peut lancer un court test et lire les erreurs, et avec le plugin 3.9.15 ou plus récent son personnage de test peut marcher sur les pads et cliquer sur les boutons du menu, mais il ne vérifie que ce qu'il a choisi de tester, donc marche sur les pads et ouvre le menu toi-même. Un téléporteur est un système parmi d'autres dans un jeu ; construire un jeu entier avec RoCode se fait comme ça, un système par prompt. Comment RoCode se connecte à Studio.

Questions fréquentes

Comment faire un pad de téléportation sur Roblox Studio ?

Donne à deux parts un attribut Destination où chacune nomme l'autre, puis laisse un seul script serveur déplacer quiconque touche un pad avec character:PivotTo vers un point juste devant l'autre pad, avec un court délai par joueur. L'étape 1 et l'étape 2 construisent exactement ça.

Pourquoi mon téléporteur ne marche pas dans Studio ?

Les pads et les menus marchent dans Studio. Les téléportations vers un autre emplacement, non : le TeleportService de Roblox ne prend pas en charge les tests dans Studio, donc publie le jeu et teste dans l'application Roblox. Le script de ce guide affiche à la place ce qu'un portail aurait fait, donc tu peux quand même vérifier qu'il se déclenche.

Comment téléporter les joueurs vers un autre place de mon jeu ?

Ajoute l'emplacement avec File > Publish As (Add as a new place), copie son place ID depuis l'Asset Manager, et appelle TeleportService:TeleportAsync(placeId, { player }) depuis un Script serveur dans un pcall, en réessayant si ça échoue. L'étape 4 le détaille.

Comment faire une interface (GUI) de téléportation ?

Construis les boutons dans un LocalScript et n'envoie au serveur que le nom de la destination choisie par le joueur. Le serveur cherche le nom dans un dossier, vérifie le délai et toute règle de déverrouillage, puis déplace le personnage. N'envoie jamais une position depuis le client : un tricheur peut envoyer la position qu'il veut.

Pourquoi mon personnage reste coincé ou se disloque après une téléportation ?

Régler la Position de la part racine ne déplace que cette part, pas le corps qui lui est relié, et copier le CFrame d'un pad place le milieu du personnage à l'intérieur du pad. Utilise character:PivotTo avec un point à hauteur debout au-dessus du sol, calculé à partir du HipHeight du Humanoid.

Peut-on envoyer des pièces ou des objets avec une téléportation ?

Pas de façon sûre. Roblox dit que les données de téléportation sont visibles par le client et non chiffrées, donc elles conviennent pour quelque chose comme une carte choisie, pas pour des pièces. Sauvegarde les pièces et les objets dans un DataStore et charge-les dans l'autre emplacement.

Sources et lectures

Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 12 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.

Essaie RoCode sur ton propre jeu.

Des crédits gratuits chaque jour, sans carte. Installe le plugin, décris la fonctionnalité et vérifie ce qui arrive dans Studio.