Коротко
Расставьте невидимые заанкеренные парты с именами 1, 2, 3 в папке внутри Workspace.Cutscenes, каждый лицом туда, куда должна смотреть камера. Script в ServerScriptService читает их CFrame, держит игрока на месте и отправляет кадры этому игроку через RemoteEvent. LocalScript в StarterPlayerScripts ставит 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, он возвращает камеру персонажу и отправляет серверу
CutsceneEventс тем же id. - Сервер снимает анкер с игрока. Если это сообщение так и не пришло, он всё равно снимает анкер, когда пройдёт длина катсцены плюс 2 секунды. Таймер запускается, когда сервер отправляет катсцену, а при медленном входе устройство может начать интро на несколько секунд позже, потому что LocalScript вне ReplicatedFirst не запускается, пока игра не загрузилась. Тогда игрок может снова двигаться раньше, чем интро закончится у него на экране.
| Элемент | Где находится | Что делает |
|---|---|---|
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, нажмите кнопку + и вставьте Folder с именем
Cutscenes. Внутри него вставьте Folder с именемIntro. Регистр букв в именах важен. - Подведите камеру Studio к первому нужному виду, как будто выстраиваете кадр для фото.
- Вставьте Part в Intro и переименуйте его в
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: Добавьте серверный скрипт
Наведите курсор на ServerScriptService, вставьте Script с именем CutsceneService и вставьте в него код ниже. Настройки вверху это строки, которые вы можете менять.
-- Script в ServerScriptService с именем CutsceneService.
-- Решает, кто какую катсцену видит и когда. Читает кадры камеры из пронумерованных
-- партов в 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
if triggers then
for _, trigger in triggers:GetChildren() do
if not trigger:IsA("BasePart") then
continue
end
if not trigger.CanTouch then
-- Подключение Touched к парту с выключенным CanTouch выдаёт ошибку, поэтому просто предупреждаем
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)
CutsceneService сам создаёт RemoteEvent CutsceneEvent, как только появляется Workspace.Cutscenes, поэтому вручную в ReplicatedStorage ничего вставлять не нужно. Если вы уже сделали RemoteEvent с таким именем, удалите его: LocalScript может найти ваш, а его на сервере никто не слушает.
| Настройка | Значение здесь | Что меняет |
|---|---|---|
INTRO_CUTSCENE | "Intro" | Папка в Workspace.Cutscenes, которая играет при первом спавне игрока на сервере. Поставьте "", чтобы интро не было. |
DEFAULT_MOVE_SECONDS | 3 | Сколько длится пролёт, если у кадра нет атрибута MoveSeconds. |
DEFAULT_HOLD_SECONDS | 1 | Сколько камера стоит на кадре, если у него нет атрибута HoldSeconds. |
MAX_SHOTS | 30 | Самый большой номер кадра, который CutsceneService ищет в одной катсцене. |
Что делает остальная часть скрипта, по порядку:
- Читает кадры на сервере.
readShotsсобирает CFrame и атрибуты каждого пронумерованного парта в список. Устройство игрока получает этот список, поэтому сами парты ему не нужны. - Одна катсцена за раз.
playничего не делает, пока игрок уже смотрит катсцену, или если у его персонажа нет Humanoid или он мёртв. - У каждой катсцены свой 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 и вставьте LocalScript с именем
CutscenePlayer. - Замените его содержимое кодом ниже.
-- LocalScript в StarterPlayer > StarterPlayerScripts с именем CutscenePlayer.
-- Проигрывает катсцену, которую присылает сервер: чёрные полосы, титры, кнопка 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
-- Работает каждый кадр во время катсцены. Focus у Scriptable камеры сам ни за чем
-- не следует, поэтому он тоже задаётся здесь.
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)
LocalScript в StarterPlayerScripts копируется игроку один раз, при входе, и продолжает работать после респавна персонажа. Поэтому у обоих ScreenGui выключен ResetOnSpawn: если его включить, Roblox удалит их при первом респавне, а этот скрипт не создаст их заново. Сообщения ремоута, пришедшие до того, как скрипт подключился к OnClientEvent, ставятся в очередь и доставляются после подключения, так что игрок, который быстро заспавнился, всё равно увидит интро.
| Часть | Что делает |
|---|---|
ScreenGui Cutscene | Две чёрные полосы, каждая по 12% высоты экрана (BAR_HEIGHT), и титр на нижней полосе. ScreenInsets None растягивает полосы до самых краёв экрана, а DisplayOrder 10 рисует их поверх ScreenGui с меньшим DisplayOrder. |
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 вставьте Folder с именем
Bridgeи расставьте его кадры как в шаге 1, с именами1и2. В строке для Command Bar пишитеBridgeвместоIntro. - Наведите курсор на Workspace и вставьте Folder с именем
CutsceneTriggers. - Вставьте в него Part с именем
BridgeTrigger. Сделайте его таким большим, чтобы игроки не могли пройти мимо, не коснувшись его, например высокую широкую плиту поперёк дороги. Отметьте Anchored, снимите CanCollide и CanQuery, оставьте CanTouch отмеченным и поставьте Transparency на 1. Выключенный CanQuery не даёт невидимой плите перекрывать рейкасты, например выстрелы из гайда по оружию. События касания управляются через CanTouch, а не CanQuery, поэтому триггер всё равно работает. - Добавьте ему атрибут
Cutsceneтипа string и задайте значениеBridge: имя папки, которую нужно проиграть.
CutsceneService подключает Touched к каждому парту прямо внутри CutsceneTriggers при старте сервера, поэтому добавляйте триггеры в Studio, а не скриптом во время игры. Триггер с выключенным CanTouch пропускается с предупреждением в Output, потому что Roblox выдаёт ошибку, когда скрипт подключает Touched к такому парту.
Пока персонаж идёт сквозь парт, Touched срабатывает много раз подряд. Таблица seen и правило "одна катсцена за раз" превращают это в одну катсцену на игрока за сервер. Игрок, который касается триггера во время другой катсцены, игнорируется, и триггер остаётся для него готовым.
Не ставьте триггеры на дорогах. HumanoidRootPart сидящего игрока приварен к сиденью, а когда один парт приваренной группы заанкерен, Roblox анкерит вместе с ним и остальные. Поэтому игрок, который въезжает в триггер, держит на месте весь свой транспорт, вместе с пассажирами, пока катсцена не закончится.
Что код камеры делает правильно
Scriptable, потом обратно Custom
Скрипты камеры Roblox не двигают и не обновляют камеру, пока CameraType равен Scriptable, и именно это позволяет CutscenePlayer её ставить. В конце он возвращает CameraType в Custom и делает Humanoid игрока CameraSubject, за которым скрипты камеры Roblox следят по умолчанию. Это выполняется и после Skip, так что игрок никогда не остаётся смотреть на последний кадр.
Две небольшие проверки держат катсцену главной, пока она играет. Если что-то ставит CameraType в другое значение посреди катсцены, функция, которая работает каждый кадр, на следующем кадре возвращает Scriptable. А workspace.CurrentCamera скрипт заново читает в начале каждой катсцены, потому что Roblox создаёт новую Camera, если текущую когда-нибудь удалят.
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, который двигает позицию по прямой и плавно поворачивает. GetValue ограничивает вход между 0 и 1, поэтому камера останавливается ровно на кадре, когда время пролёта заканчивается.
| EASING_STYLE | Как ощущается пролёт |
|---|---|
Enum.EasingStyle.Sine (здесь) | Скорость идёт по синусоиде, мягкий старт и мягкая остановка. |
Enum.EasingStyle.Quad | Как Sine, но кривая чуть резче. |
Enum.EasingStyle.Linear | Постоянная скорость, поэтому каждый пролёт начинается и заканчивается на полной скорости. |
Направление InOut: сглаживание применяется вперёд в первой половине пролёта и в обратную сторону во второй, поэтому камера разгоняется от одного кадра и замедляется к следующему.
Стриминг
В новых плейсах instance streaming включён: по умолчанию устройство игрока держит область вокруг его персонажа, поэтому кадр, который смотрит на другой край карты, может показать пустой мир. CutsceneService просит Roblox подгрузить этому игроку область каждого кадра через Player:RequestStreamAroundAsync: область первого кадра до отправки события, с ожиданием до 2 секунд, и область каждого следующего за 2 секунды до того, как камера полетит к нему.
Roblox пишет, что так область вероятно, но не точно, будет загружена, и что эффект временный. Держите важные кадры в пределах радиуса стриминга или используйте на сервере Player:AddReplicationFocus для области, которая должна оставаться загруженной, пока вы не уберёте фокус. С выключенным стримингом у устройства и так есть вся карта, а pcall вокруг каждого запроса означает, что неудачный запрос не может остановить катсцену.
Что не так в старых туториалах по катсценам
Если вы сравниваете этот гайд с видео или постом на форуме, вот различия, которые важны, и почему каждый приём это проблема.
| Туториал | Проблема | Этот гайд |
|---|---|---|
Двигает камеру через camera:Interpolate() | Roblox пометил Interpolate как устаревший и советует анимировать камеру через TweenService. | Сглаживает каждый пролёт через TweenService:GetValue и ставит камеру каждый кадр. |
Твинит camera.CFrame и больше ничего | Focus остаётся там, где его оставили скрипты камеры, рядом с персонажем, поэтому динамический свет далеко от него может не отрисоваться (справка Roblox по Camera.Focus). | Задаёт Focus каждый кадр в render step. |
| Не возвращает камеру | Игрок застревает, глядя на последний кадр. | В конце ставит CameraType в Custom и CameraSubject на Humanoid, и после Skip тоже. |
Запускает катсцену из Touched в LocalScript | Ничто не мешает ей повторяться при каждом касании, а решение принимается на устройстве, которым управляет игрок. | Сервер выбирает игрока и помнит, кто её уже видел. |
| Читает парты камеры на клиенте | При включённом стриминге парты далеко от персонажа могут ещё не существовать на устройстве. | Сервер читает парты, отправляет их CFrame и запрашивает область каждого кадра незадолго до того, как туда прилетит камера. |
Что игрок может и не может изменить
Считайте, что читер управляет всем на своём устройстве: он может изменить или удалить CutscenePlayer и отправить CutsceneEvent с любым значением. Для катсцены это почти ничего не значит, если от неё не зависит ничего настоящего.
| Читер пытается | Результат |
|---|---|
| Пропустить катсцену или вообще её не проигрывать | Можно: это его собственный экран. Никогда не давайте награду за "досмотрел катсцену". |
Отправить CutsceneEvent с любым значением | Что-то делает только число, совпадающее с его текущей катсценой, и всё, что оно делает, это размораживает его раньше. |
| Коснуться триггера из любой точки карты | Возможно: каждое устройство управляет своим персонажем, и в документации Roblox по безопасности подмена событий Touched названа среди того, что оно может делать. Он один раз увидит эту катсцену, и больше ничего не произойдёт. |
| Всё равно двигаться во время катсцены | Выиграть нечего. Заморозка не даёт честным игрокам уходить посреди катсцены; это не проверка безопасности. |
| Через ремоут запустить катсцену кому-то другому | Невозможно. Отправлять CutsceneEvent игроку может только сервер, а единственное, что устройство может отправить обратно, это "эта катсцена закончилась". |
Если катсцена ведёт к чему-то настоящему, например к двери, которая потом открывается, или к появлению босса, пусть сервер делает это по своему таймеру, а не когда устройство сообщает, что катсцена закончилась.
Шаг 5: Проверьте
- Расставьте три кадра Intro строкой для Command Bar. Дайте кадру 1
Caption"Welcome to the village", кадру 2MoveSeconds2.5 иCaption"Find the bridge", а кадр 3 оставьте без атрибутов. - Нажмите Play (F5). Появляются чёрные полосы, камера переключается на кадр 1 с его титром, за 2.5 секунды летит к кадру 2, затем за 3 секунды к кадру 3 без титра. Потом камера возвращается за спину персонажа, и список игроков появляется снова. Пока она играет, ходить нельзя.
- Остановите тест, снова нажмите Play и нажмите Skip, пока камера летит к кадру 2. Камера сразу возвращается, и можно сразу ходить.
- Зайдите в BridgeTrigger: играет катсцена Bridge. Пройдите сквозь него ещё раз: ничего не происходит.
- Выберите Server & Clients в выпадающем списке режима теста, поставьте 2 клиента и нажмите Play. Когда Client 1 заходит в триггер, катсцена Bridge играет только у Client 1, а Client 2 может ходить.
- Оставьте
Workspace.StreamingEnabledвключённым и отнесите один кадр далеко от спавна. Когда камера прилетит, окружение должно быть на месте (вероятно, но не гарантированно: см. Стриминг). - Для геймпада остановите тест, нажмите Play, откройте Controller Emulator (вкладка Emulation, затем Controller) и зайдите в BridgeTrigger эмулированным геймпадом: Skip должна быть выбрана, так что A пропускает катсцену. Если вы пользуетесь Device Simulator в Studio (на момент нашей проверки 15 октября 2026 года это бета: включите её в File, Beta Features, New Device Simulator и перезапустите Studio), выберите телефон, поверните его горизонтально и проверьте, что Skip не заходит под вырез камеры и по ней легко попасть, а стик и кнопка прыжка спрятаны, пока идёт катсцена.
- Если вы сделали ещё и главное меню, нажмите Play, потом кнопку Play в меню и дайте интро доиграть до конца: после него список игроков должен снова быть на экране.
Держите окно Output открытым (меню Window, затем Output) всё время. Когда всё работает, эти скрипты ничего не пишут, так что любое предупреждение или красная ошибка от CutsceneService или CutscenePlayer это настоящая проблема. См. Частые ошибки.
Как расширить систему
Интро только при первом заходе игрока
Таблица seen живёт один сервер, поэтому игрок, который перезашёл, снова видит интро. Чтобы показывать его только при первом заходе, сохраняйте флаг, например SeenIntro, вместе с остальными данными игрока через модуль PlayerData из туториала по DataStore. Оставьте INTRO_CUTSCENE как есть и поменяйте часть onCharacterAdded в CutsceneService, которая отвечает за интро: дождитесь, пока PlayerData.Get(player) вернёт данные игрока, пропустите интро, если data.SeenIntro равен true, и ставьте data.SeenIntro = true только когда playOnce(player, INTRO_CUTSCENE) вернул true. Не запускайте интро из кода, который загружает данные: данные могут загрузиться раньше, чем заспавнится персонаж, а без персонажа play ничего не делает, и флаг сохранится для интро, которое никто не видел.
Персонажи, которые играют в катсцене
Сделайте анимацию в Animation Editor в Studio или в стороннем плагине для анимации, например Moon Animator, который упоминается в документации Roblox, и проиграйте её на риге NPC в кадре, когда туда прилетит камера. В справке Roblox по Animator сказано, что анимации NPC реплицируются, только если их загружает и запускает сервер, поэтому проигрывайте её из серверного Script, если все игроки должны видеть, как играет NPC. Если загрузить и запустить её в CutscenePlayer, анимация не реплицируется, и это подходит для катсцены, которую смотрит только один игрок. В гайде по скриптам анимации показано, как проиграть анимацию на NPC из серверного Script.
Диалоги
Титры подходят для коротких реплик, которые идут сами. Для разговора, где игрок отвечает и выбирает варианты, см. гайд по диалогам с NPC.
Интро после главного меню
Гайд по главному меню выключает CharacterAutoLoads, поэтому никто не спавнится, пока не нажмёт Play. CutsceneService проигрывает интро при первом спавне игрока, поэтому с обеими системами интро играет при первом спавне после Play. Меню включает core GUI обратно, когда появляется персонаж, а это может случиться, когда интро уже играет, поэтому во время интро может быть виден список игроков. CutscenePlayer включает обратно только то, что спрятал сам, поэтому изменение меню он не трогает, и после интро они остаются включены. Трюк с Command Bar из гайда по главному меню для наведения парта камеры тот же, что в шаге 1.
Облёт карты в начале раунда
Чтобы запустить катсцену из другого серверного скрипта, например облёт карты в начале раунда из гайда по системе раундов, добавьте в ServerStorage BindableEvent с именем PlayCutscene. В конце CutsceneService подключите его Event к функции play, а скрипт раундов пусть вызывает его с каждым игроком и именем катсцены. play пропускает проверку "один раз за сервер", поэтому облёт играет каждый раунд.
Плагины для катсцен
Плагины можно использовать вместе с этим гайдом. Если плагин для катсцен пишет свой скрипт камеры, проверьте, что он возвращает камеру (CameraType Custom и CameraSubject) и задаёт Focus, пока камера Scriptable, а решение о том, кто видит катсцену, оставьте на сервере, как в этом гайде.
Частые ошибки и решения
Откройте окно Output (меню Window, затем Output) до нажатия Play. Большинство проблем с катсценами либо пишут там предупреждение, либо возникают из-за имени, которое не совпадает.
Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'
CutsceneService ждёт папку с именем Cutscenes прямо в Workspace. Создайте её как в шаге 1 и проверьте написание и заглавную C. Пока её нет, CutsceneService не создаёт CutsceneEvent, поэтому CutscenePlayer тоже ждёт.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'
CutscenePlayer ждёт ремоут, который создаёт CutsceneService. Проверьте, что 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 к нужному виду и снова выполните строку для Command Bar из шага 1 для этого кадра.
Триггер ничего не делает
Проверьте, что парт-триггер лежит прямо внутри Workspace.CutsceneTriggers, когда игра стартует, что CanTouch отмечен (иначе в Output будет предупреждение) и что его атрибут Cutscene это строка с именем папки в Workspace.Cutscenes. Повторный проход сквозь триггер ничего не делает, так задумано.
После катсцены камера остаётся на последнем кадре
CutscenePlayer остановился с ошибкой, не успев вернуть камеру, так что ищите от него красную ошибку в Output. Камеру может удерживать и другой скрипт, который постоянно ставит CameraType в Scriptable, например камера меню, которая всё ещё привязана.
Сделать с RoCode
Если не хочется собирать это вручную, RoCode может сделать это в открытом у вас плейсе. RoCode это независимый ИИ-агент для Roblox Studio, не от Roblox: вы описываете функцию в его веб-чате, а его плагин для Studio создаёт парт и скрипты в вашем Explorer, так что копировать код из окна чата не нужно.
Добавь вступительную катсцену: папка Cutscenes с папкой Intro и кадрами с 1 по 3, титры из атрибута Caption, чёрные полосы и кнопка Skip, играет один раз при первом спавне игрока, сервер держит игрока на месте, а в конце камера возвращается.
- Может сначала проверить ваш плейс через Search Scripts, например на скрипт меню или камеры, который уже задаёт
CameraType, чтобы они не конфликтовали - Создаёт папки и парт-триггер через Create Instance и задаёт на партах атрибуты, такие как Caption и MoveSeconds
- Пишет CutsceneService и CutscenePlayer через Create Script
- Ему велено проверять каждый написанный скрипт через Check Script, который компилирует его в Studio без запуска, и он ставит точку отмены до и после каждой пачки изменений
Расставьте парты-кадры сами, подводя камеру Studio к каждому виду, а потом просите скрипты. С плагином 3.9 или новее RoCode может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.11 или новее может управлять тестовым персонажем, чтобы проверить, что игра работает, но во время игры он не делает скриншоты, поэтому катсцену вы смотрите сами. Порядок, в котором собирать целую игру, есть на странице как сделать игру в Roblox с ИИ, система за системой. Как RoCode подключается к Studio.
Частые вопросы
Как сделать, чтобы катсцена играла при входе в игру?
Назовите папку с кадрами Intro в Workspace.Cutscenes или поменяйте INTRO_CUTSCENE на имя своей папки. CutsceneService проигрывает её при первом спавне каждого игрока на сервере. Чтобы показывать её только при самом первом заходе, сохраняйте флаг в data store и ставьте его только после того, как интро началось, как описано в разделе Как расширить систему.
Можно ли сделать катсцену без плагинов?
Да. В этом гайде только парты, атрибуты и два скрипта, а строка для Command Bar ставит каждый кадр ровно туда, где стоит камера Studio. Плагины вроде Moon Animator всё равно удобны, чтобы анимировать персонажей, которые играют в катсцене.
Почему камера не двигается в катсцене?
Обычно код камеры лежит в серверном Script, а двигать камеру игрока может только LocalScript, потому что у каждого устройства своя камера. Другая частая причина: CameraType не Scriptable, и стандартные скрипты камеры Roblox всё время возвращают камеру к персонажу.
Как запретить игроку двигаться во время катсцены?
Заанкерьте его HumanoidRootPart на сервере, пока она играет, и снимите анкер после, как делает CutsceneService. Заанкеренный парт никогда не двигается от физики. WalkSpeed при этом не трогается, поэтому это не конфликтует со скриптом спринта или пассом на скорость.
Как добавить кнопку Skip в катсцену?
Положите TextButton на экран катсцены и подключите его событие Activated, которое срабатывает на клик, тап или кнопку A на геймпаде, когда кнопка выбрана. Skip в CutscenePlayer ставит флаг, который цикл кадров проверяет каждый кадр, сама выбирается для игроков с геймпадом и лежит в своём 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 (на английском). какие анимации реплицируются
Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.