Коротко
Для площадки телепорта положите 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.