Tutorial · Mga game system

Paano gumawa ng cutscene sa Roblox Studio

Ang cutscene sa Roblox ay camera na kumukuha ng kontrol nang ilang segundo: lumilipat o lumilipad nang smooth sa pagitan ng mga shot, nagpapakita ng caption at ibinabalik ang kontrol sa player. Sa guide na ito, bubuo tayo ng cutscene na sine-set up mo sa paglalagay ng mga invisible na part kung saan dapat pumuwesto ang camera, nang walang plugin. Ang server ang nagdedesisyon kung kailan ito makikita ng player (sa unang spawn o kapag humawak sa trigger), at ang device ng player ang gumagalaw sa camera, nagpapakita ng itim na bars at Skip button, at nagbabalik ng camera.

In-update Nobyembre 20, 202625 minutong basaIsinulat ni

Sa madaling salita

Maglagay ng mga invisible at anchored na part na pinangalanang 1, 2, 3 sa isang folder sa loob ng Workspace.Cutscenes, bawat isa nakaharap kung saan dapat tumingin ang camera. Binabasa ng Script sa ServerScriptService ang CFrame nila, pinapanatili sa lugar ang player at ipinapadala ang shots sa player na iyon gamit ang RemoteEvent. Sine-set ng LocalScript sa StarterPlayerScripts ang workspace.CurrentCamera.CameraType sa Scriptable, ginagalaw ang camera bawat frame mula shot hanggang shot (pinapakinis gamit ang TweenService:GetValue), at pagkatapos ay ibinabalik ang CameraType sa Custom at ang CameraSubject sa Humanoid ng player.

  • Device lang ng player ang puwedeng kumontrol sa camera, kaya LocalScript ang camera code. Ang server ay nagdedesisyon lang kung sino ang makakakita ng aling cutscene at kailan.
  • Kapag Scriptable ang camera, humihinto ang Roblox sa pag-update ng Camera.Focus. Sabi sa reference, i-update ang Focus bawat frame, kung hindi ay baka hindi ma-render ang dynamic lighting na malayo sa lumang focus.
  • Deprecated na ang Camera:Interpolate. Sabi sa reference ng Roblox, i-animate ang camera gamit ang TweenService.
Sa page na ito
  1. Paano gumagana
  2. 1. Shots
  3. 2. Server script
  4. 3. LocalScript
  5. 4. Trigger
  6. Detalye ng camera
  7. Mga lumang tutorial
  8. Proteksyon sa cheats
  9. 5. Test
  10. Pagpapalawak
  11. Common errors
  12. Gamit ang RoCode
  13. Mga madalas itanong
  14. Mga source at dagdag na babasahin

Paano gumagana ang cutscene

IlustrasyonIntro na may dalawang shot sa totoong bilis: cut sa unang shot, 1 segundong hold, 2.5 segundong paglipad papunta sa tulay, 1 segundong hold, saka bumabalik ang camera sa player.

May sariling Camera object ang bawat device ng player, sa workspace.CurrentCamera, kaya LocalScript lang ang puwedeng gumalaw sa nakikita ng player. Trabaho ng server ang pagpapasya kung sino ang makakakita ng aling cutscene at kailan. Ganyan mismo hinahati ng guide ang trabaho. Ganito tumatakbo ang isang cutscene:

  1. Nagdedesisyon ang server na dapat makita ng player ang cutscene: Intro sa unang spawn sa server, o iba kapag humawak siya sa trigger part.
  2. Binabasa ng CutsceneService ang CFrame at settings ng mga shot part, hinihiling sa Roblox na i-load para sa player na ito ang area ng unang shot, ina-anchor ang HumanoidRootPart ng player para manatili siya sa lugar, at ipinapadala ang CutsceneEvent sa player na ito lang kasama ang id at listahan ng shots.
  3. Ipinapakita ng CutscenePlayer sa device ng player ang itim na bars at Skip button, itinatago ang player list, backpack, health bar at touch controls, ginagawang Scriptable ang camera at ginagalaw ito bawat frame.
  4. Kapag natapos ang huling shot o pinindot ng player ang Skip, ibinabalik nito ang camera sa character at ipinapadala sa server ang CutsceneEvent na may parehong id.
  5. Ina-unanchor ng server ang player. Kung hindi dumating ang mensaheng iyon, ina-unanchor pa rin niya ito kapag lumipas na ang haba ng cutscene plus 2 segundo. Nagsisimula ang timer kapag ipinadala ng server ang cutscene, at sa mabagal na pag-join, puwedeng magsimula ang device ng intro nang ilang segundong mas huli, dahil hindi tumatakbo ang LocalScript sa labas ng ReplicatedFirst hangga't hindi pa nalo-load ang game. Kung ganoon, puwedeng makagalaw ulit ang player bago matapos ang intro sa screen niya.
Mga bahagi ng cutscene system
BahagiNasaanAno ang ginagawa
Script CutsceneServiceServerScriptServiceNagdedesisyon kung sino ang makakakita ng aling cutscene at kailan, binabasa ang shots, pinapanatili sa lugar ang player at tinatandaan kung sino na ang nakakita ng ano.
LocalScript CutscenePlayerStarterPlayer, StarterPlayerScriptsPine-play ang cutscene sa screen ng player: bars, captions, Skip at galaw ng camera. Sa dulo, ibinabalik ang camera.
RemoteEvent CutsceneEventReplicatedStorage (ginagawa ito ng CutsceneService)Dala ang shots mula sa server papunta sa isang player, at pabalik ang mensaheng "tapos na ang cutscene".
Folder CutscenesWorkspaceIsang folder kada cutscene, halimbawa Intro, na may mga shot part na 1, 2, 3.
Folder CutsceneTriggersWorkspace (opsyonal)Mga part na nagsisimula ng cutscene kapag hinawakan ng player.
Ang Explorer kapag handa na ang cutscene system. Lumalabas ang Bridge at CutsceneTriggers folders sa step 4. Kapag nagsimula ang game, nagdadagdag ang CutsceneService ng RemoteEvent na pinangalanang CutsceneEvent sa ReplicatedStorage.
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

Step 1: Ilagay ang camera shots

Bawat shot ay isang invisible na part. Kinukuha ng camera ang posisyon ng part at tumitingin sa direksyon ng front face nito, kaya ang paglalagay ng shot ay paglalagay ng camera.

  1. Sa Explorer, i-hover ang Workspace, i-click ang + button at mag-insert ng Folder na pinangalanang Cutscenes. Sa loob nito, mag-insert ng Folder na pinangalanang Intro. Mahalaga ang malaki at maliit na titik sa mga pangalan.
  2. Ilipat ang Studio camera sa unang view na gusto mo, na parang nag-aayos ka ng shot para sa litrato.
  3. Mag-insert ng Part sa Intro at i-rename ito sa 1.
  4. Buksan ang Command Bar (sa Script tab o sa Window, saka Script) at patakbuhin ang workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. Sa edit mode, ang CurrentCamera ay ang view na tinitingnan mo, kaya pumupuwesto ang part sa mismong shot na ito. Kailangan ang brackets at quotes dahil hindi puwedeng isulat pagkatapos ng tuldok ang pangalang nagsisimula sa numero.
  5. Sa Properties ng part, i-check ang Anchored, i-uncheck ang CanCollide, CanTouch at CanQuery, at i-set ang Transparency sa 1. Pinipigilan ng Anchored na mahulog ito sa map; pinipigilan naman ng iba na humarang ito sa players, mag-trigger ng touch events at humarang sa raycasts.
  6. Ulitin para sa susunod na mga view, pangalanan ang mga part na 2, 3 at iba pa at palitan ang numero sa linya para sa Command Bar. Pine-play ng CutsceneService ang shots ayon sa pagkakasunod ng numero at humihinto sa unang nawawalang numero, kaya pinuputol nang maaga ng butas sa numbering ang cutscene.

Para palitan ang shot mamaya, ilipat ang camera sa bagong view at patakbuhin ang parehong linya na may numero ng shot na iyon. Sa Transparency 1, invisible rin ang mga part sa Studio, kaya piliin sila sa Explorer kapag kailangan mo sila.

Ang bawat shot ay puwedeng may tatlo pang opsyonal na attribute. Para magdagdag ng attribute, piliin ang part, i-scroll ang Properties window hanggang sa Attributes section, i-click ang +, i-type ang pangalan, piliin ang type at i-click ang Save.

Mga opsyonal na attribute sa bawat shot part
AttributeTypeDefaultAno ang ginagawa
MoveSecondsnumber3Ilang segundong lumilipad ang camera mula sa nakaraang shot papunta sa isang ito. Ang 0 ay gumagawa ng biglang cut. Laging cut ang shot 1, kaya walang epekto dito ang attribute.
HoldSecondsnumber1Ilang segundong nananatili ang camera sa shot na ito pagdating.
CaptionstringwalaText sa ibabang bar mula sa sandaling magsimulang lumipad ang camera papunta sa shot na ito. Binubura ng shot na walang Caption ang text.

Ang numerong mas mababa sa 0 o mas mataas sa 60, pati ang attribute na maling type, ay pinapalitan ng default.

Step 2: Idagdag ang server script

I-hover ang ServerScriptService, mag-insert ng Script na pinangalanang CutsceneService at i-paste dito ang code sa ibaba. Ang settings sa itaas ay ang mga linyang puwede mong palitan.

Script sa ServerScriptService na pinangalanang CutsceneService
-- Script sa ServerScriptService na pinangalanang CutsceneService.
-- Nagdedesisyon kung sino ang makakakita ng aling cutscene at kailan. Binabasa ang camera shots mula sa mga numbered
-- part sa Workspace.Cutscenes, pinapanatili sa lugar ang player at sinasabihan ang device
-- ng player na iyon na i-play ang shots. Sa device lang puwedeng galawin ang camera mismo.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Settings
local INTRO_CUTSCENE = "Intro" -- isang beses nagpe-play sa unang spawn ng player; "" para i-off
local DEFAULT_MOVE_SECONDS = 3 -- oras ng paglipad papunta sa shot kung wala itong MoveSeconds
local DEFAULT_HOLD_SECONDS = 1 -- oras sa shot kung wala itong HoldSeconds
local MAX_SHOTS = 30

local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")

-- Ang script na ito mismo ang gumagawa ng CutsceneEvent, kaya huwag itong idagdag nang mano-mano
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 ng cutscene na pinapanood ng player
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

-- Ang shots ay mga part na 1, 2, 3 ... sa folder na may pangalan ng cutscene
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,
			-- cut ang unang shot, kaya diretsong tumatalon dito ang camera
			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 -- tapos na ang cutscene na ito
	end
	playing[player] = nil
	setFrozen(player, false)
end

local function play(player: Player, name: string): boolean
	if playing[player] then
		return false -- isang cutscene bawat pagkakataon
	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

	-- Kapag naka-on ang instance streaming, puwedeng wala sa device ng player ang area
	-- na tinitingnan ng shot, at pansamantala lang naglo-load ng area ang request. Nilo-load natin
	-- ang area ng unang shot ngayon (hanggang 2 segundong paghihintay), at ang area ng bawat susunod
	-- 2 segundo bago lumipad ang camera papunta doon.
	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 -- umalis ang player habang naglo-load ang area
	end

	setFrozen(player, true)
	cutsceneEvent:FireClient(player, id, shots)
	local startsAt = 0 -- mga segundo mula ngayon hanggang sa simula ng paglipad papunta sa shot na ito
	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
	-- Safety net: ina-unfreeze ang player kahit hindi kailanman sumagot ang device niya
	task.delay(startsAt + 2, finish, player, id)
	return true
end

-- Nagbabalik ng true lang kung nagsimula ang cutscene para sa player na ito
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

-- Iniuulat ng device ng player na tapos na o na-skip ang cutscene
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
	if typeof(id) == "number" then
		finish(player, id)
	end
end)

-- Trigger parts: sinisimulan ng paghawak ang cutscene mula sa Cutscene attribute nila
if triggers then
	for _, trigger in triggers:GetChildren() do
		if not trigger:IsA("BasePart") then
			continue
		end
		if not trigger.CanTouch then
			-- Nagbibigay ng error ang pag-connect ng Touched sa part na naka-off ang CanTouch, kaya nagbababala lang tayo
			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) -- nag-respawn habang may cutscene, pinapanatili rin sa lugar ang bagong character
	elseif INTRO_CUTSCENE ~= "" then
		playOnce(player, INTRO_CUTSCENE)
	end
end

local function onPlayerAdded(player: Player)
	if seen[player] then
		return -- naka-set up na
	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 -- lahat ng pumasok habang hinihintay ng script ang Cutscenes
	onPlayerAdded(player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	seen[player] = nil
	playing[player] = nil
end)

Ang CutsceneService mismo ang gumagawa ng RemoteEvent na CutsceneEvent sa sandaling lumabas ang Workspace.Cutscenes, kaya hindi mo kailangang mag-insert ng kahit ano nang mano-mano sa ReplicatedStorage. Kung nakagawa ka na ng RemoteEvent na may ganitong pangalan, burahin ito: baka ang sa iyo ang mahanap ng LocalScript, at walang nakikinig dito sa server.

Settings sa itaas ng CutsceneService
SettingValue ditoAno ang binabago
INTRO_CUTSCENE"Intro"Ang folder sa Workspace.Cutscenes na nagpe-play sa unang spawn ng player sa server. I-set sa "" para walang intro.
DEFAULT_MOVE_SECONDS3Gaano katagal ang paglipad kung walang MoveSeconds attribute ang shot.
DEFAULT_HOLD_SECONDS1Gaano katagal nananatili ang camera sa shot kung wala itong HoldSeconds attribute.
MAX_SHOTS30Ang pinakamalaking shot number na hinahanap ng CutsceneService sa isang cutscene.

Ano ang ginagawa ng natitirang bahagi ng script, ayon sa pagkakasunod:

  • Binabasa ang shots sa server. Kinokolekta ng readShots ang CFrame at attributes ng bawat numbered part sa isang listahan. Ang listahang ito ang natatanggap ng device ng player, kaya hindi nito kailangan ang mga part mismo.
  • Isang cutscene bawat pagkakataon. Walang ginagawa ang play habang nanonood na ng cutscene ang player, o kung walang Humanoid ang character niya o patay na ito.
  • May sariling id ang bawat cutscene. Ibinabalik ng device ang id kapag natapos o na-skip ang cutscene, at ina-unfreeze lang ang player kapag tugma ang id, kaya hindi kayang tapusin ng nahuling mensahe mula sa nakaraang cutscene ang bago.
  • Pinapanatili sa lugar ang player sa pag-anchor ng HumanoidRootPart niya, at ina-anchor ang bagong character kung mag-respawn ang player sa gitna ng cutscene. Sabi sa reference ng Roblox, hindi kailanman nagbabago ng posisyon ang anchored na part dahil sa gravity, collisions o ibang physics. Hindi ginagalaw ang WalkSpeed, kaya hindi ito sumasalungat sa sprint script o speed pass. Sa dulo, ina-unanchor ng script ang root part kahit ibang script ang nag-anchor dito, kaya huwag mag-anchor ng mga character sa ibang lugar habang puwedeng may tumatakbong cutscene.
  • Safety net. Ina-unfreeze ng task.delay ang player pagkalipas ng buong haba ng cutscene plus 2 segundo, kahit hindi kailanman sumagot ang device niya.
  • Bawat cutscene nang isang beses kada server. Tinatandaan ng seen table para sa bawat player kung aling mga cutscene ang nagsimula na, kaya hindi umuulit ang intro sa respawn, at isang beses lang nagpe-play ang cutscene mula sa trigger. Nagbabalik ng true ang playOnce lang kung talagang nagsimula ang cutscene.
  • Sine-set up ang bawat player. Ang loop sa Players:GetPlayers() sa dulo ay sumasalo sa lahat ng pumasok habang hinihintay ng script ang Cutscenes folder.

Napupunta ang shots sa player sa iisang FireClient call, bilang listahan ng maliliit na table. Sabi sa page ng Roblox tungkol sa remote events, huwag magpadala ng table na may halong number at string keys; number keys lang ang nasa listahang ito, at string keys lang ang nasa bawat shot sa loob, at iyon ang hugis na pinapayo doon.

Step 3: Idagdag ang LocalScript na nagpe-play nito

  1. Sa Explorer, i-expand ang StarterPlayer, i-hover ang StarterPlayerScripts at mag-insert ng LocalScript na pinangalanang CutscenePlayer.
  2. Palitan ang laman nito ng code sa ibaba.
LocalScript sa StarterPlayerScripts na pinangalanang CutscenePlayer
-- LocalScript sa StarterPlayer > StarterPlayerScripts na pinangalanang CutscenePlayer.
-- Pine-play ang cutscene na ipinapadala ng server: itim na bars, captions, Skip button at
-- camera na lumilipad mula shot hanggang shot. Pagkatapos, ibinabalik ang camera sa player.

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 -- bawat itim na bar, bilang bahagi ng taas ng screen
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- ilang studs sa harap ng camera ang dapat i-render ng Roblox nang pinakadetalyado
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 }

-- Cutscene screen: dalawang itim na bar at caption, mula gilid hanggang gilid. Payo ng Roblox na gamitin
-- ang ScreenInsets None para lang sa mga hindi pinipindot, kaya may sariling ScreenGui ang Skip sa ibaba.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- buong screen
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

-- Default insets ang Skip button, kaya hindi ito natatakpan ng camera cutout
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) -- sa ibabang bar, sa kanan
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

-- Nananatiling sapat ang laki ng Skip para matamaan ito sa maliit na phone
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

-- Kasalukuyang paglipad: mula sa isang camera CFrame papunta sa susunod sa ibinigay na bilang ng segundo
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false

-- Tumatakbo bawat frame habang may cutscene. Hindi kusang sumusunod sa kahit ano ang Focus ng Scriptable camera,
-- kaya dito rin ito sine-set.
local function updateCamera()
	if camera.CameraType ~= Enum.CameraType.Scriptable then
		camera.CameraType = Enum.CameraType.Scriptable -- may nag-reset nito, halimbawa respawn
	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
		-- May nagpe-play na, kaya hayaang i-unfreeze agad ng server ang player para sa isang ito
		cutsceneEvent:FireServer(id)
		return
	end
	busy = true
	skipRequested = false

	-- Itinatago ang player list, backpack at health bar, habang tinatandaan kung ano ang nakikita
	local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
	for _, coreGui in HIDDEN_CORE_GUIS do
		wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
		StarterGui:SetCoreGuiEnabled(coreGui, false)
	end
	-- Sa mga phone, itinatago ang thumbstick at jump button na nasa ibabang mga kanto
	local touchControlsWere = GuiService.TouchControlsEnabled
	GuiService.TouchControlsEnabled = false
	gui.Enabled = true
	controls.Enabled = true
	-- Napi-pindot lang ng gamepad ang napiling button, kaya pinipili ang Skip para sa mga player na naka-gamepad
	if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
		GuiService.SelectedObject = skipButton
	end
	camera = workspace.CurrentCamera
	camera.CameraType = Enum.CameraType.Scriptable
	moveTo = camera.CFrame
	-- Isang hakbang pagkatapos ng sariling camera update ng Roblox, gaya sa camera tutorial ng Roblox
	RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)

	for _, shot in shots do
		moveFrom = camera.CFrame -- sinisimulan ang bawat paglipad mula sa kinaroroonan ngayon ng camera
		moveTo = shot.cframe
		moveStart = os.clock()
		moveSeconds = shot.move
		caption.Text = shot.caption
		waitOrSkip(shot.move + shot.hold)
		if skipRequested then
			break
		end
	end

	-- Ibinabalik ang camera sa character ng player
	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 = ""
	-- Ibinabalik lang ang mga in-off ng cutscene na ito, hindi ginagalaw ang iba
	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) -- ina-unfreeze agad ng server ang player
	busy = false
end

skipButton.Activated:Connect(function()
	skipRequested = true
end)

cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
	play(id, shots)
end)

Isang beses kinokopya sa player ang LocalScript sa StarterPlayerScripts, sa pag-join, at patuloy itong tumatakbo pagkatapos mag-respawn ang character. Kaya naka-off ang ResetOnSpawn sa parehong ScreenGui: kung i-on mo ito, buburahin sila ng Roblox sa unang respawn, at hindi sila gagawing muli ng script na ito. Ang mga mensahe ng remote na dumating bago mag-connect ang script sa OnClientEvent ay naka-queue at dinedeliver pagkatapos mag-connect, kaya makikita pa rin ang intro ng player na mabilis na nag-spawn.

Ano ang ginagawa ng bawat bahagi ng CutscenePlayer
BahagiAno ang ginagawa
ScreenGui CutsceneDalawang itim na bar, bawat isa 12% ng taas ng screen (BAR_HEIGHT), at caption sa ibabang bar. Hinahatak ng ScreenInsets None ang bars hanggang sa pinakagilid ng screen, at dino-drawing sila ng DisplayOrder 10 sa ibabaw ng mga ScreenGui na mas mababa ang DisplayOrder.
ScreenGui CutsceneControlsSkip button lang ang nasa loob nito, sa kanan ng ibabang bar, na may UISizeConstraint na pinapanatili itong hindi bababa sa 64 por 32 pixels, para madali itong matamaan sa phone. Default ang ScreenInsets nito, at hindi pumapasok ang laman sa ilalim ng mga button sa top bar ng Roblox at ng camera cutouts. Payo ng Roblox na None lang para sa laman na walang pipindutin, kaya hindi puwedeng tumira ang Skip sa ScreenGui ng bars.
HIDDEN_CORE_GUISItinatago ang player list, backpack at health bar gamit ang SetCoreGuiEnabled, matapos tandaan gamit ang GetCoreGuiEnabled kung alin ang naka-on, at sa dulo, ibinabalik lang ang mga in-off nito mismo. Kung itinatago ng game ang backpack sa ibang lugar, mananatili itong nakatago, at walang sumasapaw sa script na nag-o-on sa kanila habang may cutscene, halimbawa main menu.
TouchControlsEnabledSa mga phone at tablet, sine-set ng play ang GuiService.TouchControlsEnabled sa false habang may cutscene. Itinatago nito ang thumbstick at jump button na nasa ibabang mga kanto, kung saan din ang Skip, at bumabalik sila sa dulo kung naka-on sila dati.
updateCameraTumatakbo bawat frame habang may cutscene. Kinukuwenta kung gaano na kalayo ang kasalukuyang paglipad, pinapakinis ito gamit ang TweenService:GetValue, inilalagay ang camera sa pagitan ng dalawang shot gamit ang CFrame:Lerp at sine-set ang Focus 30 studs sa harap ng camera.
waitOrSkipHinihintay ang oras ng paglipad at hold ng shot, habang tsine-check ang Skip flag bawat frame.
playGinagawang Scriptable ang camera, pine-play ang shots ayon sa pagkakasunod, saka ibinabalik ang camera (CameraType Custom, ang CameraSubject ay ang Humanoid), ino-on ulit ang core GUI at touch controls at ipinapadala sa server ang id ng cutscene. Kung dumating ang pangalawang cutscene habang nagpe-play pa ang una, ibinabalik agad nito ang id niyon, para hindi panatilihin ng server sa lugar ang player para sa cutscene na hindi ipinakita ng device na ito.
Skip buttonNagfa-fire ang Activated sa mouse click, tap o A button sa gamepad kapag napili ang button. Para sa player na gamepad ang pangunahing input, pinipili ng play ang Skip sa simula ng cutscene at inaalis ang pagpili sa dulo.

Palitan ang BAR_HEIGHT para gawing mas manipis o mas makapal ang bars, at ang EASING_STYLE para baguhin ang pakiramdam ng mga paglipad (tingnan ang Ano ang tama sa camera code). Naka-on ang TextScaled sa caption at Skip button, kaya lumalaki at lumiliit ang text kasabay ng screen.

Step 4: Cutscene kapag humawak sa part

Kusang nagpe-play ang intro. Para sa cutscene sa partikular na lugar sa map, halimbawa kapag unang nakarating ang player sa tulay, magdagdag ng pangalawang cutscene at trigger part.

  1. Sa Workspace, Cutscenes, mag-insert ng Folder na pinangalanang Bridge at ilagay ang shots nito gaya sa step 1, na pinangalanang 1 at 2. Sa linya para sa Command Bar, isulat ang Bridge sa halip na Intro.
  2. I-hover ang Workspace at mag-insert ng Folder na pinangalanang CutsceneTriggers.
  3. Mag-insert dito ng Part na pinangalanang BridgeTrigger. Gawin itong sapat ang laki para hindi makadaan ang players nang hindi ito nahahawakan, halimbawa mataas at malapad na slab na nakaharang sa daan. I-check ang Anchored, i-uncheck ang CanCollide at CanQuery, iwanang naka-check ang CanTouch at i-set ang Transparency sa 1. Pinipigilan ng naka-off na CanQuery ang invisible na slab na humarang sa raycasts, halimbawa sa mga bala mula sa gun guide. Kinokontrol ng CanTouch ang touch events, hindi ng CanQuery, kaya gumagana pa rin ang trigger.
  4. Bigyan ito ng attribute na Cutscene na string type at i-set ang value sa Bridge: ang pangalan ng folder na ipe-play.

Kinokonekta ng CutsceneService ang Touched sa bawat part na direktang nasa loob ng CutsceneTriggers sa pagsisimula ng server, kaya magdagdag ng triggers sa Studio, hindi gamit ang script habang naglalaro. Nilalaktawan ang trigger na naka-off ang CanTouch nang may warning sa Output, dahil nagbibigay ng error ang Roblox kapag kinonekta ng script ang Touched sa ganoong part.

Habang naglalakad ang character sa loob ng part, maraming beses na sunod-sunod na nagfa-fire ang Touched. Ginagawa itong isang cutscene kada player kada server ng seen table at ng rule na "isang cutscene bawat pagkakataon". Hindi pinapansin ang player na humawak sa trigger habang may ibang cutscene, at nananatiling handa ang trigger para sa kanya.

Huwag maglagay ng triggers sa mga kalsada. Naka-weld sa upuan ang HumanoidRootPart ng nakaupong player, at kapag na-anchor ang isang part ng naka-weld na grupo, ina-anchor din ng Roblox ang iba kasama nito. Kaya ang player na nagmaneho papasok sa trigger ay pinapanatili sa lugar ang buong sasakyan niya, kasama ang mga pasahero, hanggang matapos ang cutscene.

Ano ang tama sa camera code

Scriptable, saka balik sa Custom

Hindi ginagalaw o ina-update ng camera scripts ng Roblox ang camera habang Scriptable ang CameraType, at iyon mismo ang nagpapahintulot sa CutscenePlayer na i-set ito. Sa dulo, ibinabalik nito ang CameraType sa Custom at ginagawang CameraSubject ang Humanoid ng player, na sinusundan ng camera scripts ng Roblox bilang default. Tumatakbo rin ito pagkatapos ng Skip, kaya hindi kailanman naiiwang nakatingin ang player sa huling shot.

Dalawang maliit na check ang nagpapanatili sa cutscene bilang boss habang nagpe-play ito. Kung may mag-set ng CameraType sa ibang value sa gitna ng cutscene, ibinabalik ito sa Scriptable ng function na tumatakbo bawat frame sa susunod na frame. At binabasa ulit ng script ang workspace.CurrentCamera sa simula ng bawat cutscene, dahil gumagawa ang Roblox ng bagong Camera kung mabura man ang kasalukuyan.

Focus, bawat frame

Sinasabi ng Camera.Focus sa engine kung aling area ang uunahin sa mga trabaho gaya ng lighting. Pinapanatili ito ng camera scripts ng Roblox sa CameraSubject, pero hindi kapag Scriptable ang camera, at sabi sa reference ng Roblox na sa ganitong kaso, i-update ito bawat frame: baka hindi ma-render ang dynamic light mula sa mga object gaya ng PointLight kapag malayo sa focus. Sine-set ito ng CutscenePlayer 30 studs sa harap ng camera (FOCUS_DISTANCE). Taasan ang numerong ito kung mas malayo ang tinitingnan ng shots mo.

Tumatakbo ang function sa pamamagitan ng RunService:BindToRenderStep, bawat frame bago mag-render, isang hakbang ng priority pagkatapos ng sariling camera update ng Roblox (Enum.RenderPriority.Camera.Value + 1). Ito ang priority na ginagamit ng camera tutorial ng Roblox, kaya sine-set ng cutscene ang camera pagkatapos tumakbo ng sariling camera code ng Roblox.

Pagpapakinis gamit ang TweenService:GetValue

Ang tween sa camera.CFrame ay gagalaw sa camera, pero kailangan pa ring i-set ang Focus bawat frame, kaya ang CutscenePlayer mismo ang gumagalaw sa camera sa parehong function. Para sa bawat paglipad, kinukuwenta nito kung gaanong bahagi ng oras ang lumipas na (mula 0 hanggang 1), dinadaan ito sa TweenService:GetValue na may easing style at direction, at inilalagay ang camera sa bahaging iyon ng daan sa pagitan ng dalawang shot gamit ang CFrame:Lerp, na gumagalaw sa posisyon nang tuwid at umiikot nang smooth. Nililimitahan ng GetValue ang input sa pagitan ng 0 at 1, kaya humihinto ang camera mismo sa shot kapag natapos ang oras ng paglipad.

Mga easing style na bagay sa paglipad ng camera
EASING_STYLEPakiramdam ng paglipad
Enum.EasingStyle.Sine (dito)Sumusunod sa sine curve ang bilis, malambot na simula at malambot na hinto.
Enum.EasingStyle.QuadGaya ng Sine, pero medyo mas matalim ang curve.
Enum.EasingStyle.LinearPare-parehong bilis, kaya nagsisimula at natatapos ang bawat paglipad nang full speed.

Ang direction na InOut: inilalapat ang easing pasulong sa unang kalahati ng paglipad at pabaligtad sa pangalawa, kaya bumibilis ang camera mula sa isang shot at bumabagal papunta sa susunod.

Streaming

Sa mga bagong place, naka-on ang instance streaming: bilang default, ang area sa paligid ng character lang ang hawak ng device ng player, kaya puwedeng magpakita ng walang lamang mundo ang shot na nakatingin sa kabilang dulo ng map. Hinihiling ng CutsceneService sa Roblox na i-load para sa player na ito ang area ng bawat shot gamit ang Player:RequestStreamAroundAsync: ang area ng unang shot bago ipadala ang event, na may hanggang 2 segundong paghihintay, at ang area ng bawat susunod 2 segundo bago lumipad ang camera papunta doon.

Sabi ng Roblox, sa ganitong paraan malamang, pero hindi sigurado, na malo-load ang area, at pansamantala ang epekto. Panatilihin ang mahahalagang shot sa loob ng streaming radius o gamitin sa server ang Player:AddReplicationFocus para sa area na dapat manatiling naka-load hanggang alisin mo ang focus. Kapag naka-off ang streaming, nasa device na ang buong map, at ang pcall sa paligid ng bawat request ay nangangahulugang hindi kayang ihinto ng pumalyang request ang cutscene.

Ano ang mali sa mga lumang cutscene tutorial

Kung ikinukumpara mo ang guide na ito sa video o forum post, narito ang mga pagkakaibang mahalaga, at kung bakit problema ang bawat technique.

Mga karaniwang technique sa cutscene tutorials at ang ginagawa ng guide na ito sa halip
TutorialProblemaAng guide na ito
Ginagalaw ang camera gamit ang camera:Interpolate()Minarkahan ng Roblox ang Interpolate bilang deprecated at pinapayong i-animate ang camera gamit ang TweenService.Pinapakinis ang bawat paglipad gamit ang TweenService:GetValue at sine-set ang camera bawat frame.
Nagtu-tween ng camera.CFrame at wala nang ibaNananatili ang Focus kung saan ito iniwan ng camera scripts, malapit sa character, kaya baka hindi ma-render ang dynamic light na malayo dito (reference ng Roblox sa Camera.Focus).Sine-set ang Focus bawat frame sa render step.
Hindi ibinabalik ang cameraNaiipit ang player na nakatingin sa huling shot.Sa dulo, sine-set ang CameraType sa Custom at ang CameraSubject sa Humanoid, pati pagkatapos ng Skip.
Sinisimulan ang cutscene mula sa Touched sa LocalScriptWalang pumipigil dito na maulit sa bawat paghawak, at napagpapasyahan ito sa device na kontrolado ng player.Pinipili ng server ang player at tinatandaan kung sino na ang nakakita nito.
Binabasa ang camera parts sa clientKapag naka-on ang streaming, baka wala pa sa device ang mga part na malayo sa character.Binabasa ng server ang mga part, ipinapadala ang CFrame nila at nire-request ang area ng bawat shot ilang sandali bago lumipad doon ang camera.

Ano ang kaya at hindi kayang baguhin ng player

Ipagpalagay na kontrolado ng cheater ang lahat sa sarili niyang device: kaya niyang baguhin o burahin ang CutscenePlayer at magpadala ng CutsceneEvent na may kahit anong value. Para sa cutscene, halos wala itong ibig sabihin, kung walang totoong bagay na nakadepende dito.

Ano ang puwedeng subukan ng cheater at ano ang mangyayari
Sinusubukan ng cheaterResulta
I-skip ang cutscene o hindi ito i-play kailanmanPuwede: sarili niyang screen iyon. Huwag kailanman magbigay ng reward para sa "pinanood ang cutscene".
Magpadala ng CutsceneEvent na may kahit anong valueMay epekto lang ang numerong tugma sa kasalukuyan niyang cutscene, at ang tanging ginagawa nito ay i-unfreeze siya nang mas maaga.
Hawakan ang trigger mula saanman sa mapPosible: kinokontrol ng bawat device ang sarili nitong character, at sa security docs ng Roblox, kasama ang pagpeke ng Touched events sa mga kaya nitong gawin. Makikita niya ang cutscene na ito nang isang beses, at wala nang ibang mangyayari.
Gumalaw pa rin habang may cutsceneWalang mapapanalunan. Pinipigilan ng freeze ang tapat na players na umalis sa gitna ng cutscene; hindi ito security check.
Gamit ang remote, simulan ang cutscene para sa ibang taoImposible. Server lang ang puwedeng magpadala ng CutsceneEvent sa player, at ang tanging maipapadala pabalik ng device ay "tapos na ang cutscene na ito".

Kung humahantong ang cutscene sa totoong bagay, halimbawa sa pintong bumubukas pagkatapos o sa paglabas ng boss, hayaang gawin ito ng server ayon sa sarili nitong timer, hindi kapag iniulat ng device na tapos na ang cutscene.

Step 5: I-test

  1. Ilagay ang tatlong Intro shot gamit ang linya para sa Command Bar. Bigyan ang shot 1 ng Caption na "Welcome to the village", ang shot 2 ng MoveSeconds na 2.5 at Caption na "Find the bridge", at iwanang walang attribute ang shot 3.
  2. Pindutin ang Play (F5). Lumalabas ang itim na bars, lumilipat ang camera sa shot 1 kasama ang caption nito, lumilipad nang 2.5 segundo papunta sa shot 2, saka nang 3 segundo papunta sa shot 3 na walang caption. Pagkatapos, bumabalik ang camera sa likod ng character, at lumalabas ulit ang player list. Habang nagpe-play ito, hindi ka makakalakad.
  3. Itigil ang test, pindutin ulit ang Play at pindutin ang Skip habang lumilipad ang camera papunta sa shot 2. Bumabalik agad ang camera, at makakalakad ka agad.
  4. Pumasok sa BridgeTrigger: nagpe-play ang Bridge cutscene. Dumaan ulit dito: walang nangyayari.
  5. Piliin ang Server & Clients sa dropdown ng test mode, i-set ang 2 client at pindutin ang Play. Kapag pumasok ang Client 1 sa trigger, sa Client 1 lang nagpe-play ang Bridge cutscene, at nakakalakad ang Client 2.
  6. Iwanang naka-on ang Workspace.StreamingEnabled at ilayo ang isang shot mula sa spawn. Pagdating ng camera, dapat nandoon ang paligid (malamang, pero hindi garantisado: tingnan ang Streaming).
  7. Para sa gamepad, itigil ang test, pindutin ang Play, buksan ang Controller Emulator (Emulation tab, saka Controller) at pumasok sa BridgeTrigger gamit ang emulated gamepad: dapat napili ang Skip, kaya na-i-skip ng A ang cutscene. Kung gumagamit ka ng Device Simulator sa Studio (noong tsine-check namin noong 15 Oktubre 2026, beta ito: i-on ito sa File, Beta Features, New Device Simulator at i-restart ang Studio), pumili ng phone, i-rotate ito nang pahiga at i-check na hindi pumapasok ang Skip sa ilalim ng camera cutout at madali itong matamaan, at na nakatago ang thumbstick at jump button habang may cutscene.
  8. Kung gumawa ka rin ng main menu, pindutin ang Play, saka ang Play button sa menu, at hayaang matapos ang intro: pagkatapos nito, dapat nasa screen ulit ang player list.

Panatilihing bukas ang Output window (Window menu, saka Output) sa buong oras. Kapag gumagana ang lahat, walang isinusulat ang mga script na ito, kaya totoong problema ang kahit anong warning o pulang error mula sa CutsceneService o CutscenePlayer. Tingnan ang Mga karaniwang error.

Paano palawakin ang system

Intro lang sa unang pag-join ng player

Isang server lang ang buhay ng seen table, kaya nakikita ulit ang intro ng player na nag-rejoin. Para ipakita ito sa unang pag-join lang, i-save ang flag, halimbawa SeenIntro, kasama ng ibang data ng player gamit ang PlayerData module mula sa DataStore tutorial. Iwanan ang INTRO_CUTSCENE gaya ng dati at palitan ang bahagi ng onCharacterAdded sa CutsceneService na humahawak sa intro: hintaying ibalik ng PlayerData.Get(player) ang data ng player, laktawan ang intro kung true ang data.SeenIntro, at i-set ang data.SeenIntro = true lang kapag nagbalik ng true ang playOnce(player, INTRO_CUTSCENE). Huwag simulan ang intro mula sa code na naglo-load ng data: puwedeng ma-load ang data bago mag-spawn ang character, at kung walang character, walang ginagawa ang play, at mase-save ang flag para sa intro na walang nakakita.

Mga character na umaarte sa cutscene

Gumawa ng animation sa Animation Editor sa Studio o sa third-party na animation plugin, halimbawa Moon Animator, na binabanggit sa docs ng Roblox, at i-play ito sa NPC rig sa shot kapag lumipad doon ang camera. Sabi sa reference ng Roblox tungkol sa Animator, nagre-replicate lang ang NPC animations kung ang server ang naglo-load at nagpe-play nito, kaya i-play ito mula sa server Script kung dapat makita ng lahat ng player ang pag-arte ng NPC. Kung i-load at i-play mo ito sa CutscenePlayer, hindi nagre-replicate ang animation, at bagay iyon sa cutscene na isang player lang ang nanonood. Sa guide sa animation scripts, ipinapakita kung paano mag-play ng animation sa NPC mula sa server Script.

Mga dialogue

Bagay ang captions sa maiikling linya na kusang tumatakbo. Para sa usapan kung saan sumasagot at pumipili ng options ang player, tingnan ang guide sa NPC dialogue.

Intro pagkatapos ng main menu

Ino-off ng main menu guide ang CharacterAutoLoads, kaya walang nag-i-spawn hangga't hindi pumipindot ng Play. Pine-play ng CutsceneService ang intro sa unang spawn ng player, kaya kapag pareho ang system, nagpe-play ang intro sa unang spawn pagkatapos ng Play. Ino-on ulit ng menu ang core GUI kapag lumabas ang character, at puwedeng mangyari iyon habang nagpe-play na ang intro, kaya puwedeng makita ang player list habang may intro. Ibinabalik lang ng CutscenePlayer ang itinago nito mismo, kaya hindi nito ginagalaw ang binago ng menu, at nananatili silang naka-on pagkatapos ng intro. Ang Command Bar trick mula sa main menu guide para i-aim ang camera part ay pareho sa step 1.

Fly-over ng map sa simula ng round

Para simulan ang cutscene mula sa ibang server script, halimbawa fly-over ng map sa simula ng round mula sa round system guide, magdagdag sa ServerStorage ng BindableEvent na pinangalanang PlayCutscene. Sa dulo ng CutsceneService, ikonekta ang Event nito sa play function, at hayaang tawagin ito ng round script kasama ang bawat player at pangalan ng cutscene. Nilalaktawan ng play ang check na "isang beses kada server", kaya nagpe-play ang fly-over bawat round.

Mga cutscene plugin

Puwedeng gamitin ang mga plugin kasabay ng guide na ito. Kung sariling camera script ang isinusulat ng cutscene plugin, i-check na ibinabalik nito ang camera (CameraType Custom at CameraSubject) at sine-set ang Focus habang Scriptable ang camera, at iwanan sa server ang desisyon kung sino ang makakakita ng cutscene, gaya sa guide na ito.

Mga karaniwang error at solusyon

Buksan ang Output window (Window menu, saka Output) bago pindutin ang Play. Karamihan sa problema sa cutscene ay nagsusulat ng warning doon, o dahil sa pangalang hindi tugma.

Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'

Hinihintay ng CutsceneService ang folder na pinangalanang Cutscenes na direktang nasa Workspace. Gawin ito gaya sa step 1 at i-check ang spelling at ang malaking C. Hangga't wala ito, hindi gumagawa ng CutsceneEvent ang CutsceneService, kaya naghihintay rin ang CutscenePlayer.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'

Hinihintay ng CutscenePlayer ang remote na ginagawa ng CutsceneService. I-check na Script ang CutsceneService, hindi LocalScript, na direkta itong nasa ServerScriptService, hindi naka-disable, at walang error o warning tungkol sa Cutscenes mula dito sa Output.

CutsceneService: no folder named Intro in Workspace.Cutscenes

Hindi tugma ang pangalan sa INTRO_CUTSCENE o sa Cutscene attribute ng trigger sa kahit anong folder sa loob ng Workspace.Cutscenes. Mahalaga ang malaki at maliit na titik sa mga pangalan.

Walang nagpe-play, at walang laman ang Output

Walang part na pinangalanang 1 sa folder, o hindi direktang nasa loob nito ang mga part (halimbawa, nasa loob ng Model). Binabasa ng CutsceneService ang mga part na 1, 2, 3 ayon sa pagkakasunod at humihinto sa unang nawawalang numero. At tandaan na isang beses lang nagpe-play ang bawat cutscene kada player kada server: itigil ang test at pindutin ulit ang Play.

Mali ang tinitingnan ng camera

Tumitingin ang camera sa direksyon ng front face ng shot part. Ilipat ang Studio camera sa tamang view at patakbuhin ulit ang linya para sa Command Bar mula sa step 1 para sa shot na iyon.

Walang ginagawa ang trigger

I-check na direktang nasa loob ng Workspace.CutsceneTriggers ang trigger part pagsimula ng game, na naka-check ang CanTouch (kung hindi, may warning sa Output) at na string ang Cutscene attribute nito na may pangalan ng folder sa Workspace.Cutscenes. Walang ginagawa ang muling pagdaan sa trigger, sinadya iyon.

Pagkatapos ng cutscene, naiiwan ang camera sa huling shot

Huminto sa error ang CutscenePlayer bago maibalik ang camera, kaya hanapin ang pulang error mula dito sa Output. Puwede ring hawak ng ibang script ang camera na paulit-ulit na nagse-set ng CameraType sa Scriptable, halimbawa menu camera na naka-bind pa rin.

Gawin gamit ang RoCode

Kung ayaw mong buuin ito nang mano-mano, kayang gawin ito ng RoCode sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi gawa ng Roblox: ilalarawan mo ang feature sa web chat nito, at ang Studio plugin nito ang gagawa ng part at mga script sa Explorer mo, kaya hindi mo kailangang kumopya ng code mula sa chat window.

Ang tina-type mo

Magdagdag ng intro cutscene: Cutscenes folder na may Intro folder at shots 1 hanggang 3, captions mula sa Caption attribute, itim na bars at Skip button, nagpe-play nang isang beses sa unang spawn ng player, pinapanatili ng server sa lugar ang player, at bumabalik ang camera sa dulo.

Ang ginagawa ng RoCode
  • Puwedeng i-check muna ang place mo gamit ang Search Scripts, halimbawa para sa menu o camera script na nagse-set na ng CameraType, para hindi sila magbanggaan
  • Ginagawa ang mga folder at trigger part gamit ang Create Instance at sine-set sa mga part ang attributes gaya ng Caption at MoveSeconds
  • Isinusulat ang CutsceneService at CutscenePlayer gamit ang Create Script
  • Sinabihan itong i-check ang bawat isinulat na script gamit ang Check Script, na kino-compile ito sa Studio nang hindi pinapatakbo, at naglalagay ito ng undo point bago at pagkatapos ng bawat batch ng pagbabago

Ikaw mismo ang maglagay ng shot parts, sa paglipat ng Studio camera sa bawat view, saka hingin ang mga script. Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang errors, at sa plugin 3.9.11 o mas bago, kaya nitong kontrolin ang test character para i-check na gumagana ang game, pero hindi ito kumukuha ng screenshots habang naglalaro, kaya ikaw ang manonood sa cutscene. Ang pagkakasunod sa pagbuo ng buong game ay nasa page na paano gumawa ng game sa Roblox gamit ang AI, system por system. Paano kumokonekta ang RoCode sa Studio.

Mga madalas itanong

Paano magpe-play ang cutscene pag-join sa game?

Pangalanan ang folder ng shots na Intro sa Workspace.Cutscenes, o palitan ang INTRO_CUTSCENE ng pangalan ng folder mo. Pine-play ito ng CutsceneService sa unang spawn ng bawat player sa server. Para ipakita ito sa pinakaunang pag-join lang, i-save ang flag sa data store at i-set lang ito pagkatapos magsimula ng intro, gaya ng nakasulat sa Paano palawakin ang system.

Puwede bang gumawa ng cutscene nang walang plugin?

Oo. Mga part, attributes at dalawang script lang ang nasa guide na ito, at inilalagay ng linya para sa Command Bar ang bawat shot mismo kung nasaan ang Studio camera. Kapaki-pakinabang pa rin ang mga plugin gaya ng Moon Animator para i-animate ang mga character na umaarte sa cutscene.

Bakit hindi gumagalaw ang camera sa cutscene?

Kadalasan, nasa server Script ang camera code, pero LocalScript lang ang puwedeng gumalaw sa camera ng player, dahil may sariling camera ang bawat device. Isa pang karaniwang dahilan: hindi Scriptable ang CameraType, at patuloy na ibinabalik ng default camera scripts ng Roblox ang camera sa character.

Paano pipigilan ang player na gumalaw habang may cutscene?

I-anchor ang HumanoidRootPart niya sa server habang nagpe-play ito, at i-unanchor pagkatapos, gaya ng ginagawa ng CutsceneService. Hindi kailanman gumagalaw dahil sa physics ang anchored na part. Hindi ginagalaw ang WalkSpeed, kaya hindi ito sumasalungat sa sprint script o speed pass.

Paano magdagdag ng Skip button sa cutscene?

Maglagay ng TextButton sa cutscene screen at ikonekta ang Activated event nito, na nagfa-fire sa click, tap o A button sa gamepad kapag napili ang button. Ang Skip sa CutscenePlayer ay nagse-set ng flag na tsine-check ng shot loop bawat frame, kusang napipili para sa mga player na naka-gamepad, at nasa sarili nitong ScreenGui na may default insets para hindi ito matakpan ng camera cutout ng phone. Nakatago ang thumbstick at jump button habang may cutscene, kaya hindi sila nakatabi dito.

Bakit walang laman ang mundo sa cutscene?

Kapag naka-on ang instance streaming, ang area lang malapit sa character ang nasa device ng player. Hayaang tawagin ng server ang player:RequestStreamAroundAsync para sa bawat shot ilang sandali bago lumipad doon ang camera, gaya ng ginagawa ng CutsceneService. Sabi ng Roblox, sa ganitong paraan malamang, pero hindi sigurado, na malo-load ang area, kaya panatilihin ang mahahalagang shot sa loob ng streaming radius o gamitin ang Player:AddReplicationFocus para sa area na dapat manatiling naka-load.

Mga source at dagdag na babasahin

Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.