Туториал · Игровые системы

Как сделать катсцену в Roblox Studio

Катсцена в Roblox это камера, которая на несколько секунд забирает управление: переключается или плавно летит между кадрами, показывает титр и возвращает управление игроку. В этом гайде мы собираем катсцену, которую вы настраиваете, расставляя невидимые парты там, где должна стоять камера, без плагинов. Сервер решает, когда игрок её видит (при первом спавне или при касании триггера), а устройство игрока двигает камеру, показывает чёрные полосы и кнопку Skip и возвращает камеру.

Обновлено 14 ноября 2026 г.20 мин чтенияАвтор:

Коротко

Расставьте невидимые заанкеренные парты с именами 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.
На этой странице
  1. Как это работает
  2. 1. Кадры
  3. 2. Серверный скрипт
  4. 3. LocalScript
  5. 4. Триггер
  6. Детали камеры
  7. Старые туториалы
  8. Защита от читов
  9. 5. Проверка
  10. Расширение
  11. Common errors
  12. С RoCode
  13. Частые вопросы
  14. Источники и что почитать

Как работает катсцена

ИллюстрацияИнтро из двух кадров в реальной скорости: переключение на первый кадр, пауза 1 секунда, пролёт к мосту за 2.5 секунды, пауза 1 секунда, затем камера возвращается к игроку.

У каждого устройства игрока свой объект Camera, в workspace.CurrentCamera, поэтому двигать то, что видит игрок, может только LocalScript. Решать, кто какую катсцену видит и когда, это работа сервера. Гайд делит работу именно так. Одна катсцена проходит так:

  1. Сервер решает, что игрок должен увидеть катсцену: Intro при первом спавне на сервере или другую, когда он касается парта-триггера.
  2. CutsceneService читает CFrame и настройки партов-кадров, просит Roblox подгрузить этому игроку область первого кадра, анкерит HumanoidRootPart игрока, чтобы он стоял на месте, и отправляет CutsceneEvent только этому игроку с id и списком кадров.
  3. CutscenePlayer на устройстве игрока показывает чёрные полосы и кнопку Skip, прячет список игроков, рюкзак, полоску здоровья и сенсорное управление, делает камеру Scriptable и двигает её каждый кадр.
  4. Когда последний кадр заканчивается или игрок нажимает Skip, он возвращает камеру персонажу и отправляет серверу CutsceneEvent с тем же id.
  5. Сервер снимает анкер с игрока. Если это сообщение так и не пришло, он всё равно снимает анкер, когда пройдёт длина катсцены плюс 2 секунды. Таймер запускается, когда сервер отправляет катсцену, а при медленном входе устройство может начать интро на несколько секунд позже, потому что LocalScript вне ReplicatedFirst не запускается, пока игра не загрузилась. Тогда игрок может снова двигаться раньше, чем интро закончится у него на экране.
Из чего состоит система катсцен
ЭлементГде находитсяЧто делает
Script CutsceneServiceServerScriptServiceРешает, кто какую катсцену видит и когда, читает кадры, держит игрока на месте и помнит, кто что уже видел.
LocalScript CutscenePlayerStarterPlayer, StarterPlayerScriptsПроигрывает катсцену на экране игрока: полосы, титры, Skip и движение камеры. В конце возвращает камеру.
RemoteEvent CutsceneEventReplicatedStorage (его создаёт CutsceneService)Несёт кадры от сервера одному игроку и обратно сообщение "катсцена закончилась".
Folder CutscenesWorkspaceПо одной папке на катсцену, например Intro, с партами-кадрами 1, 2, 3.
Folder CutsceneTriggersWorkspace (необязательно)Парты, которые запускают катсцену, когда игрок их касается.
Explorer, когда система катсцен готова. Папки Bridge и CutsceneTriggers появляются в шаге 4. Когда игра запускается, CutsceneService добавляет в ReplicatedStorage RemoteEvent с именем CutsceneEvent.
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: Расставьте кадры камеры

Каждый кадр это невидимый парт. Камера берёт позицию парта и смотрит туда же, куда его передняя грань, так что поставить кадр значит поставить камеру.

  1. В Explorer наведите курсор на Workspace, нажмите кнопку + и вставьте Folder с именем Cutscenes. Внутри него вставьте Folder с именем Intro. Регистр букв в именах важен.
  2. Подведите камеру Studio к первому нужному виду, как будто выстраиваете кадр для фото.
  3. Вставьте Part в Intro и переименуйте его в 1.
  4. Откройте Command Bar (на вкладке Script или через Window, затем Script) и выполните workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. В режиме редактирования CurrentCamera это вид, через который вы смотрите, поэтому парт встаёт ровно в этот кадр. Скобки и кавычки нужны, потому что имя, которое начинается с цифры, нельзя писать после точки.
  5. В Properties парта отметьте Anchored, снимите CanCollide, CanTouch и CanQuery и поставьте Transparency на 1. Anchored не даёт ему провалиться сквозь карту; остальное не даёт ему мешать игрокам, запускать события касания и перекрывать рейкасты.
  6. Повторите для следующих видов, называя парты 2, 3 и так далее и меняя номер в строке для Command Bar. CutsceneService проигрывает кадры по порядку номеров и останавливается на первом пропущенном номере, поэтому дырка в нумерации обрывает катсцену раньше времени.

Чтобы потом поменять кадр, подведите камеру к новому виду и выполните ту же строку с номером этого кадра. С Transparency 1 парты невидимы и в Studio, поэтому выбирайте их в Explorer, когда они нужны.

У каждого кадра могут быть ещё три необязательных атрибута. Чтобы добавить атрибут, выберите парт, прокрутите окно Properties до раздела Attributes, нажмите +, введите имя, выберите тип и нажмите Save.

Необязательные атрибуты на каждом парте-кадре
АтрибутТипПо умолчаниюЧто делает
MoveSecondsnumber3Сколько секунд камера летит от предыдущего кадра к этому. 0 делает резкое переключение. Кадр 1 всегда переключение, поэтому для него атрибут не действует.
HoldSecondsnumber1Сколько секунд камера стоит на этом кадре после прилёта.
CaptionstringнетТекст на нижней полосе с момента, когда камера начинает лететь к этому кадру. Кадр без Caption очищает текст.

Число меньше 0 или больше 60, а также атрибут неправильного типа заменяются значением по умолчанию.

Шаг 2: Добавьте серверный скрипт

Наведите курсор на ServerScriptService, вставьте Script с именем CutsceneService и вставьте в него код ниже. Настройки вверху это строки, которые вы можете менять.

Script в ServerScriptService с именем 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 может найти ваш, а его на сервере никто не слушает.

Настройки вверху CutsceneService
НастройкаЗначение здесьЧто меняет
INTRO_CUTSCENE"Intro"Папка в Workspace.Cutscenes, которая играет при первом спавне игрока на сервере. Поставьте "", чтобы интро не было.
DEFAULT_MOVE_SECONDS3Сколько длится пролёт, если у кадра нет атрибута MoveSeconds.
DEFAULT_HOLD_SECONDS1Сколько камера стоит на кадре, если у него нет атрибута HoldSeconds.
MAX_SHOTS30Самый большой номер кадра, который 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, который её проигрывает

  1. В Explorer раскройте StarterPlayer, наведите курсор на StarterPlayerScripts и вставьте LocalScript с именем CutscenePlayer.
  2. Замените его содержимое кодом ниже.
LocalScript в StarterPlayerScripts с именем 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, ставятся в очередь и доставляются после подключения, так что игрок, который быстро заспавнился, всё равно увидит интро.

Что делает каждая часть CutscenePlayer
ЧастьЧто делает
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 обратно, чтобы сервер не держал игрока на месте ради катсцены, которую это устройство не показало.
Кнопка SkipActivated срабатывает на клик мышью, тап или кнопку A на геймпаде, когда кнопка выбрана. Для игрока, у которого основной ввод это геймпад, play выбирает Skip в начале катсцены и снимает выбор в конце.

Меняйте BAR_HEIGHT, чтобы сделать полосы тоньше или толще, и EASING_STYLE, чтобы изменить ощущение от пролётов (см. Что код камеры делает правильно). У титра и кнопки Skip включён TextScaled, поэтому текст растёт и уменьшается вместе с экраном.

Шаг 4: Катсцена при касании парта

Интро играет само. Для катсцены в определённом месте карты, например когда игрок впервые доходит до моста, добавьте вторую катсцену и парт-триггер.

  1. В Workspace, Cutscenes вставьте Folder с именем Bridge и расставьте его кадры как в шаге 1, с именами 1 и 2. В строке для Command Bar пишите Bridge вместо Intro.
  2. Наведите курсор на Workspace и вставьте Folder с именем CutsceneTriggers.
  3. Вставьте в него Part с именем BridgeTrigger. Сделайте его таким большим, чтобы игроки не могли пройти мимо, не коснувшись его, например высокую широкую плиту поперёк дороги. Отметьте Anchored, снимите CanCollide и CanQuery, оставьте CanTouch отмеченным и поставьте Transparency на 1. Выключенный CanQuery не даёт невидимой плите перекрывать рейкасты, например выстрелы из гайда по оружию. События касания управляются через CanTouch, а не CanQuery, поэтому триггер всё равно работает.
  4. Добавьте ему атрибут 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: Проверьте

  1. Расставьте три кадра Intro строкой для Command Bar. Дайте кадру 1 Caption "Welcome to the village", кадру 2 MoveSeconds 2.5 и Caption "Find the bridge", а кадр 3 оставьте без атрибутов.
  2. Нажмите Play (F5). Появляются чёрные полосы, камера переключается на кадр 1 с его титром, за 2.5 секунды летит к кадру 2, затем за 3 секунды к кадру 3 без титра. Потом камера возвращается за спину персонажа, и список игроков появляется снова. Пока она играет, ходить нельзя.
  3. Остановите тест, снова нажмите Play и нажмите Skip, пока камера летит к кадру 2. Камера сразу возвращается, и можно сразу ходить.
  4. Зайдите в BridgeTrigger: играет катсцена Bridge. Пройдите сквозь него ещё раз: ничего не происходит.
  5. Выберите Server & Clients в выпадающем списке режима теста, поставьте 2 клиента и нажмите Play. Когда Client 1 заходит в триггер, катсцена Bridge играет только у Client 1, а Client 2 может ходить.
  6. Оставьте Workspace.StreamingEnabled включённым и отнесите один кадр далеко от спавна. Когда камера прилетит, окружение должно быть на месте (вероятно, но не гарантированно: см. Стриминг).
  7. Для геймпада остановите тест, нажмите Play, откройте Controller Emulator (вкладка Emulation, затем Controller) и зайдите в BridgeTrigger эмулированным геймпадом: Skip должна быть выбрана, так что A пропускает катсцену. Если вы пользуетесь Device Simulator в Studio (на момент нашей проверки 15 октября 2026 года это бета: включите её в File, Beta Features, New Device Simulator и перезапустите Studio), выберите телефон, поверните его горизонтально и проверьте, что Skip не заходит под вырез камеры и по ней легко попасть, а стик и кнопка прыжка спрятаны, пока идёт катсцена.
  8. Если вы сделали ещё и главное меню, нажмите 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, играет один раз при первом спавне игрока, сервер держит игрока на месте, а в конце камера возвращается.

RoCode делает
  • Может сначала проверить ваш плейс через 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 для области, которая должна оставаться загруженной.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.