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. PrzypisanieHumanoidRootPart.Positionodsuwa 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żywajTeleportAsyncna serwerze, opakowuj go wpcall, ponawiaj próbę i obsługujTeleportInitFailed.
Na tej stronie
Dwa rodzaje teleportu
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.
| W obrębie tego samego serwera | Do innego place twojej gry | |
|---|---|---|
| Wywołanie | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Do czego | Platformy 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ła | Script na serwerze | Tylko Script na serwerze. Kliencki Teleport() jest przestarzały. |
| Działa w playteście Studio | Tak | Nie. TeleportService w Roblox nie obsługuje playtestu w Studio, więc testuje się w opublikowanej grze. |
| Co widzi gracz | Skok 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 dane | Zostają bez zmian | Roblox 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ć.
| Element | Gdzie jest | Co robi |
|---|---|---|
Folder TeleportPads z PadA i PadB | Workspace | Dwie platformy. Atrybut Destination każdej z nich wskazuje platformę, do której wysyła graczy. |
Folder TeleportSpots | Workspace | Po jednym parcie na każde miejsce z listy menu. Atrybut WinsNeeded zamyka miejsce. |
Folder PlacePortals | Workspace | Party portali. Atrybut PlaceId każdego portalu to place, do którego wysyła graczy. |
Script Teleporters | ServerScriptService | Obsługuje wszystkie trzy rodzaje teleportu i tworzy dwa remote. Jedyne miejsce, gdzie może dojść do teleportu. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Rysuje przycisk Teleport i listę miejsc i wysyła nazwę miejsca, które wybrał gracz. |
RemoteFunction GetTeleportSpots i RemoteEvent TeleportRequest | ReplicatedStorage (tworzy je Teleporters) | Pierwszy zwraca menu listę miejsc. Drugi niesie wybraną nazwę na serwer. |
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
- W Explorerze najedź na Workspace, kliknij przycisk + i wstaw Folder. Nazwij folder
TeleportPads. Skrypt szuka dokładnie tej nazwy. - Wstaw do folderu dwa Part i nazwij je
PadAiPadB. 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. - 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. - 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.
-- 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.
| Część | Co robi | Po co |
|---|---|---|
playerFromHit | Znajduje 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. |
onCooldown | Poró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. |
rootHeight | Liczy, 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 teleportTo | Koń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 przybycia | Gó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. |
RequestStreamAroundAsync | Prosi 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 sprawdzenie | Jeś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 SeatWeld | Jeś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 lastTeleport | Uruchamia 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. |
MovementCheckSkip | Ustawia 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. |
| Ustawienie | Wartość tutaj | Co zmienia |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Jak długo platformy i portale ignorują gracza po każdym teleporcie. |
MENU_COOLDOWN_SECONDS | 3 | Najkró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_GAP | 3 | Ile studów od przedniej ściany platformy docelowej pojawiają się gracze, żeby lądowali obok platformy, a nie na niej. |
PLACE_ATTEMPTS | 3 | Ile 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.
- 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.
- 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.
- 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.
- Po powrocie do pierwszego place wstaw do Workspace Folder o nazwie
PlacePortals, a w nim zakotwiczony Part o nazwieDungeonPortal. Dodaj atrybut typu Number o nazwiePlaceIdi wklej ID jako jego wartość. - Kliknij Play i dotknij portalu. Output wypisuje linię, która zaczyna się od
Teleporters: would send: w Studio portal nic więcej nie robi. - 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:
| Ustawienie | Kto może wejść do place, który nie jest startowy |
|---|---|
| Fully open | Każdy, przez teleporty z dowolnej gry, deep linki, zaproszenia do gry i dołączanie do znajomego. |
| Limited to same universe | Tylko gracze, którzy teleportują się z twoich gier. Dozwolone są teleporty zarówno z klienta, jak i z serwera. |
| Secure within universe only | Tylko 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.
| Poradnik | Problem | Ten poradnik |
|---|---|---|
Ustawia hit.Parent.HumanoidRootPart.Position = target.Position | Dokumentacja 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 LocalScript | Roblox 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ób | Strona 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 data | Roblox 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.
| Oszust próbuje | Wynik | Dlaczego |
|---|---|---|
| Wysłać pozycję albo CFrame przez remote menu | Ignorowane | TeleportRequest czyta jeden napis, nazwę miejsca o długości do 50 znaków. Wszystko inne jest odrzucane. |
| Zażądać Castle bez 3 Wins | Odmowa | Serwer czyta Wins ze swojej kopii leaderstats. Szary przycisk to tylko podpowiedź. |
| Zażądać miejsca, które nie istnieje | Ignorowane | Serwer szuka nazwy w TeleportSpots i nic nie robi, jeśli nie ma partu o tej nazwie. |
| Wywoływać remote menu raz za razem | Najwyżej jeden teleport przez menu co 3 sekundy | Cooldown jest trzymany na serwerze, osobno dla każdego gracza. |
| Uruchomić platformę, nie podchodząc do niej | Trafia 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 gry | Możliwe, jeśli Access Control for Places nie jest ustawione na Secure within universe only | Zobacz Kto może wejść do twoich innych place. |
| Przesunąć swoją postać gdziekolwiek, także na zamknięte miejsce | Możliwe | Każ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ź
- 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.
- 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.
- 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,Winsi 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. - 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. - 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.
- 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.
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.
- 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
- Roblox Creator Docs: Teleport between places (po angielsku). TeleportAsync, playtesty w Studio, Access Control for Places, ekrany teleportu, teleport data i nieudane teleporty
- Roblox Creator Docs: TeleportService (po angielsku). przestarzały Teleport, TeleportAsync tylko na serwerze i TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (po angielsku). główna funkcja do przesuwania modeli ze skryptów
- Roblox Creator Docs: BasePart.Position (po angielsku). dlaczego ustawienie Position połączonego partu przesuwa go względem pozostałych
- Roblox Creator Docs: Humanoid.HipHeight (po angielsku). na jakiej wysokości jest główny part stojącej postaci, dla rigów R15 i R6
- Roblox Creator Docs: Seat (po angielsku). SeatWeld, który trzyma siedzącą postać, i jego niszczenie, żeby podnieść postać
- Roblox Creator Docs: Player:RequestStreamAroundAsync (po angielsku). zamawianie obszaru, zanim postać się tam przeniesie, bez gwarancji, co dotrze
- Roblox Creator Docs: Streaming techniques and conversion (po angielsku). wyprzedzający streaming przed teleportem
- Roblox Creator Docs: Access control and confidentiality (po angielsku). dlaczego klienci mogą trafić do każdego place gry, jeśli teleporty nie są zabezpieczone
- Roblox Creator Docs: Network ownership, movement validation, and physics (po angielsku). co klient może robić ze swoją postacią i wyjątki dla teleportów w sprawdzaniu ruchu
- Roblox Creator Docs: Create and publish games and places (po angielsku). publikacja, kto może otworzyć nową grę i dodawanie place przez Publish As
- Roblox Creator Docs: Asset Manager (po angielsku). jak skopiować place ID
- Roblox Creator Docs: Developer Console (po angielsku). widok Server w logu i kto go widzi
- Roblox Creator Docs: Debounce patterns (po angielsku). dlaczego Touched odpala się kilka razy przy jednym dotknięciu
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ą.