要点
在 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 中选中它们。
每个镜头还可以有三个可选的 Attribute。要添加 Attribute,选中零件,把 Properties 窗口滚动到 Attributes 部分,点击 +,输入名称,选择类型,然后点击 Save。
| Attribute | 类型 | 默认值 | 作用 |
|---|---|---|---|
MoveSeconds | number | 3 | 相机从上一个镜头飞到这个镜头用多少秒。0 表示直接切换。镜头 1 总是切换,所以这个 Attribute 对它无效。 |
HoldSeconds | number | 1 | 相机到达后在这个镜头上停留多少秒。 |
Caption | string | 无 | 从相机开始飞向这个镜头时起,显示在下方黑边上的文字。没有 Caption 的镜头会清空文字。 |
小于 0 或大于 60 的数字,以及类型不对的 Attribute,都会被替换为默认值。
第 2 步:添加服务端脚本
把鼠标移到 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")
-- 这个脚本会自己创建 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 Attribute 中的过场动画
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 -- 脚本等待 Cutscenes 期间进入的所有人
onPlayerAdded(player)
end
Players.PlayerRemoving:Connect(function(player: Player)
seen[player] = nil
playing[player] = nil
end)
Workspace.Cutscenes 一出现,CutsceneService 就会自己创建 RemoteEvent CutsceneEvent,所以不需要手动往 ReplicatedStorage 里插入任何东西。如果你已经做了一个同名的 RemoteEvent,请删除它:LocalScript 可能会找到你的那个,而服务端上没有人在监听它。
| 设置 | 这里的值 | 改变什么 |
|---|---|---|
INTRO_CUTSCENE | "Intro" | 玩家在服务器上第一次生成时播放的、Workspace.Cutscenes 中的文件夹。设为 "" 就没有开场。 |
DEFAULT_MOVE_SECONDS | 3 | 镜头没有 MoveSeconds Attribute 时,飞行持续多久。 |
DEFAULT_HOLD_SECONDS | 1 | 镜头没有 HoldSeconds Attribute 时,相机在它上面停留多久。 |
MAX_SHOTS | 30 | CutsceneService 在一段过场动画中查找的最大镜头编号。 |
脚本其余部分按顺序做了这些事:
- 在服务端读取镜头。
readShots把每个编号零件的 CFrame 和 Attribute 收集到一个列表中。玩家设备收到的是这个列表,所以它不需要零件本身。 - 一次只播一段。如果玩家已经在看过场动画,或者他的角色没有 Humanoid 或已经死亡,
play什么也不做。 - 每段过场动画都有自己的 id。过场动画结束或被跳过时,设备会把 id 发回来,只有匹配的 id 才会给玩家解冻,所以上一段过场动画迟到的消息无法结束新的一段。
- 让玩家停在原地,方法是锚固他的 HumanoidRootPart;如果玩家在过场动画中途重生,也会锚固新角色。Roblox 的说明写道,锚固的零件永远不会因重力、碰撞或其他物理而改变位置。WalkSpeed 不会被改动,所以这不会和冲刺脚本或加速通行证冲突。最后脚本会解除 root part 的锚固,即使它是被别的脚本锚固的,所以在可能播放过场动画期间,不要在别处锚固角色。
- 保险。
task.delay会在过场动画的完整时长加 2 秒后给玩家解冻,即使他的设备一直没有回应。 - 每段过场动画每个服务器只播一次。
seen表为每个玩家记住哪些过场动画已经开始过,所以重生时开场不会重复,触发器的过场动画也只播一次。只有过场动画真正开始播放时,playOnce才返回 true。 - 为每个玩家做设置。末尾对
Players:GetPlayers()的循环会处理在脚本等待 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 应在相机前方多少格内绘制最多的细节
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 会在第一次重生时删除它们,而这个脚本不会重新创建。在脚本连接到 OnClientEvent 之前到达的 Remote 消息会进入队列,并在连接后送达,所以很快生成的玩家仍然能看到开场。
| 部分 | 作用 |
|---|---|
ScreenGui Cutscene | 两条黑边,每条占屏幕高度的 12%(BAR_HEIGHT),以及下方黑边上的字幕。ScreenInsets 为 None,让黑边一直延伸到屏幕边缘,DisplayOrder 10 让它们绘制在 DisplayOrder 较小的 ScreenGui 之上。 |
ScreenGui CutsceneControls | 里面只有 Skip 按钮,位于下方黑边的右侧,带一个 UISizeConstraint,让它保持不小于 64 乘 32 像素,在手机上容易点中。它使用默认的 ScreenInsets,内容不会伸到 Roblox 顶栏按钮和摄像头开孔下面。Roblox 只建议对没有可点击内容的东西使用 None,所以 Skip 不能放在黑边所在的 ScreenGui 里。 |
HIDDEN_CORE_GUIS | 通过 SetCoreGuiEnabled 隐藏玩家列表、背包和血条,之前先用 GetCoreGuiEnabled 记住哪些是开启的,最后只重新开启它自己关闭的那些。如果游戏在别处隐藏了背包,它会保持隐藏,而在过场动画期间开启它们的脚本(例如主菜单)也不会被覆盖。 |
TouchControlsEnabled | 在手机和平板上,play 会在过场动画期间把 GuiService.TouchControlsEnabled 设为 false。这会隐藏位于下方两角的摇杆和跳跃按钮,也就是 Skip 所在的位置,结束时如果它们原本是开启的,就会恢复。 |
updateCamera | 在过场动画播放期间每一帧运行。计算当前飞行已经完成了多少,用 TweenService:GetValue 做缓动,用 CFrame:Lerp 把相机放在两个镜头之间,并把 Focus 设在相机前方 30 格处。 |
waitOrSkip | 等待飞行和镜头停留的时间,每一帧都检查 Skip 标志。 |
play | 把相机设为 Scriptable,按顺序播放镜头,然后恢复相机(CameraType 为 Custom,CameraSubject 为 Humanoid),重新开启 core GUI 和触摸控制,并把过场动画的 id 发给服务端。如果第一段还在播放时第二段到达,它会立刻把第二段的 id 发回去,这样服务端就不会为这台设备没有显示的过场动画让玩家停在原地。 |
| Skip 按钮 | Activated 会在鼠标点击、点按,或按钮被选中时按下手柄 A 键时触发。对于主要输入方式是手柄的玩家,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 类型的 Attribute
Cutscene,值设为Bridge:也就是要播放的文件夹名称。
服务器启动时,CutsceneService 会给 CutsceneTriggers 里直接包含的每个零件连接 Touched,所以请在 Studio 中添加触发器,而不是在游戏运行时用脚本添加。CanTouch 关闭的触发器会被跳过,并在 Output 中给出警告,因为脚本给这样的零件连接 Touched 时 Roblox 会报错。
角色穿过零件时,Touched 会连续触发很多次。seen 表和“一次只播一段”的规则把这变成每个玩家每个服务器一段过场动画。在另一段过场动画期间触碰触发器的玩家会被忽略,触发器对他仍然有效。
不要把触发器放在道路上。坐着的玩家的 HumanoidRootPart 是焊接在座椅上的,而当焊接组中的一个零件被锚固时,Roblox 会把其余零件也一起锚固。所以开车撞进触发器的玩家,会让他的整辆车连同乘客一起停在原地,直到过场动画结束。
相机代码做对了什么
先 Scriptable,再回到 Custom
当 CameraType 为 Scriptable 时,Roblox 的相机脚本既不移动也不更新相机,正是这一点让 CutscenePlayer 能放置它。最后它把 CameraType 恢复为 Custom,并把玩家的 Humanoid 设为 CameraSubject,也就是 Roblox 相机脚本默认跟随的对象。点击 Skip 后也会执行这一步,所以玩家永远不会停留在最后一个镜头上。
两个小检查让过场动画在播放期间保持主导。如果有东西在过场动画中途把 CameraType 改成了别的值,每一帧运行的函数会在下一帧把它改回 Scriptable。而 workspace.CurrentCamera 会在每段过场动画开始时重新读取,因为如果当前的 Camera 被删除,Roblox 会创建一个新的。
每一帧设置 Focus
Camera.Focus 告诉引擎在光照之类的工作中优先处理哪个区域。Roblox 的相机脚本会把它保持在 CameraSubject 上,但相机为 Scriptable 时不会,Roblox 的说明要求这种情况下每一帧更新它:来自 PointLight 等对象的动态光,在远离焦点的地方可能不会被渲染。CutscenePlayer 把它设在相机前方 30 格处(FOCUS_DISTANCE)。如果你的镜头看的东西更远,就调大这个数。
这个函数通过 RunService:BindToRenderStep 在每一帧绘制之前运行,优先级比 Roblox 自己的相机更新晚一步(Enum.RenderPriority.Camera.Value + 1)。Roblox 的相机教程用的就是这个优先级,所以过场动画是在 Roblox 自己的相机代码运行之后才放置相机的。
用 TweenService:GetValue 做缓动
对 camera.CFrame 做补间也能移动相机,但 Focus 仍然需要每一帧设置,所以 CutscenePlayer 在同一个函数里自己移动相机。对每次飞行,它计算已经过去的时间比例(0 到 1),把这个值连同缓动样式和方向一起传给 TweenService:GetValue,再用 CFrame:Lerp 把相机放在两个镜头之间这个比例的位置上,CFrame: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 停留在相机脚本留下的位置,也就是角色附近,所以远离它的动态光可能不会被渲染(Roblox 关于 Camera.Focus 的说明)。 | 在 render step 中每一帧设置 Focus。 |
| 不把相机还回去 | 玩家卡住,一直看着最后一个镜头。 | 最后把 CameraType 设为 Custom,CameraSubject 设为 Humanoid,点击 Skip 后也是如此。 |
在 LocalScript 的 Touched 中启动过场动画 | 没有任何东西能阻止它在每次触碰时重复,而且决定是在玩家控制的设备上做出的。 | 由服务端选择玩家,并记住谁已经看过。 |
| 在客户端读取相机零件 | 开启流式传输时,远离角色的零件可能还不存在于设备上。 | 由服务端读取零件,发送它们的 CFrame,并在相机飞到每个镜头之前不久请求加载那里的区域。 |
玩家能改什么,不能改什么
假设作弊者控制着他设备上的一切:他可以修改或删除 CutscenePlayer,并以任意值发送 CutsceneEvent。对过场动画来说,只要没有真正的东西依赖它,这几乎无关紧要。
| 作弊者尝试 | 结果 |
|---|---|
| 跳过过场动画,或者干脆不播放 | 可以:那是他自己的屏幕。永远不要为“看完了过场动画”发放奖励。 |
以任意值发送 CutsceneEvent | 只有与他当前过场动画匹配的数字才有作用,而它唯一的作用就是让他早一点解冻。 |
| 从地图上任何地方触碰触发器 | 有可能:每台设备控制着自己的角色,Roblox 的安全文档也把伪造 Touched 事件列为它能做的事情之一。他会看到一次这段过场动画,此外什么也不会发生。 |
| 在过场动画期间照样移动 | 没有任何好处。冻结是为了让守规矩的玩家不会在过场动画中途走开;它不是安全检查。 |
| 通过 Remote 给别人播放过场动画 | 做不到。只有服务端能向玩家发送 CutsceneEvent,设备能发回的唯一内容是“这段过场动画结束了”。 |
如果过场动画会引出真正的东西,例如随后打开的门或出现的 Boss,就让服务端按自己的计时器来做,而不是在设备报告过场动画结束时才做。
第 5 步:测试一下
- 用 Command Bar 那一行摆好 Intro 的三个镜头。给镜头 1 设置
Caption"Welcome to the village",给镜头 2 设置MoveSeconds2.5 和Caption"Find the bridge",镜头 3 不设 Attribute。 - 点击 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 日检查时它还是测试版:在 File、Beta Features、New Device Simulator 中开启,然后重启 Studio),选择一款手机,把它横过来,检查 Skip 没有伸到摄像头开孔下面、容易点中,并且过场动画期间摇杆和跳跃按钮是隐藏的。
- 如果你还做了 主菜单,点击 Play,再点击菜单中的 Play 按钮,让开场完整播完:之后玩家列表应该重新出现在屏幕上。
始终保持 Output 窗口打开(Window 菜单,然后 Output)。一切正常时,这些脚本不会输出任何内容,所以来自 CutsceneService 或 CutscenePlayer 的任何警告或红色错误都是真正的问题。见 常见错误。
如何扩展这个系统
只在玩家第一次进入时播放开场
seen 表只在一个服务器上有效,所以重新进入的玩家会再次看到开场。要只在第一次进入时显示,就通过 DataStore 教程 中的 PlayerData 模块,把一个标志(例如 SeenIntro)和玩家的其他数据一起保存。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 的骨架上播放它。Roblox 关于 Animator 的说明写道,NPC 的动画只有在由服务端加载和播放时才会复制,所以如果所有玩家都要看到 NPC 的表演,就从服务端 Script 中播放。如果在 CutscenePlayer 中加载和播放,动画不会复制,这适合只有一个玩家观看的过场动画。动画脚本教程 演示了如何从服务端 Script 在 NPC 上播放动画。
对话
字幕适合自动播放的简短台词。对于玩家要回答和选择选项的对话,见 NPC 对话教程。
主菜单之后的开场
主菜单教程 会关闭 CharacterAutoLoads,所以在点击 Play 之前没有人会生成。CutsceneService 在玩家第一次生成时播放开场,所以两个系统同时使用时,开场会在 Play 之后的第一次生成时播放。角色出现时菜单会重新开启 core GUI,而这可能发生在开场已经开始播放的时候,所以开场期间可能看得到玩家列表。CutscenePlayer 只重新开启它自己隐藏的东西,所以不会动菜单所做的修改,开场结束后它们保持开启。主菜单教程中用来对准相机零件的 Command Bar 技巧 和第 1 步是一样的。
回合开始时的地图巡览
要从另一个服务端脚本启动过场动画,例如 回合系统教程 中回合开始时的地图巡览,就在 ServerStorage 中添加一个名为 PlayCutscene 的 BindableEvent。在 CutsceneService 的末尾,把它的 Event 连接到 play 函数,让回合脚本用每个玩家和过场动画名称来触发它。play 会跳过“每个服务器一次”的检查,所以巡览每个回合都会播放。
过场动画插件
插件可以和本教程一起使用。如果某个过场动画插件会写自己的相机脚本,请检查它是否会把相机还回去(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 Attribute,与 Workspace.Cutscenes 中的任何文件夹都对不上。名称区分大小写。
什么都没有播放,Output 里也是空的
文件夹中没有名为 1 的零件,或者它的零件没有直接放在里面(例如放在某个 Model 中)。CutsceneService 按顺序读取零件 1、2、3,并在第一个缺失的编号处停止。另外请记住,每段过场动画对每个玩家每个服务器只播放一次:停止测试,再点一次 Play。
相机看的方向不对
相机朝向镜头零件正面所朝的方向。把 Studio 相机移到你想要的画面,再对这个镜头执行一次第 1 步中 Command Bar 的那一行。
触发器没有反应
检查游戏启动时触发零件是否直接位于 Workspace.CutsceneTriggers 中,CanTouch 是否勾选(否则 Output 中会有警告),以及它的 Cutscene Attribute 是否为 Workspace.Cutscenes 中某个文件夹名称的字符串。再次穿过触发器不会有任何反应,这是有意设计的。
过场动画结束后,相机停留在最后一个镜头上
CutscenePlayer 在还回相机之前因出错而停止了,所以请在 Output 中查找它的红色错误。也可能是另一个脚本在不断把 CameraType 设为 Scriptable,例如仍然绑定着的菜单相机。
用 RoCode 来做
如果不想手动搭建这一切,RoCode 可以在你打开的场景里完成。RoCode 是独立的 Roblox Studio AI 代理,并非 Roblox 出品:你在它的网页聊天里描述功能,它的 Studio 插件就会在你的 Explorer 中创建零件和脚本,所以不需要从聊天窗口复制代码。
添加一段开场过场动画:Cutscenes 文件夹里有 Intro 文件夹和镜头 1 到 3,字幕来自 Caption Attribute,带黑边和 Skip 按钮,在玩家第一次生成时播放一次,由服务端让玩家停在原地,最后相机回到玩家身上。
- 可以先用 Search Scripts 检查你的场景,例如查找已经设置
CameraType的菜单或相机脚本,避免它们冲突 - 用 Create Instance 创建文件夹和触发零件,并在零件上设置 Caption 和 MoveSeconds 等 Attribute
- 用 Create Script 编写 CutsceneService 和 CutscenePlayer
- 它被要求用 Check Script 检查自己写的每个脚本,Check Script 会在 Studio 中编译而不运行,并且它会在每批改动前后设置撤销点
镜头零件请你自己摆放,把 Studio 相机移到每个画面,然后再请求脚本。使用插件 3.9 及以上时,RoCode 可以运行简短的试玩测试并读取错误;使用插件 3.9.11 及以上时,它可以操控一个测试角色来检查游戏能否运行,但它在游戏过程中不截图,所以过场动画要你自己来看。搭建整个游戏的顺序,见页面 用 AI 一个系统一个系统地制作 Roblox 游戏。RoCode 如何连接到 Studio。
常见问题
怎么让过场动画在进入游戏时播放?
把镜头文件夹命名为 Workspace.Cutscenes 中的 Intro,或者把 INTRO_CUTSCENE 改成你的文件夹名称。CutsceneService 会在每个玩家在服务器上第一次生成时播放它。要只在玩家第一次进入游戏时显示,就把一个标志保存在 data store 中,并且只在开场开始之后才设置它,方法见 如何扩展这个系统。
不用插件能做过场动画吗?
能。本教程只用了零件、Attribute 和两个脚本,而 Command Bar 那一行会把每个镜头正好放在 Studio 相机所在的位置。不过 Moon Animator 之类的插件在给过场动画中表演的角色做动画时仍然很方便。
为什么过场动画里相机不动?
通常是相机代码放在了服务端 Script 中,而只有 LocalScript 能移动玩家的相机,因为每台设备都有自己的相机。另一个常见原因是:CameraType 不是 Scriptable,Roblox 默认的相机脚本一直把相机拉回角色身上。
怎么禁止玩家在过场动画期间移动?
在过场动画播放期间,在服务端锚固他的 HumanoidRootPart,结束后解除锚固,就像 CutsceneService 那样。锚固的零件永远不会因物理而移动。这样不会改动 WalkSpeed,所以不会和 冲刺脚本 或加速通行证冲突。
怎么给过场动画加 Skip 按钮?
在过场动画画面上放一个 TextButton,并连接它的 Activated 事件,它会在点击、点按,或按钮被选中时按下手柄 A 键时触发。CutscenePlayer 中的 Skip 会设置一个由镜头循环每一帧检查的标志,会为使用手柄的玩家自动选中,并放在使用默认边距的单独 ScreenGui 中,所以手机的摄像头开孔不会挡住它。过场动画期间摇杆和跳跃按钮是隐藏的,所以它们不会挤在 Skip 旁边。
为什么过场动画里的世界是空的?
开启 instance streaming 时,玩家设备上只有他角色附近的区域。像 CutsceneService 那样,让服务端在相机飞到每个镜头之前不久调用 player:RequestStreamAroundAsync。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(英文). 限制在 0 到 1 之间的缓动 alpha
- 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(英文). 哪些动画会复制
代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。