Ръководство · Игрови системи

Как да направиш телепорт в Roblox Studio

Телепортът в Roblox е едно от две неща: преместване на персонажа на друго място на същия сървър или изпращане на играча в друг плейс на играта ти. В това ръководство изграждаме и двата варианта от един сървърен скрипт: площадки, които те пращат до площадката в двойка с тях, меню Teleport, в което заключените точки се отключват с Wins, и портали към друг плейс, които опитват пак, когато телепортът на Roblox се провали.

Обновено 20 ноември 2026 г.22 мин четенеАвтор:

Накратко

За площадка за телепорт сложи Script в ServerScriptService, който слуша събитието Touched на площадката, намира играча чрез Players:GetPlayerFromCharacter и мести целия персонаж чрез character:PivotTo() в точка точно пред площадката на местоназначението, с гръб към нея, с презареждане от няколко секунди за всеки играч, за да не го върне площадката на местоназначението веднага обратно. За да пращаш играчи в друг плейс на играта си, извикай TeleportService:TeleportAsync(placeId, { player }) от сървърен Script вътре в pcall; това работи само в публикуваната игра, не в Studio.

  • Мести целия персонаж с PivotTo. Присвояването на HumanoidRootPart.Position отделя коренния парт от останалото тяло, защото при задаване на Position Roblox обновява връзките.
  • Менюто за телепорт трябва да праща на сървъра името на местоназначението, а не позиция. Сървърът проверява името, презареждането и всяко правило за отключване, преди да премести някого.
  • TeleportService:Teleport() е остарял и работи на клиента. Използвай TeleportAsync на сървъра, обвивай го в pcall, опитвай пак и обработвай TeleportInitFailed.
На тази страница
  1. Как работи
  2. 1. Площадки
  3. 2. Скрипт за телепорт
  4. 3. Меню за телепорт
  5. 4. Други плейсове
  6. Стари уроци
  7. Граници на защитата
  8. 5. Тест
  9. Разширения
  10. Common errors
  11. С RoCode
  12. Често задавани въпроси
  13. Източници и какво да прочетеш

Два вида телепорт

ИлюстрацияДопирът до PadA те поставя точно пред PadB, затова PadB не те праща веднага обратно, а сървърът отказва заключената точка Castle, но те мести на Lake.

Телепорт в игра в Roblox може да означава три неща: площадка, която те прехвърля през картата, меню с точки, до които можеш да скочиш, или портал към друго ниво. Първите две местят персонажа в сървъра, на който играчът вече е. Третото праща играча в друг плейс на играта ти, който работи на собствени сървъри. Те използват различни API, затова е полезно да знаеш кой ти трябва.

Два вида телепорт
В същия сървърВ друг плейс на играта ти
Извикванеcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
За каквоПлощадки за телепорт, менюта за телепорт, преместване на играчи от лобито на аренатаПортали към друго ниво, лоби, което праща играчите в отделен плейс с подземие или мач
Къде работиСървърен ScriptСамо сървърен Script. Клиентският Teleport() е остарял.
Работи при плейтест в StudioДаНе. TeleportService в Roblox не поддържа плейтест в Studio, затова се тества в публикуваната игра.
Какво вижда играчътСкок през картата, който може да отнеме до 2 секунди, ако тази зона първо трябва да се заредиЕкрана за зареждане на Roblox, после другия плейс
Монети, предмети и други данниОстават, както саRoblox нулира локалните данни на играча, затова всичко важно трябва да идва от хранилище за данни в другия плейс

В това ръководство и трите вида са събрани в един сървърен Script, така че един набор от правила покрива всеки телепорт в играта ти: решава сървърът, всеки играч има свое презареждане, а устройството на играча само съобщава в коя точка би искал да попадне.

От какво се състои телепортът
ЕлементКъде се намираКакво прави
Folder TeleportPads с PadA и PadBWorkspaceДве площадки. Атрибутът Destination на всяка назовава площадката, до която тя праща играчите.
Folder TeleportSpotsWorkspaceПо един парт за всяка точка в списъка на менюто. Атрибутът WinsNeeded заключва точката.
Folder PlacePortalsWorkspaceПартове портали. Атрибутът PlaceId на всеки портал е плейсът, в който той праща играчите.
Script TeleportersServerScriptServiceУправлява и трите вида телепорт и създава два ремоута. Единственото място, където може да стане телепорт.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsРисува бутона Teleport и списъка с точки и праща името на точката, която играчът е избрал.
RemoteFunction GetTeleportSpots и RemoteEvent TeleportRequestReplicatedStorage (създава ги Teleporters)Първата връща на менюто списъка с точки. Вторият носи избраното име до сървъра.
Explorer, когато телепортът е готов. Teleporters добавя GetTeleportSpots и TeleportRequest в ReplicatedStorage, когато играта е пусната.
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: направи две площадки за телепорт

  1. В Explorer задръж курсора върху Workspace, натисни бутона + и вмъкни Folder. Наречи папката TeleportPads. Скриптът търси точно това име.
  2. Вмъкни в папката два Part и ги наречи PadA и PadB. Направи всеки плоска плоча, например 6 на 1 на 6 стъда, и ги сложи на пода на известно разстояние един от друг. В прозореца Properties отметни Anchored, остави CanCollide и CanTouch включени и задай ярък цвят и материал Neon, за да ги забелязват играчите.
  3. Избери PadA, превърти прозореца Properties до раздела Attributes и натисни +. Въведи името Destination, избери типа String и натисни Save, после задай стойност PadB. Направи същото на PadB със стойност PadA.
  4. Завърти всяка площадка така, че предната ѝ страна да гледа към свободен под. Играчите се появяват на 3 стъда пред предната страна на площадката на местоназначението, с гръб към нея, затова остави там няколко стъда свободен под. За да видиш коя страна е предна, кликни с десния бутон върху площадката и избери Show Orientation Indicator: предната страна е отбелязана със синя линия. Върти площадката с инструмента Rotate, докато тази линия не сочи натам, накъдето играчите трябва да тръгнат.

Играчите се озовават до площадката, а не върху нея, нарочно. На страницата на Roblox за debounce е отбелязано, че Touched се задейства много пъти подред при един допир, затова играч, появил се направо на другата площадка, би я задействал отново веднага щом свърши презареждането му и би отлетял обратно през картата.

Не си ограничен до две площадки. Destination на площадка може да назовава всеки парт в TeleportPads, затова три площадки могат да пращат играчите в кръг. За еднопосочна площадка я насочи към парт в TeleportPads, който няма свой Destination: такъв парт приема играчи и не праща никого никъде.

Стъпка 2: добави скрипта за телепорт

Задръж курсора върху ServerScriptService, вмъкни Script, наречи го Teleporters и постави в него кода по-долу. Сега той обслужва площадките, а след следващите стъпки и менюто и порталите, затова го добавяш веднъж. Настройките в началото са редовете, които е предвидено да променяш.

Script в ServerScriptService с име 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 веднъж, при старта на сървъра, затова площадки и портали, добавени по време на играта, не правят нищо. Ако някоя папка липсва, този вид телепорт просто е изключен.

Какво прави всяка част на Teleporters
ЧастКакво правиЗащо
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 от ръководството за бягане чете този атрибут и започва да мери отначало от новата позиция. Без такъв скрипт атрибутът не прави нищо.
Настройките в началото на Teleporters
НастройкаСтойност тукКакво променя
PAD_COOLDOWN_SECONDS2Колко дълго площадките и порталите пренебрегват играча след всеки телепорт.
MENU_COOLDOWN_SECONDS3Най-краткият интервал между два телепорта през менюто за един играч. Площадките и менюто имат общ часовник за всеки играч, затова заявка от менюто до 3 секунди след телепорт с площадка също се пренебрегва.
PAD_ARRIVAL_GAP3На колко стъда от предната страна на площадката на местоназначението се появяват играчите, за да се озоват до площадката, а не върху нея.
PLACE_ATTEMPTS3Колко пъти порталът опитва TeleportAsync през 2 секунди, преди да се откаже.

Натисни Play още сега и стъпи на PadA: ще се появиш пред PadB. На менюто и порталите им трябват следващите две стъпки, но скриптът работи и без тях.

Стъпка 4: телепорт в друг плейс

Плейсът е отделен свят в играта ти, със свои сървъри: лоби и подземие или хъб и набор от нива. Играчите се местят между плейсовете чрез TeleportService, а Roblox го пуска само в публикуваната игра, затова тази стъпка завършва в приложението Roblox, а не в Studio.

  1. Ако играта още не е публикувана, избери File > Publish. Новите игри, докато не ги пуснеш, са отворени само за теб, за хората, на които си дал достъп Edit, и за членовете на групата с нужните роли, а за собствен тест на телепортите това е достатъчно.
  2. Създай втори плейс: отвори нов плейс от който и да е шаблон на Studio, построй своето подземие, после избери File > Publish As, кликни върху плочката на играта си, избери Add as a new place и натисни Create.
  3. Копирай ID на новия плейс. Отвори Asset Manager от менюто Window или от раздела Home, отиди в Places In Experience, кликни с десния бутон върху плейса и избери Copy Asset ID, това копира неговия place ID.
  4. Обратно в първия плейс вмъкни в Workspace Folder с име PlacePortals, а в нея закотвен Part с име DungeonPortal. Добави атрибут от тип Number с име PlaceId и постави ID като негова стойност.
  5. Натисни Play и докосни портала. Output отпечатва ред, който започва с Teleporters: would send: в Studio порталът не прави нищо повече.
  6. Публикувай играта отново с 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:

Трите стойности на Access Control for Places
НастройкаКой може да влезе в плейс, който не е стартовият
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) от LocalScriptRoblox отбелязва Teleport() като остарял, съветва да не се използва в нови проекти и разрешава TeleportAsync само от сървърни скриптове.Извиква TeleportAsync в сървърен скрипт.
Няма pcall, няма повторни опитиСтраницата на Roblox за телепортите казва, че те могат да се провалят и да дадат грешка, а също и да се провалят след старта.До 3 опита в pcall, а TeleportInitFailed позволява на играча да опита пак.
Отказва се, защото в Studio «не работи»TeleportService не поддържа плейтест в Studio.RunService:IsStudio() вместо това отпечатва какво би направил порталът.
GUI за телепорт, чиито бутони пращат позицияЧийтър може да извика същия ремоут с всяка позиция.Бутоните пращат името на точката, а сървърът го търси.
Монетите се предават в teleport dataRoblox казва, че teleport data се виждат от клиента и не са криптирани.Съветва да пазиш монетите и Wins в хранилище за данни и да ги зареждаш в другия плейс (виж Как да пренесеш данни в друг плейс).

Какво играчите могат и какво не могат да подправят

Приеми, че чийтърът управлява всичко на своето устройство: може да променя TeleportMenu, да извиква двата ремоута колкото пъти иска с всякакви аргументи и да мести своя персонаж. Ето какво му дава това при този телепорт.

Какво може да опита чийтърът и какво прави Teleporters с това
Чийтърът опитваРезултатЗащо
Да прати позиция или CFrame през ремоута на менютоПренебрегва сеTeleportRequest чете един низ, име на точка с дължина до 50 знака. Всичко останало се отхвърля.
Да поиска Castle без 3 WinsОтказСървърът чете Wins от своето копие на leaderstats. Сивият бутон е само подсказка.
Да поиска точка, която не съществуваПренебрегва сеСървърът търси името в TeleportSpots и не прави нищо, ако няма парт с такова име.
Да извиква ремоута на менюто отново и отновоНе повече от един телепорт през менюто на 3 секундиПрезареждането се пази на сървъра, за всеки играч.
Да задейства площадка, без да отиде до неяПопада до площадката в двойка, до която и така би могъл да стигнеRoblox изброява телепортирането до всяка точка и манипулирането на събитията Touched сред нещата, които клиентът може да прави със своя персонаж.
Да влезе директно в друг плейс на играта тиВъзможно, ако Access Control for Places не е Secure within universe onlyВиж Кой може да влезе в другите ти плейсове.
Да премести своя персонаж където си иска, включително в заключена точкаВъзможноВсяко устройство управлява движението на своя персонаж. Заключената точка е удобство, а не сейф, затова проверявай на сървъра, преди да даваш там нещо ценно.

Последният ред е честната граница на всеки телепорт. За състезателна игра добави сървърна проверка на движението, както в ръководството за бягане. Teleporters вече задава атрибута MovementCheckSkip, който тази проверка чете, затова собствените му телепорти не се отбелязват като нарушение: документацията на Roblox за сигурността казва, че игрите с легитимни телепорти имат нужда точно от такова изключение в проверките на движението.

Стъпка 5: тествай

  1. Натисни Play. Стъпи на PadA: появяваш се точно пред PadB, с гръб към нея. Обърни се и веднага стъпи на PadB: нищо не става, защото площадките те пренебрегват 2 секунди след пристигането. Слез, изчакай 2 секунди и стъпи пак на PadB: появяваш се пред PadA.
  2. Изчакай няколко секунди, после натисни Teleport в лявата част на екрана. В списъка се виждат Lake, Spawn и сивото "Castle (needs 3 wins)". Избери Lake: появяваш се на нея. Отвори менюто пак и избери Castle: нищо не става и в Output е тихо.
  3. Дай си 3 Wins (за това трябва скрипт leaderstats с IntValue Wins, например от ръководството за класация). Натисни превключвателя Client/Server, за да минеш на Server, намери в Explorer Players, своето име, leaderstats, Wins и задай неговото Value на 3 в прозореца Properties. Превключи обратно на Client и отвори менюто пак: Castle е станал лилав и те мести там.
  4. Докосни DungeonPortal. Output отпечатва ред, който започва с Teleporters: would send, с твоето име и place ID. В Studio така и трябва да бъде, а редът се отпечатва не по-често от веднъж на 2 секунди, колкото и дълго да стоиш на портала.
  5. Избери Server & Clients в падащия списък с режими на тест, задай 2 клиента и натисни Play. И двамата играчи могат да ползват площадките едновременно и презареждането на единия никога не блокира другия.
  6. Спри теста, публикувай играта и я пусни от приложението 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, с повторни опити.

RoCode прави
  • Може да прегледа плейса ти, когато стъпката го изисква, чрез 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 се виждат от клиента и не са криптирани, затова стават за нещо като избраната карта, но не и за монети. Запазвай монетите и предметите в хранилище за данни и ги зареждай в другия плейс.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.