Tutorial · Sistemi di gioco

Come fare un teletrasporto in Roblox Studio

Un teletrasporto in Roblox è una di due cose: spostare il personaggio in un altro punto dello stesso server oppure mandare il giocatore in un altro place del tuo gioco. In questa guida costruiamo entrambe le versioni con un solo script server: pad che ti mandano al pad gemello, un menu Teleport in cui i punti bloccati si sbloccano con le Wins e portali verso un altro place che riprovano quando il teletrasporto di Roblox fallisce.

Aggiornato il 20 novembre 202624 min di letturaScritto da

In breve

Per un pad di teletrasporto metti uno Script in ServerScriptService che ascolta l'evento Touched del pad, trova il giocatore con Players:GetPlayerFromCharacter e sposta l'intero personaggio con character:PivotTo() in un punto subito davanti al pad di destinazione, di spalle a esso, con un cooldown di un paio di secondi per giocatore, così il pad di destinazione non lo rimanda subito indietro. Per mandare i giocatori in un altro place del tuo gioco, chiama TeleportService:TeleportAsync(placeId, { player }) da uno Script server dentro un pcall; funziona solo nel gioco pubblicato, non in Studio.

  • Sposta l'intero personaggio con PivotTo. Assegnare HumanoidRootPart.Position stacca la parte radice dal resto del corpo, perché quando imposti Position Roblox aggiorna le giunzioni.
  • Il menu di teletrasporto deve inviare al server il nome della destinazione, non una posizione. Il server controlla il nome, il cooldown e ogni regola di sblocco prima di spostare qualcuno.
  • TeleportService:Teleport() è deprecato e funziona sul client. Usa TeleportAsync sul server, avvolgilo in un pcall, riprova e gestisci TeleportInitFailed.
In questa pagina
  1. Come funziona
  2. 1. Pad
  3. 2. Script di teletrasporto
  4. 3. Menu di teletrasporto
  5. 4. Altri place
  6. Vecchi tutorial
  7. Limiti della protezione
  8. 5. Prova
  9. Estensioni
  10. Common errors
  11. Con RoCode
  12. Domande frequenti
  13. Fonti e letture

Due tipi di teletrasporto

IllustrazioneToccare PadA ti mette subito davanti a PadB, così PadB non ti rimanda indietro, e il server rifiuta il punto bloccato Castle ma ti porta a Lake.

In un gioco Roblox un teletrasporto può voler dire tre cose: un pad che ti porta dall'altra parte della mappa, un menu di punti in cui saltare o un portale verso un altro livello. I primi due spostano il personaggio dentro il server in cui il giocatore si trova già. Il terzo manda il giocatore in un altro place del tuo gioco, che gira su server propri. Usano API diverse, quindi conviene sapere quale ti serve.

Due tipi di teletrasporto
Dentro lo stesso serverIn un altro place del tuo gioco
Chiamatacharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
A cosa servePad di teletrasporto, menu di teletrasporto, spostare i giocatori dalla lobby all'arenaPortali verso un altro livello, una lobby che manda i giocatori in un place separato con un dungeon o una partita
Dove giraScript serverSolo Script server. Il Teleport() lato client è deprecato.
Funziona nel playtest di StudioSìNo. In Roblox TeleportService non supporta il playtest in Studio, quindi si prova nel gioco pubblicato.
Cosa vede il giocatoreUn salto attraverso la mappa, che può richiedere fino a 2 secondi se quell'area deve prima caricarsiLa schermata di caricamento di Roblox, poi l'altro place
Monete, oggetti e altri datiRestano come sonoRoblox azzera i dati locali del giocatore, quindi tutto ciò che conta deve arrivare da un archivio dati nell'altro place

In questa guida tutti e tre i tipi stanno in un solo Script server, così un unico insieme di regole copre ogni teletrasporto del tuo gioco: decide il server, ogni giocatore ha il suo cooldown e il dispositivo del giocatore dice soltanto in quale punto vorrebbe andare.

Di cosa è fatto il teletrasporto
ElementoDove si trovaCosa fa
Folder TeleportPads con PadA e PadBWorkspaceDue pad. L'attributo Destination di ciascuno indica il pad a cui manda i giocatori.
Folder TeleportSpotsWorkspaceUna parte per ogni punto della lista del menu. L'attributo WinsNeeded blocca un punto.
Folder PlacePortalsWorkspaceParti portale. L'attributo PlaceId di ogni portale è il place in cui manda i giocatori.
Script TeleportersServerScriptServiceGestisce tutti e tre i tipi di teletrasporto e crea i due remote. L'unico posto in cui può avvenire un teletrasporto.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsDisegna il pulsante Teleport e la lista dei punti e invia il nome del punto scelto dal giocatore.
RemoteFunction GetTeleportSpots e RemoteEvent TeleportRequestReplicatedStorage (li crea Teleporters)La prima restituisce al menu la lista dei punti. Il secondo porta il nome scelto al server.
L'Explorer quando il teletrasporto è pronto. Teleporters aggiunge GetTeleportSpots e TeleportRequest in ReplicatedStorage quando il gioco è avviato.
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

Passo 1: costruisci due pad di teletrasporto

  1. Nell'Explorer passa il mouse su Workspace, clicca sul pulsante + e inserisci una Folder. Chiama la cartella TeleportPads. Lo script cerca esattamente questo nome.
  2. Inserisci nella cartella due Part e chiamale PadA e PadB. Rendi ciascuna una lastra piatta, per esempio 6 per 1 per 6 stud, e mettile sul pavimento a una certa distanza l'una dall'altra. Nella finestra Properties spunta Anchored, lascia attivi CanCollide e CanTouch e imposta un colore vivace e il materiale Neon, così i giocatori le notano.
  3. Seleziona PadA, scorri la finestra Properties fino alla sezione Attributes e clicca su +. Inserisci il nome Destination, scegli il tipo String e clicca su Save, poi imposta il valore PadB. Fai lo stesso su PadB con il valore PadA.
  4. Ruota ogni pad in modo che la sua faccia frontale guardi verso il pavimento libero. I giocatori compaiono 3 stud davanti alla faccia frontale del pad di destinazione, di spalle a esso, quindi lascia lì qualche stud di pavimento libero. Per vedere quale faccia è quella frontale, clicca col tasto destro sul pad e scegli Show Orientation Indicator: la faccia frontale è segnata da una linea blu. Ruota il pad con lo strumento Rotate finché quella linea non punta dove i giocatori devono andare.

I giocatori arrivano accanto al pad, non sopra, ed è voluto. La pagina di Roblox sul debounce nota che Touched scatta molte volte di fila per un solo contatto, quindi un giocatore comparso proprio sull'altro pad lo attiverebbe di nuovo appena finito il suo cooldown e tornerebbe indietro attraverso la mappa.

Non sei limitato a due pad. Il Destination di un pad può indicare qualsiasi parte in TeleportPads, quindi tre pad possono mandare i giocatori in cerchio. Per un pad a senso unico, puntalo su una parte in TeleportPads che non ha un proprio Destination: una parte così riceve i giocatori e non manda nessuno da nessuna parte.

Passo 2: aggiungi lo script di teletrasporto

Passa il mouse su ServerScriptService, inserisci uno Script, chiamalo Teleporters e incolla al suo interno il codice qui sotto. Per ora gestisce i pad, e dopo i passi successivi anche il menu e i portali, quindi lo aggiungi una volta sola. Le impostazioni all'inizio sono le righe che sei fatto apposta per modificare.

Script in ServerScriptService chiamato Teleporters
-- Script in ServerScriptService chiamato Teleporters.
-- Ogni teletrasporto si decide qui, sul server:
--   1. Pad: toccare una parte in Workspace.TeleportPads ti porta alla parte indicata
--      nel suo attributo Destination.
--   2. Menu: il LocalScript TeleportMenu chiede un punto di Workspace.TeleportSpots
--      per nome. Il server controlla il nome, il cooldown e le Wins richieste dal punto.
--   3. Portali: toccare una parte in Workspace.PlacePortals ti manda nel place
--      del suo attributo PlaceId (un altro place di questo gioco).

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 -- per quanto i pad ignorano un giocatore dopo qualsiasi teletrasporto
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- stud davanti al pad di destinazione, così i giocatori arrivano accanto
local PLACE_ATTEMPTS = 3

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

-- Questo script crea da solo entrambi i remote, quindi non aggiungerli a mano
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

-- A che altezza dal pavimento si trova la parte radice di un personaggio in piedi.
-- Formula dalla documentazione di Roblox su Humanoid.HipHeight (nei rig R6 si aggiunge l'altezza della gamba).
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() -- impostato prima dell'attesa, così un secondo tocco non avvia un secondo teletrasporto

	-- Guarda dove punta la faccia frontale della destinazione (in piano, senza inclinazione)
	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
	-- Sale sulla sua faccia superiore: il pivot del personaggio è la sua parte radice, quindi la alziamo all'altezza in piedi.
	-- Un pad invece mette i giocatori qualche stud davanti a sé, perché un giocatore in piedi
	-- sul pad lo riattiverebbe al passo successivo.
	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)

	-- Con l'instance streaming attivo, prima carica l'area intorno alla destinazione (fino a 2 secondi)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- è uscito, è rinato o è morto mentre l'area si caricava
	end
	-- Un personaggio seduto è saldato al sedile, e spostarlo si trascinerebbe dietro il sedile.
	-- Distruggere la SeatWeld libera prima il personaggio dal sedile.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- All'arrivo riavvia il cooldown: il precaricamento qui sopra può richiedere fino a 2 secondi,
	-- e il pad accanto a cui è arrivato il giocatore non deve rimandarlo subito indietro
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- per lo script di controllo della velocità, se ne hai uno
end

-- 1. Pad
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 -- avvisa una volta, non a ogni tocco
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Menu: lista dei punti, poi richiesta per nome
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 -- stesse Wins: in ordine alfabetico, così l'ordine non cambia mai
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- Il client invia solo il nome. Non accettare mai dal client una posizione o un CFrame.
	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 -- bloccato per questo giocatore
	end
	teleportTo(player, spot, false)
end)

-- 3. Portali verso un altro place di questo gioco
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- già in viaggio o ha toccato un teletrasporto un secondo fa
	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 -- ci arrendiamo; un nuovo tocco del portale riprova
end

-- Il teletrasporto può fallire anche dopo essere partito. Il giocatore resta qui e può riprovare.
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 crea da solo la RemoteFunction GetTeleportSpots e il RemoteEvent TeleportRequest, quindi non devi inserire nulla a mano in ReplicatedStorage. Collega i pad di TeleportPads e i portali di PlacePortals una sola volta, all'avvio del server, quindi pad e portali aggiunti durante la partita non fanno nulla. Se una cartella manca, quel tipo di teletrasporto è semplicemente disattivato.

Cosa fa ogni parte di Teleporters
ParteCosa faPerché
playerFromHitTrova il modello del personaggio a cui appartiene la parte che ha toccato e chiede a Players:GetPlayerFromCharacter di chi è.I pad vengono toccati da gambe, cappelli e parti sciolte. Tutto ciò che non fa parte del personaggio di un giocatore dà nil e viene ignorato.
onCooldownConfronta os.clock() con l'ora dell'ultimo teletrasporto del giocatore.Un cooldown per giocatore, quindi un giocatore fermo accanto a un pad non blocca mai gli altri. Niente aspetta e niente dorme.
rootHeightCalcola a che altezza dal pavimento si trova la parte radice di un personaggio in piedi: metà dell'altezza della parte radice più l'HipHeight dello Humanoid, più la lunghezza della gamba nei rig R6.È la formula della documentazione di Roblox su Humanoid.HipHeight. Il pivot del personaggio è la sua parte radice, quindi alzare il pivot di questo valore mette i piedi sulla superficie per avatar piccoli, grandi e R6.
Controlli all'inizio di teleportToEsce se il giocatore non ha un personaggio vivo con una parte radice, e poi registra subito l'ora.La richiesta di streaming più sotto può far aspettare lo script. Registrando l'ora prima, i numerosi eventi Touched di quel momento non avviano un secondo teletrasporto.
Punto di arrivoLa faccia superiore della destinazione, alzata di rootHeight, con lo sguardo rivolto dove punta la sua faccia frontale, senza inclinazione. Per un pad il punto è anche spostato di 3 stud dalla sua faccia frontale.Il personaggio compare in piedi, non dentro la parte di destinazione. Accanto a un pad i suoi piedi partono all'altezza della faccia superiore del pad, quindi scende sul pavimento per lo spessore del pad. CFrame.lookAlong costruisce un CFrame in una posizione con una data direzione dello sguardo.
RequestStreamAroundAsyncChiede a Roblox di inviare prima a quel giocatore l'area intorno al punto di arrivo e aspetta al massimo 2 secondi.L'instance streaming è attivo di default nei nuovi place, quindi la parte lontana della mappa potrebbe non essere ancora caricata sul dispositivo del giocatore. Roblox consiglia questa chiamata server prima di spostare lontano un personaggio, anche se non garantisce cosa arriverà esattamente.
Secondo controlloSe il giocatore è uscito, o il personaggio è rinato o morto durante l'attesa, non si muove nulla.Il giocatore potrebbe aver fatto reset o essere uscito dal gioco mentre l'area si caricava. Anche l'esempio di precaricamento di Roblox controlla che il personaggio sia ancora in gioco prima di spostarlo.
Righe con SeatWeldSe il personaggio è seduto, distrugge la Weld che lo tiene sul sedile.Roblox salda il personaggio seduto al sedile. PivotTo sposta le parti cambiandone il CFrame, e la documentazione di Roblox dice che impostare il CFrame di una parte sposta anche le parti collegate, quindi senza questo il sedile e tutto ciò che vi è saldato arriverebbero insieme al giocatore. Distruggere la SeatWeld è il modo in cui la documentazione di Roblox su Seat fa alzare un personaggio dal sedile da uno script.
character:PivotTo(target)Sposta l'intero personaggio, tutti gli arti e gli accessori insieme, nel punto di arrivo.Roblox chiama PivotTo la funzione principale per spostare i modelli dagli script.
Seconda riga con lastTeleportRiavvia il cooldown all'arrivo.La richiesta di streaming può richiedere fino a 2 secondi, quanto il cooldown stesso del pad, quindi senza questa riga il giocatore potrebbe arrivare con il cooldown già scaduto.
MovementCheckSkipImposta un attributo sul Player dopo ogni spostamento.Un controllo della velocità sul server scambierebbe il salto per un cheat. Il MovementCheck della guida allo scatto legge questo attributo e ricomincia a misurare dalla nuova posizione. Senza uno script del genere l'attributo non fa nulla.
Impostazioni all'inizio di Teleporters
ImpostazioneValore quiCosa cambia
PAD_COOLDOWN_SECONDS2Per quanto pad e portali ignorano un giocatore dopo qualsiasi teletrasporto.
MENU_COOLDOWN_SECONDS3L'intervallo più breve tra due teletrasporti dal menu per lo stesso giocatore. Pad e menu condividono lo stesso orologio per giocatore, quindi anche una richiesta dal menu entro 3 secondi da un teletrasporto con un pad viene ignorata.
PAD_ARRIVAL_GAP3A quanti stud dalla faccia frontale del pad di destinazione compaiono i giocatori, così arrivano accanto al pad e non sopra.
PLACE_ATTEMPTS3Quante volte un portale prova TeleportAsync, a intervalli di 2 secondi, prima di arrendersi.

Premi Play adesso e sali su PadA: comparirai davanti a PadB. Il menu e i portali hanno bisogno dei prossimi due passi, ma lo script funziona già anche senza.

Passo 4: teletrasporto in un altro place

Un place è un mondo separato dentro il tuo gioco, con i suoi server: una lobby e un dungeon, oppure un hub e una serie di livelli. I giocatori si spostano tra i place con TeleportService, e Roblox lo esegue solo nel gioco pubblicato, quindi questo passo finisce nell'app di Roblox, non in Studio.

  1. Se il gioco non è ancora pubblicato, scegli File > Publish. I nuovi giochi, finché non li rilasci, sono aperti solo a te, alle persone a cui hai dato accesso Edit e ai membri del gruppo con i ruoli giusti, e per provare tu stesso i teletrasporti basta questo.
  2. Crea un secondo place: apri un nuovo place da qualsiasi modello di Studio, costruisci il tuo dungeon, poi scegli File > Publish As, clicca sul riquadro del tuo gioco, scegli Add as a new place e clicca su Create.
  3. Copia l'ID del nuovo place. Apri Asset Manager dal menu Window o dalla scheda Home, vai in Places In Experience, clicca col tasto destro sul place e scegli Copy Asset ID, che copia il suo place ID.
  4. Tornato nel primo place, inserisci in Workspace una Folder chiamata PlacePortals e al suo interno una Part ancorata chiamata DungeonPortal. Aggiungi un attributo di tipo Number chiamato PlaceId e incolla l'ID come valore.
  5. Premi Play e tocca il portale. L'Output stampa una riga che inizia con Teleporters: would send: in Studio il portale non fa altro.
  6. Pubblica di nuovo il gioco con File > Publish, così il portale compare nel gioco pubblicato, e provalo dall'app di Roblox come nel passo 5.

Teleporters chiama TeleportAsync dentro un pcall, fino a 3 volte con una pausa di 2 secondi tra un tentativo e l'altro, perché la pagina di Roblox sui teletrasporti dice che i teletrasporti possono fallire e dare un errore, e consiglia di riprovare. Un teletrasporto può anche partire e fallire all'ultimo momento senza errore, lasciando il giocatore dov'era. Per questo caso Roblox chiama TeleportInitFailed, e lo script toglie al giocatore il flag "in partenza", quindi un nuovo tocco del portale riprova.

Per far tornare i giocatori, fai lo stesso nell'altro place: metti una copia di Teleporters nel suo ServerScriptService e aggiungi un portale il cui PlaceId è l'ID del tuo primo place, copiato dall'Asset Manager nello stesso modo.

Chi può entrare negli altri tuoi place

La documentazione di Roblox sulla sicurezza avverte: appena un client si trova in un place del tuo gioco, può teletrasportarsi in qualsiasi altro suo place, qualunque percorso tu abbia previsto, e disattivare il Direct Access di un place toglie solo il pulsante Join sul sito. A cambiare questo è l'impostazione Access Control for Places nella sezione Audience > Access Settings del Creator Dashboard:

I tre valori di Access Control for Places
ImpostazioneChi può entrare in un place che non è quello iniziale
Fully openChiunque, tramite teletrasporti da qualsiasi gioco, deep link, inviti al gioco e unendosi a un amico.
Limited to same universeSolo i giocatori che si teletrasportano dall'interno dei tuoi giochi. Sono consentiti teletrasporti sia dal client sia dal server.
Secure within universe onlySolo i giocatori teletrasportati dai tuoi script server dall'interno di questo gioco.

Se i giocatori devono entrare in un place solo dal tuo portale, per esempio un dungeon, scegli Secure within universe only. Ogni teletrasporto di questa guida parte dal server, quindi continuerà a funzionare. Roblox dice anche che a molti giochi i teletrasporti protetti non servono, quindi un gioco i cui place sono tutti aperti a tutti può lasciare l'impostazione com'è.

In cosa sbagliano i vecchi tutorial sui teletrasporti

Se confronti questa guida con un video o un post su un forum, ecco le differenze importanti e il motivo per cui ogni trucco crea un problema.

Trucchi comuni nei tutorial sui teletrasporti e cosa fa questa guida al loro posto
TutorialProblemaQuesta guida
Imposta hit.Parent.HumanoidRootPart.Position = target.PositionLa documentazione di Roblox dice che impostare Position aggiorna le giunzioni della parte, che si sposta rispetto alle parti a cui è collegata: la parte radice se ne va senza il corpo.Sposta l'intero personaggio con PivotTo.
Imposta HumanoidRootPart.CFrame = target.CFrameIl centro del personaggio finisce al centro della parte di destinazione, in parte dentro di essa, e ne prende l'inclinazione.Il personaggio compare all'altezza in piedi sopra la faccia superiore, accanto al pad, senza inclinazione.
Usa una sola variabile debounce per tutto il padMentre un giocatore si teletrasporta, il pad ignora tutti gli altri. E senza alcun debounce un giocatore comparso sull'altro pad viene subito rimandato indietro.Un cooldown per giocatore, registrato prima di qualsiasi attesa, e i giocatori compaiono accanto al pad.
Chiama TeleportService:Teleport(placeId, player) da un LocalScriptRoblox segna Teleport() come deprecato, consiglia di non usarlo nei nuovi progetti e permette TeleportAsync solo dagli script server.Chiama TeleportAsync in uno script server.
Niente pcall, niente nuovi tentativiLa pagina di Roblox sui teletrasporti dice che possono fallire e dare un errore, e anche fallire dopo essere partiti.Fino a 3 tentativi in un pcall, e TeleportInitFailed permette al giocatore di riprovare.
Si arrende perché in Studio "non funziona"TeleportService non supporta il playtest in Studio.RunService:IsStudio() stampa invece cosa farebbe il portale.
GUI di teletrasporto i cui pulsanti inviano una posizioneUn cheater può chiamare lo stesso remote con qualsiasi posizione.I pulsanti inviano il nome del punto, e il server lo cerca.
Le monete passano nei teleport dataRoblox dice che i teleport data sono visibili al client e non sono cifrati.Consiglia di tenere monete e Wins in un archivio dati e caricarle nell'altro place (vedi Come portare i dati in un altro place).

Cosa i giocatori possono e non possono falsificare

Considera che un cheater controlla tutto sul proprio dispositivo: può modificare TeleportMenu, chiamare entrambi i remote tutte le volte che vuole con qualsiasi argomento e muovere il proprio personaggio. Ecco cosa ottiene con questo teletrasporto.

Cosa può tentare un cheater e cosa ne fa Teleporters
Il cheater prova aRisultatoPerché
Inviare una posizione o un CFrame tramite il remote del menuIgnoratoTeleportRequest legge una sola stringa, il nome di un punto lungo fino a 50 caratteri. Tutto il resto viene scartato.
Chiedere Castle senza 3 WinsRifiutatoIl server legge le Wins dalla sua copia dei leaderstats. Il pulsante grigio è solo un suggerimento.
Chiedere un punto che non esisteIgnoratoIl server cerca il nome in TeleportSpots e non fa nulla se non c'è una parte con quel nome.
Chiamare il remote del menu ancora e ancoraNon più di un teletrasporto dal menu ogni 3 secondiIl cooldown è conservato sul server, per ogni giocatore.
Attivare un pad senza avvicinarsiArriva al pad gemello, che avrebbe potuto raggiungere comunque a piediRoblox elenca il teletrasporto in qualsiasi punto e la manipolazione degli eventi Touched tra le cose che un client può fare con il proprio personaggio.
Entrare direttamente in un altro place del tuo giocoPossibile, se Access Control for Places non è Secure within universe onlyVedi Chi può entrare negli altri tuoi place.
Spostare il proprio personaggio ovunque, anche in un punto bloccatoPossibileOgni dispositivo controlla il movimento del proprio personaggio. Un punto bloccato è una comodità, non una cassaforte, quindi controlla sul server prima di dare lì qualcosa di prezioso.

L'ultima riga è il limite onesto di qualsiasi teletrasporto. Per un gioco competitivo aggiungi un controllo del movimento sul server, come nella guida allo scatto. Teleporters imposta già l'attributo MovementCheckSkip letto da quel controllo, quindi i suoi teletrasporti non vengono segnalati come violazioni: la documentazione di Roblox sulla sicurezza dice che i giochi con teletrasporti legittimi hanno bisogno proprio di un'eccezione così nei controlli del movimento.

Passo 5: provalo

  1. Premi Play. Sali su PadA: compari subito davanti a PadB, di spalle a esso. Girati e sali subito su PadB: non succede nulla, perché i pad ti ignorano per 2 secondi dopo l'arrivo. Scendi, aspetta 2 secondi e risali su PadB: compari davanti a PadA.
  2. Aspetta qualche secondo, poi premi Teleport sul lato sinistro dello schermo. Nella lista si vedono Lake, Spawn e un grigio "Castle (needs 3 wins)". Scegli Lake: compari lì sopra. Riapri il menu e scegli Castle: non succede nulla, e l'Output resta in silenzio.
  3. Assegnati 3 Wins (serve uno script leaderstats con un IntValue Wins, per esempio quello della guida alla classifica). Clicca sull'interruttore Client/Server per passare a Server, trova nell'Explorer Players, il tuo nome, leaderstats, Wins e imposta il suo Value a 3 nella finestra Properties. Torna su Client e riapri il menu: Castle è diventato viola e ti porta lì.
  4. Tocca DungeonPortal. L'Output stampa una riga che inizia con Teleporters: would send, con il tuo nome e il place ID. In Studio è giusto così, e viene stampata non più di una volta ogni 2 secondi, per quanto tu resti sul portale.
  5. Scegli Server & Clients nel menu a tendina delle modalità di test, imposta 2 client e premi Play. Entrambi i giocatori possono usare i pad nello stesso momento, e il cooldown di uno non blocca mai l'altro.
  6. Ferma il test, pubblica il gioco e avvialo dall'app di Roblox. Tocca il portale: compare la schermata di caricamento di Roblox e ti ritrovi nell'altro place. Se sei rimasto dov'eri, apri la Developer Console con il tasto F9, passa il log alla vista Server, che vedono solo il proprietario del gioco e i membri del gruppo con permesso di modifica, e cerca gli avvisi Teleporters:, che riportano il motivo indicato da Roblox.

Durante i passi in Studio tieni aperta la finestra Output (menu Window, poi Output). Quando Teleporters funziona non stampa nulla, a parte la riga del portale del passo 4, quindi vale la pena leggere qualsiasi avviso o errore rosso. Vedi Errori comuni.

Come estenderlo

Teletrasportare insieme una squadra o un party

TeleportAsync accetta una lista di giocatori, quindi un solo portale può mandare un intero gruppo nello stesso place. La pagina di Roblox sui teletrasporti suggerisce di partire dal giocatore che ha toccato il portale: player.Team e Team:GetPlayers() per una squadra, oppure SocialService:GetPlayersByPartyId() con player.PartyId per un party. Passa quella lista al posto di { player } e imposta il flag leavingForPlace per ogni giocatore della lista.

Mandare un gruppo su un server tutto suo

Di default i giocatori teletrasportati finiscono su un server pubblico dell'altro place. Per mandare un gruppo su un nuovo server riservato, per esempio per una partita, crea un TeleportOptions, imposta il suo ShouldReserveServer a true e passalo come terzo argomento: TeleportService:TeleportAsync(placeId, players, options). Roblox nota che con gli errori legati proprio ai server riservati i nuovi tentativi sono particolarmente utili, e lo script li fa già.

Come portare i dati in un altro place

Il teletrasporto azzera tutti i dati locali di quel giocatore. I teleport data di Roblox, impostati con TeleportOptions:SetTeleportData() e letti nell'altro place con player:GetJoinData(), sono visibili al client e non sono cifrati, quindi usali solo per scelte innocue, come quale mappa caricare. Monete, Wins e oggetti tienili in un archivio dati, come nel tutorial su DataStore, e ricaricali quando il giocatore arriva nell'altro place.

Una schermata di caricamento tua

Mentre un teletrasporto verso un place si carica, i giocatori vedono la schermata di caricamento standard di Roblox. Per mostrarne una tua, chiama sul client TeleportService:SetTeleportGui() con una ScreenGui, per esempio una che si trova in ReplicatedStorage. I teletrasporti di questa guida partono dal server, quindi il client deve chiamarlo in anticipo, per esempio appena il giocatore entra. Roblox dice che la schermata va impostata di nuovo prima di ogni teletrasporto e che non viene usata per un place di un altro gioco. Nota anche che gli script dentro quella ScreenGui non vengono eseguiti, quindi rendila statica.

Teletrasporti dei round e checkpoint

Il sistema di round all'inizio di ogni round porta tutti i giocatori nell'arena con la stessa chiamata PivotTo, e la sezione PivotTo o SpawnLocation (in inglese) della guida agli obby confronta questo approccio con gli SpawnLocation di Roblox. Se un punto deve sbloccarsi solo dopo un round, il sistema di round assegna già le Wins lette da WinsNeeded.

Errori comuni e soluzioni

Apri la finestra Output (menu Window, poi Output) prima di premere Play. Teleporters indica il pad quando un Destination non punta a niente, quindi la maggior parte dei problemi si vede lì.

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

TeleportMenu aspetta un remote creato da Teleporters, quindi Teleporters non sta girando. Controlla che sia uno Script e non un LocalScript, che si trovi direttamente in ServerScriptService, che non sia disattivato e che nell'Output non ci sia un suo errore rosso. La guida agli errori degli script spiega questo avviso nel dettaglio.

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

L'attributo Destination del pad indica qualcosa che non è una parte direttamente dentro la cartella TeleportPads. Controlla l'ortografia e le maiuscole nel valore dell'attributo e nel nome del pad di destinazione. L'avviso compare una volta per pad, la prima volta che un giocatore lo tocca.

Salgo sul pad e non succede nulla

Controlla che la cartella si chiami esattamente TeleportPads e si trovi direttamente in Workspace all'avvio del gioco, che l'attributo Destination del pad sia di tipo String (un attributo di tipo Number viene ignorato) e che siano passati 2 secondi dal tuo ultimo teletrasporto. Controlla anche che il pad abbia CanTouch attivo: Roblox dice che collegare Touched a una parte con CanTouch disattivato dà un errore, e quell'errore ferma lo script.

Compaio dentro un muro o cado dal bordo

I giocatori compaiono 3 stud davanti alla faccia frontale del pad di destinazione. Clicca col tasto destro sul pad, scegli Show Orientation Indicator e ruota il pad finché la linea blu non punta verso il pavimento libero. I punti del menu mettono i giocatori sopra la parte, quindi tieni ogni punto sul pavimento.

Il pulsante Castle resta grigio dopo che ho guadagnato 3 Wins

La lista viene disegnata all'apertura del menu, quindi chiudi il menu e riaprilo. Se il pulsante è ancora grigio, controlla che in leaderstats ci sia un IntValue chiamato esattamente Wins e che le Wins siano cambiate sul server, non solo in modalità Client.

Il portale non fa nulla nel gioco pubblicato

Apri la Developer Console con il tasto F9, passa il log alla vista Server (la vedono solo il proprietario del gioco e i membri del gruppo con permesso di modifica, perché Teleporters è uno Script server) e leggi gli avvisi Teleporters:, che riportano il motivo indicato da Roblox. Controlla che l'attributo PlaceId del portale sia di tipo Number e contenga l'ID dell'Asset Manager, e che tu abbia ripubblicato il place dopo aver aggiunto il portale.

Farlo con RoCode

Se non hai voglia di costruire tutto questo a mano, RoCode può farlo nel place che hai aperto. RoCode è un agente IA indipendente per Roblox Studio, non di Roblox: descrivi la funzione nella sua chat web, e il suo plugin per Studio crea le parti e gli script nel tuo Explorer, così non devi copiare codice dalla finestra della chat.

Tu scrivi

Aggiungi i teletrasporti: pad in Workspace.TeleportPads che mandano i giocatori al pad indicato nel proprio attributo Destination con un cooldown di 2 secondi, un menu Teleport per i punti in Workspace.TeleportSpots, dove Castle richiede 3 Wins con controllo sul server, e portali in Workspace.PlacePortals che mandano i giocatori nel place con l'ID del proprio attributo PlaceId, con nuovi tentativi.

RoCode fa
  • Può esaminare il tuo place quando un passo lo richiede, con Search Game e Search Scripts, per basarsi su oggetti, remote o codice di salvataggio che hai già invece di aggiungere un secondo sistema
  • Crea le cartelle e le parti dei pad con Create Instance, imposta le loro proprietà con Set Property e scrive Teleporters e TeleportMenu con Create Script
  • Ha l'istruzione di controllare la compilazione di ogni script che scrive con Check Script, che lo compila in Studio senza eseguirlo
  • Invia le modifiche a blocchi, e ogni blocco è un punto di annullamento nella cronologia di Studio

I teletrasporti tra place funzionano solo nel gioco pubblicato, quindi provali tu nell'app di Roblox. Con il plugin 3.9 o successivo RoCode può avviare un breve playtest e leggere gli errori, e con il plugin 3.9.15 o successivo il suo personaggio di test può salire sui pad e premere i pulsanti del menu, ma controlla solo ciò che ha deciso di testare, quindi sali sui pad e apri il menu anche tu. Il teletrasporto è uno dei tanti sistemi di un gioco; creare un gioco intero con RoCode funziona allo stesso modo, un sistema per prompt. Come RoCode si collega a Studio.

Domande frequenti

Come si fa un pad di teletrasporto in Roblox Studio?

Dai a due parti un attributo Destination con il nome dell'altra, e fai in modo che un solo script server sposti chi tocca un pad con character:PivotTo in un punto subito davanti all'altro pad, con un breve cooldown per giocatore. Il passo 1 e il passo 2 costruiscono esattamente questo.

Perché il mio teletrasporto non funziona in Studio?

Pad e menu in Studio funzionano. I teletrasporti verso un altro place no: in Roblox TeleportService non supporta il playtest in Studio, quindi pubblica il gioco e provalo nell'app di Roblox. Lo script di questa guida, invece di teletrasportare, stampa cosa farebbe il portale, così puoi comunque verificare che scatti.

Come teletrasporto i giocatori in un altro place del mio gioco?

Aggiungi il place con File > Publish As (Add as a new place), copia il suo place ID dall'Asset Manager e chiama TeleportService:TeleportAsync(placeId, { player }) da uno Script server dentro un pcall, riprovando in caso di errore. Il passo 4 ti guida in tutto questo.

Come si fa una GUI di teletrasporto?

Costruisci i pulsanti in un LocalScript e invia al server solo il nome del punto scelto dal giocatore. Il server cerca il nome in una cartella, controlla il cooldown e ogni regola di sblocco, poi sposta il personaggio. Non inviare mai una posizione dal client: un cheater può inviarne una qualsiasi.

Perché il mio personaggio si blocca o si smonta dopo un teletrasporto?

Assegnare la Position della parte radice sposta solo quella parte, senza il corpo collegato, e copiare il CFrame del pad mette il centro del personaggio dentro il pad. Usa character:PivotTo con un punto all'altezza in piedi sopra il pavimento, calcolato dall'HipHeight dello Humanoid.

Posso portare monete o oggetti con il teletrasporto?

Non in modo sicuro. Roblox dice che i teleport data sono visibili al client e non sono cifrati, quindi vanno bene per cose come la mappa scelta, ma non per le monete. Salva monete e oggetti in un archivio dati e caricali nell'altro place.

Fonti e letture

Come è stato controllato il codice: ogni script di questa pagina supera il controllo dei tipi rigoroso di Luau con le definizioni dell'API di Roblox (luau-lsp, 20 novembre 2026). Il controllo dei tipi trova API scritte male e tipi sbagliati, non la logica del gioco, quindi provalo in Studio prima di pubblicare.

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.