重點摘要
在 Workspace.Cutscenes 中的資料夾裡,擺好名為 1、2、3 的隱形錨定零件,每個都朝向攝影機該看的方向。ServerScriptService 中的 Script 讀取它們的 CFrame,讓玩家停在原地,並透過 RemoteEvent 把鏡頭傳給這位玩家。StarterPlayerScripts 中的 LocalScript 把 workspace.CurrentCamera.CameraType 設為 Scriptable,每一幀讓攝影機從一個鏡頭移到下一個(用 TweenService:GetValue 做平滑),最後把 CameraType 改回 Custom,並把 CameraSubject 設回玩家的 Humanoid。
- 只有玩家的裝置能控制攝影機,所以攝影機程式碼是 LocalScript。伺服器只決定誰在何時看到哪段過場動畫。
- 攝影機是 Scriptable 時,Roblox 會停止更新
Camera.Focus。參考文件說要每一幀更新 Focus,否則離舊焦點很遠的動態光源可能不會被繪製。 Camera:Interpolate已被淘汰。Roblox 參考文件說要用 TweenService 來做攝影機動畫。
過場動畫的運作方式
每個玩家裝置都有自己的 Camera 物件,位在 workspace.CurrentCamera,所以只有 LocalScript 能移動玩家看到的畫面。決定誰在何時看到哪段過場動畫,則是伺服器的工作。本教學就是這樣分工的。一段過場動畫的流程如下:
- 伺服器決定玩家該看過場動畫:在伺服器上第一次重生時播
Intro,碰到觸發零件時則播另一段。 - CutsceneService 讀取鏡頭零件的 CFrame 與設定,請 Roblox 替這位玩家載入第一個鏡頭的區域,把玩家的 HumanoidRootPart 錨定讓他站著不動,然後只對這位玩家傳送
CutsceneEvent,內含 id 與鏡頭清單。 - 玩家裝置上的 CutscenePlayer 顯示黑邊與 Skip 按鈕,隱藏玩家清單、背包、生命條與觸控操作,把攝影機設為 Scriptable,並在每一幀移動它。
- 最後一個鏡頭結束,或玩家按下 Skip 時,它把攝影機還給角色,並帶著同樣的 id 對伺服器傳送
CutsceneEvent。 - 伺服器解除玩家的錨定。如果這則訊息一直沒來,它也會在過場動畫長度再加 2 秒後解除錨定。計時器在伺服器傳出過場動畫時開始,而在進入遊戲較慢時,裝置可能晚幾秒才開始播開場,因為不在 ReplicatedFirst 中的 LocalScript 要等遊戲載入完才會執行。這時玩家可能在自己畫面上的開場播完之前就能再移動。
| 元件 | 位置 | 作用 |
|---|---|---|
Script CutsceneService | ServerScriptService | 決定誰在何時看到哪段過場動畫、讀取鏡頭、讓玩家停在原地,並記住誰已經看過什麼。 |
LocalScript CutscenePlayer | StarterPlayer, StarterPlayerScripts | 在玩家畫面上播放過場動畫:黑邊、字幕、Skip 與攝影機移動。最後把攝影機還回來。 |
RemoteEvent CutsceneEvent | ReplicatedStorage(由 CutsceneService 建立) | 把鏡頭從伺服器送給單一玩家,並把「過場動畫結束了」的訊息傳回去。 |
Folder Cutscenes | Workspace | 每段過場動畫一個資料夾,例如 Intro,裡面有鏡頭零件 1、2、3。 |
Folder CutsceneTriggers | Workspace(選用) | 玩家碰到時就會啟動過場動畫的零件。 |
Workspace
Cutscenes Folder new
Intro Folder new
1 Part new
2 Part new
3 Part new
Bridge Folder new
1 Part new
2 Part new
CutsceneTriggers Folder new
BridgeTrigger Part new
ServerScriptService
CutsceneService Script new
StarterPlayer
StarterPlayerScripts
CutscenePlayer LocalScript new
步驟 1:擺好攝影機鏡頭
每個鏡頭都是一個隱形零件。攝影機會取用零件的位置,並朝向零件正面所朝的方向,所以擺一個鏡頭就等於擺一台攝影機。
- 在 Explorer 中把滑鼠移到 Workspace 上,按下 + 按鈕,插入名為
Cutscenes的 Folder。在裡面再插入一個名為Intro的 Folder。名稱的大小寫有差別。 - 把 Studio 攝影機移到你要的第一個畫面,就像替照片構圖一樣。
- 在 Intro 中插入一個 Part,改名為
1。 - 打開 Command Bar(在 Script 分頁,或從 Window 再選 Script),執行
workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame。在編輯模式下,CurrentCamera就是你正在看的畫面,所以零件會剛好放在這個鏡頭上。需要方括號與引號,是因為以數字開頭的名稱不能寫在點號後面。 - 在零件的 Properties 中勾選 Anchored,取消 CanCollide、CanTouch 與 CanQuery,並把 Transparency 設為 1。Anchored 讓它不會掉出地圖;其他設定讓它不會擋到玩家、觸發碰觸事件或擋住射線。
- 對接下來的畫面重複這些步驟,把零件命名為
2、3依此類推,並改掉 Command Bar 那行中的數字。CutsceneService 會依數字順序播放鏡頭,遇到第一個缺少的數字就停下,所以編號中有空缺會讓過場動畫提早結束。
之後想修改某個鏡頭,就把攝影機移到新的畫面,再用這個鏡頭的數字執行同一行。Transparency 為 1 時,零件在 Studio 中也看不見,所以需要時請在 Explorer 中選取它們。
每個鏡頭還可以有三個選用屬性。要新增屬性,先選取零件,把 Properties 視窗捲到 Attributes 區塊,按下 +,輸入名稱、選擇類型,再按 Save。
| 屬性 | 類型 | 預設值 | 作用 |
|---|---|---|---|
MoveSeconds | number | 3 | 攝影機從上一個鏡頭移到這個鏡頭要花幾秒。0 代表直接切換。鏡頭 1 永遠是切換,所以這個屬性對它無效。 |
HoldSeconds | number | 1 | 攝影機抵達後在這個鏡頭停留幾秒。 |
Caption | string | 無 | 從攝影機開始移向這個鏡頭起,顯示在下方黑邊上的文字。沒有 Caption 的鏡頭會清除文字。 |
小於 0 或大於 60 的數字,以及類型錯誤的屬性,都會被換成預設值。
步驟 2:加入伺服器 Script
把滑鼠移到 ServerScriptService 上,插入名為 CutsceneService 的 Script,貼上下面的程式碼。最上面的設定就是你可以修改的幾行。
-- 位於 ServerScriptService、名為 CutsceneService 的 Script。
-- 決定誰在何時看到哪段過場動畫。從 Workspace.Cutscenes 中有編號的零件
-- 讀取攝影機鏡頭,讓玩家停在原地,並告訴這位玩家的裝置
-- 播放這些鏡頭。攝影機本身只能在裝置上移動。
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- 設定
local INTRO_CUTSCENE = "Intro" -- 在玩家第一次重生時播放一次;設為 "" 就關閉
local DEFAULT_MOVE_SECONDS = 3 -- 鏡頭沒有 MoveSeconds 時的移動時間
local DEFAULT_HOLD_SECONDS = 1 -- 鏡頭沒有 HoldSeconds 時的停留時間
local MAX_SHOTS = 30
local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")
-- 這個 Script 會自己建立 CutsceneEvent,所以不要手動加入
local cutsceneEvent = Instance.new("RemoteEvent")
cutsceneEvent.Name = "CutsceneEvent"
cutsceneEvent.Parent = ReplicatedStorage
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
local seen: { [Player]: { [string]: boolean } } = {}
local playing: { [Player]: number } = {} -- 玩家正在看的過場動畫 id
local lastId = 0
local function secondsAttribute(part: Instance, name: string, default: number): number
local value = part:GetAttribute(name)
if typeof(value) == "number" and value >= 0 and value <= 60 then
return value
end
return default
end
-- 鏡頭就是以過場動畫命名的資料夾中的零件 1、2、3 ...
local function readShots(name: string): { Shot }
local shots: { Shot } = {}
local folder = cutscenes:FindFirstChild(name)
if not folder then
warn(`CutsceneService: no folder named {name} in Workspace.Cutscenes`)
return shots
end
for index = 1, MAX_SHOTS do
local part = folder:FindFirstChild(tostring(index))
if not (part and part:IsA("BasePart")) then
break
end
local caption = part:GetAttribute("Caption")
table.insert(shots, {
cframe = part.CFrame,
-- 第一個鏡頭是切換,所以攝影機會直接跳過去
move = if index == 1 then 0 else secondsAttribute(part, "MoveSeconds", DEFAULT_MOVE_SECONDS),
hold = secondsAttribute(part, "HoldSeconds", DEFAULT_HOLD_SECONDS),
caption = if typeof(caption) == "string" then caption else "",
})
end
return shots
end
local function setFrozen(player: Player, frozen: boolean)
local character = player.Character
local rootPart = character and character:FindFirstChild("HumanoidRootPart")
if rootPart and rootPart:IsA("BasePart") then
rootPart.Anchored = frozen
end
end
local function finish(player: Player, id: number)
if playing[player] ~= id then
return -- 這段過場動畫已經結束
end
playing[player] = nil
setFrozen(player, false)
end
local function play(player: Player, name: string): boolean
if playing[player] then
return false -- 一次只播一段過場動畫
end
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not humanoid or humanoid.Health <= 0 then
return false
end
local shots = readShots(name)
if #shots == 0 then
return false
end
lastId += 1
local id = lastId
playing[player] = id
-- 開啟 instance streaming 時,玩家的裝置上可能沒有鏡頭所看的區域,
-- 而請求只會暫時載入區域。現在先載入
-- 第一個鏡頭的區域(最多等 2 秒),之後每個鏡頭的區域
-- 則在攝影機移過去前 2 秒載入。
local function request(position: Vector3)
pcall(function()
player:RequestStreamAroundAsync(position, 2)
end)
end
request(shots[1].cframe.Position)
if playing[player] ~= id or player.Parent ~= Players then
return false -- 載入區域時玩家離開了
end
setFrozen(player, true)
cutsceneEvent:FireClient(player, id, shots)
local startsAt = 0 -- 從現在到開始移向這個鏡頭的秒數
for index, shot in shots do
if index > 1 then
task.delay(math.max(startsAt - 2, 0), function()
if playing[player] == id then
request(shot.cframe.Position)
end
end)
end
startsAt += shot.move + shot.hold
end
-- 保險:即使玩家的裝置一直沒回應,也解除玩家的凍結
task.delay(startsAt + 2, finish, player, id)
return true
end
-- 只有在這位玩家的過場動畫真的開始時才傳回 true
local function playOnce(player: Player, name: string): boolean
local playerSeen = seen[player]
if not playerSeen or playerSeen[name] then
return false
end
if play(player, name) then
playerSeen[name] = true
return true
end
return false
end
-- 玩家的裝置回報過場動畫已結束或被略過
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
if typeof(id) == "number" then
finish(player, id)
end
end)
-- 觸發零件:碰到時會播放它們的 Cutscene 屬性所指定的過場動畫
if triggers then
for _, trigger in triggers:GetChildren() do
if not trigger:IsA("BasePart") then
continue
end
if not trigger.CanTouch then
-- 對關閉 CanTouch 的零件連接 Touched 會出錯,所以只發出警告
warn(`CutsceneService: tick CanTouch on {trigger:GetFullName()} so it can start a cutscene`)
continue
end
trigger.Touched:Connect(function(otherPart: BasePart)
local name = trigger:GetAttribute("Cutscene")
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if player and typeof(name) == "string" then
playOnce(player, name)
end
end)
end
end
local function onCharacterAdded(player: Player, character: Model)
character:WaitForChild("HumanoidRootPart", 10)
if playing[player] then
setFrozen(player, true) -- 在過場動畫中重生,新角色也要讓他停在原地
elseif INTRO_CUTSCENE ~= "" then
playOnce(player, INTRO_CUTSCENE)
end
end
local function onPlayerAdded(player: Player)
if seen[player] then
return -- 已經設定好了
end
seen[player] = {}
player.CharacterAdded:Connect(function(character: Model)
onCharacterAdded(player, character)
end)
local character = player.Character
if character then
task.spawn(onCharacterAdded, player, character)
end
end
Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do -- Script 等待 Cutscenes 期間進入的所有玩家
onPlayerAdded(player)
end
Players.PlayerRemoving:Connect(function(player: Player)
seen[player] = nil
playing[player] = nil
end)
CutsceneService 會在 Workspace.Cutscenes 出現後自己建立 RemoteEvent CutsceneEvent,所以不需要手動在 ReplicatedStorage 插入任何東西。如果你已經做了同名的 RemoteEvent,請刪除它:LocalScript 可能會找到你那個,而伺服器上沒有人在監聽它。
| 設定 | 這裡的值 | 改變什麼 |
|---|---|---|
INTRO_CUTSCENE | "Intro" | Workspace.Cutscenes 中,在玩家第一次於伺服器上重生時播放的資料夾。設為 "" 就沒有開場。 |
DEFAULT_MOVE_SECONDS | 3 | 鏡頭沒有 MoveSeconds 屬性時,移動要花多久。 |
DEFAULT_HOLD_SECONDS | 1 | 鏡頭沒有 HoldSeconds 屬性時,攝影機要在鏡頭上停留多久。 |
MAX_SHOTS | 30 | CutsceneService 在一段過場動畫中會找的最大鏡頭編號。 |
Script 其餘部分依序做的事:
- 在伺服器上讀取鏡頭。
readShots把每個有編號零件的 CFrame 與屬性收集成清單。玩家的裝置拿到的是這份清單,所以它不需要那些零件本身。 - 一次一段過場動畫。玩家已經在看過場動畫,或他的角色沒有 Humanoid 或已經死亡時,
play什麼都不做。 - 每段過場動畫都有自己的 id。過場動畫結束或被略過時,裝置會把 id 傳回來,只有相符的 id 才會解除玩家的凍結,所以上一段過場動畫遲到的訊息無法結束新的一段。
- 讓玩家停在原地,方法是錨定他的 HumanoidRootPart;如果玩家在過場動畫中途重生,也會錨定新角色。Roblox 參考文件說,錨定的零件永遠不會因為重力、碰撞或其他物理而改變位置。WalkSpeed 不會被動到,所以不會和衝刺 Script 或加速通行證衝突。最後 Script 會解除 root part 的錨定,即使它是被別的 Script 錨定的也一樣,所以在可能播放過場動畫的期間,不要在其他地方錨定角色。
- 保險。
task.delay會在整段過場動畫長度再加 2 秒後解除玩家的凍結,即使他的裝置一直沒回應。 - 每段過場動畫在每台伺服器只播一次。
seen表格記錄每位玩家已經開始過哪些過場動畫,所以開場不會在重生時重播,觸發器的過場動畫也只播一次。playOnce只有在過場動畫真的開始時才傳回 true。 - 設定每位玩家。最後對
Players:GetPlayers()的迴圈,會接手 Script 等待 Cutscenes 資料夾期間進入的所有玩家。
鏡頭會用一次 FireClient 呼叫傳給玩家,形式是一份由小表格組成的清單。Roblox 的 remote events 頁面說不要傳送混用數字鍵與字串鍵的表格;這份清單只有數字鍵,而裡面每個鏡頭只有字串鍵,正是那裡建議的形式。
步驟 3:加入播放它的 LocalScript
- 在 Explorer 中展開 StarterPlayer,把滑鼠移到 StarterPlayerScripts 上,插入名為
CutscenePlayer的 LocalScript。 - 把它的內容換成下面的程式碼。
-- 位於 StarterPlayer > StarterPlayerScripts、名為 CutscenePlayer 的 LocalScript。
-- 播放伺服器傳來的過場動畫:黑邊、字幕、Skip 按鈕,以及
-- 在鏡頭之間移動的攝影機。之後把攝影機還給玩家。
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local StarterGui = game:GetService("StarterGui")
local TweenService = game:GetService("TweenService")
local UserInputService = game:GetService("UserInputService")
local cutsceneEvent = ReplicatedStorage:WaitForChild("CutsceneEvent") :: RemoteEvent
local player = Players.LocalPlayer
local camera = workspace.CurrentCamera
local BAR_HEIGHT = 0.12 -- 每條黑邊佔畫面高度的比例
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- Roblox 應該在攝影機前方幾個 stud 處繪製最多細節
local HIDDEN_CORE_GUIS = { Enum.CoreGuiType.PlayerList, Enum.CoreGuiType.Backpack, Enum.CoreGuiType.Health }
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
-- 過場動畫畫面:兩條黑邊與字幕,從邊緣延伸到邊緣。Roblox 建議
-- 只有沒人會按的東西才設 ScreenInsets None,所以下面的 Skip 有自己的 ScreenGui。
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- 全螢幕
gui.DisplayOrder = 10
gui.Enabled = false
local topBar = Instance.new("Frame")
topBar.Size = UDim2.fromScale(1, BAR_HEIGHT)
topBar.BackgroundColor3 = Color3.new(0, 0, 0)
topBar.BorderSizePixel = 0
topBar.Parent = gui
local bottomBar = topBar:Clone()
bottomBar.Position = UDim2.fromScale(0, 1 - BAR_HEIGHT)
bottomBar.Parent = gui
local caption = Instance.new("TextLabel")
caption.Size = UDim2.fromScale(0.7, 0.5)
caption.Position = UDim2.fromScale(0.15, 0.25)
caption.BackgroundTransparency = 1
caption.TextColor3 = Color3.new(1, 1, 1)
caption.TextScaled = true
caption.FontFace = REGULAR
caption.Text = ""
caption.Parent = bottomBar
-- Skip 按鈕使用預設內距,所以不會被相機挖孔擋住
local controls = Instance.new("ScreenGui")
controls.Name = "CutsceneControls"
controls.ResetOnSpawn = false
controls.DisplayOrder = 11
controls.Enabled = false
local skipButton = Instance.new("TextButton")
skipButton.AnchorPoint = Vector2.new(1, 0.5)
skipButton.Size = UDim2.fromScale(0.1, BAR_HEIGHT * 0.5)
skipButton.Position = UDim2.new(1, -16, 1 - BAR_HEIGHT / 2, 0) -- 在下方黑邊上,靠右
skipButton.BackgroundColor3 = Color3.fromRGB(60, 60, 60)
skipButton.TextColor3 = Color3.new(1, 1, 1)
skipButton.TextScaled = true
skipButton.FontFace = BOLD
skipButton.Text = "Skip"
skipButton.Parent = controls
-- Skip 要夠大,在小手機上也點得到
local skipMinSize = Instance.new("UISizeConstraint")
skipMinSize.MinSize = Vector2.new(64, 32)
skipMinSize.Parent = skipButton
local playerGui = player:WaitForChild("PlayerGui")
gui.Parent = playerGui
controls.Parent = playerGui
-- 目前的移動:在指定秒數內從一個攝影機 CFrame 移到下一個
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false
-- 在過場動畫期間每一幀執行。Scriptable 攝影機的 Focus 不會自己
-- 跟著任何東西,所以也在這裡設定。
local function updateCamera()
if camera.CameraType ~= Enum.CameraType.Scriptable then
camera.CameraType = Enum.CameraType.Scriptable -- 有東西把它重設了,例如重生
end
local alpha = if moveSeconds > 0 then (os.clock() - moveStart) / moveSeconds else 1
local eased = TweenService:GetValue(alpha, EASING_STYLE, Enum.EasingDirection.InOut)
camera.CFrame = moveFrom:Lerp(moveTo, eased)
camera.Focus = camera.CFrame * CFrame.new(0, 0, -FOCUS_DISTANCE)
end
local function waitOrSkip(seconds: number)
local endTime = os.clock() + seconds
while os.clock() < endTime and not skipRequested do
task.wait()
end
end
local function play(id: number, shots: { Shot })
if busy then
-- 已經有一段在播了,所以讓伺服器立刻解除玩家在這一段的凍結
cutsceneEvent:FireServer(id)
return
end
busy = true
skipRequested = false
-- 隱藏玩家清單、背包與生命條,並記住原本哪些是顯示的
local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
for _, coreGui in HIDDEN_CORE_GUIS do
wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
StarterGui:SetCoreGuiEnabled(coreGui, false)
end
-- 在手機上隱藏放在下方兩角的搖桿與跳躍按鈕
local touchControlsWere = GuiService.TouchControlsEnabled
GuiService.TouchControlsEnabled = false
gui.Enabled = true
controls.Enabled = true
-- 手把只能按下被選取的按鈕,所以對使用手把的玩家選取 Skip
if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = skipButton
end
camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable
moveTo = camera.CFrame
-- 排在 Roblox 自己的攝影機更新之後一步,和 Roblox 的攝影機教學相同
RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)
for _, shot in shots do
moveFrom = camera.CFrame -- 每次移動都從攝影機目前的位置開始
moveTo = shot.cframe
moveStart = os.clock()
moveSeconds = shot.move
caption.Text = shot.caption
waitOrSkip(shot.move + shot.hold)
if skipRequested then
break
end
end
-- 把攝影機還給玩家的角色
RunService:UnbindFromRenderStep("Cutscene")
camera.CameraType = Enum.CameraType.Custom
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if humanoid then
camera.CameraSubject = humanoid
end
if GuiService.SelectedObject == skipButton then
GuiService.SelectedObject = nil
end
gui.Enabled = false
controls.Enabled = false
caption.Text = ""
-- 只重新開啟這段過場動畫關掉的東西,其他的不動
for coreGui, enabled in wasEnabled do
if enabled then
StarterGui:SetCoreGuiEnabled(coreGui, true)
end
end
if touchControlsWere then
GuiService.TouchControlsEnabled = true
end
cutsceneEvent:FireServer(id) -- 伺服器會立刻解除玩家的凍結
busy = false
end
skipButton.Activated:Connect(function()
skipRequested = true
end)
cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
play(id, shots)
end)
StarterPlayerScripts 中的 LocalScript 只會在玩家進入時複製給他一次,角色重生後也會繼續執行。因此兩個 ScreenGui 都關閉了 ResetOnSpawn:如果開啟,Roblox 會在第一次重生時刪除它們,而這個 Script 不會重新建立。在 Script 連接 OnClientEvent 之前抵達的 remote 訊息會排入佇列,在連接後送達,所以很快就重生的玩家仍然會看到開場。
| 部分 | 作用 |
|---|---|
ScreenGui Cutscene | 兩條黑邊,各佔畫面高度的 12%(BAR_HEIGHT),以及下方黑邊上的字幕。ScreenInsets None 讓黑邊延伸到畫面最邊緣,DisplayOrder 10 則讓它們畫在 DisplayOrder 較小的 ScreenGui 上面。 |
ScreenGui CutsceneControls | 裡面只有 Skip 按鈕,位在下方黑邊右側,並有 UISizeConstraint 讓它不小於 64 x 32 像素,在手機上也容易點到。它使用預設的 ScreenInsets,內容不會跑到 Roblox 頂部列的按鈕與相機挖孔底下。Roblox 只建議對沒有東西可按的內容使用 None,所以 Skip 不能放在黑邊的 ScreenGui 裡。 |
HIDDEN_CORE_GUIS | 用 SetCoreGuiEnabled 隱藏玩家清單、背包與生命條,之前先用 GetCoreGuiEnabled 記下哪些是開啟的,最後只重新開啟它自己關掉的那些。如果遊戲在別處隱藏了背包,背包會維持隱藏;而在過場動畫期間開啟它們的 Script,例如主選單,也不會被覆蓋。 |
TouchControlsEnabled | 在手機與平板上,play 會在過場動畫期間把 GuiService.TouchControlsEnabled 設為 false。這會隱藏放在下方兩角、和 Skip 同一位置的搖桿與跳躍按鈕,如果它們原本是開啟的,最後會恢復。 |
updateCamera | 在過場動畫進行中每一幀執行。計算目前的移動完成了多少,用 TweenService:GetValue 做平滑,用 CFrame:Lerp 把攝影機放在兩個鏡頭之間,並把 Focus 設在攝影機前方 30 stud。 |
waitOrSkip | 等待鏡頭的移動與停留時間,每一幀都檢查 Skip 旗標。 |
play | 把攝影機設為 Scriptable,依序播放鏡頭,然後把攝影機還回來(CameraType 為 Custom,CameraSubject 為 Humanoid),重新開啟 core GUI 與觸控操作,並把過場動畫 id 傳給伺服器。如果第一段還在播時又來了第二段,它會立刻把第二段的 id 傳回去,讓伺服器不會為了這台裝置沒播的過場動畫把玩家留在原地。 |
| Skip 按鈕 | 按鈕被選取時,滑鼠點擊、觸控點按或手把的 A 鍵都會觸發 Activated。對主要輸入是手把的玩家,play 會在過場動畫開始時選取 Skip,結束時取消選取。 |
修改 BAR_HEIGHT 可以讓黑邊變細或變粗,修改 EASING_STYLE 可以改變鏡頭移動的感覺(請看攝影機程式碼做對了哪些事)。字幕與 Skip 按鈕都開啟了 TextScaled,所以文字會隨畫面放大縮小。
步驟 4:碰到零件時播放過場動畫
開場會自動播放。如果要在地圖上特定位置播放過場動畫,例如玩家第一次走到橋邊時,請加入第二段過場動畫與一個觸發零件。
- 在 Workspace、Cutscenes 中插入名為
Bridge的 Folder,照步驟 1 擺好它的鏡頭,命名為1與2。在 Command Bar 那行中,把Intro換成Bridge。 - 把滑鼠移到 Workspace 上,插入名為
CutsceneTriggers的 Folder。 - 在裡面插入名為
BridgeTrigger的 Part。把它做得夠大,讓玩家不碰到它就走不過去,例如橫跨道路的一塊又高又寬的板子。勾選 Anchored,取消 CanCollide 與 CanQuery,保持 CanTouch 勾選,並把 Transparency 設為 1。關閉 CanQuery 讓這塊隱形板子不會擋住射線,例如武器教學中的子彈。碰觸事件是由 CanTouch 控制,而不是 CanQuery,所以觸發器仍然有效。 - 替它加上 string 類型的
Cutscene屬性,值設為Bridge:也就是要播放的資料夾名稱。
CutsceneService 會在伺服器啟動時,對 CutsceneTriggers 中直接包含的每個零件連接 Touched,所以請在 Studio 中加入觸發器,不要在遊戲進行中用 Script 加入。關閉 CanTouch 的觸發器會被略過,並在 Output 中發出警告,因為 Script 對這種零件連接 Touched 時 Roblox 會出錯。
角色穿過零件時,Touched 會連續觸發很多次。seen 表格與「一次一段過場動畫」的規則,讓這變成每位玩家在每台伺服器只看一次。在另一段過場動畫期間碰到觸發器的玩家會被忽略,觸發器對他仍然保持可用。
不要把觸發器放在車道上。坐著的玩家的 HumanoidRootPart 會被焊接在座椅上,而焊接群組中有一個零件被錨定時,Roblox 會連同其他零件一起錨定。所以開車撞進觸發器的玩家,會讓整台載具連同乘客都停在原地,直到過場動畫結束。
攝影機程式碼做對了哪些事
設為 Scriptable,之後改回 Custom
CameraType 是 Scriptable 時,Roblox 的攝影機 Script 不會移動或更新攝影機,CutscenePlayer 正是因此才能設定它。最後它把 CameraType 改回 Custom,並把玩家的 Humanoid 設為 CameraSubject,也就是 Roblox 攝影機 Script 預設追蹤的對象。按下 Skip 後也會執行這一步,所以玩家永遠不會卡在看著最後一個鏡頭。
有兩個小檢查讓過場動畫在播放期間保持主導。如果有東西在過場動畫中途把 CameraType 改成別的值,每一幀執行的函式會在下一幀把它改回 Scriptable。而 Script 在每段過場動畫開始時都會重新讀取 workspace.CurrentCamera,因為目前的 Camera 一旦被刪除,Roblox 會建立新的。
每一幀設定 Focus
Camera.Focus 告訴引擎在光照之類的工作中要優先處理哪個區域。Roblox 的攝影機 Script 會讓它保持在 CameraSubject 上,但攝影機是 Scriptable 時就不會,Roblox 參考文件說這時要每一幀更新它:PointLight 之類物件的動態光源,在離焦點很遠的地方可能不會被繪製。CutscenePlayer 把它放在攝影機前方 30 stud(FOCUS_DISTANCE)。如果你的鏡頭看向更遠的東西,就把這個數字調大。
這個函式透過 RunService:BindToRenderStep 執行,在每一幀繪製之前,優先順序排在 Roblox 自己的攝影機更新之後一步(Enum.RenderPriority.Camera.Value + 1)。Roblox 的攝影機教學用的就是這個優先順序,所以過場動畫會在 Roblox 自己的攝影機程式碼執行完後才設定攝影機。
用 TweenService:GetValue 做平滑
對 camera.CFrame 做補間也能移動攝影機,但 Focus 仍然得每一幀設定,所以 CutscenePlayer 在同一個函式裡自己移動攝影機。對每一次移動,它會算出經過的時間比例(0 到 1),把它丟進帶有緩動樣式與方向的 TweenService:GetValue,再用 CFrame:Lerp 把攝影機放在兩個鏡頭之間相應的位置,Lerp 會讓位置沿直線移動,並平滑地旋轉。GetValue 會把輸入限制在 0 到 1 之間,所以移動時間一到,攝影機就剛好停在鏡頭上。
| EASING_STYLE | 移動的感覺 |
|---|---|
Enum.EasingStyle.Sine(本教學使用) | 速度依正弦曲線變化,起步柔和、停下也柔和。 |
Enum.EasingStyle.Quad | 和 Sine 類似,但曲線稍微陡一點。 |
Enum.EasingStyle.Linear | 速度固定,所以每次移動都以全速開始、以全速結束。 |
方向 InOut:緩動在移動的前半段正向套用,後半段反向套用,所以攝影機會從一個鏡頭加速出發,再減速抵達下一個鏡頭。
串流
新場景預設開啟 instance streaming:玩家的裝置預設只保留他角色周圍的區域,所以看向地圖另一端的鏡頭,可能會拍到空蕩蕩的世界。CutsceneService 會透過 Player:RequestStreamAroundAsync 請 Roblox 替這位玩家載入每個鏡頭的區域:第一個鏡頭的區域在傳送事件前載入,最多等 2 秒;之後每個鏡頭的區域則在攝影機移過去前 2 秒載入。
Roblox 寫道,這樣區域很可能會被載入,但不保證,而且效果是暫時的。請把重要的鏡頭放在串流半徑內,或在伺服器上對必須保持載入的區域使用 Player:AddReplicationFocus,直到你移除焦點為止。關閉串流時,裝置本來就有整張地圖,而每個請求外面的 pcall 代表失敗的請求不會讓過場動畫停下來。
舊的過場動畫教學有哪些問題
如果你拿這篇教學和影片或論壇文章比較,以下是重要的差異,以及每種做法為什麼會出問題。
| 教學 | 問題 | 本教學 |
|---|---|---|
用 camera:Interpolate() 移動攝影機 | Roblox 已把 Interpolate 標為淘汰,並建議用 TweenService 做攝影機動畫。 | 用 TweenService:GetValue 平滑每次移動,並在每一幀設定攝影機。 |
只對 camera.CFrame 做補間,其他都不管 | Focus 留在攝影機 Script 最後放的位置,也就是角色附近,所以離它很遠的動態光源可能不會被繪製(Roblox 的 Camera.Focus 參考文件)。 | 在 render step 中每一幀設定 Focus。 |
| 沒有把攝影機還回去 | 玩家會卡在看著最後一個鏡頭。 | 最後把 CameraType 設為 Custom,把 CameraSubject 設回 Humanoid,按下 Skip 後也一樣。 |
在 LocalScript 中由 Touched 啟動過場動畫 | 沒有東西能阻止它每次碰到都重播,而且決定是在玩家控制的裝置上做出的。 | 由伺服器挑選玩家,並記住誰已經看過。 |
| 在用戶端讀取攝影機零件 | 開啟串流時,離角色很遠的零件可能還不存在於裝置上。 | 由伺服器讀取零件、傳送它們的 CFrame,並在攝影機抵達前不久請求每個鏡頭的區域。 |
玩家能改變與不能改變的事
請假設作弊者能控制他裝置上的一切:他可以修改或刪除 CutscenePlayer,也能用任何值傳送 CutsceneEvent。對過場動畫來說,只要沒有任何實際的東西取決於它,這幾乎沒有影響。
| 作弊者嘗試 | 結果 |
|---|---|
| 略過過場動畫,或根本不播放 | 可以:那是他自己的畫面。永遠不要為「看完過場動畫」發放獎勵。 |
用任何值傳送 CutsceneEvent | 只有和他目前過場動畫相符的數字才有作用,而它唯一的作用就是讓他早一點解除凍結。 |
| 從地圖上任何地方碰觸觸發器 | 有可能:每台裝置都控制著自己的角色,Roblox 的安全文件也把偽造 Touched 事件列為它能做到的事之一。他會看到這段過場動畫一次,之後什麼也不會發生。 |
| 在過場動畫中照樣移動 | 沒有任何好處。凍結是為了讓正常玩家不會在過場動畫中途走開,不是安全檢查。 |
| 透過 remote 對別人播放過場動畫 | 不可能。只有伺服器能對玩家傳送 CutsceneEvent,而裝置唯一能傳回的,就是「這段過場動畫結束了」。 |
如果過場動畫之後會發生實際的事,例如之後會打開的門,或頭目登場,請讓伺服器依自己的計時器來做,而不是等裝置回報過場動畫結束。
步驟 5:測試
- 用 Command Bar 那行擺好 Intro 的三個鏡頭。給鏡頭 1 設
Caption"Welcome to the village",給鏡頭 2 設MoveSeconds2.5 與Caption"Find the bridge",鏡頭 3 不設任何屬性。 - 按下 Play(F5)。黑邊出現,攝影機帶著字幕切到鏡頭 1,用 2.5 秒移到鏡頭 2,再用 3 秒移到沒有字幕的鏡頭 3。之後攝影機回到角色身後,玩家清單重新出現。播放期間不能走動。
- 停止測試,再按一次 Play,在攝影機移向鏡頭 2 時按下 Skip。攝影機立刻回來,也能馬上走動。
- 走進 BridgeTrigger:播放 Bridge 過場動畫。再穿過它一次:什麼都不會發生。
- 在測試模式下拉選單中選擇 Server & Clients,設 2 個用戶端,按下 Play。Client 1 走進觸發器時,Bridge 過場動畫只在 Client 1 播放,Client 2 可以照常走動。
- 保持
Workspace.StreamingEnabled開啟,把一個鏡頭移到離重生點很遠的地方。攝影機抵達時,周圍的環境應該已經在那裡(很可能,但不保證:請看串流)。 - 測試手把時,停止測試、按下 Play,打開 Controller Emulator(Emulation 分頁,再選 Controller),用模擬手把走進 BridgeTrigger:Skip 應該已被選取,所以按 A 就能略過過場動畫。如果你使用 Studio 的 Device Simulator(在我們 2026 年 10 月 15 日檢查時它是 Beta:在 File、Beta Features、New Device Simulator 中開啟它並重新啟動 Studio),請選一支手機,把它轉成橫向,確認 Skip 沒有跑到相機挖孔底下、容易點到,而且過場動畫播放時搖桿與跳躍按鈕是隱藏的。
- 如果你也做了主選單,按下 Play,再按選單中的 Play 按鈕,讓開場播到最後:播完後玩家清單應該重新出現在畫面上。
全程保持 Output 視窗開著(Window 選單,再選 Output)。一切正常時,這些 Script 不會輸出任何東西,所以 CutsceneService 或 CutscenePlayer 發出的任何警告或紅色錯誤都是真正的問題。請看常見錯誤。
如何擴充這個系統
只在玩家第一次進入時播放開場
seen 表格只存在於一台伺服器,所以重新進入的玩家會再看到開場。要只在第一次進入時顯示,請把一個旗標,例如 SeenIntro,和玩家的其他資料一起透過DataStore 教學中的 PlayerData 模組儲存。INTRO_CUTSCENE 維持原樣,修改 CutsceneService 中 onCharacterAdded 負責開場的部分:等 PlayerData.Get(player) 傳回玩家資料,如果 data.SeenIntro 是 true 就略過開場,並且只在 playOnce(player, INTRO_CUTSCENE) 傳回 true 時才設定 data.SeenIntro = true。不要從載入資料的程式碼啟動開場:資料可能比角色重生更早載入完,而沒有角色時 play 什麼都不做,旗標就會替一段沒人看過的開場存下來。
在過場動畫中演出的角色
用 Studio 的 Animation Editor,或 Roblox 文件中提到的第三方動畫外掛程式,例如 Moon Animator,製作動畫,並在攝影機抵達時,於鏡頭中的 NPC rig 上播放。Roblox 的 Animator 參考文件說,NPC 動畫只有在由伺服器載入並播放時才會複寫,所以如果所有玩家都該看到 NPC 演出,請從伺服器 Script 播放。如果在 CutscenePlayer 中載入並播放,動畫不會複寫,這適合只有一位玩家在看的過場動畫。動畫 Script 教學示範了怎麼從伺服器 Script 在 NPC 上播放動畫。
對話
字幕適合會自動播放的簡短台詞。如果是玩家要回答、選擇選項的對話,請看NPC 對話教學。
主選單之後的開場
主選單教學會關閉 CharacterAutoLoads,所以在按下 Play 之前沒有人會重生。CutsceneService 在玩家第一次重生時播放開場,所以兩個系統一起用時,開場會在按下 Play 後的第一次重生時播放。角色出現時,選單會重新開啟 core GUI,而這可能發生在開場已經在播的時候,所以開場期間可能看得到玩家清單。CutscenePlayer 只會重新開啟它自己隱藏的東西,所以不會動到選單做的修改,開場結束後它們仍然是開啟的。主選單教學中用來對準攝影機零件的 Command Bar 技巧,和步驟 1 的一樣。
回合開始時環繞地圖
要從另一個伺服器 Script 啟動過場動畫,例如回合系統教學中回合開始時的地圖環繞鏡頭,請在 ServerStorage 中加入名為 PlayCutscene 的 BindableEvent。在 CutsceneService 最後,把它的 Event 連接到 play 函式,再讓回合 Script 對每位玩家帶著過場動畫名稱呼叫它。play 會略過「每台伺服器一次」的檢查,所以環繞鏡頭每個回合都會播放。
過場動畫外掛程式
外掛程式可以和這篇教學一起使用。如果過場動畫外掛程式會寫自己的攝影機 Script,請確認它會把攝影機還回去(CameraType 為 Custom 與 CameraSubject),並在攝影機是 Scriptable 時設定 Focus,而誰看得到過場動畫的決定,就像本教學一樣留給伺服器。
常見錯誤與解法
按下 Play 之前先打開 Output 視窗(Window 選單,再選 Output)。大多數過場動畫的問題,不是會在那裡寫出警告,就是因為名稱不一致而發生。
Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'
CutsceneService 會等待直接位於 Workspace 中、名為 Cutscenes 的資料夾。照步驟 1 建立它,並檢查拼字與大寫的 C。在它出現之前,CutsceneService 不會建立 CutsceneEvent,所以 CutscenePlayer 也會一直等。
Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'
CutscenePlayer 在等 CutsceneService 建立的 remote。請確認 CutsceneService 是 Script 而不是 LocalScript、直接放在 ServerScriptService 中、沒有被停用,而且 Output 中沒有它發出的關於 Cutscenes 的錯誤或警告。
CutsceneService: no folder named Intro in Workspace.Cutscenes
INTRO_CUTSCENE 或觸發器的 Cutscene 屬性中的名稱,和 Workspace.Cutscenes 中的任何資料夾都不相符。名稱的大小寫有差別。
什麼都沒播放,Output 也是空的
資料夾中沒有名為 1 的零件,或它的零件沒有直接放在裡面(例如放在 Model 中)。CutsceneService 依序讀取零件 1、2、3,遇到第一個缺少的數字就停下。另外別忘了,每段過場動畫每位玩家在每台伺服器只播一次:停止測試,再按一次 Play。
攝影機看錯方向
攝影機會朝向鏡頭零件正面的方向。把 Studio 攝影機移到你要的畫面,再對這個鏡頭重新執行步驟 1 的 Command Bar 那行。
觸發器沒有作用
請確認遊戲開始時觸發零件直接位於 Workspace.CutsceneTriggers 中、CanTouch 是勾選的(否則 Output 中會有警告),而且它的 Cutscene 屬性是字串,內容是 Workspace.Cutscenes 中某個資料夾的名稱。再次穿過觸發器不會有任何反應,這是刻意設計的。
過場動畫結束後,攝影機停在最後一個鏡頭
CutscenePlayer 在把攝影機還回去之前就出錯停止了,所以請在 Output 中找它發出的紅色錯誤。也可能是另一個 Script 一直把 CameraType 設成 Scriptable 而占住攝影機,例如仍然綁定著的選單攝影機。
用 RoCode 製作
如果不想自己動手做,RoCode 可以在你開啟的場景中做好。RoCode 是 Roblox Studio 的獨立 AI 代理,並非 Roblox 官方產品:你在它的網頁聊天中描述功能,它的 Studio 外掛程式就會在你的 Explorer 中建立零件與 Script,不需要從聊天視窗複製程式碼。
加入開場過場動畫:Cutscenes 資料夾裡有 Intro 資料夾與鏡頭 1 到 3,字幕來自 Caption 屬性,有黑邊與 Skip 按鈕,在玩家第一次重生時播放一次,伺服器讓玩家停在原地,最後攝影機會回來。
- 可以先用 Search Scripts 檢查你的場景,例如找出已經在設定
CameraType的選單或攝影機 Script,避免彼此衝突 - 用 Create Instance 建立資料夾與觸發零件,並在零件上設定 Caption 與 MoveSeconds 等屬性
- 用 Create Script 寫出 CutsceneService 與 CutscenePlayer
- 它被指示用 Check Script 檢查每一個寫好的 Script,Check Script 會在 Studio 中編譯它而不執行,而且它會在每一批變更前後設下復原點
鏡頭零件請自己擺,把 Studio 攝影機移到每個畫面,然後再要求它寫 Script。外掛程式 3.9 或更新版本時,RoCode 可以執行一次簡短的試玩測試並讀取錯誤;外掛程式 3.9.11 或更新版本時,它可以操作測試角色來確認遊戲能運作,但遊戲進行中它不會截圖,所以過場動畫要你自己看。製作整個遊戲的順序,請看如何用 AI 製作 Roblox 遊戲,一個系統接一個系統這一頁。RoCode 如何連接到 Studio。
常見問題
怎麼讓過場動畫在進入遊戲時播放?
把鏡頭資料夾命名為 Intro 並放在 Workspace.Cutscenes 中,或把 INTRO_CUTSCENE 改成你的資料夾名稱。CutsceneService 會在每位玩家第一次於伺服器上重生時播放它。要只在玩家真正第一次進入時顯示,請把旗標存在 data store 中,並且只在開場開始後才設定它,做法請看如何擴充這個系統一節。
不用外掛程式也能做過場動畫嗎?
可以。這篇教學只用了零件、屬性與兩個 Script,而 Command Bar 那行會把每個鏡頭剛好放在 Studio 攝影機的位置。不過 Moon Animator 之類的外掛程式,在替過場動畫中演出的角色做動畫時還是很方便。
為什麼過場動畫中攝影機不會動?
通常是攝影機程式碼放在伺服器 Script 中,但只有 LocalScript 能移動玩家的攝影機,因為每台裝置都有自己的攝影機。另一個常見原因是:CameraType 不是 Scriptable,所以 Roblox 的預設攝影機 Script 一直把攝影機拉回角色身上。
怎麼讓玩家在過場動畫中不能移動?
播放期間在伺服器上錨定他的 HumanoidRootPart,結束後再解除錨定,就像 CutsceneService 的做法。錨定的零件永遠不會因物理而移動。WalkSpeed 不會被動到,所以不會和衝刺 Script 或加速通行證衝突。
怎麼在過場動畫中加入 Skip 按鈕?
在過場動畫畫面上放一個 TextButton,並連接它的 Activated 事件;按鈕被選取時,點擊、觸控點按或手把的 A 鍵都會觸發它。CutscenePlayer 中的 Skip 會設定一個旗標,由鏡頭迴圈每一幀檢查;它會為使用手把的玩家自動被選取,並放在使用預設內距的獨立 ScreenGui 中,讓手機的相機挖孔不會擋住它。過場動畫播放時搖桿與跳躍按鈕是隱藏的,所以不會和它擠在一起。
為什麼過場動畫中的世界是空的?
開啟 instance streaming 時,玩家的裝置上只有他角色附近的區域。讓伺服器在攝影機抵達每個鏡頭前不久呼叫 player:RequestStreamAroundAsync,就像 CutsceneService 的做法。Roblox 寫道,這樣區域很可能會被載入,但不保證,所以請把重要的鏡頭放在串流半徑內,或對必須保持載入的區域使用 Player:AddReplicationFocus。
來源與延伸閱讀
- Roblox Creator Docs:Customize the camera(英文). 每個用戶端各自的 Camera、Scriptable、CFrame 與 Focus
- Roblox Engine API:Camera(英文). CameraType、CameraSubject、每一幀設定 Focus,以及已淘汰的 Interpolate
- Roblox Creator Docs: Control the user's camera(英文). BindToRenderStep 的優先順序排在攝影機之後一步
- Roblox Engine API:TweenService:GetValue(英文). 經過緩動的 alpha,限制在 0 到 1 之間
- Roblox Engine API:ScreenGui.ScreenInsets(英文). 為什麼 None 只用於沒有東西可按的內容
- Roblox Creator Docs:Instance streaming(英文). 新場景預設開啟,以及 replication focus
- Roblox Creator Docs:Streaming techniques(英文). 傳送事件前先預先載入區域
- Roblox Engine API:Player:RequestStreamAroundAsync(英文). 暫時性、不保證成功的請求
- Roblox Creator Docs:Remote events and callbacks(英文). 訊息佇列,以及哪些表格可以傳送
- Roblox Creator Docs:Network ownership, movement validation, and physics(英文). 用戶端能對自己的角色做什麼,包括偽造 Touched 事件
- Roblox Engine API:Animator:LoadAnimation(英文). 哪些動畫會複寫
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。