重點摘要
傳送墊的做法是在 ServerScriptService 中放一個 Script,監聽傳送墊的 Touched 事件,用 Players:GetPlayerFromCharacter 找出玩家,再用 character:PivotTo() 把整個角色移到目標傳送墊正前方、背對著它,並對每位玩家設定幾秒的冷卻時間,讓目標傳送墊不會馬上把他送回去。要把玩家送到你遊戲中的另一個場景,請在伺服器 Script 中用 pcall 包住並呼叫 TeleportService:TeleportAsync(placeId, { player });這只在已發布的遊戲中有效,在 Studio 中無效。
- 用
PivotTo移動整個角色。設定HumanoidRootPart.Position會讓根零件和身體其他部分分開,因為設定 Position 時 Roblox 會更新接合。 - 傳送選單應該把目的地的名稱傳給伺服器,而不是位置。伺服器在移動任何人之前,會檢查名稱、冷卻時間與任何解鎖規則。
TeleportService:Teleport()已淘汰,而且是在用戶端執行。請在伺服器上使用TeleportAsync,用pcall包住、失敗時重試,並處理TeleportInitFailed。
兩種傳送
Roblox 遊戲中的傳送可能是三種東西:把你送過地圖的傳送墊、列出可跳往地點的選單,或通往另一個關卡的傳送門。前兩種是在玩家目前所在的伺服器內移動角色。第三種則把玩家送到你遊戲中的另一個場景,那個場景在自己的伺服器上執行。它們使用不同的 API,所以先弄清楚你需要哪一種會很有幫助。
| 同一個伺服器內 | 到你遊戲中的另一個場景 | |
|---|---|---|
| 呼叫 | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| 用途 | 傳送墊、傳送選單、把玩家從大廳移到競技場 | 通往另一個關卡的傳送門、把玩家送到獨立地城或對戰場景的大廳 |
| 在哪裡執行 | 伺服器 Script | 只能在伺服器 Script。用戶端的 Teleport() 已淘汰。 |
| 在 Studio 試玩測試中能用 | 可以 | 不行。Roblox 的 TeleportService 不支援 Studio 試玩測試,所以要在已發布的遊戲中測試。 |
| 玩家看到什麼 | 跳過地圖,如果該區域要先載入,可能要花最多 2 秒 | Roblox 的載入畫面,接著是另一個場景 |
| 金幣、物品與其他資料 | 維持原樣 | Roblox 會重設玩家的本機資料,所以所有重要的東西都必須在另一個場景中從資料儲存區取得 |
在本教學中,三種都放在同一個伺服器 Script 裡,所以一套規則就涵蓋你遊戲中的每一次傳送:由伺服器決定,每位玩家有自己的冷卻時間,玩家的裝置只負責告訴伺服器他想去哪個地點。
| 部分 | 位置 | 作用 |
|---|---|---|
含有 PadA 與 PadB 的 Folder TeleportPads | Workspace | 兩個傳送墊。每個傳送墊的 Destination 屬性寫著它要把玩家送去的傳送墊。 |
Folder TeleportSpots | Workspace | 選單清單中的每個地點各一個零件。WinsNeeded 屬性會把地點上鎖。 |
Folder PlacePortals | Workspace | 傳送門零件。每個傳送門的 PlaceId 屬性是它要把玩家送去的場景。 |
Script Teleporters | ServerScriptService | 處理三種傳送,並建立兩個 remote。這是唯一能發生傳送的地方。 |
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。Script 找的就是這個名稱。 - 在資料夾中插入兩個 Part,命名為
PadA與PadB。把每個都做成扁平的板子,例如 6 × 1 × 6 stud,並放在地上、彼此隔一段距離。在 Properties 視窗中勾選 Anchored,保持 CanCollide 與 CanTouch 開啟,並設定鮮豔的顏色與 Neon 材質,讓玩家注意到它們。 - 選取 PadA,把 Properties 視窗捲到 Attributes 區段,按 +。輸入名稱
Destination,選擇 String 型別並按 Save,然後把值設為PadB。在 PadB 上做同樣的事,值設為PadA。 - 旋轉每個傳送墊,讓它的正面朝向空地。玩家會出現在目標傳送墊正面前方 3 stud 處,背對著它,所以請在那裡留幾 stud 的空地。要看哪一面是正面,在傳送墊上按右鍵並選擇 Show Orientation Indicator:藍線標示的就是正面。用 Rotate 工具旋轉傳送墊,直到這條線指向玩家應該走開的方向。
讓玩家落在傳送墊旁邊而不是上面,是刻意的。Roblox 關於 debounce 的頁面提到,一次碰觸 Touched 會連續觸發很多次,所以直接出現在另一個傳送墊上的玩家,一旦冷卻結束就會再次觸發它,又被送回地圖另一頭。
你不只能用兩個傳送墊。傳送墊的 Destination 可以寫 TeleportPads 中的任何零件,所以三個傳送墊可以把玩家輪流送一圈。要做單向傳送墊,讓它指向 TeleportPads 中沒有自己 Destination 的零件:這樣的零件只接收玩家,不會把任何人送到別處。
步驟 2:加入傳送 Script
把游標移到 ServerScriptService 上,插入一個 Script,命名為 Teleporters,並貼上下面的程式碼。它現在處理傳送墊,完成接下來的步驟後還會處理選單與傳送門,所以只需要加入一次。開頭的設定就是你可以修改的那幾行。
-- 放在 ServerScriptService 中、名為 Teleporters 的 Script。
-- 每一次傳送都在這裡,也就是伺服器上決定:
-- 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")
-- 這個 Script 會自己建立兩個 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 rig 要加上腿的高度)。
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) -- 給速度檢查 Script 用的,如果你有的話
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 | 計算站立角色的根零件離地面多高:根零件高度的一半加上 Humanoid 的 HipHeight,R6 rig 再加上腿長。 | 這是 Roblox Humanoid.HipHeight 參考文件中的公式。角色的 pivot 是它的根零件,所以把 pivot 抬高這個量,不管是小的、大的虛擬人偶還是 R6,腳都會剛好踩在表面上。 |
teleportTo 開頭的檢查 | 如果玩家沒有帶根零件的活角色就結束,接著立刻記錄時間。 | 下面的串流請求可能讓 Script 等待。事先記錄時間,這段期間大量的 Touched 事件就不會觸發第二次傳送。 |
| 抵達點 | 目的地的上表面,抬高 rootHeight,面向它正面所指的方向,沒有傾斜。傳送墊的抵達點還會從正面再往外移 3 stud。 | 角色以站姿出現,而不是在目標零件裡面。在傳送墊旁邊時,他的腳從傳送墊上表面的高度開始,所以會往下落傳送墊厚度的距離到地面。CFrame.lookAlong 會在指定位置建立面向指定方向的 CFrame。 |
RequestStreamAroundAsync | 請 Roblox 先把抵達點周圍的區域傳給這位玩家,最多等 2 秒。 | 新的場景預設開啟 instance streaming,所以地圖遠處可能還沒載入到玩家的裝置上。Roblox 建議在把角色移到遠處前呼叫這個伺服器函式,但不保證實際會送達什麼。 |
| 第二次檢查 | 如果等待期間玩家離開了,或角色重生、死亡,就什麼都不移動。 | 玩家可能在區域載入時 reset 或離開遊戲。Roblox 自己的預先載入範例,也會在移動角色前檢查角色是否還在遊戲中。 |
有 SeatWeld 的那幾行 | 如果角色坐著,就銷毀把他固定在座位上的 Weld。 | Roblox 會把坐著的角色焊接在座位上。PivotTo 透過改變零件的 CFrame 來移動它們,而 Roblox 參考文件說,設定零件的 CFrame 也會移動與它接合的零件,所以少了這幾行,座位和焊在上面的一切都會跟著玩家一起抵達。銷毀 SeatWeld 正是 Roblox Seat 參考文件中用 Script 讓角色離開座位的方式。 |
character:PivotTo(target) | 把整個角色,所有肢體與配件一起,移到抵達點。 | Roblox 把 PivotTo 稱為從 Script 移動模型的主要函式。 |
第二行 lastTeleport | 抵達時重新開始冷卻。 | 串流請求可能要花最多 2 秒,和傳送墊本身的冷卻一樣長,所以少了這一行,玩家抵達時冷卻可能已經結束。 |
MovementCheckSkip | 每次移動後在 Player 上設定一個屬性。 | 伺服器的速度檢查會把這次跳躍當成作弊。跑步教學中的 MovementCheck 會讀取這個屬性,並從新位置重新開始測量。沒有這種 Script 時,這個屬性沒有作用。 |
| 設定 | 這裡的值 | 改變什麼 |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | 任何傳送之後,傳送墊與傳送門忽略玩家多久。 |
MENU_COOLDOWN_SECONDS | 3 | 同一位玩家兩次透過選單傳送之間的最短間隔。傳送墊和選單共用每位玩家的時鐘,所以從傳送墊傳送後 3 秒內的選單請求也會被忽略。 |
PAD_ARRIVAL_GAP | 3 | 玩家出現在離目標傳送墊正面幾 stud 的地方,讓他們落在傳送墊旁邊而不是上面。 |
PLACE_ATTEMPTS | 3 | 傳送門以 2 秒間隔嘗試 TeleportAsync 幾次後放棄。 |
現在就按 Play 並踏上 PadA:你會出現在 PadB 前面。選單與傳送門需要接下來兩個步驟,但 Script 沒有它們也已經能運作。
步驟 4:傳送到另一個場景
場景是你遊戲中一個獨立的世界,有自己的伺服器:大廳與地城,或主城與一組關卡。玩家透過 TeleportService 在場景之間移動,而 Roblox 只在已發布的遊戲中執行它,所以這一步最後是在 Roblox App 中完成,而不是在 Studio。
- 如果遊戲還沒發布,請選擇 File > Publish。新遊戲在你正式推出之前,只對你、你給予 Edit 權限的人,以及有相應角色的群組成員開放,用來自己測試傳送已經足夠。
- 建立第二個場景:從任一個 Studio 範本開啟新場景,蓋好你的地城,然後選擇 File > Publish As,點你遊戲的圖塊,選擇 Add as a new place 並按 Create。
- 複製新場景的 ID。從 Window 選單或 Home 分頁打開 Asset Manager,進入 Places In Experience,在場景上按右鍵並選擇 Copy Asset ID,這會複製它的 place ID。
- 回到第一個場景,在 Workspace 中插入一個名為
PlacePortals的 Folder,並在裡面放一個名為DungeonPortal、Anchored 的 Part。加入一個名為PlaceId、型別為 Number 的屬性,並把 ID 貼上作為它的值。 - 按 Play 並碰觸傳送門。Output 會印出一行以
Teleporters: would send開頭的訊息:在 Studio 中傳送門只會做這件事。 - 再次透過 File > Publish 發布遊戲,讓傳送門出現在已發布的遊戲中,並像步驟 5那樣從 Roblox App 測試它。
Teleporters 在 pcall 中呼叫 TeleportAsync,最多 3 次,每次嘗試之間停 2 秒,因為 Roblox 關於傳送的頁面說,傳送可能會失敗並丟出錯誤,並建議重試。傳送也可能已經開始,卻在最後一刻沒有錯誤地失敗,讓玩家留在原地。這種情況 Roblox 會觸發 TeleportInitFailed,Script 會取消玩家的「正在離開」旗標,所以再次碰觸傳送門就會重新嘗試。
要讓玩家回來,在另一個場景中做同樣的事:把一份 Teleporters 放到它的 ServerScriptService,並加一個傳送門,它的 PlaceId 是你第一個場景的 ID,用同樣的方式從 Asset Manager 複製。
誰能進入你的其他場景
Roblox 的安全文件警告:用戶端一旦進入你遊戲中的一個場景,就能傳送到其中任何其他場景,不管你設計了什麼路線,而關閉場景的 Direct Access 只會移除網站上的 Join 按鈕。改變這件事的是 Creator Dashboard 中 Audience > Access Settings 下的 Access Control for Places 設定:
| 設定 | 誰能進入不是起始場景的場景 |
|---|---|
| Fully open | 任何人,透過任何遊戲的傳送、deep link、遊戲邀請與加入好友。 |
| Limited to same universe | 只有從你的遊戲內部傳送過來的玩家。用戶端與伺服器的傳送都允許。 |
| Secure within universe only | 只有你的伺服器 Script 從這個遊戲內部傳送過來的玩家。 |
如果玩家只能透過你的傳送門進入某個場景,例如地城,請選擇 Secure within universe only。本教學中的每一次傳送都從伺服器開始,所以它會繼續運作。Roblox 也說很多遊戲不需要安全傳送,所以所有場景都對所有人開放的遊戲,可以維持原本的設定。
舊的傳送教學錯在哪裡
如果你在拿本教學和影片或論壇文章比較,以下是重要的差異,以及每種做法會造成問題的原因。
| 教學 | 問題 | 本教學 |
|---|---|---|
設定 hit.Parent.HumanoidRootPart.Position = target.Position | Roblox 參考文件說,設定 Position 會更新零件的接合,它會相對於接合的零件移動:根零件自己跑走,身體留在原地。 | 用 PivotTo 移動整個角色。 |
設定 HumanoidRootPart.CFrame = target.CFrame | 角色的中心落在目標零件的中心,有一部分卡在裡面,還會繼承零件的傾斜。 | 角色以站立高度出現在上表面上方、傳送墊旁邊,沒有傾斜。 |
整個傳送墊只用一個 debounce 變數 | 一位玩家傳送時,傳送墊會忽略其他所有人。而完全沒有 debounce 時,出現在另一個傳送墊上的玩家會馬上被送回去。 | 每位玩家一個冷卻時間,在任何等待之前記錄,而且玩家出現在傳送墊旁邊。 |
從 LocalScript 呼叫 TeleportService:Teleport(placeId, player) | Roblox 把 Teleport() 標為已淘汰,建議新專案不要使用,並且只允許從伺服器 Script 呼叫 TeleportAsync。 | 在伺服器 Script 中呼叫 TeleportAsync。 |
沒有 pcall,沒有重試 | Roblox 關於傳送的頁面說,傳送可能會失敗並丟出錯誤,也可能在開始後才失敗。 | 在 pcall 中最多嘗試 3 次,TeleportInitFailed 讓玩家可以再試一次。 |
| 因為在 Studio 中「沒有作用」就放棄 | TeleportService 不支援 Studio 試玩測試。 | 改用 RunService:IsStudio() 印出傳送門會做什麼。 |
| 按鈕會傳送位置的傳送 GUI | 作弊者可以用任何位置呼叫同一個 remote。 | 按鈕傳送地點名稱,由伺服器去尋找。 |
| 把金幣放在 teleport data 中傳過去 | Roblox 說 teleport data 用戶端看得到,而且沒有加密。 | 建議把金幣與 Wins 存在資料儲存區,並在另一個場景中載入(請見如何把資料帶到另一個場景)。 |
玩家能偽造什麼、不能偽造什麼
假設作弊者控制自己裝置上的一切:他可以修改 TeleportMenu、用任何引數任意次數呼叫兩個 remote,並移動自己的角色。以下是這些對這套傳送能帶給他什麼。
| 作弊者嘗試 | 結果 | 原因 |
|---|---|---|
| 透過選單 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:測試
- 按 Play。踏上 PadA:你會出現在 PadB 正前方,背對著它。轉身馬上踏上 PadB:什麼都不會發生,因為傳送墊在你抵達後 2 秒內會忽略你。走下來,等 2 秒再踏上 PadB:你會出現在 PadA 前面。
- 等幾秒,然後按畫面左側的 Teleport。清單中會看到 Lake、Spawn 和灰色的 "Castle (needs 3 wins)"。選 Lake:你會出現在那裡。再打開選單並選 Castle:什麼都不會發生,Output 也很安靜。
- 給自己 3 Wins(這需要一個有 IntValue Wins 的 leaderstats Script,例如排行榜教學中的那個)。按 Client/Server 切換按鈕切到 Server,在 Explorer 中找到
Players、你的名字、leaderstats、Wins,並在 Properties 視窗中把它的 Value 設為 3。切回 Client 並再次打開選單:Castle 變成紫色,而且會把你送過去。 - 碰觸 DungeonPortal。Output 會印出一行以
Teleporters: would send開頭、帶有你的名字與 place ID 的訊息。在 Studio 中本來就該這樣,而且不管你在傳送門上站多久,它每 2 秒最多只印一次。 - 在測試模式下拉選單中選擇 Server & Clients,設定 2 個用戶端並按 Play。兩位玩家可以同時使用傳送墊,一位玩家的冷卻永遠不會擋住另一位。
- 停止測試,發布遊戲,並從 Roblox App 啟動它。碰觸傳送門:會出現 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 提到,遇到和保留伺服器有關的失敗時,重試特別有用,而 Script 已經會重試了。
如何把資料帶到另一個場景
傳送會重設這位玩家的所有本機資料。Roblox 的 teleport data 用 TeleportOptions:SetTeleportData() 設定,在另一個場景中用 player:GetJoinData() 讀取,它用戶端看得到而且沒有加密,所以只能用在無害的選擇上,例如要載入哪張地圖。金幣、Wins 與物品請存在資料儲存區,像DataStore 教學那樣,並在玩家抵達另一個場景時重新載入。
自訂載入畫面
傳送到場景的載入期間,玩家會看到 Roblox 的標準載入畫面。要顯示你自己的畫面,請在用戶端用一個 ScreenGui 呼叫 TeleportService:SetTeleportGui(),例如放在 ReplicatedStorage 中的那個。本教學的傳送都從伺服器開始,所以用戶端必須事先呼叫它,例如在玩家一進入時。Roblox 說每次傳送前都要重新設定畫面,而且它不會用在其他遊戲的場景上。那裡也提到,這個 ScreenGui 裡面的 Script 不會執行,所以請把它做成靜態的。
回合傳送與檢查點
回合系統在每個回合開始時,用同樣的 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 中沒有它的紅色錯誤。Script 錯誤教學會詳細說明這個警告。
Teleporters: PadA points to PadC, which is not a part in TeleportPads
傳送墊的 Destination 屬性寫的東西,不是直接放在 TeleportPads 資料夾中的零件。請檢查屬性值與目標傳送墊名稱的拼字和大小寫。每個傳送墊只會在玩家第一次碰到時警告一次。
我踏上傳送墊,什麼都沒發生
確認資料夾的名稱完全是 TeleportPads,而且遊戲開始時直接放在 Workspace 中,傳送墊的 Destination 屬性是 String 型別(Number 型別的屬性會被忽略),而且距離你上次傳送已經過了 2 秒。也請確認傳送墊開啟了 CanTouch:Roblox 說,把 Touched 連接到 CanTouch 關閉的零件會丟出錯誤,而這會讓 Script 停止。
我出現在牆壁裡,或從邊緣掉下去
玩家會出現在目標傳送墊正面前方 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 中建立零件與 Script,所以不需要從聊天視窗複製程式碼。
加入傳送:Workspace.TeleportPads 中的傳送墊,把玩家送到自己 Destination 屬性所寫的傳送墊,冷卻 2 秒;Workspace.TeleportSpots 中地點的 Teleport 選單,Castle 需要 3 Wins,由伺服器檢查;以及 Workspace.PlacePortals 中的傳送門,把玩家送到自己 PlaceId 屬性中 ID 的場景,並會重試。
- 需要時可以透過 Search Game 與 Search Scripts 瀏覽你的場景,沿用已經有的物品、remote 或儲存程式碼,而不是再加一套系統
- 透過 Create Instance 建立資料夾與傳送墊零件,透過 Set Property 設定它們的屬性,並透過 Create Script 寫出 Teleporters 與 TeleportMenu
- 它被要求用 Check Script 檢查寫出的每個 Script 能否編譯,Check Script 會在 Studio 中編譯而不執行它
- 分批送出變更,每一批都是 Studio 記錄中的一個復原點
場景之間的傳送只在已發布的遊戲中有效,所以請自己在 Roblox App 中測試。使用外掛程式 3.9 或更新版本,RoCode 可以執行短暫的試玩測試並讀取錯誤;使用外掛程式 3.9.15 或更新版本,它的測試角色可以踏上傳送墊並按選單按鈕,但它只檢查自己決定要測試的項目,所以請自己踏上傳送墊並打開選單。傳送只是遊戲中眾多系統之一;用 RoCode 製作整個遊戲也是一樣,一個提示詞做一個系統。RoCode 如何連接 Studio。
常見問題
要怎麼在 Roblox Studio 做傳送墊?
給兩個零件設定 Destination 屬性,寫上彼此的名稱,再讓一個伺服器 Script 用 character:PivotTo 把碰到傳送墊的人移到另一個傳送墊正前方,並對每位玩家設定短暫的冷卻時間。步驟 1 與步驟 2 做的正是這件事。
為什麼我的傳送在 Studio 中沒有作用?
傳送墊與選單在 Studio 中可以用。傳送到另一個場景則不行:Roblox 的 TeleportService 不支援 Studio 試玩測試,所以請發布遊戲,在 Roblox App 中測試。本教學的 Script 會改為印出傳送門會做什麼,所以你還是能確認它有觸發。
要怎麼把玩家傳送到我遊戲中的另一個場景?
透過 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 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(英文). 從 Script 移動模型的主要函式
- Roblox Creator Docs:BasePart.Position(英文). 為什麼設定接合零件的 Position 會讓它相對於其他零件移動
- Roblox Creator Docs:Humanoid.HipHeight(英文). 站立角色的根零件在什麼高度,適用 R15 與 R6 rig
- 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 會觸發好幾次
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。