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. AssegnareHumanoidRootPart.Positionstacca 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. UsaTeleportAsyncsul server, avvolgilo in unpcall, riprova e gestisciTeleportInitFailed.
In questa pagina
Due tipi di teletrasporto
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.
| Dentro lo stesso server | In un altro place del tuo gioco | |
|---|---|---|
| Chiamata | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| A cosa serve | Pad di teletrasporto, menu di teletrasporto, spostare i giocatori dalla lobby all'arena | Portali verso un altro livello, una lobby che manda i giocatori in un place separato con un dungeon o una partita |
| Dove gira | Script server | Solo Script server. Il Teleport() lato client è deprecato. |
| Funziona nel playtest di Studio | Sì | No. In Roblox TeleportService non supporta il playtest in Studio, quindi si prova nel gioco pubblicato. |
| Cosa vede il giocatore | Un salto attraverso la mappa, che può richiedere fino a 2 secondi se quell'area deve prima caricarsi | La schermata di caricamento di Roblox, poi l'altro place |
| Monete, oggetti e altri dati | Restano come sono | Roblox 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.
| Elemento | Dove si trova | Cosa fa |
|---|---|---|
Folder TeleportPads con PadA e PadB | Workspace | Due pad. L'attributo Destination di ciascuno indica il pad a cui manda i giocatori. |
Folder TeleportSpots | Workspace | Una parte per ogni punto della lista del menu. L'attributo WinsNeeded blocca un punto. |
Folder PlacePortals | Workspace | Parti portale. L'attributo PlaceId di ogni portale è il place in cui manda i giocatori. |
Script Teleporters | ServerScriptService | Gestisce tutti e tre i tipi di teletrasporto e crea i due remote. L'unico posto in cui può avvenire un teletrasporto. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Disegna il pulsante Teleport e la lista dei punti e invia il nome del punto scelto dal giocatore. |
RemoteFunction GetTeleportSpots e RemoteEvent TeleportRequest | ReplicatedStorage (li crea Teleporters) | La prima restituisce al menu la lista dei punti. Il secondo porta il nome scelto al server. |
Workspace
TeleportPads Folder new
PadA Part new
PadB Part new
TeleportSpots Folder new
Spawn Part new
Lake Part new
Castle Part new
PlacePortals Folder new
DungeonPortal Part new
ServerScriptService
Teleporters Script new
StarterPlayer
StarterPlayerScripts
TeleportMenu LocalScript new
Passo 1: costruisci due pad di teletrasporto
- Nell'Explorer passa il mouse su Workspace, clicca sul pulsante + e inserisci una Folder. Chiama la cartella
TeleportPads. Lo script cerca esattamente questo nome. - Inserisci nella cartella due Part e chiamale
PadAePadB. 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. - 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 valorePadB. Fai lo stesso su PadB con il valorePadA. - 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.
-- 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.
| Parte | Cosa fa | Perché |
|---|---|---|
playerFromHit | Trova 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. |
onCooldown | Confronta 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. |
rootHeight | Calcola 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 teleportTo | Esce 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 arrivo | La 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. |
RequestStreamAroundAsync | Chiede 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 controllo | Se 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 SeatWeld | Se 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 lastTeleport | Riavvia 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. |
MovementCheckSkip | Imposta 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. |
| Impostazione | Valore qui | Cosa cambia |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Per quanto pad e portali ignorano un giocatore dopo qualsiasi teletrasporto. |
MENU_COOLDOWN_SECONDS | 3 | L'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_GAP | 3 | A quanti stud dalla faccia frontale del pad di destinazione compaiono i giocatori, così arrivano accanto al pad e non sopra. |
PLACE_ATTEMPTS | 3 | Quante 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.
- 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.
- 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.
- 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.
- Tornato nel primo place, inserisci in Workspace una Folder chiamata
PlacePortalse al suo interno una Part ancorata chiamataDungeonPortal. Aggiungi un attributo di tipo Number chiamatoPlaceIde incolla l'ID come valore. - Premi Play e tocca il portale. L'Output stampa una riga che inizia con
Teleporters: would send: in Studio il portale non fa altro. - 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:
| Impostazione | Chi può entrare in un place che non è quello iniziale |
|---|---|
| Fully open | Chiunque, tramite teletrasporti da qualsiasi gioco, deep link, inviti al gioco e unendosi a un amico. |
| Limited to same universe | Solo i giocatori che si teletrasportano dall'interno dei tuoi giochi. Sono consentiti teletrasporti sia dal client sia dal server. |
| Secure within universe only | Solo 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.
| Tutorial | Problema | Questa guida |
|---|---|---|
Imposta hit.Parent.HumanoidRootPart.Position = target.Position | La 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.CFrame | Il 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 pad | Mentre 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 LocalScript | Roblox 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 tentativi | La 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 posizione | Un 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 data | Roblox 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.
| Il cheater prova a | Risultato | Perché |
|---|---|---|
| Inviare una posizione o un CFrame tramite il remote del menu | Ignorato | TeleportRequest legge una sola stringa, il nome di un punto lungo fino a 50 caratteri. Tutto il resto viene scartato. |
| Chiedere Castle senza 3 Wins | Rifiutato | Il server legge le Wins dalla sua copia dei leaderstats. Il pulsante grigio è solo un suggerimento. |
| Chiedere un punto che non esiste | Ignorato | Il 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 ancora | Non più di un teletrasporto dal menu ogni 3 secondi | Il cooldown è conservato sul server, per ogni giocatore. |
| Attivare un pad senza avvicinarsi | Arriva al pad gemello, che avrebbe potuto raggiungere comunque a piedi | Roblox 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 gioco | Possibile, se Access Control for Places non è Secure within universe only | Vedi Chi può entrare negli altri tuoi place. |
| Spostare il proprio personaggio ovunque, anche in un punto bloccato | Possibile | Ogni 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
- 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.
- 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.
- 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,Winse imposta il suo Value a 3 nella finestra Properties. Torna su Client e riapri il menu: Castle è diventato viola e ti porta lì. - 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. - 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.
- 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.
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.
- 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
- Roblox Creator Docs: Teleport between places (in inglese). TeleportAsync, playtest in Studio, Access Control for Places, schermate di teletrasporto, teleport data e teletrasporti falliti
- Roblox Creator Docs: TeleportService (in inglese). Teleport deprecato, TeleportAsync solo sul server e TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (in inglese). la funzione principale per spostare i modelli dagli script
- Roblox Creator Docs: BasePart.Position (in inglese). perché impostare Position su una parte collegata la sposta rispetto alle altre
- Roblox Creator Docs: Humanoid.HipHeight (in inglese). a che altezza si trova la parte radice di un personaggio in piedi, per rig R15 e R6
- Roblox Creator Docs: Seat (in inglese). la SeatWeld che tiene il personaggio seduto, e la sua distruzione per farlo alzare
- Roblox Creator Docs: Player:RequestStreamAroundAsync (in inglese). richiedere un'area prima che il personaggio ci si sposti, senza garanzia su cosa arriva
- Roblox Creator Docs: Streaming techniques and conversion (in inglese). streaming anticipato prima di un teletrasporto
- Roblox Creator Docs: Access control and confidentiality (in inglese). perché i client possono entrare in qualsiasi place del gioco se i teletrasporti non sono protetti
- Roblox Creator Docs: Network ownership, movement validation, and physics (in inglese). cosa può fare un client con il proprio personaggio ed eccezioni per i teletrasporti nei controlli del movimento
- Roblox Creator Docs: Create and publish games and places (in inglese). pubblicazione, chi può aprire un nuovo gioco, e aggiungere un place con Publish As
- Roblox Creator Docs: Asset Manager (in inglese). come copiare un place ID
- Roblox Creator Docs: Developer Console (in inglese). la vista Server del log e chi la vede
- Roblox Creator Docs: Debounce patterns (in inglese). perché Touched scatta più volte per un solo contatto
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.