Коротко
Для майданчика телепорту покладіть Script у ServerScriptService, який слухає подію Touched майданчика, знаходить гравця через Players:GetPlayerFromCharacter і переносить усього персонажа через character:PivotTo() у точку прямо перед майданчиком призначення, спиною до нього, з кулдауном у пару секунд на гравця, щоб майданчик призначення не відправив його одразу назад. Щоб надіслати гравців в інший плейс вашої гри, викличте TeleportService:TeleportAsync(placeId, { player }) із серверного Script усередині pcall; це працює тільки в опублікованій грі, не в Studio.
- Переносьте всього персонажа через
PivotTo. ПрисвоєнняHumanoidRootPart.Positionвідсуває кореневий парт від решти тіла, бо під час задання Position Roblox оновлює з'єднання. - Меню телепорту має надсилати серверу назву точки призначення, а не позицію. Сервер перевіряє назву, кулдаун і будь-яке правило розблокування, перш ніж когось перенести.
TeleportService:Teleport()застарів і працює на клієнті. ВикористовуйтеTeleportAsyncна сервері, обгортайте його вpcall, повторюйте спробу й обробляйтеTeleportInitFailed.
На цій сторінці
Два види телепорту
Телепорт у грі Roblox може означати три речі: майданчик, який переносить вас через карту, меню точок, куди можна стрибнути, або портал на інший рівень. Перші два переносять персонажа в межах сервера, на якому гравець уже перебуває. Третій надсилає гравця в інший плейс вашої гри, який працює на власних серверах. Вони використовують різні API, тому корисно знати, який вам потрібен.
| У межах того самого сервера | В інший плейс вашої гри | |
|---|---|---|
| Виклик | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Для чого | Майданчики телепорту, меню телепорту, перенесення гравців із лобі на арену | Портали на інший рівень, лобі, яке надсилає гравців в окремий плейс із підземеллям або матчем |
| Де працює | Серверний Script | Тільки серверний Script. Клієнтський Teleport() застарів. |
| Працює в плейтесті Studio | Так | Ні. TeleportService у Roblox не підтримує плейтест у Studio, тому тестують в опублікованій грі. |
| Що бачить гравець | Стрибок через карту, який може тривати до 2 секунд, якщо цю область спершу треба завантажити | Екран завантаження Roblox, потім інший плейс |
| Монети, предмети та інші дані | Залишаються як є | Roblox скидає локальні дані гравця, тому все важливе має надходити зі сховища даних в іншому плейсі |
У цьому гайді всі три види зібрано в одному серверному Script, тому один набір правил охоплює кожен телепорт у вашій грі: вирішує сервер, у кожного гравця свій кулдаун, а пристрій гравця тільки повідомляє, у яку точку він хотів би потрапити.
| Елемент | Де розташований | Що робить |
|---|---|---|
Folder TeleportPads з PadA і PadB | Workspace | Два майданчики. Атрибут Destination кожного називає майданчик, до якого він надсилає гравців. |
Folder TeleportSpots | Workspace | По одному парту на кожну точку в списку меню. Атрибут WinsNeeded закриває точку. |
Folder PlacePortals | Workspace | Парти-портали. Атрибут PlaceId кожного порталу це плейс, у який він надсилає гравців. |
Script Teleporters | ServerScriptService | Керує всіма трьома видами телепорту й створює два ремоути. Єдине місце, де може статися телепорт. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Малює кнопку Teleport і список точок і надсилає назву точки, яку вибрав гравець. |
RemoteFunction GetTeleportSpots і RemoteEvent TeleportRequest | ReplicatedStorage (їх створює Teleporters) | Перша повертає меню список точок. Другий несе вибрану назву на сервер. |
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
Крок 1: зберіть два майданчики телепорту
- В Explorer наведіть курсор на Workspace, натисніть кнопку + і вставте Folder. Назвіть папку
TeleportPads. Скрипт шукає саме цю назву. - Вставте в папку два Part і назвіть їх
PadAіPadB. Зробіть кожен пласкою плитою, наприклад 6 на 1 на 6 стадів, і поставте їх на підлогу на певній відстані один від одного. У вікні Properties позначте Anchored, залиште CanCollide і CanTouch увімкненими й задайте яскравий колір і матеріал Neon, щоб гравці їх помічали. - Виділіть PadA, прокрутіть вікно Properties до розділу Attributes і натисніть +. Введіть назву
Destination, виберіть тип String і натисніть Save, потім задайте значенняPadB. Зробіть те саме на PadB зі значеннямPadA. - Поверніть кожен майданчик так, щоб його передня грань дивилася на вільну підлогу. Гравці з'являються за 3 стади перед передньою гранню майданчика призначення, спиною до нього, тому залиште там кілька стадів вільної підлоги. Щоб побачити, яка грань передня, клікніть по майданчику правою кнопкою й виберіть Show Orientation Indicator: передню грань позначає синя лінія. Повертайте майданчик інструментом Rotate, доки ця лінія не вкаже туди, куди гравці мають іти.
Гравці опиняються поруч із майданчиком, а не на ньому, навмисно. На сторінці Roblox про debounce зазначено, що Touched спрацьовує багато разів поспіль за один дотик, тому гравець, який з'явився прямо на іншому майданчику, запустив би його знову, щойно закінчиться його кулдаун, і полетів би назад через карту.
Ви не обмежені двома майданчиками. Destination майданчика може називати будь-який парт у TeleportPads, тому три майданчики можуть надсилати гравців по колу. Для однобічного майданчика направте його на парт у TeleportPads, який не має свого Destination: такий парт приймає гравців і нікого нікуди не надсилає.
Крок 2: додайте скрипт телепорту
Наведіть курсор на ServerScriptService, вставте Script, назвіть його Teleporters і вставте в нього код нижче. Зараз він обслуговує майданчики, а після наступних кроків ще меню й портали, тому додаєте ви його один раз. Налаштування на початку це рядки, які вам і належить змінювати.
-- Script у ServerScriptService з назвою Teleporters.
-- Кожен телепорт вирішується тут, на сервері:
-- 1. Майданчики: дотик до парта в Workspace.TeleportPads переносить вас до парта, названого
-- в його атрибуті Destination.
-- 2. Меню: LocalScript TeleportMenu просить точку з Workspace.TeleportSpots
-- за назвою. Сервер перевіряє назву, кулдаун і Wins, які потрібні для точки.
-- 3. Портали: дотик до парта в Workspace.PlacePortals надсилає вас у плейс
-- з його атрибута PlaceId (інший плейс цієї гри).
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 -- стільки майданчики ігнорують гравця після будь-якого телепорту
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- стадів перед майданчиком призначення, щоб гравці опинялися поруч із ним
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Цей скрипт сам створює обидва ремоути, тому не додавайте їх вручну
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
-- На якій висоті над підлогою розташований кореневий парт персонажа, що стоїть.
-- Формула з довідки Roblox щодо Humanoid.HipHeight (у ригів R6 додається висота ноги).
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() -- задаємо до очікування, щоб другий дотик не запустив другий телепорт
-- Дивимося туди, куди спрямована передня грань точки призначення (рівно, без нахилу)
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
-- Стаємо на її верхню грань: pivot персонажа це його кореневий парт, тому піднімаємо його на висоту стоячи.
-- Майданчик же ставить гравців за кілька стадів перед собою, бо гравець, який стоїть
-- на майданчику, знову запустив би його наступним кроком.
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)
-- Коли ввімкнено instance streaming, спершу завантажуємо область навколо точки призначення (до 2 секунд)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- вийшов, відродився або помер, поки область завантажувалася
end
-- Персонаж, що сидить, приварений до сидіння, і його переміщення потягло б сидіння за собою.
-- Знищення SeatWeld спершу звільняє персонажа від сидіння.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Після прибуття запускаємо кулдаун заново: попереднє завантаження вище може тривати до 2 секунд,
-- а майданчик, біля якого гравець опинився, не повинен одразу відправити його назад
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- для скрипта перевірки швидкості, якщо він у вас є
end
-- 1. Майданчики
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 -- попереджаємо один раз, а не під час кожного дотику
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Меню: список точок, потім запит за назвою
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 -- однакові Wins: за абеткою, щоб порядок ніколи не змінювався
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Клієнт надсилає тільки назву. Ніколи не приймайте від клієнта позицію або 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 -- закрито для цього гравця
end
teleportTo(player, spot, false)
end)
-- 3. Портали в інший плейс цієї гри
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- уже в дорозі або торкався телепорту секунду тому
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 -- здаємося; новий дотик до порталу пробує знову
end
-- Телепорт може зірватися і після старту. Гравець залишається тут і може спробувати знову.
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 сам створює RemoteFunction GetTeleportSpots і RemoteEvent TeleportRequest, тому вручну вставляти в ReplicatedStorage нічого не треба. Він підключає майданчики з TeleportPads і портали з PlacePortals один раз, під час старту сервера, тому майданчики й портали, додані під час гри, нічого не роблять. Якщо якоїсь папки немає, цей вид телепорту просто вимкнений.
| Частина | Що робить | Навіщо |
|---|---|---|
playerFromHit | Знаходить модель персонажа, якій належить парт, що торкнувся, і питає в Players:GetPlayerFromCharacter, чия вона. | Майданчиків торкаються ноги, капелюхи й вільні парти. Усе, що не є частиною персонажа гравця, дає nil та ігнорується. |
onCooldown | Порівнює os.clock() з часом останнього телепорту гравця. | Один кулдаун на гравця, тому гравець, який стоїть біля майданчика, ніколи не блокує інших. Ніщо не чекає й не спить. |
rootHeight | Обчислює, на якій висоті над підлогою розташований кореневий парт персонажа, що стоїть: половина висоти кореневого парта плюс HipHeight у Humanoid, плюс довжина ноги в ригів R6. | Це формула з довідки Roblox щодо Humanoid.HipHeight. Pivot персонажа це його кореневий парт, тому підйом pivot на цю величину ставить ноги на поверхню і в маленьких, і у великих аватарів, і в R6. |
Перевірки на початку teleportTo | Виходить, якщо в гравця немає живого персонажа з кореневим партом, і потім одразу записує час. | Запит стримінгу нижче може змусити скрипт чекати. Якщо записати час заздалегідь, численні події Touched у цей момент не запустять другий телепорт. |
| Точка прибуття | Верхня грань точки призначення, піднята на rootHeight, з напрямком погляду туди, куди дивиться її передня грань, без нахилу. Для майданчика точку ще й зсунуто на 3 стади від його передньої грані. | Персонаж з'являється стоячи, а не всередині парта призначення. Поруч із майданчиком його ноги починають на рівні його верхньої грані, тому він опускається на підлогу на товщину майданчика. CFrame.lookAlong будує CFrame у позиції із заданим напрямком погляду. |
RequestStreamAroundAsync | Просить Roblox спершу надіслати цьому гравцеві область навколо точки прибуття й чекає не більше 2 секунд. | Instance streaming увімкнено за замовчуванням у нових плейсах, тому далека частина карти може бути ще не завантажена на пристрої гравця. Roblox рекомендує цей серверний виклик перед перенесенням персонажа далеко, хоча й не гарантує, що саме дійде. |
| Друга перевірка | Якщо гравець вийшов, а персонаж відродився або помер за час очікування, нічого не рухається. | Гравець міг зробити reset або вийти з гри, поки область завантажувалася. Власний приклад попереднього завантаження від Roblox теж перевіряє, що персонаж усе ще в грі, перш ніж його рухати. |
Рядки з SeatWeld | Якщо персонаж сидить, знищує Weld, який тримає його на сидінні. | Roblox приварює персонажа, що сидить, до сидіння. PivotTo рухає парти, змінюючи їхній CFrame, а в довідці Roblox сказано, що задання CFrame парта рухає й з'єднані з ним парти, тому без цього сидіння і все, що до нього приварено, прибуло б разом із гравцем. Знищення SeatWeld це спосіб, яким довідка Roblox щодо Seat піднімає персонажа із сидіння зі скрипта. |
character:PivotTo(target) | Переносить усього персонажа, усі кінцівки й аксесуари разом, у точку прибуття. | Roblox називає PivotTo основною функцією для переміщення моделей зі скриптів. |
Другий рядок із lastTeleport | Запускає кулдаун заново після прибуття. | Запит стримінгу може тривати до 2 секунд, стільки ж, скільки сам кулдаун майданчика, тому без цього рядка гравець міг би прибути з уже вичерпаним кулдауном. |
MovementCheckSkip | Виставляє атрибут на Player після кожного перенесення. | Серверна перевірка швидкості сприйняла б стрибок за чит. MovementCheck із гайда про спринт читає цей атрибут і починає вимірювати заново з нової позиції. Без такого скрипта атрибут нічого не робить. |
| Налаштування | Значення тут | Що змінює |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Скільки майданчики й портали ігнорують гравця після будь-якого телепорту. |
MENU_COOLDOWN_SECONDS | 3 | Найкоротший проміжок між двома телепортами через меню для одного гравця. Майданчики й меню мають спільний годинник на гравця, тому запит із меню протягом 3 секунд після телепорту з майданчика теж ігнорується. |
PAD_ARRIVAL_GAP | 3 | За скільки стадів від передньої грані майданчика призначення з'являються гравці, щоб вони опинялися поруч із майданчиком, а не на ньому. |
PLACE_ATTEMPTS | 3 | Скільки разів портал пробує TeleportAsync з інтервалом 2 секунди, перш ніж здатися. |
Натисніть Play просто зараз і наступіть на PadA: ви з'явитеся перед PadB. Меню й порталам потрібні наступні два кроки, але скрипт працює вже й без них.
Крок 4: телепорт в інший плейс
Плейс це окремий світ усередині вашої гри, зі своїми серверами: лобі й підземелля або хаб і набір рівнів. Гравці переміщуються між плейсами через TeleportService, а Roblox запускає його тільки в опублікованій грі, тому цей крок закінчується в застосунку Roblox, а не в Studio.
- Якщо гру ще не опубліковано, виберіть File > Publish. Нові ігри, поки ви їх не випустите, відкриті тільки вам, людям, яким ви дали доступ Edit, і учасникам групи з потрібними ролями, і для власного тесту телепортів цього достатньо.
- Створіть другий плейс: відкрийте новий плейс із будь-якого шаблону Studio, збудуйте своє підземелля, потім виберіть File > Publish As, клікніть по плитці своєї гри, виберіть Add as a new place і натисніть Create.
- Скопіюйте ID нового плейсу. Відкрийте Asset Manager з меню Window або з вкладки Home, перейдіть у Places In Experience, клікніть по плейсу правою кнопкою й виберіть Copy Asset ID, це скопіює його place ID.
- Повернувшись у перший плейс, вставте у Workspace Folder з назвою
PlacePortals, а всередину неї заанкерений Part з назвоюDungeonPortal. Додайте атрибут типу Number з назвоюPlaceIdі вставте ID як його значення. - Натисніть Play і торкніться порталу. Output друкує рядок, який починається з
Teleporters: would send: у Studio портал більше нічого не робить. - Опублікуйте гру знову через File > Publish, щоб портал з'явився в опублікованій грі, і перевірте його із застосунку Roblox, як у кроці 5.
Teleporters викликає TeleportAsync усередині pcall, до 3 разів із паузою 2 секунди між спробами, бо на сторінці Roblox про телепорти сказано, що телепорти можуть зриватися й видавати помилку, і рекомендується повторювати спробу. Телепорт може також початися й зірватися в останній момент без помилки, залишивши гравця там, де він був. Для цього випадку Roblox викликає TeleportInitFailed, і скрипт знімає з гравця прапорець «іде», тому новий дотик до порталу пробує знову.
Щоб повертати гравців, зробіть те саме в іншому плейсі: покладіть копію Teleporters у його ServerScriptService і додайте портал, у якого PlaceId це ID вашого першого плейсу, скопійований з Asset Manager тим самим способом.
Хто може зайти у ваші інші плейси
Документація Roblox щодо безпеки попереджає: щойно клієнт опинився в одному плейсі вашої гри, він може телепортуватися в будь-який інший її плейс, хоч який маршрут ви задумали, а вимкнення Direct Access у плейсу прибирає тільки кнопку Join на сайті. Це змінює налаштування Access Control for Places у розділі Audience > Access Settings у Creator Dashboard:
| Налаштування | Хто може зайти в плейс, який не є стартовим |
|---|---|
| Fully open | Будь-хто, через телепорти з будь-якої гри, deep links, запрошення в гру та приєднання до друга. |
| Limited to same universe | Тільки гравці, які телепортуються зсередини ваших ігор. Дозволені телепорти і з клієнта, і з сервера. |
| Secure within universe only | Тільки гравці, яких телепортують ваші серверні скрипти зсередини цієї гри. |
Якщо гравці мають потрапляти в плейс тільки через ваш портал, наприклад у підземелля, виберіть Secure within universe only. Кожен телепорт у цьому гайді починається на сервері, тому він і далі працюватиме. Roblox також каже, що багатьом іграм захищені телепорти не потрібні, тому гра, усі плейси якої відкриті для всіх, може залишити налаштування як є.
У чому помиляються старі туторіали про телепорти
Якщо ви порівнюєте цей гайд із відео або постом на форумі, ось важливі відмінності й причина, з якої кожен прийом створює проблему.
| Туторіал | Проблема | Цей гайд |
|---|---|---|
Задає hit.Parent.HumanoidRootPart.Position = target.Position | У довідці Roblox сказано, що задання Position оновлює з'єднання парта, і він зсувається відносно партів, з якими з'єднаний: кореневий парт від'їжджає без тіла. | Переносить усього персонажа через PivotTo. |
Задає HumanoidRootPart.CFrame = target.CFrame | Середина персонажа опиняється в середині цільового парта, частково всередині нього, і переймає нахил парта. | Персонаж з'являється на висоті стоячи над верхньою гранню, поруч із майданчиком, без нахилу. |
Використовує одну змінну debounce на весь майданчик | Поки телепортується один гравець, майданчик ігнорує всіх інших. А зовсім без debounce гравець, який з'явився на іншому майданчику, одразу відправляється назад. | Один кулдаун на гравця, записаний до будь-якого очікування, і гравці з'являються поруч із майданчиком. |
Викликає TeleportService:Teleport(placeId, player) з LocalScript | Roblox позначає Teleport() як застарілий, радить не використовувати його в нових проєктах і дозволяє TeleportAsync тільки з серверних скриптів. | Викликає TeleportAsync у серверному скрипті. |
Немає pcall, немає повторних спроб | На сторінці Roblox про телепорти сказано, що вони можуть зриватися й видавати помилку, а також зриватися вже після старту. | До 3 спроб у pcall, а TeleportInitFailed дозволяє гравцеві спробувати знову. |
| Здається, бо в Studio «не працює» | TeleportService не підтримує плейтест у Studio. | RunService:IsStudio() натомість друкує, що зробив би портал. |
| GUI телепорту, кнопки якого надсилають позицію | Чітер може викликати той самий ремоут із будь-якою позицією. | Кнопки надсилають назву точки, а сервер її шукає. |
| Монети передаються в teleport data | Roblox каже, що teleport data видно клієнту й вони не зашифровані. | Радить зберігати монети й Wins у сховищі даних і завантажувати їх в іншому плейсі (дивіться Як перенести дані в інший плейс). |
Що гравці можуть і чого не можуть підробити
Вважайте, що чітер керує всім на своєму пристрої: він може редагувати TeleportMenu, викликати обидва ремоути скільки завгодно разів із будь-якими аргументами й рухати свого персонажа. Ось що це дає йому з цим телепортом.
| Чітер намагається | Результат | Чому |
|---|---|---|
| Надіслати позицію або CFrame через ремоут меню | Ігнорується | TeleportRequest читає один рядок, назву точки завдовжки до 50 символів. Усе інше відкидається. |
| Запитати Castle без 3 Wins | Відмова | Сервер читає Wins зі своєї копії leaderstats. Сіра кнопка це тільки підказка. |
| Запитати точку, якої не існує | Ігнорується | Сервер шукає назву в TeleportSpots і нічого не робить, якщо парта з такою назвою немає. |
| Викликати ремоут меню знову і знову | Не більше одного телепорту через меню раз на 3 секунди | Кулдаун зберігається на сервері, для кожного гравця. |
| Запустити майданчик, не підходячи до нього | Він потрапляє до парного майданчика, до якого й так міг дійти | Roblox перелічує телепортацію в будь-яку точку й маніпуляції з подіями Touched серед того, що клієнт може робити зі своїм персонажем. |
| Зайти в інший плейс вашої гри напряму | Можливо, якщо Access Control for Places не дорівнює Secure within universe only | Дивіться Хто може зайти у ваші інші плейси. |
| Перемістити свого персонажа куди завгодно, зокрема в закриту точку | Можливо | Кожен пристрій керує рухом свого персонажа. Закрита точка це зручність, а не сейф, тому перевіряйте на сервері, перш ніж видавати там щось цінне. |
Останній рядок це чесна межа будь-якого телепорту. Для змагальної гри додайте серверну перевірку руху, як у гайді про спринт. Teleporters уже виставляє атрибут MovementCheckSkip, який читає та перевірка, тому його власні телепорти не позначаються як порушення: у документації Roblox щодо безпеки сказано, що іграм із легітимними телепортами потрібен саме такий виняток у перевірках руху.
Крок 5: перевірте
- Натисніть Play. Наступіть на PadA: ви з'являєтеся прямо перед PadB, спиною до нього. Розверніться й одразу наступіть на PadB: нічого не відбувається, бо майданчики ігнорують вас 2 секунди після прибуття. Зійдіть, зачекайте 2 секунди й знову зайдіть на PadB: ви з'являєтеся перед PadA.
- Зачекайте кілька секунд, потім натисніть Teleport у лівій частині екрана. У списку видно Lake, Spawn і сіру "Castle (needs 3 wins)". Виберіть Lake: ви з'являєтеся на ній. Відкрийте меню знову й виберіть Castle: нічого не відбувається, і в Output тихо.
- Видайте собі 3 Wins (для цього потрібен скрипт leaderstats з IntValue Wins, наприклад із гайда про таблицю лідерів). Натисніть перемикач Client/Server, щоб перейти на Server, знайдіть в Explorer
Players, своє ім'я,leaderstats,Winsі задайте його Value рівним 3 у вікні Properties. Перемкніться назад на Client і знову відкрийте меню: Castle стала фіолетовою й переносить вас туди. - Торкніться DungeonPortal. Output друкує рядок, який починається з
Teleporters: would send, із вашим ім'ям і place ID. У Studio так і має бути, і друкується він не частіше ніж раз на 2 секунди, хоч скільки б ви стояли на порталі. - Виберіть Server & Clients у випадному списку режимів тесту, задайте 2 клієнти й натисніть Play. Обидва гравці можуть користуватися майданчиками одночасно, і кулдаун одного ніколи не блокує іншого.
- Зупиніть тест, опублікуйте гру й запустіть її із застосунку Roblox. Торкніться порталу: з'являється екран завантаження Roblox, і ви опиняєтеся в іншому плейсі. Якщо ви залишилися на місці, відкрийте Developer Console клавішею F9, перемкніть лог на вигляд Server, який бачать тільки власник гри й учасники групи з правом редагування, і знайдіть попередження
Teleporters:, у них указано причину, яку назвав Roblox.
Під час кроків у Studio тримайте вікно Output відкритим (меню Window, потім Output). Коли Teleporters працює, він нічого не друкує, крім рядка порталу з кроку 4, тому будь-яке попередження або червону помилку варто прочитати. Дивіться Часті помилки.
Як розширити
Телепорт команди або паті разом
TeleportAsync приймає список гравців, тому один портал може надіслати в один плейс цілу групу. Сторінка Roblox про телепорти пропонує відштовхуватися від гравця, який торкнувся порталу: player.Team і Team:GetPlayers() для команди або SocialService:GetPlayersByPartyId() з player.PartyId для паті. Передайте цей список замість { player } і виставте прапорець leavingForPlace кожному гравцеві з нього.
Надсилання групи на власний сервер
За замовчуванням телепортовані гравці потрапляють на публічний сервер іншого плейсу. Щоб надіслати групу на новий зарезервований сервер, наприклад для матчу, створіть TeleportOptions, задайте його ShouldReserveServer рівним true і передайте третім аргументом: TeleportService:TeleportAsync(placeId, players, options). Roblox зазначає, що за збоїв, пов'язаних саме із зарезервованими серверами, повторні спроби особливо корисні, а скрипт їх уже робить.
Як перенести дані в інший плейс
Телепортація скидає всі локальні дані цього гравця. Teleport data в Roblox, які задаються через TeleportOptions:SetTeleportData() і читаються в іншому плейсі через player:GetJoinData(), видно клієнту і вони не зашифровані, тому використовуйте їх тільки для нешкідливих виборів, наприклад яку карту завантажити. Монети, Wins і предмети зберігайте у сховищі даних, як у туторіалі про DataStore, і завантажуйте їх знову, коли гравець прибуває в інший плейс.
Власний екран завантаження
Поки завантажується телепорт у плейс, гравці бачать стандартний екран завантаження Roblox. Щоб показати свій, викличте на клієнті TeleportService:SetTeleportGui() зі ScreenGui, наприклад із тим, що лежить у ReplicatedStorage. Телепорти в цьому гайді починаються на сервері, тому клієнт має викликати його заздалегідь, наприклад щойно гравець зайшов. Roblox каже, що екран треба задавати заново перед кожним телепортом і що він не використовується для плейсу в іншій грі. Там само зазначено, що скрипти всередині цього ScreenGui не запускаються, тому робіть його статичним.
Телепорти раундів і чекпоінти
Система раундів на початку кожного раунду переносить усіх гравців на арену таким самим викликом PivotTo, а розділ PivotTo або SpawnLocation у гайді про обі порівнює цей підхід із точками спавну Roblox. Якщо точка має відкриватися тільки після раунду, система раундів уже нараховує Wins, які читає WinsNeeded.
Поширені помилки та рішення
Відкрийте вікно Output (меню Window, потім Output) до натискання Play. Teleporters називає майданчик, коли Destination вказує в нікуди, тому більшість проблем видно там.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu чекає ремоут, який створює Teleporters, отже, Teleporters не працює. Перевірте, що це Script, а не LocalScript, що він лежить прямо в ServerScriptService, не вимкнений і що в Output немає червоної помилки від нього. Гайд про помилки скриптів докладно пояснює це попередження.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Атрибут Destination майданчика називає те, що не є партом прямо всередині папки TeleportPads. Перевірте написання й великі літери в значенні атрибута і в назві майданчика призначення. Попередження з'являється один раз на майданчик, коли гравець торкається його вперше.
Я наступаю на майданчик, і нічого не відбувається
Перевірте, що папка називається точно TeleportPads і лежить прямо у Workspace під час старту гри, що атрибут Destination майданчика має тип String (атрибут типу Number ігнорується) і що з вашого останнього телепорту минуло 2 секунди. Перевірте також, що в майданчика ввімкнено CanTouch: Roblox каже, що підключення Touched до парта з вимкненим CanTouch видає помилку, а вона зупиняє скрипт.
Я з'являюся всередині стіни або падаю з краю
Гравці з'являються за 3 стади перед передньою гранню майданчика призначення. Клікніть по майданчику правою кнопкою, виберіть Show Orientation Indicator і повертайте майданчик, доки синя лінія не вкаже на вільну підлогу. Точки меню ставлять гравців згори на парт, тому тримайте кожну точку на підлозі.
Кнопка Castle залишається сірою після того, як я заробив 3 Wins
Список малюється під час відкриття меню, тому закрийте меню й відкрийте його знову. Якщо кнопка все ще сіра, перевірте, що в leaderstats є IntValue з назвою точно Wins і що Wins змінилися на сервері, а не тільки в режимі Client.
Портал нічого не робить в опублікованій грі
Відкрийте Developer Console клавішею F9, перемкніть лог на вигляд Server (його бачать тільки власник гри й учасники групи з правом редагування, бо Teleporters це серверний Script) і прочитайте попередження Teleporters:, у них указано причину, яку назвав Roblox. Перевірте, що атрибут PlaceId порталу має тип Number і містить ID з Asset Manager і що ви опублікували плейс заново після додавання порталу.
Зробити з RoCode
Якщо не хочеться збирати все це вручну, RoCode може зробити це у відкритому у вас плейсі. RoCode це незалежний ШІ-агент для Roblox Studio, не від Roblox: ви описуєте функцію в його вебчаті, а його плагін для Studio створює парти й скрипти у вашому Explorer, тож вам не доводиться копіювати код із вікна чату.
Додай телепорти: майданчики в Workspace.TeleportPads, які надсилають гравців до майданчика зі свого атрибута Destination з кулдауном 2 секунди, меню Teleport для точок у Workspace.TeleportSpots, де для Castle потрібно 3 Wins з перевіркою на сервері, і портали в Workspace.PlacePortals, які надсилають гравців у плейс з ID зі свого атрибута PlaceId, з повторними спробами.
- Може переглянути ваш плейс, коли кроку це потрібно, через Search Game і Search Scripts, щоб спертися на вже наявні предмети, ремоути або код збереження, а не додавати другу систему
- Створює папки й парти майданчиків через Create Instance, задає їхні властивості через Set Property і пише Teleporters і TeleportMenu через Create Script
- Йому наказано перевіряти компіляцію кожного написаного скрипта через Check Script, який компілює його в Studio без запуску
- Надсилає зміни пакетами, і кожен пакет це точка скасування в історії Studio
Телепорти між плейсами працюють тільки в опублікованій грі, тому їх перевірте в застосунку Roblox самі. З плагіном 3.9 або новішим RoCode може запустити короткий плейтест і прочитати помилки, а з плагіном 3.9.15 або новішим його тестовий персонаж може наступати на майданчики й натискати кнопки меню, але він перевіряє тільки те, що сам вирішив протестувати, тому наступіть на майданчики й відкрийте меню самі. Телепорт це одна система з багатьох у грі; створення цілої гри з RoCode іде так само, по одній системі на промпт. Як RoCode підключається до Studio.
Поширені запитання
Як зробити майданчик телепорту в Roblox Studio?
Задайте двом партам атрибут Destination з назвами одне одного, і нехай один серверний скрипт переносить того, хто торкнувся майданчика, через character:PivotTo у точку прямо перед іншим майданчиком, з коротким кулдауном на гравця. Крок 1 і крок 2 збирають саме це.
Чому мій телепорт не працює в Studio?
Майданчики й меню в Studio працюють. Телепорти в інший плейс ні: TeleportService у Roblox не підтримує плейтест у Studio, тому опублікуйте гру й тестуйте в застосунку Roblox. Скрипт із цього гайда замість телепорту друкує, що зробив би портал, тож ви все одно можете перевірити, що він спрацьовує.
Як телепортувати гравців в інший плейс моєї гри?
Додайте плейс через File > Publish As (Add as a new place), скопіюйте його place ID з Asset Manager і викличте TeleportService:TeleportAsync(placeId, { player }) із серверного Script усередині pcall, повторюючи спробу в разі збою. Крок 4 проводить через усе це.
Як зробити GUI телепорту?
Зберіть кнопки в LocalScript і надсилайте серверу тільки назву точки, яку вибрав гравець. Сервер шукає назву в папці, перевіряє кулдаун і будь-яке правило розблокування, потім переносить персонажа. Ніколи не надсилайте позицію з клієнта: чітер може надіслати будь-яку.
Чому мій персонаж застрягає або розвалюється після телепорту?
Присвоєння Position кореневого парта рухає тільки цей парт, без з'єднаного з ним тіла, а копіювання CFrame майданчика ставить середину персонажа всередину майданчика. Використовуйте character:PivotTo з точкою на висоті стоячи над підлогою, обчисленою з HipHeight у Humanoid.
Чи можна передати монети або предмети разом із телепортом?
Безпечно не можна. Roblox каже, що teleport data видно клієнту й вони не зашифровані, тому вони годяться для чогось на кшталт вибраної карти, але не для монет. Зберігайте монети й предмети у сховищі даних і завантажуйте їх в іншому плейсі.
Джерела та що почитати
- Roblox Creator Docs: Teleport between places (англійською). TeleportAsync, плейтести в Studio, Access Control for Places, екрани телепорту, teleport data і зірвані телепорти
- Roblox Creator Docs: TeleportService (англійською). застарілий Teleport, TeleportAsync тільки на сервері й TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (англійською). основна функція для переміщення моделей зі скриптів
- Roblox Creator Docs: BasePart.Position (англійською). чому задання Position у з'єднаного парта зсуває його відносно інших
- Roblox Creator Docs: Humanoid.HipHeight (англійською). на якій висоті розташований кореневий парт персонажа, що стоїть, для ригів R15 і R6
- Roblox Creator Docs: Seat (англійською). SeatWeld, який тримає персонажа, що сидить, і його знищення, щоб підняти персонажа
- Roblox Creator Docs: Player:RequestStreamAroundAsync (англійською). запит області до того, як персонаж туди переміститься, без гарантії того, що дійде
- Roblox Creator Docs: Streaming techniques and conversion (англійською). випереджальний стримінг перед телепортом
- Roblox Creator Docs: Access control and confidentiality (англійською). чому клієнти можуть потрапити в будь-який плейс гри, якщо телепорти не захищені
- Roblox Creator Docs: Network ownership, movement validation, and physics (англійською). що клієнт може робити зі своїм персонажем і винятки для телепортів у перевірках руху
- Roblox Creator Docs: Create and publish games and places (англійською). публікація, хто може відкрити нову гру, і додавання плейсу через Publish As
- Roblox Creator Docs: Asset Manager (англійською). як скопіювати place ID
- Roblox Creator Docs: Developer Console (англійською). вигляд Server у лозі і хто його бачить
- Roblox Creator Docs: Debounce patterns (англійською). чому Touched спрацьовує кілька разів за один дотик
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.