教程 · 游戏系统

Roblox Studio 怎么做传送

Roblox 里的传送是两件事之一:把角色移到同一服务器上的另一个位置,或者把玩家送到你游戏中的另一个场景。在这篇教程里,我们用一个服务端脚本把两种都做出来:把你送到配对踏板的传送踏板,一个用 Wins 解锁锁定地点的 Teleport 菜单,以及在 Roblox 传送失败时会重试的跨场景传送门。

更新于 2026年11月20日阅读约 5 分钟作者

要点

做传送踏板,在 ServerScriptService 中放一个 Script,监听踏板的 Touched 事件,用 Players:GetPlayerFromCharacter 找到玩家,再用 character:PivotTo() 把整个角色移到目标踏板正前方、背对着它的位置,并给每个玩家几秒钟的冷却时间,这样目标踏板不会立刻把他送回去。要把玩家送到你游戏的另一个场景,在服务端 Script 里用 pcall 包住 TeleportService:TeleportAsync(placeId, { player }) 来调用;这只在已发布的游戏中有效,在 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 试玩中能用吗能不能。Roblox 的 TeleportService 不支持在 Studio 中试玩,所以要在已发布的游戏中测试。
玩家看到什么一次跨越地图的跳转,如果需要先加载那片区域,可能要花最多 2 秒Roblox 的加载界面,然后是另一个场景
金币、物品和其他数据保持不变Roblox 会清除玩家的本地数据,所以一切重要的东西都必须在另一个场景里从数据存储加载

本教程把这三种都放在一个服务端 Script 里,所以一套规则就覆盖了你游戏里的每一次传送:由服务端决定,每个玩家有自己的冷却时间,玩家的设备只报告它想去哪个地点。

传送由哪些部分组成
组成部分位置作用
Folder TeleportPads,里面有 PadA 和 PadBWorkspace两块踏板。每块的 Destination 属性写着它把玩家送到哪块踏板。
Folder TeleportSpotsWorkspace菜单列表中的每个地点对应一个零件。WinsNeeded 属性用来锁定地点。
Folder PlacePortalsWorkspace传送门零件。每个传送门的 PlaceId 属性就是它要把玩家送去的场景。
Script TeleportersServerScriptService管理全部三种传送,并创建两个 remote。传送只可能在这里发生。
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 x 1 x 6 stud,并隔开一段距离放在地面上。在 Properties 窗口中勾选 Anchored,保持 CanCollide 和 CanTouch 开启,并设置醒目的颜色和 Neon 材质,让玩家能注意到它们。
  3. 选中 PadA,把 Properties 窗口滚动到 Attributes 部分,点击 +。输入名称 Destination,选择类型 String,点击 Save,然后把值设为 PadB。在 PadB 上做同样的操作,值设为 PadA。
  4. 旋转每块踏板,让它的正面朝向空地。玩家会出现在目标踏板正面前方 3 stud 处,背对着它,所以那里要留出几 stud 的空地。要看哪一面是正面,右键点击踏板并选择 Show Orientation Indicator:蓝线标出的就是正面。用 Rotate 工具旋转踏板,直到这条线指向玩家应该走开的方向。

玩家出现在踏板旁边而不是踏板上,这是有意的。Roblox 关于 debounce 的页面指出,一次触碰会让 Touched 连续触发很多次,所以直接出现在另一块踏板上的玩家会在冷却结束时再次触发它,又被送回地图另一边。

你不限于两块踏板。踏板的 Destination 可以指向 TeleportPads 中的任何零件,所以三块踏板可以把玩家轮流送成一个圈。要做单向踏板,就让它指向 TeleportPads 中一个没有自己 Destination 的零件:这样的零件只接收玩家,不把任何人送走。

第 2 步:添加传送脚本

把鼠标移到 ServerScriptService 上,插入一个 Script,命名为 Teleporters,并粘贴下面的代码。现在它负责踏板,完成后面的步骤后还会负责菜单和传送门,所以你只需要添加一次。开头的设置就是给你修改的那几行。

Script 位置: ServerScriptService 名称: Teleporters
-- ServerScriptService 中的 Script,名为 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 -- 目标踏板前方的 stud 数,让玩家落在它旁边
local PLACE_ATTEMPTS = 3

local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")

-- 这个脚本自己创建两个 remote,所以不要手动添加它们
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 是它的根零件,所以把它抬到站立高度。
	-- 踏板则把玩家放在自己前方几 stud 处,因为站在踏板上的玩家
	-- 下一步就会再次触发它。
	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计算站立角色的根零件离地面有多高:根零件高度的一半加上 Humanoid 的 HipHeight,R6 骨架还要加上腿长。这是 Roblox 的 Humanoid.HipHeight 参考文档里的公式。角色的 pivot 是它的根零件,所以把 pivot 抬高这么多,无论是小角色、大角色还是 R6,脚都会落在表面上。
teleportTo 开头的检查如果玩家没有带根零件的存活角色就退出,然后立即记录时间。下面的流式加载请求可能让脚本等待。提前记录时间,这期间的大量 Touched 事件就不会触发第二次传送。
到达点目标的顶面,抬高 rootHeight,朝向它正面所指的方向,没有倾斜。对踏板来说,这个点还会从它的正面再移出 3 stud。角色以站立姿态出现,而不是卡在目标零件里。在踏板旁边时,他的脚从踏板顶面的高度开始,所以会下落一个踏板厚度到地面上。CFrame.lookAlong 在一个位置上按给定的朝向构建 CFrame。
RequestStreamAroundAsync请 Roblox 先把到达点周围的区域发给这个玩家,最多等待 2 秒。新场景默认开启 instance streaming,所以地图的远处可能还没有加载到玩家的设备上。Roblox 建议在把角色移到远处之前进行这个服务端调用,不过它不保证具体能加载到什么。
第二次检查如果在等待期间玩家离开了,或者角色重生或死亡了,就什么都不移动。玩家可能在区域加载期间重置或退出了游戏。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玩家出现在离目标踏板正面多少 stud 的地方,让他们落在踏板旁边而不是踏板上。
PLACE_ATTEMPTS3传送门以 2 秒间隔尝试 TeleportAsync 多少次后放弃。

现在就点击 Play 并踩上 PadA:你会出现在 PadB 前面。菜单和传送门需要接下来的两步,但脚本没有它们也已经能工作了。

第 4 步:传送到另一个场景

场景(place)是你游戏中一个独立的世界,有自己的服务器:比如大厅和地牢,或者枢纽和一组关卡。玩家通过 TeleportService 在场景之间移动,而 Roblox 只在已发布的游戏中运行它,所以这一步最终要在 Roblox 应用中完成,而不是在 Studio 中。

  1. 如果游戏还没有发布,选择 File > Publish。新游戏在你正式发布之前只对你自己、你给了 Edit 权限的人以及拥有相应角色的群组成员开放,用来自己测试传送已经足够。
  2. 创建第二个场景:用任意 Studio 模板打开一个新场景,搭好你的地牢,然后选择 File > Publish As,点击你游戏的图块,选择 Add as a new place,再点击 Create。
  3. 复制新场景的 ID。从 Window 菜单或 Home 选项卡打开 Asset Manager,进入 Places In Experience,右键点击场景并选择 Copy Asset ID,这会复制它的 place ID。
  4. 回到第一个场景,在 Workspace 中插入一个名为 PlacePortals 的 Folder,在里面放一个名为 DungeonPortal 的锚固 Part。添加一个 Number 类型、名为 PlaceId 的属性,并把 ID 粘贴为它的值。
  5. 点击 Play 并碰一下传送门。Output 会打印一行以 Teleporters: would send 开头的内容:在 Studio 中传送门只会做这件事。
  6. 通过 File > Publish 再次发布游戏,让传送门出现在已发布的游戏中,然后像第 5 步那样在 Roblox 应用中测试它。

Teleporters 在 pcall 中调用 TeleportAsync,最多 3 次,每次间隔 2 秒,因为 Roblox 关于传送的页面说传送可能失败并报错,并建议重试。传送也可能已经开始,却在最后一刻失败而不报错,把玩家留在原地。对这种情况,Roblox 会触发 TeleportInitFailed,脚本会清除玩家的“正在离开”标记,所以再碰一次传送门会重新尝试。

要让玩家能回来,在另一个场景里做同样的事:把 Teleporters 的副本放进它的 ServerScriptService,并添加一个传送门,它的 PlaceId 是你第一个场景的 ID,用同样的方法从 Asset Manager 复制。

谁能进入你的其他场景

Roblox 的安全文档提醒:一旦客户端进入了你游戏中的某个场景,它就能传送到这个游戏的任何其他场景,无论你设计的路线是什么,而关闭场景的 Direct Access 只会去掉网站上的 Join 按钮。能改变这一点的是 Creator Dashboard 中 Audience > Access Settings 下的 Access Control for Places 设置:

Access Control for Places 的三个值
设置谁能进入非起始场景
Fully open任何人,通过任何游戏的传送、deep link、游戏邀请以及加入好友。
Limited to same universe只有从你的游戏内部传送过来的玩家。客户端和服务端发起的传送都允许。
Secure within universe only只有被你的服务端脚本从这个游戏内部传送过来的玩家。

如果玩家只能通过你的传送门进入某个场景,比如地牢,请选择 Secure within universe only。本教程中的每次传送都从服务端开始,所以它会继续正常工作。Roblox 也说很多游戏并不需要安全传送,所以所有场景都对所有人开放的游戏可以保持默认设置。

旧的传送教程错在哪里

如果你在拿本教程和视频或论坛帖子作比较,下面是重要的区别,以及每种做法造成问题的原因。

传送教程中的常见做法,以及本教程用什么代替
旧教程问题本教程
设置 hit.Parent.HumanoidRootPart.Position = target.PositionRoblox 参考文档说,设置 Position 会更新零件的连接,它会相对于与之相连的零件发生偏移:根零件跑了,身体没跟上。用 PivotTo 移动整个角色。
设置 HumanoidRootPart.CFrame = target.CFrame角色的中心落在目标零件的中心,部分卡在里面,并继承零件的倾斜。角色出现在顶面上方的站立高度,在踏板旁边,没有倾斜。
整块踏板只用一个 debounce 变量一个玩家传送时,踏板会忽略所有其他人。而完全没有 debounce 时,出现在另一块踏板上的玩家会立刻被送回去。每个玩家一个冷却时间,在任何等待之前记录,并且玩家出现在踏板旁边。
在 LocalScript 中调用 TeleportService:Teleport(placeId, player)Roblox 把 Teleport() 标为已弃用,建议新项目不要使用,并且只允许在服务端脚本中调用 TeleportAsync。在服务端脚本中调用 TeleportAsync。
没有 pcall,没有重试Roblox 关于传送的页面说,传送可能失败并报错,也可能在开始之后才失败。在 pcall 中最多尝试 3 次,TeleportInitFailed 让玩家可以再试一次。
因为在 Studio 里“不能用”而放弃TeleportService 不支持在 Studio 中试玩。RunService:IsStudio() 改为打印传送门会做什么。
按钮发送位置的传送 GUI作弊者可以用任意位置调用同一个 remote。按钮发送地点名字,由服务端去查找。
把金币放在 teleport data 里传递Roblox 说 teleport data 对客户端可见且未加密。建议把金币和 Wins 保存在数据存储中,并在另一个场景里加载(见如何把数据带到另一个场景)。

玩家能伪造什么,不能伪造什么

假设作弊者能控制自己设备上的一切:他可以修改 TeleportMenu,用任意参数任意多次调用两个 remote,并移动自己的角色。下面是这些对这个传送系统意味着什么。

作弊者可能尝试什么,以及 Teleporters 如何应对
作弊者尝试结果原因
通过菜单 remote 发送位置或 CFrame被忽略TeleportRequest 只读取一个字符串,即长度不超过 50 个字符的地点名字。其他一切都被丢弃。
没有 3 Wins 就请求 Castle被拒绝服务端从它自己的 leaderstats 副本读取 Wins。灰色按钮只是提示。
请求一个不存在的地点被忽略服务端在 TeleportSpots 中查找这个名字,如果没有同名零件就什么也不做。
一遍又一遍地调用菜单 remote每 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(这需要一个带 Wins IntValue 的 leaderstats 脚本,比如排行榜教程里的那个)。点击 Client/Server 切换按钮切到 Server,在 Explorer 中找到 Players、你的名字、leaderstats、Wins,然后在 Properties 窗口中把它的 Value 设为 3。切回 Client 并重新打开菜单:Castle 变成了紫色,并且能把你送到那里。
  4. 碰一下 DungeonPortal。Output 会打印一行以 Teleporters: would send 开头、带有你的名字和 place ID 的内容。在 Studio 中本就应该这样,而且无论你在传送门上站多久,它最多每 2 秒打印一次。
  5. 在测试模式下拉列表中选择 Server & Clients,设为 2 个客户端,点击 Play。两个玩家可以同时使用踏板,一个人的冷却时间永远不会挡住另一个人。
  6. 停止测试,发布游戏,并从 Roblox 应用中启动它。碰一下传送门:Roblox 的加载界面出现,你会到达另一个场景。如果你留在原地,按 F9 打开 Developer Console,把日志切换到 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 指出,对于与预留服务器相关的失败,重试尤其有用,而这个脚本已经会重试。

如何把数据带到另一个场景

传送会清除这个玩家的所有本地数据。Roblox 的 teleport data 通过 TeleportOptions:SetTeleportData() 设置,在另一个场景中通过 player:GetJoinData() 读取,它对客户端可见且未加密,所以只用它传递无害的选择,比如要加载哪张地图。金币、Wins 和物品请保存在数据存储中,就像 DataStore 教程里那样,并在玩家到达另一个场景时重新加载。

自定义加载界面

跨场景传送加载期间,玩家看到的是 Roblox 的标准加载界面。要显示你自己的,在客户端用一个 ScreenGui 调用 TeleportService:SetTeleportGui(),比如放在 ReplicatedStorage 里的那个。本教程中的传送从服务端开始,所以客户端需要提前调用它,比如玩家一进入就调用。Roblox 说每次传送前都需要重新设置这个界面,而且传送到另一个游戏的场景时不会使用它。那里还指出,这个 ScreenGui 里的脚本不会运行,所以要把它做成静态的。

回合传送和存档点

回合系统在每回合开始时用同样的 PivotTo 调用把所有玩家送到竞技场,而跑酷教程中的 PivotTo 还是 SpawnLocation 一节把这种做法和 Roblox 的出生点做了比较。如果某个地点只应在打完回合后解锁,回合系统已经会发放 WinsNeeded 读取的 Wins。

常见错误与解决办法

点击 Play 之前先打开 Output 窗口(Window 菜单,然后 Output)。当 Destination 指向不存在的东西时,Teleporters 会写出踏板的名字,所以大多数问题都能在那里看到。

Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'

TeleportMenu 在等待 Teleporters 创建的 remote,说明 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 说,在关闭了 CanTouch 的零件上连接 Touched 会报错,而这个错误会让脚本停止。

我出现在墙里,或者从边缘掉下去

玩家会出现在目标踏板正面前方 3 stud 处。右键点击踏板,选择 Show Orientation Indicator,然后旋转踏板,直到蓝线指向空地。菜单地点会把玩家放在零件上方,所以每个地点都要放在地面上。

我拿到 3 Wins 之后 Castle 按钮仍然是灰色

列表在打开菜单时绘制,所以关掉菜单再重新打开。如果按钮还是灰色,检查 leaderstats 里有一个名字正好是 Wins 的 IntValue,并且 Wins 是在服务端改变的,而不只是在 Client 模式下。

传送门在已发布的游戏中没有反应

按 F9 打开 Developer Console,把日志切换到 Server 视图(只有游戏所有者和有编辑权限的群组成员能看到,因为 Teleporters 是服务端 Script),阅读 Teleporters: 警告,里面写着 Roblox 给出的原因。检查传送门的 PlaceId 属性是 Number 类型,包含来自 Asset Manager 的 ID,并且添加传送门后你重新发布了场景。

用 RoCode 来做

如果不想手动搭建这些,RoCode 可以在你打开的场景里完成。RoCode 是独立的 Roblox Studio AI 代理,与 Roblox 无关:你在它的网页聊天里描述功能,它的 Studio 插件会在你的 Explorer 中创建零件和脚本,所以你不必从聊天窗口复制代码。

你输入

添加传送:Workspace.TeleportPads 中的踏板,把玩家送到它自己 Destination 属性所写的踏板,冷却 2 秒;一个用于 Workspace.TeleportSpots 中地点的 Teleport 菜单,其中 Castle 需要 3 Wins,并在服务端检查;以及 Workspace.PlacePortals 中的传送门,把玩家送到它自己 PlaceId 属性所写 ID 的场景,并带有重试。

RoCode 的操作
  • 在某一步需要时,可以用 Search Game 和 Search Scripts 查看你的场景,基于已有的物品、remote 或存档代码来做,而不是再加一套系统
  • 用 Create Instance 创建文件夹和踏板零件,用 Set Property 设置它们的属性,并用 Create Script 编写 Teleporters 和 TeleportMenu
  • 它被要求用 Check Script 检查每个写好的脚本能否编译,Check Script 会在 Studio 中编译脚本而不运行它
  • 分批发送改动,每一批都是 Studio 历史中的一个撤销点

跨场景传送只在已发布的游戏中有效,所以请自己在 Roblox 应用中测试它们。使用插件 3.9 或更新版本时,RoCode 可以运行简短试玩并读取错误;使用插件 3.9.15 或更新版本时,它的测试角色可以踩踏板、点击菜单按钮,但它只检查自己决定要测试的内容,所以请亲自踩一踩踏板、打开菜单看看。传送只是游戏中众多系统之一;用 RoCode 制作整个游戏也是同样的方式,每个提示词一个系统。RoCode 如何连接 Studio。

常见问题

怎么在 Roblox Studio 里做传送踏板?

给两个零件设置 Destination 属性,值是彼此的名字,再让一个服务端脚本用 character:PivotTo 把碰到踏板的人移到另一块踏板正前方,每个玩家有短暂的冷却时间。第 1 步和第 2 步做的正是这个。

为什么我的传送在 Studio 里不起作用?

踏板和菜单在 Studio 中是能用的。跨场景传送不行:Roblox 的 TeleportService 不支持在 Studio 中试玩,所以请发布游戏并在 Roblox 应用中测试。本教程的脚本会打印传送门本来会做什么来代替传送,所以你仍然可以确认它被触发了。

怎么把玩家传送到我游戏的另一个场景?

通过 File > Publish As(Add as a new place)添加场景,从 Asset Manager 复制它的 place ID,然后在服务端 Script 中用 pcall 包住 TeleportService:TeleportAsync(placeId, { player }) 来调用,失败时重试。第 4 步会带你完成全部过程。

怎么做传送 GUI?

在 LocalScript 中搭建按钮,只把玩家选中的地点名字发给服务端。服务端在文件夹中查找这个名字,检查冷却时间和任何解锁规则,然后移动角色。永远不要从客户端发送位置:作弊者可以发送任意位置。

为什么传送后我的角色会卡住或散架?

给根零件的 Position 赋值只会移动这个零件,不带上与它相连的身体,而复制踏板的 CFrame 会把角色的中心放进踏板里。请使用 character:PivotTo,目标点位于地面上方的站立高度,由 Humanoid 的 HipHeight 计算得出。

可以在传送时把金币或物品一起带过去吗?

安全地带不了。Roblox 说 teleport data 对客户端可见且未加密,所以它适合用来传递选中的地图之类的东西,但不适合金币。把金币和物品保存在数据存储中,并在另一个场景中加载它们。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。