Накратко
Постави невидими закотвени партове с имена 1, 2, 3 в папка в Workspace.Cutscenes, всеки с лице натам, накъдето трябва да гледа камерата. Script в ServerScriptService чете техните CFrame, държи играча на място и праща кадрите на този играч чрез RemoteEvent. LocalScript в StarterPlayerScripts задава workspace.CurrentCamera.CameraType на Scriptable, на всеки кадър движи камерата от кадър към кадър (с изглаждане чрез TweenService:GetValue), а после връща CameraType на Custom и CameraSubject към Humanoid на играча.
- Камерата може да се управлява само от устройството на играча, затова кодът за камерата е LocalScript. Сървърът само решава кой каква катсцена вижда и кога.
- Когато камерата е Scriptable, Roblox спира да обновява
Camera.Focus. В справката пише Focus да се обновява на всеки кадър, иначе динамичното осветление далеч от стария фокус може да не се изрисува. Camera:Interpolateе остарял. В справката на Roblox пише камерата да се анимира чрез TweenService.
На тази страница
Как работи катсцената
Всяко устройство на играч има собствен обект Camera, в workspace.CurrentCamera, затова само LocalScript може да движи това, което играчът вижда. Решението кой каква катсцена вижда и кога е работа на сървъра. Ръководството разделя работата точно така. Една катсцена минава така:
- Сървърът решава, че играчът трябва да види катсцена:
Introпри първата поява на сървъра или друга, когато докосне парт тригер. - CutsceneService чете CFrame и настройките на партовете кадри, моли Roblox да зареди за този играч областта на първия кадър, закотвя HumanoidRootPart на играча, за да стои на място, и праща
CutsceneEventсамо на този играч с id и списък с кадри. - CutscenePlayer на устройството на играча показва черните ленти и бутона Skip, скрива списъка с играчи, раницата, лентата за здраве и сензорното управление, прави камерата Scriptable и я движи на всеки кадър.
- Когато последният кадър свърши или играчът натисне Skip, той връща камерата към персонажа и праща на сървъра
CutsceneEventсъс същия id. - Сървърът отключва играча. Ако това съобщение така и не дойде, пак го отключва, когато мине дължината на катсцената плюс 2 секунди. Таймерът тръгва, когато сървърът изпрати катсцената, а при бавно влизане устройството може да започне интрото няколко секунди по-късно, защото LocalScript извън ReplicatedFirst не тръгва, докато играта не се зареди. Тогава играчът може пак да се движи, преди интрото да е свършило на екрана му.
| Елемент | Къде се намира | Какво прави |
|---|---|---|
Script CutsceneService | ServerScriptService | Решава кой каква катсцена вижда и кога, чете кадрите, държи играча на място и помни кой какво вече е видял. |
LocalScript CutscenePlayer | StarterPlayer, StarterPlayerScripts | Пуска катсцената на екрана на играча: ленти, надписи, Skip и движение на камерата. Накрая връща камерата. |
RemoteEvent CutsceneEvent | ReplicatedStorage (създава го CutsceneService) | Носи кадрите от сървъра до един играч и обратно съобщението "катсцената свърши". |
Folder Cutscenes | Workspace | По една папка за всяка катсцена, например Intro, с партове кадри 1, 2, 3. |
Folder CutsceneTriggers | Workspace (по желание) | Партове, които пускат катсцена, когато играчът ги докосне. |
Workspace
Cutscenes Folder new
Intro Folder new
1 Part new
2 Part new
3 Part new
Bridge Folder new
1 Part new
2 Part new
CutsceneTriggers Folder new
BridgeTrigger Part new
ServerScriptService
CutsceneService Script new
StarterPlayer
StarterPlayerScripts
CutscenePlayer LocalScript new
Стъпка 1: Постави кадрите на камерата
Всеки кадър е невидим парт. Камерата взема позицията на парта и гледа натам, накъдето гледа предната му страна, така че да поставиш кадър значи да поставиш камерата.
- В Explorer задръж курсора над Workspace, натисни бутона + и постави Folder с име
Cutscenes. В нея постави Folder с имеIntro. Главните и малките букви в имената са важни. - Насочи камерата на Studio към първия изглед, който искаш, все едно нагласяш кадър за снимка.
- Постави Part в Intro и го преименувай на
1. - Отвори Command Bar (в раздела Script или чрез Window, после Script) и изпълни
workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. В режим на редактиранеCurrentCameraе изгледът, през който гледаш, затова партът застава точно в този кадър. Скобите и кавичките са нужни, защото име, което започва с цифра, не може да се пише след точка. - В Properties на парта отметни Anchored, махни отметките от CanCollide, CanTouch и CanQuery и задай Transparency на 1. Anchored не му дава да пропадне през картата; останалото не му дава да пречи на играчите, да пуска събития при докосване и да прегражда рейкастове.
- Повтори за следващите изгледи, като кръщаваш партовете
2,3и така нататък и сменяш номера в реда за Command Bar. CutsceneService пуска кадрите по реда на номерата и спира при първия пропуснат номер, затова дупка в номерацията прекъсва катсцената по-рано.
За да смениш кадър по-късно, насочи камерата към новия изглед и изпълни същия ред с номера на този кадър. С Transparency 1 партовете са невидими и в Studio, затова ги избирай в Explorer, когато ти трябват.
Всеки кадър може да има още три атрибута по желание. За да добавиш атрибут, избери парта, превърти прозореца Properties до раздела Attributes, натисни +, въведи име, избери тип и натисни Save.
| Атрибут | Тип | По подразбиране | Какво прави |
|---|---|---|---|
MoveSeconds | number | 3 | Колко секунди камерата лети от предишния кадър до този. 0 прави рязко превключване. Кадър 1 винаги е превключване, затова при него атрибутът не действа. |
HoldSeconds | number | 1 | Колко секунди камерата стои на този кадър, след като стигне до него. |
Caption | string | няма | Текст на долната лента от момента, в който камерата започне да лети към този кадър. Кадър без Caption изчиства текста. |
Число под 0 или над 60, както и атрибут с грешен тип, се заменят със стойността по подразбиране.
Стъпка 2: Добави сървърния скрипт
Задръж курсора над ServerScriptService, постави Script с име CutsceneService и постави в него кода по-долу. Настройките най-горе са редовете, които можеш да променяш.
-- Script в ServerScriptService с име CutsceneService.
-- Решава кой каква катсцена вижда и кога. Чете кадрите на камерата от номерирани
-- партове в Workspace.Cutscenes, държи играча на място и казва на устройството
-- на този играч да пусне кадрите. Самата камера може да се движи само на устройството.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Настройки
local INTRO_CUTSCENE = "Intro" -- пуска се веднъж при първата поява на играча; "" за изключване
local DEFAULT_MOVE_SECONDS = 3 -- време за прехода до кадър, ако няма MoveSeconds
local DEFAULT_HOLD_SECONDS = 1 -- време на кадъра, ако няма HoldSeconds
local MAX_SHOTS = 30
local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")
-- Този скрипт сам създава CutsceneEvent, затова не го добавяй на ръка
local cutsceneEvent = Instance.new("RemoteEvent")
cutsceneEvent.Name = "CutsceneEvent"
cutsceneEvent.Parent = ReplicatedStorage
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
local seen: { [Player]: { [string]: boolean } } = {}
local playing: { [Player]: number } = {} -- id на катсцената, която играчът гледа
local lastId = 0
local function secondsAttribute(part: Instance, name: string, default: number): number
local value = part:GetAttribute(name)
if typeof(value) == "number" and value >= 0 and value <= 60 then
return value
end
return default
end
-- Кадрите са партовете 1, 2, 3 ... в папката с името на катсцената
local function readShots(name: string): { Shot }
local shots: { Shot } = {}
local folder = cutscenes:FindFirstChild(name)
if not folder then
warn(`CutsceneService: no folder named {name} in Workspace.Cutscenes`)
return shots
end
for index = 1, MAX_SHOTS do
local part = folder:FindFirstChild(tostring(index))
if not (part and part:IsA("BasePart")) then
break
end
local caption = part:GetAttribute("Caption")
table.insert(shots, {
cframe = part.CFrame,
-- първият кадър е превключване, затова камерата веднага скача в него
move = if index == 1 then 0 else secondsAttribute(part, "MoveSeconds", DEFAULT_MOVE_SECONDS),
hold = secondsAttribute(part, "HoldSeconds", DEFAULT_HOLD_SECONDS),
caption = if typeof(caption) == "string" then caption else "",
})
end
return shots
end
local function setFrozen(player: Player, frozen: boolean)
local character = player.Character
local rootPart = character and character:FindFirstChild("HumanoidRootPart")
if rootPart and rootPart:IsA("BasePart") then
rootPart.Anchored = frozen
end
end
local function finish(player: Player, id: number)
if playing[player] ~= id then
return -- тази катсцена вече е свършила
end
playing[player] = nil
setFrozen(player, false)
end
local function play(player: Player, name: string): boolean
if playing[player] then
return false -- една катсцена наведнъж
end
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not humanoid or humanoid.Health <= 0 then
return false
end
local shots = readShots(name)
if #shots == 0 then
return false
end
lastId += 1
local id = lastId
playing[player] = id
-- При включен instance streaming на устройството на играча може да я няма областта,
-- към която гледа кадърът, а заявката зарежда областта само временно. Зареждаме
-- областта на първия кадър сега (чакаме до 2 секунди), а областта на всеки следващ
-- 2 секунди преди камерата да полети към него.
local function request(position: Vector3)
pcall(function()
player:RequestStreamAroundAsync(position, 2)
end)
end
request(shots[1].cframe.Position)
if playing[player] ~= id or player.Parent ~= Players then
return false -- играчът е излязъл, докато областта се зареждаше
end
setFrozen(player, true)
cutsceneEvent:FireClient(player, id, shots)
local startsAt = 0 -- секунди от сега до началото на прехода към този кадър
for index, shot in shots do
if index > 1 then
task.delay(math.max(startsAt - 2, 0), function()
if playing[player] == id then
request(shot.cframe.Position)
end
end)
end
startsAt += shot.move + shot.hold
end
-- Застраховка: отключваме играча, дори ако устройството му така и не е отговорило
task.delay(startsAt + 2, finish, player, id)
return true
end
-- Връща true, само ако катсцената е тръгнала за този играч
local function playOnce(player: Player, name: string): boolean
local playerSeen = seen[player]
if not playerSeen or playerSeen[name] then
return false
end
if play(player, name) then
playerSeen[name] = true
return true
end
return false
end
-- Устройството на играча съобщава, че катсцената е свършила или е пропусната
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
if typeof(id) == "number" then
finish(player, id)
end
end)
-- Партове тригери: докосването пуска катсцената от техния атрибут Cutscene
if triggers then
for _, trigger in triggers:GetChildren() do
if not trigger:IsA("BasePart") then
continue
end
if not trigger.CanTouch then
-- Свързването на Touched към парт с изключен CanTouch дава грешка, затова само предупреждаваме
warn(`CutsceneService: tick CanTouch on {trigger:GetFullName()} so it can start a cutscene`)
continue
end
trigger.Touched:Connect(function(otherPart: BasePart)
local name = trigger:GetAttribute("Cutscene")
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if player and typeof(name) == "string" then
playOnce(player, name)
end
end)
end
end
local function onCharacterAdded(player: Player, character: Model)
character:WaitForChild("HumanoidRootPart", 10)
if playing[player] then
setFrozen(player, true) -- поява по време на катсцена, държим на място и новия персонаж
elseif INTRO_CUTSCENE ~= "" then
playOnce(player, INTRO_CUTSCENE)
end
end
local function onPlayerAdded(player: Player)
if seen[player] then
return -- вече е настроен
end
seen[player] = {}
player.CharacterAdded:Connect(function(character: Model)
onCharacterAdded(player, character)
end)
local character = player.Character
if character then
task.spawn(onCharacterAdded, player, character)
end
end
Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do -- всички, които са влезли, докато скриптът чакаше Cutscenes
onPlayerAdded(player)
end
Players.PlayerRemoving:Connect(function(player: Player)
seen[player] = nil
playing[player] = nil
end)
CutsceneService сам създава RemoteEvent CutsceneEvent, щом се появи Workspace.Cutscenes, затова не трябва да поставяш нищо на ръка в ReplicatedStorage. Ако вече си направил RemoteEvent с такова име, изтрий го: LocalScript може да намери твоя, а него на сървъра никой не слуша.
| Настройка | Стойност тук | Какво променя |
|---|---|---|
INTRO_CUTSCENE | "Intro" | Папката в Workspace.Cutscenes, която се пуска при първата поява на играча на сървъра. Задай "", за да няма интро. |
DEFAULT_MOVE_SECONDS | 3 | Колко трае преходът, ако кадърът няма атрибут MoveSeconds. |
DEFAULT_HOLD_SECONDS | 1 | Колко стои камерата на кадъра, ако той няма атрибут HoldSeconds. |
MAX_SHOTS | 30 | Най-големият номер на кадър, който CutsceneService търси в една катсцена. |
Какво прави останалата част от скрипта, по ред:
- Чете кадрите на сървъра.
readShotsсъбира CFrame и атрибутите на всеки номериран парт в списък. Устройството на играча получава този списък, затова самите партове не са му нужни. - Една катсцена наведнъж.
playне прави нищо, докато играчът вече гледа катсцена, или ако персонажът му няма Humanoid или е мъртъв. - Всяка катсцена има свой id. Устройството праща id обратно, когато катсцената свърши или е пропусната, и само съвпадащ id отключва играча, затова закъсняло съобщение от предишна катсцена не може да прекрати новата.
- Държи играча на място, като закотвя неговия HumanoidRootPart, и закотвя новия персонаж, ако играчът се появи отново по средата на катсцената. В справката на Roblox пише, че закотвен парт никога не сменя позицията си заради гравитация, сблъсъци или друга физика. WalkSpeed не се пипа, затова това не влиза в конфликт със скрипт за бягане или геймпас за скорост. Накрая скриптът маха Anchored от root part, дори ако го е закотвил друг скрипт, затова не закотвяй персонажите на друго място, докато може да върви катсцена.
- Застраховка.
task.delayотключва играча след пълната дължина на катсцената плюс 2 секунди, дори ако устройството му така и не е отговорило. - Всяка катсцена веднъж на сървър. Таблицата
seenпомни за всеки играч кои катсцени вече са започнали, затова интрото не се повтаря при нова поява, а катсцената от тригер се пуска веднъж.playOnceвръща true, само ако катсцената наистина е тръгнала. - Настройва всеки играч. Цикълът по
Players:GetPlayers()накрая хваща всички, които са влезли, докато скриптът е чакал папката Cutscenes.
Кадрите стигат до играча с едно извикване на FireClient, като списък от малки таблици. На страницата на Roblox за remote events пише да не се праща таблица, в която са смесени числови и текстови ключове; в този списък има само числови ключове, а във всеки кадър вътре само текстови, и това е формата, която се препоръчва там.
Стъпка 3: Добави LocalScript, който я пуска
- В Explorer разгъни StarterPlayer, задръж курсора над StarterPlayerScripts и постави LocalScript с име
CutscenePlayer. - Замени съдържанието му с кода по-долу.
-- LocalScript в StarterPlayer > StarterPlayerScripts с име CutscenePlayer.
-- Пуска катсцената, която праща сървърът: черни ленти, надписи, бутон Skip и
-- камера, която лети от кадър към кадър. После връща камерата на играча.
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local StarterGui = game:GetService("StarterGui")
local TweenService = game:GetService("TweenService")
local UserInputService = game:GetService("UserInputService")
local cutsceneEvent = ReplicatedStorage:WaitForChild("CutsceneEvent") :: RemoteEvent
local player = Players.LocalPlayer
local camera = workspace.CurrentCamera
local BAR_HEIGHT = 0.12 -- всяка черна лента, като дял от височината на екрана
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- на колко стъда пред камерата Roblox да рисува с най-много детайли
local HIDDEN_CORE_GUIS = { Enum.CoreGuiType.PlayerList, Enum.CoreGuiType.Backpack, Enum.CoreGuiType.Health }
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
-- Екранът на катсцената: две черни ленти и надпис, от край до край. Roblox съветва да се слага
-- ScreenInsets None само за неща, които никой не натиска, затова Skip по-долу има свой ScreenGui.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- на цял екран
gui.DisplayOrder = 10
gui.Enabled = false
local topBar = Instance.new("Frame")
topBar.Size = UDim2.fromScale(1, BAR_HEIGHT)
topBar.BackgroundColor3 = Color3.new(0, 0, 0)
topBar.BorderSizePixel = 0
topBar.Parent = gui
local bottomBar = topBar:Clone()
bottomBar.Position = UDim2.fromScale(0, 1 - BAR_HEIGHT)
bottomBar.Parent = gui
local caption = Instance.new("TextLabel")
caption.Size = UDim2.fromScale(0.7, 0.5)
caption.Position = UDim2.fromScale(0.15, 0.25)
caption.BackgroundTransparency = 1
caption.TextColor3 = Color3.new(1, 1, 1)
caption.TextScaled = true
caption.FontFace = REGULAR
caption.Text = ""
caption.Parent = bottomBar
-- Бутонът Skip е с отстъпите по подразбиране, затова изрезът за камерата не го закрива
local controls = Instance.new("ScreenGui")
controls.Name = "CutsceneControls"
controls.ResetOnSpawn = false
controls.DisplayOrder = 11
controls.Enabled = false
local skipButton = Instance.new("TextButton")
skipButton.AnchorPoint = Vector2.new(1, 0.5)
skipButton.Size = UDim2.fromScale(0.1, BAR_HEIGHT * 0.5)
skipButton.Position = UDim2.new(1, -16, 1 - BAR_HEIGHT / 2, 0) -- на долната лента, вдясно
skipButton.BackgroundColor3 = Color3.fromRGB(60, 60, 60)
skipButton.TextColor3 = Color3.new(1, 1, 1)
skipButton.TextScaled = true
skipButton.FontFace = BOLD
skipButton.Text = "Skip"
skipButton.Parent = controls
-- Skip остава достатъчно голям, за да се уцели на малък телефон
local skipMinSize = Instance.new("UISizeConstraint")
skipMinSize.MinSize = Vector2.new(64, 32)
skipMinSize.Parent = skipButton
local playerGui = player:WaitForChild("PlayerGui")
gui.Parent = playerGui
controls.Parent = playerGui
-- Текущият преход: от един CFrame на камерата към следващия за зададен брой секунди
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false
-- Работи на всеки кадър по време на катсцената. Focus на Scriptable камера сам не следи
-- нищо, затова и той се задава тук.
local function updateCamera()
if camera.CameraType ~= Enum.CameraType.Scriptable then
camera.CameraType = Enum.CameraType.Scriptable -- нещо го е нулирало, например нова поява
end
local alpha = if moveSeconds > 0 then (os.clock() - moveStart) / moveSeconds else 1
local eased = TweenService:GetValue(alpha, EASING_STYLE, Enum.EasingDirection.InOut)
camera.CFrame = moveFrom:Lerp(moveTo, eased)
camera.Focus = camera.CFrame * CFrame.new(0, 0, -FOCUS_DISTANCE)
end
local function waitOrSkip(seconds: number)
local endTime = os.clock() + seconds
while os.clock() < endTime and not skipRequested do
task.wait()
end
end
local function play(id: number, shots: { Shot })
if busy then
-- Една вече върви, затова нека сървърът веднага отключи играча за тази
cutsceneEvent:FireServer(id)
return
end
busy = true
skipRequested = false
-- Скриваме списъка с играчи, раницата и лентата за здраве, като помним какво се е виждало
local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
for _, coreGui in HIDDEN_CORE_GUIS do
wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
StarterGui:SetCoreGuiEnabled(coreGui, false)
end
-- На телефоните скриваме стика и бутона за скок, които са в долните ъгли
local touchControlsWere = GuiService.TouchControlsEnabled
GuiService.TouchControlsEnabled = false
gui.Enabled = true
controls.Enabled = true
-- Геймпадът може да натисне само избрания бутон, затова за играчите с геймпад избираме Skip
if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = skipButton
end
camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable
moveTo = camera.CFrame
-- Една стъпка след собственото обновяване на камерата на Roblox, както в урока на Roblox за камерата
RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)
for _, shot in shots do
moveFrom = camera.CFrame -- всеки преход започва оттам, където е камерата сега
moveTo = shot.cframe
moveStart = os.clock()
moveSeconds = shot.move
caption.Text = shot.caption
waitOrSkip(shot.move + shot.hold)
if skipRequested then
break
end
end
-- Връщаме камерата на персонажа на играча
RunService:UnbindFromRenderStep("Cutscene")
camera.CameraType = Enum.CameraType.Custom
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if humanoid then
camera.CameraSubject = humanoid
end
if GuiService.SelectedObject == skipButton then
GuiService.SelectedObject = nil
end
gui.Enabled = false
controls.Enabled = false
caption.Text = ""
-- Включваме обратно само това, което тази катсцена е изключила, останалото не пипаме
for coreGui, enabled in wasEnabled do
if enabled then
StarterGui:SetCoreGuiEnabled(coreGui, true)
end
end
if touchControlsWere then
GuiService.TouchControlsEnabled = true
end
cutsceneEvent:FireServer(id) -- сървърът веднага отключва играча
busy = false
end
skipButton.Activated:Connect(function()
skipRequested = true
end)
cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
play(id, shots)
end)
LocalScript в StarterPlayerScripts се копира на играча веднъж, при влизане, и продължава да работи след нова поява на персонажа. Затова и двата ScreenGui са с изключено ResetOnSpawn: ако го включиш, Roblox ще ги изтрие при първата нова поява, а този скрипт няма да ги създаде отново. Съобщенията на ремоута, дошли преди скриптът да се свърже с OnClientEvent, се нареждат на опашка и се доставят след свързването, така че играч, който се е появил бързо, пак ще види интрото.
| Част | Какво прави |
|---|---|
ScreenGui Cutscene | Две черни ленти, всяка по 12% от височината на екрана (BAR_HEIGHT), и надпис на долната лента. ScreenInsets None разтяга лентите до самите краища на екрана, а DisplayOrder 10 ги рисува над ScreenGui с по-малък DisplayOrder. |
ScreenGui CutsceneControls | В него е само бутонът Skip, вдясно на долната лента, с UISizeConstraint, който го държи поне 64 на 32 пиксела, за да се уцелва лесно на телефон. Той е с ScreenInsets по подразбиране и съдържанието не влиза под бутоните на горната лента на Roblox и изрезите за камерата. Roblox съветва None само за съдържание, което няма какво да се натиска, затова Skip не може да е в ScreenGui с лентите. |
HIDDEN_CORE_GUIS | Скрива списъка с играчи, раницата и лентата за здраве чрез SetCoreGuiEnabled, като преди това запомня чрез GetCoreGuiEnabled кои са били включени, а накрая включва обратно само тези, които сам е изключил. Ако играта скрива раницата на друго място, тя ще остане скрита, а скрипт, който ги включва по време на катсцената, например главното меню, никой не го прекъсва. |
TouchControlsEnabled | На телефони и таблети play задава GuiService.TouchControlsEnabled на false за времето на катсцената. Това скрива стика и бутона за скок, които са в долните ъгли, на същото място като Skip, и накрая те се връщат, ако са били включени. |
updateCamera | Работи на всеки кадър, докато върви катсцената. Изчислява каква част от текущия преход е минала, изглажда я чрез TweenService:GetValue, слага камерата между двата кадъра чрез CFrame:Lerp и задава Focus на 30 стъда пред камерата. |
waitOrSkip | Чака времето на прехода и паузата на кадъра, като на всеки кадър проверява флага Skip. |
play | Прави камерата Scriptable, пуска кадрите по ред, после връща камерата (CameraType Custom, CameraSubject е Humanoid), включва обратно core GUI и сензорното управление и праща на сървъра id на катсцената. Ако втора катсцена дойде, докато първата още върви, веднага праща нейния id обратно, за да не държи сървърът играча на място заради катсцена, която това устройство не е показало. |
| Бутонът Skip | Activated се задейства при кликване с мишката, докосване или бутона A на геймпада, когато бутонът е избран. За играч, чийто основен вход е геймпад, play избира Skip в началото на катсцената и маха избора накрая. |
Променяй BAR_HEIGHT, за да направиш лентите по-тънки или по-дебели, и EASING_STYLE, за да промениш усещането от преходите (виж Какво кодът за камерата прави правилно). Надписът и бутонът Skip са с включено TextScaled, затова текстът расте и намалява заедно с екрана.
Стъпка 4: Катсцена при докосване на парт
Интрото се пуска само. За катсцена на определено място в картата, например когато играчът за пръв път стигне до моста, добави втора катсцена и парт тригер.
- В Workspace, Cutscenes постави Folder с име
Bridgeи подреди кадрите му като в стъпка 1, с имена1и2. В реда за Command Bar пишиBridgeвместоIntro. - Задръж курсора над Workspace и постави Folder с име
CutsceneTriggers. - Постави в нея Part с име
BridgeTrigger. Направи го толкова голям, че играчите да не могат да минат покрай него, без да го докоснат, например висока широка плоча напряко на пътя. Отметни Anchored, махни отметките от CanCollide и CanQuery, остави CanTouch отметнато и задай Transparency на 1. Изключеното CanQuery не дава на невидимата плоча да прегражда рейкастове, например изстрелите от ръководството за оръжие. Събитията при докосване се управляват от CanTouch, а не от CanQuery, затова тригерът пак работи. - Добави му атрибут
Cutsceneот тип string и задай стойностBridge: името на папката, която трябва да се пусне.
CutsceneService свързва Touched с всеки парт директно в CutsceneTriggers при старта на сървъра, затова добавяй тригерите в Studio, а не със скрипт по време на игра. Тригер с изключено CanTouch се пропуска с предупреждение в Output, защото Roblox дава грешка, когато скрипт свърже Touched с такъв парт.
Докато персонажът минава през парта, Touched се задейства много пъти подред. Таблицата seen и правилото "една катсцена наведнъж" превръщат това в една катсцена на играч за сървър. Играч, който докосне тригера по време на друга катсцена, се пренебрегва и тригерът остава готов за него.
Не слагай тригери на пътища. HumanoidRootPart на седнал играч е заварен към седалката, а когато един парт от заварена група е закотвен, Roblox закотвя заедно с него и останалите. Затова играч, който влезе в тригера с превозно средство, държи на място цялото си превозно средство, заедно с пътниците, докато катсцената не свърши.
Какво кодът за камерата прави правилно
Scriptable, после обратно Custom
Скриптовете за камера на Roblox не движат и не обновяват камерата, докато CameraType е Scriptable, и точно това позволява на CutscenePlayer да я задава. Накрая той връща CameraType на Custom и прави Humanoid на играча CameraSubject, който скриптовете за камера на Roblox следят по подразбиране. Това се изпълнява и след Skip, така че играчът никога не остава загледан в последния кадър.
Две малки проверки държат катсцената главна, докато върви. Ако нещо зададе CameraType на друга стойност по средата на катсцената, функцията, която работи на всеки кадър, на следващия кадър връща Scriptable. А workspace.CurrentCamera скриптът чете наново в началото на всяка катсцена, защото Roblox създава нова Camera, ако текущата някога бъде изтрита.
Focus, на всеки кадър
Camera.Focus казва на енджина на коя област да дава приоритет в работа като осветлението. Скриптовете за камера на Roblox го държат на CameraSubject, но не и когато камерата е Scriptable, и в справката на Roblox пише в този случай да се обновява на всеки кадър: динамичната светлина от обекти като PointLight може да не се изрисува далеч от фокуса. CutscenePlayer го слага на 30 стъда пред камерата (FOCUS_DISTANCE). Увеличи това число, ако кадрите ти гледат към нещо по-далеч.
Функцията работи чрез RunService:BindToRenderStep, на всеки кадър преди изрисуването, една стъпка по приоритет след собственото обновяване на камерата на Roblox (Enum.RenderPriority.Camera.Value + 1). Този приоритет използва урокът на Roblox за камерата, затова катсцената задава камерата, след като собственият код за камера на Roblox е приключил.
Изглаждане чрез TweenService:GetValue
Туин върху camera.CFrame би движил камерата, но Focus пак трябва да се задава на всеки кадър, затова CutscenePlayer движи камерата сам в същата функция. За всеки преход изчислява какъв дял от времето е минал (от 0 до 1), прекарва го през TweenService:GetValue със стила и посоката на изглаждане и слага камерата на този дял от пътя между двата кадъра чрез CFrame:Lerp, който движи позицията по права линия и завърта плавно. GetValue ограничава входа между 0 и 1, затова камерата спира точно на кадъра, когато времето за прехода свърши.
| EASING_STYLE | Как се усеща преходът |
|---|---|
Enum.EasingStyle.Sine (тук) | Скоростта следва синусоида, мек старт и меко спиране. |
Enum.EasingStyle.Quad | Като Sine, но кривата е малко по-рязка. |
Enum.EasingStyle.Linear | Постоянна скорост, затова всеки преход започва и свършва на пълна скорост. |
Посоката InOut: изглаждането се прилага напред в първата половина на прехода и в обратна посока във втората, затова камерата ускорява от единия кадър и забавя към следващия.
Стрийминг
В новите плейсове instance streaming е включен: по подразбиране устройството на играча държи областта около неговия персонаж, затова кадър, който гледа към другия край на картата, може да покаже празен свят. CutsceneService моли Roblox да зареди за този играч областта на всеки кадър чрез Player:RequestStreamAroundAsync: областта на първия кадър преди изпращането на събитието, с чакане до 2 секунди, и областта на всеки следващ 2 секунди преди камерата да полети към него.
Roblox пише, че така областта вероятно, но не със сигурност, ще бъде заредена и че ефектът е временен. Дръж важните кадри в радиуса на стрийминга или използвай на сървъра Player:AddReplicationFocus за област, която трябва да остане заредена, докато не махнеш фокуса. При изключен стрийминг устройството и без това има цялата карта, а pcall около всяка заявка означава, че неуспешна заявка не може да спре катсцената.
Какво не е наред в старите уроци за катсцени
Ако сравняваш това ръководство с видео или публикация във форум, ето разликите, които са важни, и защо всеки от тези похвати е проблем.
| Урокът | Проблем | Това ръководство |
|---|---|---|
Движи камерата чрез camera:Interpolate() | Roblox е отбелязал Interpolate като остарял и съветва камерата да се анимира чрез TweenService. | Изглажда всеки преход чрез TweenService:GetValue и задава камерата на всеки кадър. |
Прави туин на camera.CFrame и нищо друго | Focus остава там, където са го оставили скриптовете за камера, близо до персонажа, затова динамичната светлина далеч от него може да не се изрисува (справката на Roblox за Camera.Focus). | Задава Focus на всеки кадър в render step. |
| Не връща камерата | Играчът остава заседнал, загледан в последния кадър. | Накрая задава CameraType на Custom и CameraSubject на Humanoid, и след Skip също. |
Пуска катсцената от Touched в LocalScript | Нищо не ѝ пречи да се повтаря при всяко докосване, а решението се взема на устройството, което управлява играчът. | Сървърът избира играча и помни кой вече я е видял. |
| Чете партовете за камерата на клиента | При включен стрийминг партовете далеч от персонажа може още да не съществуват на устройството. | Сървърът чете партовете, праща техните CFrame и иска областта на всеки кадър малко преди камерата да стигне там. |
Какво играчът може и не може да промени
Приеми, че измамникът управлява всичко на своето устройство: може да промени или изтрие CutscenePlayer и да прати CutsceneEvent с каквато и да е стойност. За катсцената това почти нищо не значи, ако от нея не зависи нищо истинско.
| Измамникът опитва | Резултат |
|---|---|
| Да пропусне катсцената или изобщо да не я пусне | Може: това е неговият собствен екран. Никога не давай награда за "изгледа катсцената". |
Да прати CutsceneEvent с каквато и да е стойност | Нещо прави само число, съвпадащо с текущата му катсцена, и единственото, което прави, е да го отключи по-рано. |
| Да докосне тригера от коя да е точка на картата | Възможно е: всяко устройство управлява своя персонаж и в документацията на Roblox за сигурност подправянето на събития Touched е посочено сред нещата, които то може да прави. Ще види тази катсцена веднъж и нищо повече няма да стане. |
| Да се движи въпреки всичко по време на катсцената | Няма какво да спечели. Замразяването не дава на честните играчи да си тръгват по средата на катсцената; това не е проверка за сигурност. |
| Да пусне чрез ремоута катсцена на някой друг | Невъзможно. Само сървърът може да праща CutsceneEvent на играч, а единственото, което устройството може да прати обратно, е "тази катсцена свърши". |
Ако катсцената води до нещо истинско, например до врата, която после се отваря, или до появата на бос, нека сървърът прави това по свой таймер, а не когато устройството съобщи, че катсцената е свършила.
Стъпка 5: Тествай
- Постави трите кадъра на Intro с реда за Command Bar. Дай на кадър 1
Caption"Welcome to the village", на кадър 2MoveSeconds2.5 иCaption"Find the bridge", а кадър 3 остави без атрибути. - Натисни Play (F5). Появяват се черните ленти, камерата превключва на кадър 1 с неговия надпис, за 2.5 секунди лети към кадър 2, после за 3 секунди към кадър 3 без надпис. След това камерата се връща зад гърба на персонажа и списъкът с играчи се появява отново. Докато тя върви, не можеш да ходиш.
- Спри теста, натисни пак Play и натисни Skip, докато камерата лети към кадър 2. Камерата веднага се връща и можеш веднага да ходиш.
- Влез в BridgeTrigger: пуска се катсцената Bridge. Мини през него още веднъж: нищо не става.
- Избери Server & Clients в падащия списък с режима на теста, задай 2 клиента и натисни Play. Когато Client 1 влезе в тригера, катсцената Bridge се пуска само при Client 1, а Client 2 може да ходи.
- Остави
Workspace.StreamingEnabledвключено и премести един кадър далеч от мястото на появата. Когато камерата стигне, околността трябва да е на мястото си (вероятно, но не гарантирано: виж Стрийминг). - За геймпад спри теста, натисни Play, отвори Controller Emulator (раздела Emulation, после Controller) и влез в BridgeTrigger с емулирания геймпад: Skip трябва да е избран, така че A пропуска катсцената. Ако използваш Device Simulator в Studio (към нашата проверка на 15 октомври 2026 г. е бета: включи го в File, Beta Features, New Device Simulator и рестартирай Studio), избери телефон, завърти го хоризонтално и провери, че Skip не влиза под изреза за камерата и се уцелва лесно, а стикът и бутонът за скок са скрити, докато върви катсцената.
- Ако си направил и главно меню, натисни Play, после бутона Play в менюто и остави интрото да стигне до края: след него списъкът с играчи трябва отново да е на екрана.
Дръж прозореца Output отворен (менюто Window, после Output) през цялото време. Когато всичко работи, тези скриптове не пишат нищо, така че всяко предупреждение или червена грешка от CutsceneService или CutscenePlayer е истински проблем. Виж Чести грешки.
Как да разшириш системата
Интро само при първото влизане на играча
Таблицата seen живее един сървър, затова играч, който е влязъл отново, пак вижда интрото. За да го показваш само при първото влизане, запазвай флаг, например SeenIntro, заедно с останалите данни на играча чрез модула PlayerData от урока за DataStore. Остави INTRO_CUTSCENE както е и промени частта от onCharacterAdded в CutsceneService, която отговаря за интрото: изчакай PlayerData.Get(player) да върне данните на играча, пропусни интрото, ако data.SeenIntro е true, и задавай data.SeenIntro = true само когато playOnce(player, INTRO_CUTSCENE) е върнал true. Не пускай интрото от кода, който зарежда данните: данните може да се заредят преди персонажът да се появи, а без персонаж play не прави нищо и флагът ще се запази за интро, което никой не е видял.
Персонажи, които играят в катсцената
Направи анимация в Animation Editor в Studio или в плъгин за анимация от трета страна, например Moon Animator, който се споменава в документацията на Roblox, и я пусни на рига на NPC в кадъра, когато камерата стигне там. В справката на Roblox за Animator пише, че анимациите на NPC се репликират, само ако ги зарежда и пуска сървърът, затова я пускай от сървърен Script, ако всички играчи трябва да виждат как играе NPC. Ако я заредиш и пуснеш в CutscenePlayer, анимацията не се репликира и това става за катсцена, която гледа само един играч. В ръководството за скриптове за анимация е показано как да пуснеш анимация на NPC от сървърен Script.
Диалози
Надписите стават за кратки реплики, които вървят сами. За разговор, в който играчът отговаря и избира варианти, виж ръководството за диалози с NPC.
Интро след главното меню
Ръководството за главно меню изключва CharacterAutoLoads, затова никой не се появява, докато не натисне Play. CutsceneService пуска интрото при първата поява на играча, затова с двете системи интрото се пуска при първата поява след Play. Менюто включва обратно core GUI, когато се появи персонажът, а това може да стане, когато интрото вече върви, затова по време на интрото може да се вижда списъкът с играчи. CutscenePlayer включва обратно само това, което сам е скрил, затова не пипа промяната на менюто и след интрото те остават включени. Трикът с Command Bar от ръководството за главно меню за насочване на парта за камерата е същият като в стъпка 1.
Облитане на картата в началото на рунда
За да пуснеш катсцена от друг сървърен скрипт, например облитане на картата в началото на рунда от ръководството за система от рундове, добави в ServerStorage BindableEvent с име PlayCutscene. В края на CutsceneService свържи неговия Event с функцията play, а скриптът за рундове нека го вика с всеки играч и името на катсцената. play пропуска проверката "веднъж на сървър", затова облитането се пуска всеки рунд.
Плъгини за катсцени
Плъгините могат да се използват заедно с това ръководство. Ако плъгин за катсцени пише свой скрипт за камерата, провери, че връща камерата (CameraType Custom и CameraSubject) и задава Focus, докато камерата е Scriptable, а решението кой вижда катсцената остави на сървъра, както в това ръководство.
Чести грешки и решения
Отвори прозореца Output (менюто Window, после Output), преди да натиснеш Play. Повечето проблеми с катсцени или пишат предупреждение там, или идват от име, което не съвпада.
Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'
CutsceneService чака папка с име Cutscenes директно в Workspace. Създай я като в стъпка 1 и провери изписването и главното C. Докато я няма, CutsceneService не създава CutsceneEvent, затова и CutscenePlayer чака.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'
CutscenePlayer чака ремоута, който създава CutsceneService. Провери, че CutsceneService е Script, а не LocalScript, че е директно в ServerScriptService, не е изключен и че в Output няма грешка или предупреждение за Cutscenes от него.
CutsceneService: no folder named Intro in Workspace.Cutscenes
Името в INTRO_CUTSCENE или в атрибута Cutscene на тригера не съвпада с нито една папка в Workspace.Cutscenes. Главните и малките букви в имената са важни.
Нищо не се пуска, а в Output е празно
В папката няма парт с име 1 или партовете ѝ не са директно в нея (например са в Model). CutsceneService чете партовете 1, 2, 3 по ред и спира при първия пропуснат номер. И помни, че всяка катсцена се пуска веднъж на играч за сървър: спри теста и натисни пак Play.
Камерата гледа на грешното място
Камерата гледа натам, накъдето гледа предната страна на парта кадър. Насочи камерата на Studio към нужния изглед и изпълни пак реда за Command Bar от стъпка 1 за този кадър.
Тригерът не прави нищо
Провери, че партът тригер е директно в Workspace.CutsceneTriggers, когато играта тръгва, че CanTouch е отметнато (иначе в Output ще има предупреждение) и че атрибутът му Cutscene е низ с името на папка в Workspace.Cutscenes. Повторното минаване през тригера не прави нищо, така е замислено.
След катсцената камерата остава на последния кадър
CutscenePlayer е спрял с грешка, преди да успее да върне камерата, така че търси червена грешка от него в Output. Камерата може да я задържа и друг скрипт, който постоянно задава CameraType на Scriptable, например камера за менюто, която още е свързана.
Направи го с RoCode
Ако не ти се сглобява това на ръка, RoCode може да го направи в плейса, който имаш отворен. RoCode е независим ИИ агент за Roblox Studio, не от Roblox: описваш функцията в неговия уеб чат, а плъгинът му за Studio създава парта и скриптовете в твоя Explorer, така че не трябва да копираш код от прозореца на чата.
Добави встъпителна катсцена: папка Cutscenes с папка Intro и кадри от 1 до 3, надписи от атрибута Caption, черни ленти и бутон Skip, пуска се веднъж при първата поява на играча, сървърът държи играча на място, а накрая камерата се връща.
- Може първо да провери плейса ти чрез Search Scripts, например за скрипт за меню или камера, който вече задава
CameraType, за да не влизат в конфликт - Създава папките и парта тригер чрез Create Instance и задава на партовете атрибути като Caption и MoveSeconds
- Пише CutsceneService и CutscenePlayer чрез Create Script
- Казано му е да проверява всеки написан скрипт чрез Check Script, който го компилира в Studio, без да го пуска, и поставя точка за отмяна преди и след всеки пакет промени
Постави партовете кадри сам, като насочваш камерата на Studio към всеки изглед, а после поискай скриптовете. С плъгин 3.9 или по-нов RoCode може да пусне кратък плейтест и да прочете грешките, а с плъгин 3.9.11 или по-нов може да управлява тестов персонаж, за да провери, че играта работи, но по време на игра не прави скрийншоти, затова катсцената я гледаш сам. Редът, в който да изградиш цяла игра, е на страницата как да направиш игра в Roblox с ИИ, система по система. Как RoCode се свързва със Studio.
Често задавани въпроси
Как да направя катсцената да се пуска при влизане в играта?
Кръсти папката с кадрите Intro в Workspace.Cutscenes или смени INTRO_CUTSCENE на името на своята папка. CutsceneService я пуска при първата поява на всеки играч на сървъра. За да я показваш само при най-първото влизане, запазвай флаг в data store и го задавай само след като интрото е започнало, както е описано в раздела Как да разшириш системата.
Може ли да се направи катсцена без плъгини?
Да. В това ръководство има само партове, атрибути и два скрипта, а редът за Command Bar поставя всеки кадър точно там, където стои камерата на Studio. Плъгини като Moon Animator пак са удобни, за да анимираш персонажите, които играят в катсцената.
Защо камерата не се движи в катсцената?
Обикновено кодът за камерата е в сървърен Script, а камерата на играча може да се движи само от LocalScript, защото всяко устройство има своя камера. Друга честа причина: CameraType не е Scriptable и стандартните скриптове за камера на Roblox постоянно връщат камерата към персонажа.
Как да забраня на играча да се движи по време на катсцена?
Закотви неговия HumanoidRootPart на сървъра, докато тя върви, и махни Anchored след това, както прави CutsceneService. Закотвен парт никога не се движи от физиката. WalkSpeed при това не се пипа, затова няма конфликт със скрипт за бягане или геймпас за скорост.
Как да добавя бутон Skip в катсцената?
Сложи TextButton на екрана на катсцената и свържи неговото събитие Activated, което се задейства при кликване, докосване или бутона A на геймпада, когато бутонът е избран. Skip в CutscenePlayer вдига флаг, който цикълът на кадрите проверява на всеки кадър, сам се избира за играчите с геймпад и е в свой ScreenGui с отстъпите по подразбиране, за да не го закрие изрезът за камерата на телефона. Стикът и бутонът за скок са скрити, докато върви катсцената, затова не стоят до него.
Защо в катсцената светът е празен?
При включен instance streaming на устройството на играча има само областта близо до неговия персонаж. Нека сървърът вика player:RequestStreamAroundAsync за всеки кадър малко преди камерата да стигне там, както прави CutsceneService. Roblox пише, че така областта вероятно, но не със сигурност, ще бъде заредена, затова дръж важните кадри в радиуса на стрийминга или използвай Player:AddReplicationFocus за област, която трябва да остане заредена.
Източници и какво да прочетеш
- Roblox Creator Docs: Customize the camera (на английски). собствена Camera на всеки клиент, Scriptable, CFrame и Focus
- Roblox Engine API: Camera (на английски). CameraType, CameraSubject, Focus на всеки кадър и остарелият Interpolate
- Roblox Creator Docs: Control the user's camera (на английски). BindToRenderStep една стъпка по приоритет след камерата
- Roblox Engine API: TweenService:GetValue (на английски). изгладена alpha, ограничена между 0 и 1
- Roblox Engine API: ScreenGui.ScreenInsets (на английски). защо None само за съдържание, което няма какво да се натиска
- Roblox Creator Docs: Instance streaming (на английски). включен по подразбиране в новите плейсове, и replication focus
- Roblox Creator Docs: Streaming techniques (на английски). предварително зареждане на областта преди изпращане на събитието
- Roblox Engine API: Player:RequestStreamAroundAsync (на английски). временна заявка без гаранция
- Roblox Creator Docs: Remote events and callbacks (на английски). опашката от съобщения и кои таблици може да се пращат
- Roblox Creator Docs: Network ownership, movement validation, and physics (на английски). какво може клиентът да прави със своя персонаж, включително подправяне на събития Touched
- Roblox Engine API: Animator:LoadAnimation (на английски). кои анимации се репликират
Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.