Poradnik · Systemy gry

Jak zrobić teleport w Roblox Studio

Teleport w Roblox to jedno z dwojga: przeniesienie postaci w inne miejsce na tym samym serwerze albo wysłanie gracza do innego place twojej gry. W tym poradniku składamy oba warianty z jednego skryptu serwera: platformy, które wysyłają cię do platformy do pary, menu Teleport, w którym zamknięte miejsca otwierają się za Wins, i portale do innego place, które ponawiają próbę, gdy teleport Roblox się nie uda.

Zaktualizowano 20 listopada 202620 min czytaniaAutor:

W skrócie

Dla platformy teleportu włóż Script do ServerScriptService, który nasłuchuje zdarzenia Touched platformy, znajduje gracza przez Players:GetPlayerFromCharacter i przenosi całą postać przez character:PivotTo() w punkt tuż przed platformą docelową, plecami do niej, z cooldownem kilku sekund na gracza, żeby platforma docelowa nie odesłała go od razu z powrotem. Żeby wysłać graczy do innego place twojej gry, wywołaj TeleportService:TeleportAsync(placeId, { player }) ze Script na serwerze wewnątrz pcall; działa to tylko w opublikowanej grze, nie w Studio.

  • Przenoś całą postać przez PivotTo. Przypisanie HumanoidRootPart.Position odsuwa główny part od reszty ciała, bo przy ustawianiu Position Roblox aktualizuje połączenia.
  • Menu teleportu powinno wysyłać serwerowi nazwę miejsca docelowego, a nie pozycję. Serwer sprawdza nazwę, cooldown i każdą zasadę odblokowania, zanim kogokolwiek przeniesie.
  • TeleportService:Teleport() jest przestarzały i działa na kliencie. Używaj TeleportAsync na serwerze, opakowuj go w pcall, ponawiaj próbę i obsługuj TeleportInitFailed.
Na tej stronie
  1. Jak to działa
  2. 1. Platformy
  3. 2. Skrypt teleportu
  4. 3. Menu teleportu
  5. 4. Inne place
  6. Starsze poradniki
  7. Granice ochrony
  8. 5. Sprawdzenie
  9. Rozszerzenia
  10. Common errors
  11. Z RoCode
  12. Najczęstsze pytania
  13. Źródła i dalsza lektura

Dwa rodzaje teleportu

IlustracjaDotknięcie PadA stawia cię tuż przed PadB, więc PadB nie odsyła cię od razu z powrotem, a serwer odmawia zamkniętego miejsca Castle, ale przenosi cię na Lake.

Teleport w grze Roblox może oznaczać trzy rzeczy: platformę, która przenosi cię przez mapę, menu miejsc, do których można skoczyć, albo portal na inny poziom. Pierwsze dwa przenoszą postać w obrębie serwera, na którym gracz już jest. Trzeci wysyła gracza do innego place twojej gry, który działa na własnych serwerach. Używają różnych API, więc warto wiedzieć, którego potrzebujesz.

Dwa rodzaje teleportu
W obrębie tego samego serweraDo innego place twojej gry
Wywołaniecharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Do czegoPlatformy teleportu, menu teleportu, przenoszenie graczy z lobby na arenęPortale na inny poziom, lobby, które wysyła graczy do osobnego place z lochem albo meczem
Gdzie działaScript na serwerzeTylko Script na serwerze. Kliencki Teleport() jest przestarzały.
Działa w playteście StudioTakNie. TeleportService w Roblox nie obsługuje playtestu w Studio, więc testuje się w opublikowanej grze.
Co widzi graczSkok przez mapę, który może potrwać do 2 sekund, jeśli ten obszar trzeba najpierw wczytaćEkran ładowania Roblox, potem inny place
Monety, przedmioty i inne daneZostają bez zmianRoblox czyści lokalne dane gracza, więc wszystko ważne musi przychodzić z magazynu danych w drugim place

W tym poradniku wszystkie trzy rodzaje są zebrane w jednym Script na serwerze, więc jeden zestaw zasad obejmuje każdy teleport w twojej grze: decyduje serwer, każdy gracz ma własny cooldown, a urządzenie gracza tylko mówi, do którego miejsca chciałby trafić.

Z czego składa się teleport
ElementGdzie jestCo robi
Folder TeleportPads z PadA i PadBWorkspaceDwie platformy. Atrybut Destination każdej z nich wskazuje platformę, do której wysyła graczy.
Folder TeleportSpotsWorkspacePo jednym parcie na każde miejsce z listy menu. Atrybut WinsNeeded zamyka miejsce.
Folder PlacePortalsWorkspaceParty portali. Atrybut PlaceId każdego portalu to place, do którego wysyła graczy.
Script TeleportersServerScriptServiceObsługuje wszystkie trzy rodzaje teleportu i tworzy dwa remote. Jedyne miejsce, gdzie może dojść do teleportu.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsRysuje przycisk Teleport i listę miejsc i wysyła nazwę miejsca, które wybrał gracz.
RemoteFunction GetTeleportSpots i RemoteEvent TeleportRequestReplicatedStorage (tworzy je Teleporters)Pierwszy zwraca menu listę miejsc. Drugi niesie wybraną nazwę na serwer.
Explorer, gdy teleport jest gotowy. Teleporters dodaje GetTeleportSpots i TeleportRequest do ReplicatedStorage, gdy gra działa.
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

Krok 1: złóż dwie platformy teleportu

  1. W Explorerze najedź na Workspace, kliknij przycisk + i wstaw Folder. Nazwij folder TeleportPads. Skrypt szuka dokładnie tej nazwy.
  2. Wstaw do folderu dwa Part i nazwij je PadA i PadB. Zrób z każdego płaską płytę, na przykład 6 na 1 na 6 studów, i postaw je na podłodze w pewnej odległości od siebie. W oknie Properties zaznacz Anchored, zostaw włączone CanCollide i CanTouch i ustaw jaskrawy kolor oraz materiał Neon, żeby gracze je zauważali.
  3. Zaznacz PadA, przewiń okno Properties do sekcji Attributes i kliknij +. Wpisz nazwę Destination, wybierz typ String i kliknij Save, potem ustaw wartość PadB. Zrób to samo na PadB z wartością PadA.
  4. Obróć każdą platformę tak, żeby jej przednia ściana patrzyła na wolną podłogę. Gracze pojawiają się 3 study przed przednią ścianą platformy docelowej, plecami do niej, więc zostaw tam kilka studów wolnej podłogi. Żeby zobaczyć, która ściana jest przednia, kliknij platformę prawym przyciskiem i wybierz Show Orientation Indicator: przednią ścianę zaznacza niebieska linia. Obracaj platformę narzędziem Rotate, aż ta linia wskaże, w którą stronę gracze mają odchodzić.

Gracze lądują obok platformy, a nie na niej, celowo. Strona Roblox o debounce zaznacza, że Touched odpala się wiele razy z rzędu przy jednym dotknięciu, więc gracz, który pojawiłby się prosto na drugiej platformie, uruchomiłby ją znowu, gdy tylko skończy się jego cooldown, i poleciałby z powrotem przez mapę.

Nie jesteś ograniczony do dwóch platform. Destination platformy może wskazywać dowolny part w TeleportPads, więc trzy platformy mogą wysyłać graczy w kółko. Dla platformy jednokierunkowej skieruj ją na part w TeleportPads, który nie ma własnego Destination: taki part przyjmuje graczy i nikogo nigdzie nie wysyła.

Krok 2: dodaj skrypt teleportu

Najedź na ServerScriptService, wstaw Script, nazwij go Teleporters i wklej do niego kod poniżej. Na razie obsługuje platformy, a po kolejnych krokach także menu i portale, więc dodajesz go jeden raz. Ustawienia na początku to linie, które masz zmieniać.

Script w ServerScriptService o nazwie Teleporters
-- Script w ServerScriptService o nazwie Teleporters.
-- O każdym teleporcie decyduje się tutaj, na serwerze:
--   1. Platformy: dotknięcie partu w Workspace.TeleportPads przenosi cię do partu wskazanego
--      w jego atrybucie Destination.
--   2. Menu: LocalScript TeleportMenu prosi o miejsce z Workspace.TeleportSpots
--      po nazwie. Serwer sprawdza nazwę, cooldown i Wins potrzebne do miejsca.
--   3. Portale: dotknięcie partu w Workspace.PlacePortals wysyła cię do place
--      z jego atrybutu PlaceId (innego place tej gry).

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 -- tak długo platformy ignorują gracza po każdym teleporcie
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studów przed platformą docelową, żeby gracze lądowali obok niej
local PLACE_ATTEMPTS = 3

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

-- Ten skrypt sam tworzy oba remote, więc nie dodawaj ich ręcznie
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

-- Na jakiej wysokości nad podłogą jest główny part stojącej postaci.
-- Wzór z dokumentacji Roblox o Humanoid.HipHeight (w rigach R6 dochodzi wysokość nogi).
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() -- ustawiamy przed czekaniem, żeby drugie dotknięcie nie uruchomiło drugiego teleportu

	-- Patrzymy tam, gdzie skierowana jest przednia ściana miejsca docelowego (prosto, bez nachylenia)
	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
	-- Stajemy na jej górnej ścianie: pivot postaci to jej główny part, więc podnosimy go na wysokość stania.
	-- Platforma za to stawia graczy kilka studów przed sobą, bo gracz stojący
	-- na platformie uruchomiłby ją znowu następnym krokiem.
	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)

	-- Przy włączonym instance streaming najpierw wczytujemy obszar wokół miejsca docelowego (do 2 sekund)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- wyszedł, odrodził się albo zginął, gdy obszar się wczytywał
	end
	-- Siedząca postać jest przyspawana do siedzenia, a jej przeniesienie pociągnęłoby siedzenie za sobą.
	-- Zniszczenie SeatWeld najpierw uwalnia postać z siedzenia.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Po przybyciu uruchamiamy cooldown od nowa: wczytywanie wyżej może potrwać do 2 sekund,
	-- a platforma, obok której wylądował gracz, nie powinna od razu odesłać go z powrotem
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- dla skryptu sprawdzania prędkości, jeśli go masz
end

-- 1. Platformy
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 -- ostrzegamy raz, a nie przy każdym dotknięciu
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Menu: lista miejsc, potem żądanie po nazwie
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 -- takie same Wins: alfabetycznie, żeby kolejność nigdy się nie zmieniała
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- Klient wysyła tylko nazwę. Nigdy nie przyjmuj od klienta pozycji ani 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 -- zamknięte dla tego gracza
	end
	teleportTo(player, spot, false)
end)

-- 3. Portale do innego place tej gry
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- już w drodze albo dotykał teleportu sekundę temu
	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 -- poddajemy się; nowe dotknięcie portalu próbuje znowu
end

-- Teleport może się nie udać także po starcie. Gracz zostaje tutaj i może spróbować znowu.
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 sam tworzy RemoteFunction GetTeleportSpots i RemoteEvent TeleportRequest, więc nie musisz niczego ręcznie wstawiać do ReplicatedStorage. Podłącza platformy z TeleportPads i portale z PlacePortals jeden raz, przy starcie serwera, więc platformy i portale dodane w trakcie gry nic nie robią. Jeśli któregoś folderu nie ma, ten rodzaj teleportu jest po prostu wyłączony.

Co robi każda część Teleporters
CzęśćCo robiPo co
playerFromHitZnajduje model postaci, do którego należy dotykający part, i pyta Players:GetPlayerFromCharacter, czyj on jest.Platform dotykają stopy, czapki i luźne party. Wszystko, co nie jest częścią postaci gracza, daje nil i jest ignorowane.
onCooldownPorównuje os.clock() z czasem ostatniego teleportu gracza.Jeden cooldown na gracza, więc gracz stojący przy platformie nigdy nie blokuje innych. Nic nie czeka ani nie śpi.
rootHeightLiczy, na jakiej wysokości nad podłogą jest główny part stojącej postaci: połowa wysokości głównego partu plus HipHeight Humanoida, plus długość nogi w rigach R6.To wzór z dokumentacji Roblox o Humanoid.HipHeight. Pivot postaci to jej główny part, więc podniesienie pivota o tę wartość stawia stopy na powierzchni i u małych, i u dużych awatarów, i w R6.
Sprawdzenia na początku teleportToKończy, jeśli gracz nie ma żywej postaci z głównym partem, a potem od razu zapisuje czas.Zapytanie streamingu niżej może kazać skryptowi czekać. Jeśli zapisać czas wcześniej, liczne zdarzenia Touched w tym momencie nie uruchomią drugiego teleportu.
Punkt przybyciaGórna ściana miejsca docelowego, podniesiona o rootHeight, z kierunkiem patrzenia tam, gdzie patrzy jej przednia ściana, bez nachylenia. Dla platformy punkt jest dodatkowo przesunięty o 3 study od jej przedniej ściany.Postać pojawia się na stojąco, a nie w środku docelowego partu. Obok platformy jej stopy zaczynają na wysokości jej górnej ściany, więc opada na podłogę o grubość platformy. CFrame.lookAlong buduje CFrame w pozycji z zadanym kierunkiem patrzenia.
RequestStreamAroundAsyncProsi Roblox, żeby najpierw wysłał temu graczowi obszar wokół punktu przybycia, i czeka najwyżej 2 sekundy.Instance streaming jest domyślnie włączony w nowych place, więc daleka część mapy może jeszcze nie być wczytana na urządzeniu gracza. Roblox zaleca to wywołanie na serwerze przed przeniesieniem postaci daleko, choć nie gwarantuje, co dokładnie dotrze.
Drugie sprawdzenieJeśli gracz wyszedł, a postać odrodziła się albo zginęła w czasie czekania, nic się nie rusza.Gracz mógł zrobić reset albo wyjść z gry, gdy obszar się wczytywał. Własny przykład wczytywania od Roblox też sprawdza, czy postać wciąż jest w grze, zanim ją ruszy.
Linie z SeatWeldJeśli postać siedzi, niszczy Weld, który trzyma ją na siedzeniu.Roblox przyspawa siedzącą postać do siedzenia. PivotTo rusza party, zmieniając ich CFrame, a dokumentacja Roblox mówi, że ustawienie CFrame partu rusza też połączone z nim party, więc bez tego siedzenie i wszystko, co jest do niego przyspawane, przybyłoby razem z graczem. Zniszczenie SeatWeld to sposób, w jaki dokumentacja Roblox o Seat podnosi postać z siedzenia ze skryptu.
character:PivotTo(target)Przenosi całą postać, wszystkie kończyny i akcesoria razem, do punktu przybycia.Roblox nazywa PivotTo główną funkcją do przesuwania modeli ze skryptów.
Druga linia z lastTeleportUruchamia cooldown od nowa po przybyciu.Zapytanie streamingu może potrwać do 2 sekund, tyle samo co cooldown platformy, więc bez tej linii gracz mógłby przybyć z już wygasłym cooldownem.
MovementCheckSkipUstawia atrybut na Player po każdym przeniesieniu.Sprawdzanie prędkości na serwerze wzięłoby skok za oszustwo. MovementCheck z poradnika o sprincie czyta ten atrybut i zaczyna mierzyć od nowa z nowej pozycji. Bez takiego skryptu atrybut nic nie robi.
Ustawienia na początku Teleporters
UstawienieWartość tutajCo zmienia
PAD_COOLDOWN_SECONDS2Jak długo platformy i portale ignorują gracza po każdym teleporcie.
MENU_COOLDOWN_SECONDS3Najkrótszy odstęp między dwoma teleportami przez menu dla jednego gracza. Platformy i menu mają wspólny zegar na gracza, więc żądanie z menu w ciągu 3 sekund po teleporcie z platformy też jest ignorowane.
PAD_ARRIVAL_GAP3Ile studów od przedniej ściany platformy docelowej pojawiają się gracze, żeby lądowali obok platformy, a nie na niej.
PLACE_ATTEMPTS3Ile razy portal próbuje TeleportAsync w odstępach 2 sekund, zanim się podda.

Kliknij Play od razu i stań na PadA: pojawisz się przed PadB. Menu i portale potrzebują dwóch kolejnych kroków, ale skrypt działa już bez nich.

Krok 4: teleport do innego place

Place to osobny świat w twojej grze, z własnymi serwerami: lobby i loch albo hub i zestaw poziomów. Gracze przechodzą między place przez TeleportService, a Roblox uruchamia go tylko w opublikowanej grze, więc ten krok kończy się w aplikacji Roblox, a nie w Studio.

  1. Jeśli gra nie jest jeszcze opublikowana, wybierz File > Publish. Nowe gry, dopóki ich nie wydasz, są otwarte tylko dla ciebie, osób, którym dałeś dostęp Edit, i członków grupy z odpowiednimi rolami, a do własnego testu teleportów to wystarczy.
  2. Utwórz drugi place: otwórz nowy place z dowolnego szablonu Studio, zbuduj swój loch, potem wybierz File > Publish As, kliknij kafelek swojej gry, wybierz Add as a new place i kliknij Create.
  3. Skopiuj ID nowego place. Otwórz Asset Manager z menu Window albo z karty Home, przejdź do Places In Experience, kliknij place prawym przyciskiem i wybierz Copy Asset ID, to skopiuje jego place ID.
  4. Po powrocie do pierwszego place wstaw do Workspace Folder o nazwie PlacePortals, a w nim zakotwiczony Part o nazwie DungeonPortal. Dodaj atrybut typu Number o nazwie PlaceId i wklej ID jako jego wartość.
  5. Kliknij Play i dotknij portalu. Output wypisuje linię, która zaczyna się od Teleporters: would send: w Studio portal nic więcej nie robi.
  6. Opublikuj grę ponownie przez File > Publish, żeby portal pojawił się w opublikowanej grze, i sprawdź go z aplikacji Roblox, jak w kroku 5.

Teleporters wywołuje TeleportAsync wewnątrz pcall, do 3 razy z przerwą 2 sekund między próbami, bo strona Roblox o teleportach mówi, że teleporty mogą się nie udawać i zgłaszać błąd, i zaleca ponawianie prób. Teleport może też się zacząć i nie udać w ostatniej chwili bez błędu, zostawiając gracza tam, gdzie był. Na ten przypadek Roblox wywołuje TeleportInitFailed, a skrypt zdejmuje z gracza flagę „wychodzi”, więc nowe dotknięcie portalu próbuje znowu.

Żeby zawracać graczy, zrób to samo w drugim place: włóż kopię Teleporters do jego ServerScriptService i dodaj portal, którego PlaceId to ID twojego pierwszego place, skopiowane z Asset Manager w ten sam sposób.

Kto może wejść do twoich innych place

Dokumentacja Roblox o bezpieczeństwie ostrzega: gdy tylko klient znajdzie się w jednym place twojej gry, może się teleportować do każdego innego jej place, jakąkolwiek trasę zaplanowałeś, a wyłączenie Direct Access w place usuwa tylko przycisk Join na stronie. Zmienia to ustawienie Access Control for Places w sekcji Audience > Access Settings w Creator Dashboard:

Trzy wartości Access Control for Places
UstawienieKto może wejść do place, który nie jest startowy
Fully openKażdy, przez teleporty z dowolnej gry, deep linki, zaproszenia do gry i dołączanie do znajomego.
Limited to same universeTylko gracze, którzy teleportują się z twoich gier. Dozwolone są teleporty zarówno z klienta, jak i z serwera.
Secure within universe onlyTylko gracze, których teleportują twoje skrypty serwera z tej gry.

Jeśli gracze mają trafiać do place tylko przez twój portal, na przykład do lochu, wybierz Secure within universe only. Każdy teleport w tym poradniku zaczyna się na serwerze, więc będzie dalej działał. Roblox mówi też, że wiele gier nie potrzebuje zabezpieczonych teleportów, więc gra, której wszystkie place są otwarte dla wszystkich, może zostawić ustawienie bez zmian.

W czym mylą się starsze poradniki o teleportach

Jeśli porównujesz ten poradnik z filmem albo postem na forum, oto ważne różnice i powód, dla którego każdy sposób tworzy problem.

Częste sposoby w poradnikach o teleportach i co ten poradnik robi zamiast nich
PoradnikProblemTen poradnik
Ustawia hit.Parent.HumanoidRootPart.Position = target.PositionDokumentacja Roblox mówi, że ustawienie Position aktualizuje połączenia partu i przesuwa go względem partów, z którymi jest połączony: główny part odjeżdża bez ciała.Przenosi całą postać przez PivotTo.
Ustawia HumanoidRootPart.CFrame = target.CFrameŚrodek postaci ląduje w środku docelowego partu, częściowo w nim, i przejmuje nachylenie partu.Postać pojawia się na wysokości stania nad górną ścianą, obok platformy, bez nachylenia.
Używa jednej zmiennej debounce na całą platformęGdy teleportuje się jeden gracz, platforma ignoruje wszystkich pozostałych. A zupełnie bez debounce gracz, który pojawi się na drugiej platformie, od razu wraca z powrotem.Jeden cooldown na gracza, zapisany przed jakimkolwiek czekaniem, a gracze pojawiają się obok platformy.
Wywołuje TeleportService:Teleport(placeId, player) z LocalScriptRoblox oznacza Teleport() jako przestarzały, radzi nie używać go w nowych projektach i pozwala na TeleportAsync tylko ze skryptów serwera.Wywołuje TeleportAsync w skrypcie serwera.
Brak pcall, brak ponownych próbStrona Roblox o teleportach mówi, że mogą się nie udawać i zgłaszać błąd, a także nie udać się już po starcie.Do 3 prób w pcall, a TeleportInitFailed pozwala graczowi spróbować znowu.
Poddaje się, bo w Studio „nie działa”TeleportService nie obsługuje playtestu w Studio.RunService:IsStudio() zamiast tego wypisuje, co zrobiłby portal.
GUI teleportu, którego przyciski wysyłają pozycjęOszust może wywołać ten sam remote z dowolną pozycją.Przyciski wysyłają nazwę miejsca, a serwer jej szuka.
Monety przekazywane w teleport dataRoblox mówi, że teleport data są widoczne dla klienta i nie są szyfrowane.Radzi trzymać monety i Wins w magazynie danych i wczytywać je w drugim place (zobacz Jak przenieść dane do innego place).

Co gracze mogą, a czego nie mogą podrobić

Załóż, że oszust kontroluje wszystko na swoim urządzeniu: może przerabiać TeleportMenu, wywoływać oba remote dowolnie wiele razy z dowolnymi argumentami i ruszać swoją postacią. Oto co mu to daje przy tym teleporcie.

Czego może spróbować oszust i co z tym robi Teleporters
Oszust próbujeWynikDlaczego
Wysłać pozycję albo CFrame przez remote menuIgnorowaneTeleportRequest czyta jeden napis, nazwę miejsca o długości do 50 znaków. Wszystko inne jest odrzucane.
Zażądać Castle bez 3 WinsOdmowaSerwer czyta Wins ze swojej kopii leaderstats. Szary przycisk to tylko podpowiedź.
Zażądać miejsca, które nie istniejeIgnorowaneSerwer szuka nazwy w TeleportSpots i nic nie robi, jeśli nie ma partu o tej nazwie.
Wywoływać remote menu raz za razemNajwyżej jeden teleport przez menu co 3 sekundyCooldown jest trzymany na serwerze, osobno dla każdego gracza.
Uruchomić platformę, nie podchodząc do niejTrafia do platformy do pary, do której i tak mógł dojśćRoblox wymienia teleport w dowolne miejsce i manipulowanie zdarzeniami Touched wśród tego, co klient może robić ze swoją postacią.
Wejść bezpośrednio do innego place twojej gryMożliwe, jeśli Access Control for Places nie jest ustawione na Secure within universe onlyZobacz Kto może wejść do twoich innych place.
Przesunąć swoją postać gdziekolwiek, także na zamknięte miejsceMożliweKażde urządzenie steruje ruchem swojej postaci. Zamknięte miejsce to wygoda, a nie sejf, więc sprawdzaj na serwerze, zanim dasz tam coś cennego.

Ostatni wiersz to uczciwa granica każdego teleportu. W grze rywalizacyjnej dodaj sprawdzanie ruchu na serwerze, jak w poradniku o sprincie. Teleporters już ustawia atrybut MovementCheckSkip, który czyta to sprawdzanie, więc jego własne teleporty nie są oznaczane jako naruszenie: dokumentacja Roblox o bezpieczeństwie mówi, że gry z uprawnionymi teleportami potrzebują właśnie takiego wyjątku w sprawdzaniu ruchu.

Krok 5: sprawdź

  1. Kliknij Play. Stań na PadA: pojawiasz się tuż przed PadB, plecami do niej. Odwróć się i od razu stań na PadB: nic się nie dzieje, bo platformy ignorują cię przez 2 sekundy po przybyciu. Zejdź, odczekaj 2 sekundy i znowu wejdź na PadB: pojawiasz się przed PadA.
  2. Odczekaj kilka sekund, potem kliknij Teleport po lewej stronie ekranu. Na liście widać Lake, Spawn i szare "Castle (needs 3 wins)". Wybierz Lake: pojawiasz się na nim. Otwórz menu znowu i wybierz Castle: nic się nie dzieje, a w Output jest cicho.
  3. Daj sobie 3 Wins (do tego potrzebny jest skrypt leaderstats z IntValue Wins, na przykład z poradnika o tablicy wyników). Kliknij przełącznik Client/Server, żeby przejść na Server, znajdź w Explorerze Players, swoją nazwę, leaderstats, Wins i ustaw jego Value na 3 w oknie Properties. Przełącz z powrotem na Client i znowu otwórz menu: Castle zrobiło się fioletowe i przenosi cię tam.
  4. Dotknij DungeonPortal. Output wypisuje linię, która zaczyna się od Teleporters: would send, z twoją nazwą i place ID. W Studio tak ma być, a wypisuje się nie częściej niż raz na 2 sekundy, niezależnie od tego, jak długo stoisz na portalu.
  5. Wybierz Server & Clients z rozwijanej listy trybów testu, ustaw 2 klientów i kliknij Play. Obaj gracze mogą korzystać z platform jednocześnie, a cooldown jednego nigdy nie blokuje drugiego.
  6. Zatrzymaj test, opublikuj grę i uruchom ją z aplikacji Roblox. Dotknij portalu: pojawia się ekran ładowania Roblox i lądujesz w drugim place. Jeśli zostałeś na miejscu, otwórz Developer Console klawiszem F9, przełącz log na widok Server, który widzą tylko właściciel gry i członkowie grupy z prawem edycji, i znajdź ostrzeżenia Teleporters:, w których jest powód podany przez Roblox.

Podczas kroków w Studio trzymaj otwarte okno Output (menu Window, potem Output). Gdy Teleporters działa, nic nie wypisuje oprócz linii portalu z kroku 4, więc każde ostrzeżenie albo czerwony błąd warto przeczytać. Zobacz Częste błędy.

Jak rozbudować

Teleport drużyny albo party razem

TeleportAsync przyjmuje listę graczy, więc jeden portal może wysłać do jednego place całą grupę. Strona Roblox o teleportach proponuje wyjść od gracza, który dotknął portalu: player.Team i Team:GetPlayers() dla drużyny albo SocialService:GetPlayersByPartyId() z player.PartyId dla party. Przekaż tę listę zamiast { player } i ustaw flagę leavingForPlace każdemu graczowi z niej.

Wysyłanie grupy na własny serwer

Domyślnie teleportowani gracze trafiają na publiczny serwer drugiego place. Żeby wysłać grupę na nowy zarezerwowany serwer, na przykład na mecz, utwórz TeleportOptions, ustaw jego ShouldReserveServer na true i przekaż jako trzeci argument: TeleportService:TeleportAsync(placeId, players, options). Roblox zaznacza, że przy awariach związanych właśnie z zarezerwowanymi serwerami ponowne próby są szczególnie przydatne, a skrypt już je robi.

Jak przenieść dane do innego place

Teleportacja czyści wszystkie lokalne dane tego gracza. Teleport data w Roblox, które ustawia się przez TeleportOptions:SetTeleportData() i czyta w drugim place przez player:GetJoinData(), są widoczne dla klienta i nie są szyfrowane, więc używaj ich tylko do niegroźnych wyborów, na przykład którą mapę wczytać. Monety, Wins i przedmioty trzymaj w magazynie danych, jak w poradniku o DataStore, i wczytuj je ponownie, gdy gracz przybywa do drugiego place.

Własny ekran ładowania

Gdy wczytuje się teleport do place, gracze widzą standardowy ekran ładowania Roblox. Żeby pokazać własny, wywołaj na kliencie TeleportService:SetTeleportGui() ze ScreenGui, na przykład z tym, który leży w ReplicatedStorage. Teleporty w tym poradniku zaczynają się na serwerze, więc klient musi wywołać go zawczasu, na przykład gdy tylko gracz wejdzie. Roblox mówi, że ekran trzeba ustawiać od nowa przed każdym teleportem i że nie jest używany dla place w innej grze. Zaznacza też, że skrypty w tym ScreenGui się nie uruchamiają, więc rób go statycznym.

Teleporty rund i checkpointy

System rund na początku każdej rundy przenosi wszystkich graczy na arenę takim samym wywołaniem PivotTo, a sekcja PivotTo czy SpawnLocation w poradniku o obby porównuje to podejście z punktami spawnu Roblox. Jeśli miejsce ma się otwierać dopiero po rundzie, system rund już przyznaje Wins, które czyta WinsNeeded.

Częste błędy i rozwiązania

Otwórz okno Output (menu Window, potem Output) przed kliknięciem Play. Teleporters podaje nazwę platformy, gdy Destination wskazuje donikąd, więc większość problemów widać właśnie tam.

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

TeleportMenu czeka na remote, który tworzy Teleporters, więc Teleporters nie działa. Sprawdź, czy to Script, a nie LocalScript, czy leży bezpośrednio w ServerScriptService, nie jest wyłączony i czy w Output nie ma od niego czerwonego błędu. Poradnik o błędach skryptów szczegółowo wyjaśnia to ostrzeżenie.

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

Atrybut Destination platformy wskazuje coś, co nie jest partem bezpośrednio w folderze TeleportPads. Sprawdź pisownię i wielkie litery w wartości atrybutu i w nazwie platformy docelowej. Ostrzeżenie pojawia się raz na platformę, gdy gracz dotknie jej pierwszy raz.

Staję na platformie i nic się nie dzieje

Sprawdź, czy folder nazywa się dokładnie TeleportPads i leży bezpośrednio w Workspace przy starcie gry, czy atrybut Destination platformy ma typ String (atrybut typu Number jest ignorowany) i czy od twojego ostatniego teleportu minęły 2 sekundy. Sprawdź też, czy platforma ma włączone CanTouch: Roblox mówi, że podłączenie Touched do partu z wyłączonym CanTouch zgłasza błąd, a ten zatrzymuje skrypt.

Pojawiam się w ścianie albo spadam z krawędzi

Gracze pojawiają się 3 study przed przednią ścianą platformy docelowej. Kliknij platformę prawym przyciskiem, wybierz Show Orientation Indicator i obracaj platformę, aż niebieska linia wskaże wolną podłogę. Miejsca z menu stawiają graczy na wierzchu partu, więc trzymaj każde miejsce na podłodze.

Przycisk Castle zostaje szary, choć zdobyłem 3 Wins

Lista rysuje się przy otwarciu menu, więc zamknij menu i otwórz je znowu. Jeśli przycisk wciąż jest szary, sprawdź, czy w leaderstats jest IntValue o nazwie dokładnie Wins i czy Wins zmieniły się na serwerze, a nie tylko w trybie Client.

Portal nic nie robi w opublikowanej grze

Otwórz Developer Console klawiszem F9, przełącz log na widok Server (widzą go tylko właściciel gry i członkowie grupy z prawem edycji, bo Teleporters to Script na serwerze) i przeczytaj ostrzeżenia Teleporters:, w których jest powód podany przez Roblox. Sprawdź, czy atrybut PlaceId portalu ma typ Number i zawiera ID z Asset Manager oraz czy opublikowałeś place ponownie po dodaniu portalu.

Zrób to z RoCode

Jeśli nie chce ci się składać tego wszystkiego ręcznie, RoCode może to zrobić w grze, którą masz otwartą. RoCode to niezależny agent AI do Roblox Studio, nie robi go Roblox: opisujesz funkcję na jego czacie w przeglądarce, a jego plugin do Studio tworzy party i skrypty w twoim Explorerze, więc nie musisz kopiować kodu z okna czatu.

Ty piszesz

Dodaj teleporty: platformy w Workspace.TeleportPads, które wysyłają graczy do platformy z własnego atrybutu Destination z cooldownem 2 sekundy, menu Teleport dla miejsc w Workspace.TeleportSpots, gdzie Castle wymaga 3 Wins ze sprawdzaniem na serwerze, i portale w Workspace.PlacePortals, które wysyłają graczy do place o ID z własnego atrybutu PlaceId, z ponownymi próbami.

RoCode robi
  • Może przejrzeć twój place, gdy krok tego wymaga, przez Search Game i Search Scripts, żeby oprzeć się na istniejących przedmiotach, remote albo kodzie zapisu, a nie dodawać drugiego systemu
  • Tworzy foldery i party platform przez Create Instance, ustawia ich właściwości przez Set Property i pisze Teleporters i TeleportMenu przez Create Script
  • Ma polecenie sprawdzać kompilację każdego napisanego skryptu przez Check Script, który kompiluje go w Studio bez uruchamiania
  • Wysyła zmiany paczkami, a każda paczka to punkt cofania w historii Studio

Teleporty między place działają tylko w opublikowanej grze, więc sprawdź je sam w aplikacji Roblox. Z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.15 lub nowszym jego testowa postać może stawać na platformach i naciskać przyciski menu, ale sprawdza tylko to, co sam postanowił przetestować, więc stań na platformach i otwórz menu sam. Teleport to jeden system z wielu w grze; tworzenie całej gry z RoCode idzie tak samo, po jednym systemie na prompt. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Jak zrobić platformę teleportu w Roblox Studio?

Daj dwóm partom atrybut Destination z nazwami siebie nawzajem i niech jeden skrypt serwera przenosi tego, kto dotknął platformy, przez character:PivotTo w punkt tuż przed drugą platformą, z krótkim cooldownem na gracza. Krok 1 i krok 2 składają właśnie to.

Dlaczego mój teleport nie działa w Studio?

Platformy i menu w Studio działają. Teleporty do innego place nie: TeleportService w Roblox nie obsługuje playtestu w Studio, więc opublikuj grę i testuj w aplikacji Roblox. Skrypt z tego poradnika zamiast teleportu wypisuje, co zrobiłby portal, więc i tak możesz sprawdzić, czy się uruchamia.

Jak teleportować graczy do innego place mojej gry?

Dodaj place przez File > Publish As (Add as a new place), skopiuj jego place ID z Asset Manager i wywołaj TeleportService:TeleportAsync(placeId, { player }) ze Script na serwerze wewnątrz pcall, ponawiając próbę przy awarii. Krok 4 prowadzi przez to wszystko.

Jak zrobić GUI teleportu?

Złóż przyciski w LocalScript i wysyłaj serwerowi tylko nazwę miejsca, które wybrał gracz. Serwer szuka nazwy w folderze, sprawdza cooldown i każdą zasadę odblokowania, potem przenosi postać. Nigdy nie wysyłaj pozycji z klienta: oszust może wysłać dowolną.

Dlaczego moja postać utyka albo się rozpada po teleporcie?

Przypisanie Position głównego partu rusza tylko ten part, bez połączonego z nim ciała, a skopiowanie CFrame platformy stawia środek postaci w platformie. Używaj character:PivotTo z punktem na wysokości stania nad podłogą, policzonym z HipHeight Humanoida.

Czy można przekazać monety albo przedmioty razem z teleportem?

Bezpiecznie nie. Roblox mówi, że teleport data są widoczne dla klienta i nie są szyfrowane, więc nadają się do czegoś w rodzaju wybranej mapy, ale nie do monet. Zapisuj monety i przedmioty w magazynie danych i wczytuj je w drugim place.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.