Урок · Игрови системи

Как да направиш катсцена в Roblox Studio

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

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

Накратко

Постави невидими закотвени партове с имена 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 не се пипа, затова това не влиза в конфликт със скрипт за бягане или геймпас за скорост. Накрая скриптът маха Anchored от 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 на сървъра, докато тя върви, и махни Anchored след това, както прави CutsceneService. Закотвен парт никога не се движи от физиката. WalkSpeed при това не се пипа, затова няма конфликт със скрипт за бягане или геймпас за скорост.

Как да добавя бутон Skip в катсцената?

Сложи TextButton на екрана на катсцената и свържи неговото събитие Activated, което се задейства при кликване, докосване или бутона A на геймпада, когато бутонът е избран. Skip в CutscenePlayer вдига флаг, който цикълът на кадрите проверява на всеки кадър, сам се избира за играчите с геймпад и е в свой ScreenGui с отстъпите по подразбиране, за да не го закрие изрезът за камерата на телефона. Стикът и бутонът за скок са скрити, докато върви катсцената, затова не стоят до него.

Защо в катсцената светът е празен?

При включен instance streaming на устройството на играча има само областта близо до неговия персонаж. Нека сървърът вика player:RequestStreamAroundAsync за всеки кадър малко преди камерата да стигне там, както прави CutsceneService. Roblox пише, че така областта вероятно, но не със сигурност, ще бъде заредена, затова дръж важните кадри в радиуса на стрийминга или използвай Player:AddReplicationFocus за област, която трябва да остане заредена.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.