Pe scurt
Pentru o platformă de teleport, pune un Script în ServerScriptService care ascultă evenimentul Touched al platformei, găsește jucătorul prin Players:GetPlayerFromCharacter și mută tot personajul prin character:PivotTo() într-un punct chiar în fața platformei de destinație, cu spatele la ea, cu un cooldown de câteva secunde per jucător, ca platforma de destinație să nu-l trimită imediat înapoi. Ca să trimiți jucători în alt place al jocului tău, apelează TeleportService:TeleportAsync(placeId, { player }) dintr-un Script de server în interiorul unui pcall; asta merge doar în jocul publicat, nu în Studio.
- Mută tot personajul prin
PivotTo. Atribuirea luiHumanoidRootPart.Positiondesparte part-ul rădăcină de restul corpului, pentru că la setarea lui Position Roblox actualizează îmbinările. - Un meniu de teleport trebuie să-i trimită serverului numele destinației, nu o poziție. Serverul verifică numele, cooldown-ul și orice regulă de deblocare înainte să mute pe cineva.
TeleportService:Teleport()e învechit și rulează pe client. FoloseșteTeleportAsyncpe server, înfășoară-l într-unpcall, reîncearcă și trateazăTeleportInitFailed.
Pe această pagină
Două tipuri de teleport
Un teleport într-un joc Roblox poate însemna trei lucruri: o platformă care te mută peste hartă, un meniu de puncte în care poți sări sau un portal spre alt nivel. Primele două mută personajul în cadrul serverului pe care se află deja jucătorul. Al treilea trimite jucătorul în alt place al jocului tău, care rulează pe propriile servere. Folosesc API-uri diferite, așa că e util să știi de care ai nevoie.
| În cadrul aceluiași server | În alt place al jocului tău | |
|---|---|---|
| Apelul | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Pentru ce | Platforme de teleport, meniuri de teleport, mutarea jucătorilor din lobby în arenă | Portaluri spre alt nivel, un lobby care trimite jucătorii într-un place separat cu un dungeon sau un meci |
| Unde rulează | Script de server | Doar Script de server. Teleport() de pe client e învechit. |
| Merge în playtestul din Studio | Da | Nu. TeleportService din Roblox nu suportă playtestul din Studio, așa că se testează în jocul publicat. |
| Ce vede jucătorul | Un salt peste hartă, care poate dura până la 2 secunde dacă zona trebuie încărcată întâi | Ecranul de încărcare Roblox, apoi celălalt place |
| Monede, obiecte și alte date | Rămân cum sunt | Roblox resetează datele locale ale jucătorului, așa că tot ce e important trebuie să vină dintr-un data store în celălalt place |
În acest ghid toate cele trei tipuri sunt adunate într-un singur Script de server, așa că un singur set de reguli acoperă fiecare teleport din jocul tău: decide serverul, fiecare jucător are propriul cooldown, iar dispozitivul jucătorului doar spune în ce punct ar vrea să ajungă.
| Element | Unde se află | Ce face |
|---|---|---|
Folder TeleportPads cu PadA și PadB | Workspace | Două platforme. Atributul Destination al fiecăreia numește platforma la care trimite jucătorii. |
Folder TeleportSpots | Workspace | Câte un part pentru fiecare punct din lista meniului. Atributul WinsNeeded închide un punct. |
Folder PlacePortals | Workspace | Parts-portal. Atributul PlaceId al fiecărui portal este place-ul în care trimite jucătorii. |
Script Teleporters | ServerScriptService | Gestionează toate cele trei tipuri de teleport și creează două remote-uri. Singurul loc unde poate avea loc un teleport. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Desenează butonul Teleport și lista de puncte și trimite numele punctului ales de jucător. |
RemoteFunction GetTeleportSpots și RemoteEvent TeleportRequest | ReplicatedStorage (le creează Teleporters) | Prima îi returnează meniului lista de puncte. Al doilea duce numele ales la 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
Pasul 1: construiește două platforme de teleport
- În Explorer treci cu mouse-ul peste Workspace, apasă butonul + și inserează un Folder. Numește folderul
TeleportPads. Scriptul caută exact acest nume. - Inserează în folder două Part și numește-le
PadAșiPadB. Fă-l pe fiecare o placă plată, de exemplu 6 pe 1 pe 6 studs, și pune-le pe podea la o oarecare distanță una de alta. În fereastra Properties bifează Anchored, lasă CanCollide și CanTouch pornite și setează o culoare vie și materialul Neon, ca jucătorii să le observe. - Selectează PadA, derulează fereastra Properties până la secțiunea Attributes și apasă +. Introdu numele
Destination, alege tipul String și apasă Save, apoi setează valoareaPadB. Fă la fel pe PadB, cu valoareaPadA. - Rotește fiecare platformă astfel încât fața din față să privească spre podeaua liberă. Jucătorii apar la 3 studs în fața feței din față a platformei de destinație, cu spatele la ea, așa că lasă acolo câțiva studs de podea liberă. Ca să vezi care e fața din față, dă clic dreapta pe platformă și alege Show Orientation Indicator: fața din față e marcată de o linie albastră. Rotește platforma cu instrumentul Rotate până când această linie arată spre unde trebuie să plece jucătorii.
Jucătorii ajung lângă platformă, nu pe ea, intenționat. Pagina Roblox despre debounce notează că Touched se declanșează de multe ori la rând pentru o singură atingere, așa că un jucător apărut direct pe cealaltă platformă ar porni-o din nou imediat ce i se termină cooldown-ul și ar zbura înapoi peste hartă.
Nu ești limitat la două platforme. Destination-ul unei platforme poate numi orice part din TeleportPads, așa că trei platforme pot trimite jucătorii în cerc. Pentru o platformă cu sens unic, îndreapt-o spre un part din TeleportPads care nu are propriul Destination: un asemenea part primește jucători și nu trimite pe nimeni nicăieri.
Pasul 2: adaugă scriptul de teleport
Treci cu mouse-ul peste ServerScriptService, inserează un Script, numește-l Teleporters și lipește în el codul de mai jos. Acum deservește platformele, iar după pașii următori și meniul și portalurile, așa că îl adaugi o singură dată. Setările de la început sunt liniile pe care trebuie să le schimbi.
-- Script în ServerScriptService, numit Teleporters.
-- Fiecare teleport se decide aici, pe server:
-- 1. Platforme: atingerea unui part din Workspace.TeleportPads te duce la part-ul numit
-- în atributul lui Destination.
-- 2. Meniu: LocalScript-ul TeleportMenu cere un punct din Workspace.TeleportSpots
-- după nume. Serverul verifică numele, cooldown-ul și Wins necesare pentru punct.
-- 3. Portaluri: atingerea unui part din Workspace.PlacePortals te trimite în place-ul
-- din atributul lui PlaceId (alt place al acestui joc).
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 -- atât timp platformele ignoră un jucător după orice teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs în fața platformei de destinație, ca jucătorii să ajungă lângă ea
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Acest script creează singur ambele remote-uri, așa că nu le adăugați de mână
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
-- La ce înălțime deasupra podelei se află part-ul rădăcină al unui personaj în picioare.
-- Formula din referința Roblox pentru Humanoid.HipHeight (la rig-urile R6 se adaugă înălțimea piciorului).
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() -- setăm înainte de așteptare, ca o a doua atingere să nu pornească un al doilea teleport
-- Privim spre unde e îndreptată fața din față a destinației (drept, fără înclinare)
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
-- Stăm pe fața ei de sus: pivotul personajului este part-ul lui rădăcină, așa că îl ridicăm la înălțimea în picioare.
-- O platformă însă pune jucătorii la câțiva studs în fața ei, pentru că un jucător care stă
-- pe platformă ar porni-o din nou la pasul următor.
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)
-- Cu instance streaming pornit, încărcăm întâi zona din jurul destinației (până la 2 secunde)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- a ieșit, a făcut respawn sau a murit cât timp se încărca zona
end
-- Un personaj așezat e sudat de scaun, iar mutarea lui ar trage scaunul după el.
-- Distrugerea SeatWeld eliberează întâi personajul de scaun.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- La sosire repornim cooldown-ul: preîncărcarea de mai sus poate dura până la 2 secunde,
-- iar platforma lângă care a ajuns jucătorul nu trebuie să-l trimită imediat înapoi
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- pentru scriptul de verificare a vitezei, dacă aveți unul
end
-- 1. Platforme
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 -- avertizăm o singură dată, nu la fiecare atingere
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Meniu: lista de puncte, apoi cererea după nume
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 -- aceleași Wins: alfabetic, ca ordinea să nu se schimbe niciodată
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Clientul trimite doar numele. Nu acceptați niciodată de la client o poziție sau 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 -- închis pentru acest jucător
end
teleportTo(player, spot, false)
end)
-- 3. Portaluri spre alt place al acestui joc
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- deja pe drum sau a atins un teleport acum o secundă
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 -- renunțăm; o nouă atingere a portalului încearcă din nou
end
-- Teleportul poate eșua și după pornire. Jucătorul rămâne aici și poate încerca din nou.
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 creează singur RemoteFunction-ul GetTeleportSpots și RemoteEvent-ul TeleportRequest, așa că nu trebuie să inserezi nimic de mână în ReplicatedStorage. Conectează platformele din TeleportPads și portalurile din PlacePortals o singură dată, la pornirea serverului, așa că platformele și portalurile adăugate în timpul jocului nu fac nimic. Dacă un folder lipsește, acel tip de teleport e pur și simplu oprit.
| Parte | Ce face | De ce |
|---|---|---|
playerFromHit | Găsește modelul de personaj căruia îi aparține part-ul care a atins și întreabă Players:GetPlayerFromCharacter al cui e. | Platformele sunt atinse de picioare, pălării și parts libere. Tot ce nu face parte din personajul unui jucător dă nil și e ignorat. |
onCooldown | Compară os.clock() cu ora ultimului teleport al jucătorului. | Un cooldown per jucător, așa că un jucător care stă lângă platformă nu-i blochează niciodată pe ceilalți. Nimic nu așteaptă și nu doarme. |
rootHeight | Calculează la ce înălțime deasupra podelei se află part-ul rădăcină al unui personaj în picioare: jumătate din înălțimea part-ului rădăcină plus HipHeight-ul Humanoid-ului, plus lungimea piciorului la rig-urile R6. | Este formula din referința Roblox pentru Humanoid.HipHeight. Pivotul personajului este part-ul lui rădăcină, așa că ridicarea pivotului cu această valoare pune picioarele pe suprafață atât la avatarele mici, cât și la cele mari și la R6. |
Verificările de la începutul teleportTo | Iese dacă jucătorul nu are un personaj viu cu part rădăcină, apoi notează imediat ora. | Cererea de streaming de mai jos poate face scriptul să aștepte. Dacă ora e notată dinainte, numeroasele evenimente Touched din acel moment nu pornesc un al doilea teleport. |
| Punctul de sosire | Fața de sus a destinației, ridicată cu rootHeight, cu privirea spre unde arată fața ei din față, fără înclinare. Pentru o platformă, punctul e în plus mutat la 3 studs de fața ei din față. | Personajul apare în picioare, nu în interiorul part-ului de destinație. Lângă o platformă, picioarele lui pornesc la nivelul feței ei de sus, așa că el coboară pe podea cu grosimea platformei. CFrame.lookAlong construiește un CFrame într-o poziție cu o direcție de privire dată. |
RequestStreamAroundAsync | Îi cere lui Roblox să trimită întâi acestui jucător zona din jurul punctului de sosire și așteaptă cel mult 2 secunde. | Instance streaming e pornit implicit în place-urile noi, așa că o parte îndepărtată a hărții poate să nu fie încă încărcată pe dispozitivul jucătorului. Roblox recomandă acest apel de pe server înainte să muți un personaj departe, deși nu garantează exact ce ajunge. |
| A doua verificare | Dacă jucătorul a ieșit, iar personajul a făcut respawn sau a murit în timpul așteptării, nimic nu se mișcă. | Jucătorul putea face reset sau putea ieși din joc cât timp se încărca zona. Exemplul propriu de preîncărcare al Roblox verifică și el că personajul e încă în joc înainte să-l miște. |
Liniile cu SeatWeld | Dacă personajul stă jos, distruge Weld-ul care îl ține pe scaun. | Roblox sudează un personaj așezat de scaun. PivotTo mută parts schimbându-le CFrame-ul, iar referința Roblox spune că setarea CFrame-ului unui part mută și parts-urile îmbinate cu el, așa că fără asta scaunul și tot ce e sudat de el ar sosi odată cu jucătorul. Distrugerea SeatWeld e modul în care referința Roblox pentru Seat ridică un personaj de pe scaun dintr-un script. |
character:PivotTo(target) | Mută tot personajul, toate membrele și accesoriile împreună, în punctul de sosire. | Roblox numește PivotTo funcția principală pentru mutarea modelelor din scripturi. |
A doua linie cu lastTeleport | Repornește cooldown-ul la sosire. | Cererea de streaming poate dura până la 2 secunde, cât cooldown-ul platformei însuși, așa că fără această linie jucătorul ar putea sosi cu cooldown-ul deja expirat. |
MovementCheckSkip | Setează un atribut pe Player după fiecare mutare. | O verificare a vitezei pe server ar lua saltul drept trișat. MovementCheck din ghidul de sprint citește acest atribut și începe să măsoare din nou de la poziția nouă. Fără un asemenea script, atributul nu face nimic. |
| Setare | Valoarea de aici | Ce schimbă |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Cât timp platformele și portalurile ignoră un jucător după orice teleport. |
MENU_COOLDOWN_SECONDS | 3 | Cel mai scurt interval dintre două teleporturi prin meniu pentru un jucător. Platformele și meniul au un ceas comun per jucător, așa că o cerere din meniu în primele 3 secunde după un teleport de pe platformă e și ea ignorată. |
PAD_ARRIVAL_GAP | 3 | La câți studs de fața din față a platformei de destinație apar jucătorii, ca să ajungă lângă platformă, nu pe ea. |
PLACE_ATTEMPTS | 3 | De câte ori încearcă un portal TeleportAsync, la un interval de 2 secunde, înainte să renunțe. |
Apasă Play chiar acum și pășește pe PadA: vei apărea în fața lui PadB. Meniul și portalurile au nevoie de următorii doi pași, dar scriptul funcționează deja și fără ei.
Pasul 4: teleport în alt place
Un place este o lume separată în jocul tău, cu propriile servere: un lobby și un dungeon sau un hub și un set de niveluri. Jucătorii se mută între place-uri prin TeleportService, iar Roblox îl rulează doar în jocul publicat, așa că acest pas se termină în aplicația Roblox, nu în Studio.
- Dacă jocul nu e încă publicat, alege File > Publish. Jocurile noi, până nu le lansezi, sunt deschise doar ție, persoanelor cărora le-ai dat acces Edit și membrilor grupului cu rolurile potrivite, iar pentru propriul test al teleporturilor asta ajunge.
- Creează al doilea place: deschide un place nou din orice șablon Studio, construiește-ți dungeon-ul, apoi alege File > Publish As, dă clic pe tile-ul jocului tău, alege Add as a new place și apasă Create.
- Copiază ID-ul noului place. Deschide Asset Manager din meniul Window sau din fila Home, mergi la Places In Experience, dă clic dreapta pe place și alege Copy Asset ID, care îi copiază place ID-ul.
- Înapoi în primul place, inserează în Workspace un Folder numit
PlacePortals, iar în el un Part ancorat numitDungeonPortal. Adaugă un atribut de tip Number numitPlaceIdși lipește ID-ul ca valoare. - Apasă Play și atinge portalul. Output afișează o linie care începe cu
Teleporters: would send: în Studio portalul nu face nimic altceva. - Publică jocul din nou prin File > Publish, ca portalul să apară în jocul publicat, și testează-l din aplicația Roblox, ca la pasul 5.
Teleporters apelează TeleportAsync în interiorul unui pcall, de până la 3 ori, cu o pauză de 2 secunde între încercări, pentru că pagina Roblox despre teleporturi spune că teleporturile pot eșua și arunca o eroare și recomandă reîncercarea. Un teleport poate de asemenea să înceapă și să eșueze în ultimul moment fără eroare, lăsând jucătorul unde era. Pentru acest caz Roblox declanșează TeleportInitFailed, iar scriptul îi scoate jucătorului flag-ul „pleacă”, așa că o nouă atingere a portalului încearcă din nou.
Ca să aduci jucătorii înapoi, fă la fel în celălalt place: pune o copie a Teleporters în ServerScriptService-ul lui și adaugă un portal al cărui PlaceId este ID-ul primului tău place, copiat din Asset Manager în același fel.
Cine poate intra în celelalte place-uri ale tale
Documentația Roblox despre securitate avertizează: odată ce un client a ajuns într-un place al jocului tău, se poate teleporta în oricare alt place al lui, oricare ar fi traseul pe care l-ai gândit, iar dezactivarea Direct Access la un place scoate doar butonul Join de pe site. Asta o schimbă setarea Access Control for Places din secțiunea Audience > Access Settings din Creator Dashboard:
| Setare | Cine poate intra într-un place care nu e cel de start |
|---|---|
| Fully open | Oricine, prin teleporturi din orice joc, deep links, invitații în joc și alăturarea la un prieten. |
| Limited to same universe | Doar jucătorii care se teleportează din interiorul jocurilor tale. Sunt permise teleporturile atât de pe client, cât și de pe server. |
| Secure within universe only | Doar jucătorii pe care îi teleportează scripturile tale de server din interiorul acestui joc. |
Dacă jucătorii trebuie să ajungă într-un place doar prin portalul tău, de exemplu într-un dungeon, alege Secure within universe only. Fiecare teleport din acest ghid începe pe server, așa că va continua să funcționeze. Roblox spune și că multe jocuri nu au nevoie de teleporturi securizate, așa că un joc ale cărui place-uri sunt toate deschise tuturor poate lăsa setarea cum e.
Unde greșesc tutorialele vechi de teleport
Dacă compari acest ghid cu un video sau o postare pe forum, iată diferențele importante și motivul pentru care fiecare tehnică creează o problemă.
| Tutorialul | Problema | Acest ghid |
|---|---|---|
Setează hit.Parent.HumanoidRootPart.Position = target.Position | Referința Roblox spune că setarea lui Position actualizează îmbinările part-ului, iar el se deplasează față de parts-urile de care e îmbinat: part-ul rădăcină pleacă fără corp. | Mută tot personajul prin PivotTo. |
Setează HumanoidRootPart.CFrame = target.CFrame | Mijlocul personajului ajunge în mijlocul part-ului țintă, parțial în interiorul lui, și preia înclinarea part-ului. | Personajul apare la înălțimea în picioare deasupra feței de sus, lângă platformă, fără înclinare. |
Folosește o singură variabilă debounce pentru toată platforma | Cât timp se teleportează un jucător, platforma îi ignoră pe toți ceilalți. Iar fără niciun debounce, un jucător apărut pe cealaltă platformă e trimis imediat înapoi. | Un cooldown per jucător, notat înainte de orice așteptare, iar jucătorii apar lângă platformă. |
Apelează TeleportService:Teleport(placeId, player) dintr-un LocalScript | Roblox marchează Teleport() ca învechit, recomandă să nu-l folosești în proiecte noi și permite TeleportAsync doar din scripturi de server. | Apelează TeleportAsync într-un script de server. |
Fără pcall, fără reîncercări | Pagina Roblox despre teleporturi spune că pot eșua și arunca o eroare, ba chiar pot eșua după pornire. | Până la 3 încercări într-un pcall, iar TeleportInitFailed îi permite jucătorului să încerce din nou. |
| Renunță pentru că în Studio „nu merge” | TeleportService nu suportă playtestul din Studio. | RunService:IsStudio() afișează în schimb ce ar fi făcut portalul. |
| Un GUI de teleport ale cărui butoane trimit o poziție | Un trișor poate apela același remote cu orice poziție. | Butoanele trimit numele punctului, iar serverul îl caută. |
| Monedele sunt trimise în teleport data | Roblox spune că teleport data sunt vizibile clientului și nu sunt criptate. | Recomandă păstrarea monedelor și a Wins într-un data store și încărcarea lor în celălalt place (vezi Cum muți datele în alt place). |
Ce pot și ce nu pot falsifica jucătorii
Pleacă de la ideea că un trișor controlează tot pe dispozitivul lui: poate edita TeleportMenu, poate apela ambele remote-uri de oricâte ori, cu orice argumente, și își poate mișca personajul. Iată ce îi aduce asta cu acest teleport.
| Trișorul încearcă | Rezultat | De ce |
|---|---|---|
| Să trimită o poziție sau un CFrame prin remote-ul meniului | Ignorat | TeleportRequest citește un singur șir, numele unui punct de cel mult 50 de caractere. Orice altceva e aruncat. |
| Să ceară Castle fără 3 Wins | Refuz | Serverul citește Wins din propria copie a leaderstats. Butonul gri e doar un indiciu. |
| Să ceară un punct care nu există | Ignorat | Serverul caută numele în TeleportSpots și nu face nimic dacă nu există un part cu acest nume. |
| Să apeleze remote-ul meniului iar și iar | Cel mult un teleport prin meniu la fiecare 3 secunde | Cooldown-ul e păstrat pe server, pentru fiecare jucător. |
| Să pornească o platformă fără să se apropie de ea | Ajunge la platforma pereche, la care oricum putea merge | Roblox enumeră teleportarea în orice punct și manipularea evenimentelor Touched printre lucrurile pe care clientul le poate face cu personajul lui. |
| Să intre direct în alt place al jocului tău | Posibil, dacă Access Control for Places nu e Secure within universe only | Vezi Cine poate intra în celelalte place-uri ale tale. |
| Să-și mute personajul oriunde, inclusiv într-un punct închis | Posibil | Fiecare dispozitiv controlează mișcarea propriului personaj. Un punct închis e o comoditate, nu un seif, așa că verifică pe server înainte să dai acolo ceva valoros. |
Ultimul rând e limita cinstită a oricărui teleport. Pentru un joc competitiv, adaugă o verificare a mișcării pe server, ca în ghidul de sprint. Teleporters setează deja atributul MovementCheckSkip pe care îl citește acea verificare, așa că propriile lui teleporturi nu sunt marcate ca încălcări: documentația Roblox despre securitate spune că jocurile cu teleporturi legitime au nevoie exact de o asemenea excepție în verificările de mișcare.
Pasul 5: testează
- Apasă Play. Pășește pe PadA: apari chiar în fața lui PadB, cu spatele la ea. Întoarce-te și pășește imediat pe PadB: nu se întâmplă nimic, pentru că platformele te ignoră 2 secunde după sosire. Coboară, așteaptă 2 secunde și urcă din nou pe PadB: apari în fața lui PadA.
- Așteaptă câteva secunde, apoi apasă Teleport în partea stângă a ecranului. În listă se văd Lake, Spawn și un "Castle (needs 3 wins)" gri. Alege Lake: apari acolo. Deschide meniul din nou și alege Castle: nu se întâmplă nimic, iar Output tace.
- Dă-ți 3 Wins (pentru asta îți trebuie un script leaderstats cu un IntValue Wins, de exemplu din ghidul de clasament). Apasă comutatorul Client/Server ca să treci pe Server, găsește în Explorer
Players, numele tău,leaderstats,Winsși setează-i Value la 3 în fereastra Properties. Comută înapoi pe Client și deschide din nou meniul: Castle a devenit violet și te duce acolo. - Atinge DungeonPortal. Output afișează o linie care începe cu
Teleporters: would send, cu numele tău și place ID-ul. În Studio așa trebuie să fie, iar linia e afișată cel mult o dată la 2 secunde, oricât ai sta pe portal. - Alege Server & Clients din lista derulantă a modurilor de test, setează 2 clienți și apasă Play. Ambii jucători pot folosi platformele în același timp, iar cooldown-ul unuia nu-l blochează niciodată pe celălalt.
- Oprește testul, publică jocul și pornește-l din aplicația Roblox. Atinge portalul: apare ecranul de încărcare Roblox și ajungi în celălalt place. Dacă ai rămas pe loc, deschide Developer Console cu tasta F9, comută logul pe vederea Server, pe care o văd doar proprietarul jocului și membrii grupului cu drept de editare, și caută avertismentele
Teleporters:, care conțin motivul dat de Roblox.
În timpul pașilor din Studio ține fereastra Output deschisă (meniul Window, apoi Output). Când Teleporters funcționează, nu afișează nimic în afară de linia portalului de la pasul 4, așa că merită citit orice avertisment sau eroare roșie. Vezi Erori frecvente.
Cum îl extinzi
Teleportul unei echipe sau al unui party împreună
TeleportAsync acceptă o listă de jucători, așa că un singur portal poate trimite un grup întreg în același place. Pagina Roblox despre teleporturi propune să pornești de la jucătorul care a atins portalul: player.Team și Team:GetPlayers() pentru o echipă sau SocialService:GetPlayersByPartyId() cu player.PartyId pentru un party. Dă această listă în locul lui { player } și setează flag-ul leavingForPlace fiecărui jucător din ea.
Trimiterea unui grup pe un server propriu
Implicit, jucătorii teleportați ajung pe un server public al celuilalt place. Ca să trimiți un grup pe un server rezervat nou, de exemplu pentru un meci, creează un TeleportOptions, setează-i ShouldReserveServer la true și dă-l ca al treilea argument: TeleportService:TeleportAsync(placeId, players, options). Roblox notează că la eșecurile legate tocmai de serverele rezervate reîncercările sunt deosebit de utile, iar scriptul le face deja.
Cum muți datele în alt place
Teleportarea resetează toate datele locale ale acelui jucător. Teleport data din Roblox, care se setează prin TeleportOptions:SetTeleportData() și se citesc în celălalt place prin player:GetJoinData(), sunt vizibile clientului și nu sunt criptate, așa că folosește-le doar pentru alegeri inofensive, de exemplu ce hartă să se încarce. Monedele, Wins și obiectele păstrează-le într-un data store, ca în tutorialul DataStore, și încarcă-le din nou când jucătorul ajunge în celălalt place.
Un ecran de încărcare propriu
Cât timp se încarcă un teleport spre un place, jucătorii văd ecranul de încărcare standard Roblox. Ca să arăți unul propriu, apelează pe client TeleportService:SetTeleportGui() cu un ScreenGui, de exemplu cu unul care stă în ReplicatedStorage. Teleporturile din acest ghid încep pe server, așa că clientul trebuie să-l apeleze dinainte, de exemplu imediat ce intră jucătorul. Roblox spune că ecranul trebuie setat din nou înainte de fiecare teleport și că nu e folosit pentru un place din alt joc. Tot acolo se notează că scripturile din acel ScreenGui nu rulează, așa că fă-l static.
Teleporturi de rundă și checkpointuri
Sistemul de runde mută la începutul fiecărei runde toți jucătorii în arenă cu același apel PivotTo, iar secțiunea PivotTo sau SpawnLocation din ghidul de obby compară această abordare cu punctele de spawn din Roblox. Dacă un punct trebuie să se deschidă doar după o rundă, sistemul de runde acordă deja Wins pe care le citește WinsNeeded.
Erori frecvente și soluții
Deschide fereastra Output (meniul Window, apoi Output) înainte să apeși Play. Teleporters numește platforma când Destination nu arată spre nimic, așa că majoritatea problemelor se văd acolo.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu așteaptă remote-ul pe care îl creează Teleporters, deci Teleporters nu rulează. Verifică faptul că e un Script, nu un LocalScript, că stă direct în ServerScriptService, nu e dezactivat și că în Output nu există o eroare roșie de la el. Ghidul de erori de script explică în detaliu acest avertisment.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Atributul Destination al platformei numește ceva ce nu e un part direct în folderul TeleportPads. Verifică scrierea și majusculele din valoarea atributului și din numele platformei de destinație. Avertismentul apare o singură dată per platformă, când un jucător o atinge prima dată.
Pășesc pe platformă și nu se întâmplă nimic
Verifică faptul că folderul se numește exact TeleportPads și stă direct în Workspace la pornirea jocului, că atributul Destination al platformei e de tip String (un atribut de tip Number e ignorat) și că de la ultimul tău teleport au trecut 2 secunde. Verifică și că platforma are CanTouch pornit: Roblox spune că conectarea lui Touched la un part cu CanTouch oprit aruncă o eroare, iar ea oprește scriptul.
Apar într-un perete sau cad de pe margine
Jucătorii apar la 3 studs în fața feței din față a platformei de destinație. Dă clic dreapta pe platformă, alege Show Orientation Indicator și rotește platforma până când linia albastră arată spre podeaua liberă. Punctele din meniu pun jucătorii deasupra part-ului, așa că ține fiecare punct pe podea.
Butonul Castle rămâne gri după ce am câștigat 3 Wins
Lista se desenează la deschiderea meniului, așa că închide meniul și deschide-l din nou. Dacă butonul e tot gri, verifică faptul că în leaderstats există un IntValue numit exact Wins și că Wins s-au schimbat pe server, nu doar în modul Client.
Portalul nu face nimic în jocul publicat
Deschide Developer Console cu tasta F9, comută logul pe vederea Server (o văd doar proprietarul jocului și membrii grupului cu drept de editare, pentru că Teleporters e un Script de server) și citește avertismentele Teleporters:, care conțin motivul dat de Roblox. Verifică faptul că atributul PlaceId al portalului e de tip Number și conține ID-ul din Asset Manager și că ai publicat place-ul din nou după ce ai adăugat portalul.
Fă-l cu RoCode
Dacă nu ai chef să construiești toate acestea de mână, RoCode le poate face în place-ul pe care îl ai deschis. RoCode este un agent AI independent pentru Roblox Studio, nu de la Roblox: descrii funcția în chatul lui web, iar pluginul lui pentru Studio creează parts-urile și scripturile în Explorer-ul tău, așa că nu trebuie să copiezi cod din fereastra de chat.
Adaugă teleporturi: platforme în Workspace.TeleportPads care trimit jucătorii la platforma din atributul lor Destination, cu un cooldown de 2 secunde, un meniu Teleport pentru punctele din Workspace.TeleportSpots, unde Castle cere 3 Wins verificate pe server, și portaluri în Workspace.PlacePortals care trimit jucătorii în place-ul cu ID-ul din atributul lor PlaceId, cu reîncercări.
- Îți poate parcurge place-ul când un pas are nevoie, prin Search Game și Search Scripts, ca să se bazeze pe obiectele, remote-urile sau codul de salvare existente, în loc să adauge un al doilea sistem
- Creează folderele și parts-urile platformelor prin Create Instance, le setează proprietățile prin Set Property și scrie Teleporters și TeleportMenu prin Create Script
- Are instrucțiunea să verifice compilarea fiecărui script scris prin Check Script, care îl compilează în Studio fără să-l ruleze
- Trimite schimbările în pachete, iar fiecare pachet este un punct de undo în istoricul Studio
Teleporturile între place-uri merg doar în jocul publicat, așa că verifică-le singur în aplicația Roblox. Cu pluginul 3.9 sau mai nou RoCode poate porni un playtest scurt și poate citi erorile, iar cu pluginul 3.9.15 sau mai nou personajul lui de test poate păși pe platforme și apăsa butoanele meniului, dar verifică doar ce a decis singur să testeze, așa că pășește pe platforme și deschide meniul tu însuți. Teleportul este un sistem dintre multe dintr-un joc; crearea unui joc întreg cu RoCode merge la fel, câte un sistem pe prompt. Cum se conectează RoCode la Studio.
Întrebări frecvente
Cum fac o platformă de teleport în Roblox Studio?
Dă la două parts un atribut Destination cu numele celuilalt și lasă un singur script de server să-l mute pe cel care atinge platforma prin character:PivotTo într-un punct chiar în fața celeilalte platforme, cu un cooldown scurt per jucător. Pasul 1 și pasul 2 construiesc exact asta.
De ce nu merge teleportul meu în Studio?
Platformele și meniul merg în Studio. Teleporturile spre alt place nu: TeleportService din Roblox nu suportă playtestul din Studio, așa că publică jocul și testează în aplicația Roblox. Scriptul din acest ghid afișează, în locul teleportului, ce ar fi făcut portalul, așa că poți verifica oricum că se declanșează.
Cum teleportez jucătorii în alt place al jocului meu?
Adaugă place-ul prin File > Publish As (Add as a new place), copiază-i place ID-ul din Asset Manager și apelează TeleportService:TeleportAsync(placeId, { player }) dintr-un Script de server în interiorul unui pcall, reîncercând la eșec. Pasul 4 te trece prin toate acestea.
Cum fac un GUI de teleport?
Construiește butoanele într-un LocalScript și trimite-i serverului doar numele punctului ales de jucător. Serverul caută numele într-un folder, verifică cooldown-ul și orice regulă de deblocare, apoi mută personajul. Nu trimite niciodată o poziție de pe client: un trișor poate trimite orice.
De ce personajul meu se blochează sau se dezmembrează după teleport?
Atribuirea lui Position pentru part-ul rădăcină mută doar acel part, fără corpul îmbinat cu el, iar copierea CFrame-ului platformei pune mijlocul personajului în interiorul platformei. Folosește character:PivotTo cu un punct la înălțimea în picioare deasupra podelei, calculată din HipHeight-ul Humanoid-ului.
Pot trimite monede sau obiecte odată cu teleportul?
În siguranță, nu. Roblox spune că teleport data sunt vizibile clientului și nu sunt criptate, așa că sunt bune pentru ceva precum harta aleasă, dar nu pentru monede. Salvează monedele și obiectele într-un data store și încarcă-le în celălalt place.
Surse și lecturi suplimentare
- Roblox Creator Docs: Teleport between places (în engleză). TeleportAsync, playtesturi în Studio, Access Control for Places, ecrane de teleport, teleport data și teleporturi eșuate
- Roblox Creator Docs: TeleportService (în engleză). Teleport învechit, TeleportAsync doar pe server și TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (în engleză). funcția principală pentru mutarea modelelor din scripturi
- Roblox Creator Docs: BasePart.Position (în engleză). de ce setarea lui Position la un part îmbinat îl deplasează față de celelalte
- Roblox Creator Docs: Humanoid.HipHeight (în engleză). la ce înălțime se află part-ul rădăcină al unui personaj în picioare, pentru rig-urile R15 și R6
- Roblox Creator Docs: Seat (în engleză). SeatWeld, care ține personajul așezat, și distrugerea lui ca să ridici personajul
- Roblox Creator Docs: Player:RequestStreamAroundAsync (în engleză). cererea unei zone înainte ca personajul să se mute acolo, fără garanția a ce ajunge
- Roblox Creator Docs: Streaming techniques and conversion (în engleză). streaming anticipat înainte de un teleport
- Roblox Creator Docs: Access control and confidentiality (în engleză). de ce clienții pot ajunge în orice place al jocului dacă teleporturile nu sunt securizate
- Roblox Creator Docs: Network ownership, movement validation, and physics (în engleză). ce poate face clientul cu personajul lui și excepțiile pentru teleporturi în verificările de mișcare
- Roblox Creator Docs: Create and publish games and places (în engleză). publicarea, cine poate deschide un joc nou și adăugarea unui place prin Publish As
- Roblox Creator Docs: Asset Manager (în engleză). cum copiezi un place ID
- Roblox Creator Docs: Developer Console (în engleză). vederea Server din log și cine o vede
- Roblox Creator Docs: Debounce patterns (în engleză). de ce Touched se declanșează de mai multe ori pentru o singură atingere
Cum a fost verificat codul: fiecare script de pe această pagină trece printr-o verificare strictă a tipurilor Luau cu definițiile API Roblox (luau-lsp, 20 noiembrie 2026). Verificarea tipurilor prinde nume greșite de API și tipuri greșite, dar nu și greșelile de logică a jocului, așa că testează totul în Studio înainte să publici.