Накратко
За площадка за телепорт сложи 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, преди да публикуваш.