Hướng dẫn · Hệ thống game

Cách làm cutscene trong Roblox Studio

Cutscene trong Roblox là camera tạm giành quyền điều khiển trong vài giây: chuyển cảnh hoặc lia mượt giữa các cảnh quay, hiện phụ đề rồi trả quyền điều khiển lại cho người chơi. Trong hướng dẫn này, chúng ta làm một cutscene mà bạn thiết lập bằng cách đặt các part vô hình ở chỗ camera cần đứng, không cần plugin. Server quyết định khi nào người chơi thấy nó (lần spawn đầu tiên hoặc khi chạm vào trigger), còn thiết bị của người chơi di chuyển camera, hiện dải đen và nút Skip, rồi trả camera về.

Cập nhật ngày 20 tháng 11, 202626 phút đọcTác giả:

Tóm tắt

Đặt các part vô hình đã anchor tên là 1, 2, 3 vào một thư mục bên trong Workspace.Cutscenes, mỗi part quay mặt về phía camera cần nhìn. Script trong ServerScriptService đọc CFrame của chúng, giữ người chơi đứng yên và gửi các cảnh quay cho người chơi đó qua RemoteEvent. LocalScript trong StarterPlayerScripts đặt workspace.CurrentCamera.CameraType thành Scriptable, mỗi khung hình di chuyển camera từ cảnh này sang cảnh khác (làm mượt bằng TweenService:GetValue), rồi trả CameraType về Custom và CameraSubject về Humanoid của người chơi.

  • Chỉ thiết bị của người chơi mới điều khiển được camera, nên code camera là LocalScript. Server chỉ quyết định ai thấy cutscene nào và khi nào.
  • Khi camera là Scriptable, Roblox ngừng cập nhật Camera.Focus. Tài liệu tham khảo nói phải cập nhật Focus mỗi khung hình, nếu không ánh sáng động ở xa focus cũ có thể không được vẽ.
  • Camera:Interpolate đã lỗi thời. Tài liệu Roblox nói hãy tạo chuyển động camera bằng TweenService.
Trong trang này
  1. Cách hoạt động
  2. 1. Cảnh quay
  3. 2. Script server
  4. 3. LocalScript
  5. 4. Trigger
  6. Chi tiết camera
  7. Hướng dẫn cũ
  8. Chống hack
  9. 5. Kiểm tra
  10. Mở rộng
  11. Common errors
  12. Với RoCode
  13. Câu hỏi thường gặp
  14. Nguồn và tài liệu đọc thêm

Cutscene hoạt động như thế nào

Minh họaĐoạn mở đầu hai cảnh quay ở tốc độ thật: chuyển sang cảnh 1, dừng 1 giây, lia tới cây cầu trong 2.5 giây, dừng 1 giây, rồi camera trở về với người chơi.

Mỗi thiết bị của người chơi có object Camera riêng, trong workspace.CurrentCamera, nên chỉ LocalScript mới di chuyển được những gì người chơi nhìn thấy. Quyết định ai thấy cutscene nào và khi nào là việc của server. Hướng dẫn chia việc đúng như vậy. Một cutscene diễn ra như sau:

  1. Server quyết định người chơi cần xem cutscene: Intro ở lần spawn đầu tiên trên server, hoặc một cutscene khác khi họ chạm vào part trigger.
  2. CutsceneService đọc CFrame và thiết lập của các part cảnh quay, yêu cầu Roblox tải trước vùng của cảnh 1 cho người chơi đó, anchor HumanoidRootPart của người chơi để họ đứng yên, và chỉ gửi CutsceneEvent cho người chơi đó kèm id và danh sách cảnh quay.
  3. CutscenePlayer trên thiết bị người chơi hiện dải đen và nút Skip, ẩn danh sách người chơi, ba lô, thanh máu và điều khiển cảm ứng, đặt camera thành Scriptable và di chuyển nó mỗi khung hình.
  4. Khi cảnh cuối kết thúc hoặc người chơi bấm Skip, nó trả camera về nhân vật và gửi cho server CutsceneEvent với cùng id đó.
  5. Server bỏ anchor cho người chơi. Nếu tin nhắn đó không bao giờ đến, server vẫn bỏ anchor khi hết độ dài cutscene cộng 2 giây. Bộ đếm bắt đầu khi server gửi cutscene, còn khi vào game chậm, thiết bị có thể bắt đầu đoạn mở đầu muộn vài giây, vì LocalScript nằm ngoài ReplicatedFirst không chạy cho đến khi game tải xong. Khi đó người chơi có thể di chuyển lại trước khi đoạn mở đầu kết thúc trên màn hình của họ.
Hệ thống cutscene gồm những gì
Thành phầnNằm ở đâuLàm gì
Script CutsceneServiceServerScriptServiceQuyết định ai thấy cutscene nào và khi nào, đọc các cảnh quay, giữ người chơi đứng yên và nhớ ai đã xem gì.
LocalScript CutscenePlayerStarterPlayer, StarterPlayerScriptsChạy cutscene trên màn hình người chơi: dải đen, phụ đề, Skip và chuyển động camera. Cuối cùng trả camera về.
RemoteEvent CutsceneEventReplicatedStorage (do CutsceneService tạo)Mang các cảnh quay từ server tới một người chơi, và mang về tin nhắn "cutscene đã kết thúc".
Folder CutscenesWorkspaceMỗi cutscene một thư mục, ví dụ Intro, với các part cảnh quay 1, 2, 3.
Folder CutsceneTriggersWorkspace (không bắt buộc)Các part khởi động cutscene khi người chơi chạm vào.
Explorer khi hệ thống cutscene đã xong. Thư mục Bridge và CutsceneTriggers xuất hiện ở bước 4. Khi game chạy, CutsceneService thêm vào ReplicatedStorage một RemoteEvent tên là CutsceneEvent.
Workspace
  Cutscenes Folder new
    Intro Folder new
      1 Part new
      2 Part new
      3 Part new
    Bridge Folder new
      1 Part new
      2 Part new
  CutsceneTriggers Folder new
    BridgeTrigger Part new
ServerScriptService
  CutsceneService Script new
StarterPlayer
  StarterPlayerScripts
    CutscenePlayer LocalScript new

Bước 1: Đặt các cảnh quay camera

Mỗi cảnh quay là một part vô hình. Camera lấy vị trí của part và nhìn theo hướng mặt trước của nó, nên đặt cảnh quay chính là đặt camera.

  1. Trong Explorer, di chuột lên Workspace, bấm nút + và chèn một Folder tên là Cutscenes. Bên trong nó, chèn một Folder tên là Intro. Tên phân biệt chữ hoa chữ thường.
  2. Đưa camera của Studio tới góc nhìn đầu tiên bạn muốn, như thể đang canh khung để chụp ảnh.
  3. Chèn một Part vào Intro và đổi tên thành 1.
  4. Mở Command Bar (ở tab Script hoặc qua Window, rồi Script) và chạy workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. Ở chế độ chỉnh sửa, CurrentCamera là góc nhìn bạn đang thấy, nên part được đặt đúng vào khung đó. Cần dấu ngoặc và dấu nháy vì tên bắt đầu bằng chữ số không viết được sau dấu chấm.
  5. Trong Properties của part, tích Anchored, bỏ tích CanCollide, CanTouch và CanQuery, và đặt Transparency là 1. Anchored giữ cho nó không rơi xuyên bản đồ; phần còn lại giữ cho nó không cản người chơi, không kích hoạt sự kiện chạm và không chặn raycast.
  6. Lặp lại cho các góc nhìn tiếp theo, đặt tên part là 2, 3 và cứ thế, đổi số trong dòng lệnh Command Bar. CutsceneService chạy các cảnh theo thứ tự số và dừng ở số đầu tiên bị thiếu, nên một lỗ hổng trong dãy số sẽ cắt ngắn cutscene.

Để đổi một cảnh quay sau này, đưa camera tới góc nhìn mới và chạy lại dòng lệnh đó với số của cảnh. Với Transparency 1, các part vô hình cả trong Studio, nên hãy chọn chúng trong Explorer khi cần.

Mỗi cảnh quay có thể có thêm ba attribute không bắt buộc. Để thêm attribute, chọn part, cuộn cửa sổ Properties xuống phần Attributes, bấm +, nhập tên, chọn kiểu và bấm Save.

Attribute không bắt buộc trên mỗi part cảnh quay
AttributeKiểuMặc địnhLàm gì
MoveSecondsnumber3Số giây camera lia từ cảnh trước tới cảnh này. 0 là chuyển cảnh tức thì. Cảnh 1 luôn là chuyển tức thì, nên attribute này không có tác dụng với nó.
HoldSecondsnumber1Số giây camera dừng ở cảnh này sau khi tới nơi.
Captionstringkhông cóChữ trên dải dưới kể từ lúc camera bắt đầu lia tới cảnh này. Cảnh không có Caption sẽ xóa chữ.

Số nhỏ hơn 0 hoặc lớn hơn 60, cũng như attribute sai kiểu, sẽ được thay bằng giá trị mặc định.

Bước 2: Thêm script phía server

Di chuột lên ServerScriptService, chèn một Script tên là CutsceneService và dán code bên dưới vào. Các thiết lập ở đầu là những dòng bạn có thể thay đổi.

Script trong ServerScriptService tên là CutsceneService
-- Script trong ServerScriptService tên là CutsceneService.
-- Quyết định ai thấy cutscene nào và khi nào. Đọc các cảnh quay camera từ những part
-- được đánh số trong Workspace.Cutscenes, giữ người chơi đứng yên và bảo thiết bị
-- của người chơi đó chạy các cảnh quay. Bản thân camera chỉ di chuyển được trên thiết bị.

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

-- Thiết lập
local INTRO_CUTSCENE = "Intro" -- chạy một lần ở lần spawn đầu tiên của người chơi; "" để tắt
local DEFAULT_MOVE_SECONDS = 3 -- thời gian lia tới cảnh nếu cảnh không có MoveSeconds
local DEFAULT_HOLD_SECONDS = 1 -- thời gian dừng ở cảnh nếu cảnh không có HoldSeconds
local MAX_SHOTS = 30

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

-- Script này tự tạo CutsceneEvent, nên đừng thêm nó bằng tay
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 của cutscene người chơi đang xem
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

-- Các cảnh quay là part 1, 2, 3 ... trong thư mục mang tên 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,
			-- cảnh đầu tiên là chuyển tức thì, nên camera nhảy thẳng vào đó
			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 -- cutscene này đã kết thúc rồi
	end
	playing[player] = nil
	setFrozen(player, false)
end

local function play(player: Player, name: string): boolean
	if playing[player] then
		return false -- mỗi lần một cutscene
	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

	-- Khi bật instance streaming, thiết bị người chơi có thể chưa có vùng mà cảnh quay
	-- nhìn vào, còn yêu cầu chỉ tải vùng đó tạm thời. Tải vùng của cảnh đầu tiên ngay
	-- bây giờ (chờ tối đa 2 giây), và vùng của mỗi cảnh tiếp theo 2 giây trước khi
	-- camera lia tới đó.
	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 -- người chơi đã thoát trong lúc tải vùng
	end

	setFrozen(player, true)
	cutsceneEvent:FireClient(player, id, shots)
	local startsAt = 0 -- số giây từ bây giờ đến lúc bắt đầu lia tới cảnh này
	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
	-- Dự phòng: bỏ đóng băng người chơi kể cả khi thiết bị của họ không bao giờ trả lời
	task.delay(startsAt + 2, finish, player, id)
	return true
end

-- Chỉ trả về true nếu cutscene đã bắt đầu cho người chơi này
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

-- Thiết bị người chơi báo cutscene đã kết thúc hoặc bị bỏ qua
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
	if typeof(id) == "number" then
		finish(player, id)
	end
end)

-- Part trigger: chạm vào sẽ chạy cutscene ghi trong attribute Cutscene của nó
if triggers then
	for _, trigger in triggers:GetChildren() do
		if not trigger:IsA("BasePart") then
			continue
		end
		if not trigger.CanTouch then
			-- Kết nối Touched với part đã tắt CanTouch sẽ báo lỗi, nên chỉ cảnh báo
			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) -- hồi sinh giữa cutscene, giữ cả nhân vật mới đứng yên
	elseif INTRO_CUTSCENE ~= "" then
		playOnce(player, INTRO_CUTSCENE)
	end
end

local function onPlayerAdded(player: Player)
	if seen[player] then
		return -- đã thiết lập rồi
	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 -- những người đã vào trong lúc script chờ Cutscenes
	onPlayerAdded(player)
end

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

CutsceneService tự tạo RemoteEvent CutsceneEvent ngay khi có Workspace.Cutscenes, nên bạn không cần chèn gì vào ReplicatedStorage bằng tay. Nếu bạn đã tạo một RemoteEvent cùng tên, hãy xóa nó: LocalScript có thể tìm thấy cái của bạn, mà trên server không ai lắng nghe nó.

Các thiết lập ở đầu CutsceneService
Thiết lậpGiá trị ở đâyThay đổi điều gì
INTRO_CUTSCENE"Intro"Thư mục trong Workspace.Cutscenes chạy ở lần spawn đầu tiên của người chơi trên server. Đặt "" để không có đoạn mở đầu.
DEFAULT_MOVE_SECONDS3Thời gian lia nếu cảnh quay không có attribute MoveSeconds.
DEFAULT_HOLD_SECONDS1Thời gian camera dừng ở cảnh nếu cảnh không có attribute HoldSeconds.
MAX_SHOTS30Số cảnh quay lớn nhất mà CutsceneService tìm trong một cutscene.

Phần còn lại của script làm gì, theo thứ tự:

  • Đọc các cảnh quay trên server. readShots gom CFrame và attribute của từng part được đánh số thành một danh sách. Thiết bị người chơi nhận danh sách này, nên nó không cần chính các part.
  • Mỗi lần một cutscene. play không làm gì khi người chơi đang xem một cutscene, hoặc nếu nhân vật của họ không có Humanoid hoặc đã chết.
  • Mỗi cutscene có id riêng. Thiết bị gửi id trở lại khi cutscene kết thúc hoặc bị bỏ qua, và chỉ id khớp mới bỏ đóng băng người chơi, nên một tin nhắn đến trễ từ cutscene trước không thể kết thúc cutscene mới.
  • Giữ người chơi đứng yên bằng cách anchor HumanoidRootPart, và anchor nhân vật mới nếu người chơi hồi sinh giữa cutscene. Tài liệu Roblox nói part đã anchor không bao giờ đổi vị trí do trọng lực, va chạm hay vật lý khác. WalkSpeed không bị động tới, nên không xung đột với script chạy nhanh hay pass tốc độ. Cuối cùng script bỏ anchor root part kể cả khi script khác đã anchor nó, nên đừng anchor nhân vật ở chỗ khác khi cutscene có thể đang chạy.
  • Dự phòng. task.delay bỏ đóng băng người chơi sau toàn bộ độ dài cutscene cộng 2 giây, kể cả khi thiết bị của họ không bao giờ trả lời.
  • Mỗi cutscene một lần trên mỗi server. Bảng seen nhớ với từng người chơi những cutscene nào đã bắt đầu, nên đoạn mở đầu không lặp lại khi hồi sinh, và cutscene từ trigger chỉ chạy một lần. playOnce chỉ trả về true nếu cutscene thực sự đã bắt đầu.
  • Thiết lập cho từng người chơi. Vòng lặp qua Players:GetPlayers() ở cuối bắt được tất cả những ai đã vào trong lúc script chờ thư mục Cutscenes.

Các cảnh quay được gửi cho người chơi bằng một lệnh FireClient, dưới dạng danh sách các bảng nhỏ. Trang của Roblox về remote event nói đừng gửi bảng trộn lẫn khóa số và khóa chuỗi; danh sách này chỉ có khóa số, còn mỗi cảnh quay bên trong chỉ có khóa chuỗi, đúng dạng mà trang đó khuyên dùng.

Bước 3: Thêm LocalScript để chạy cutscene

  1. Trong Explorer, mở rộng StarterPlayer, di chuột lên StarterPlayerScripts và chèn một LocalScript tên là CutscenePlayer.
  2. Thay nội dung của nó bằng code bên dưới.
LocalScript trong StarterPlayerScripts tên là CutscenePlayer
-- LocalScript trong StarterPlayer > StarterPlayerScripts tên là CutscenePlayer.
-- Chạy cutscene do server gửi tới: dải đen, phụ đề, nút Skip và
-- camera lia từ cảnh này sang cảnh khác. Sau đó trả camera về cho người chơi.

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 -- mỗi dải đen, tính theo tỉ lệ chiều cao màn hình
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- bao nhiêu stud phía trước camera mà Roblox nên vẽ chi tiết nhất
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 }

-- Màn hình cutscene: hai dải đen và phụ đề, tràn từ mép này sang mép kia. Roblox khuyên chỉ đặt
-- ScreenInsets None cho thứ không ai bấm vào, nên nút Skip bên dưới có ScreenGui riêng.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- toàn màn hình
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

-- Nút Skip dùng khoảng lề mặc định, nên phần khuyết camera không che nó
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) -- trên dải dưới, bên phải
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 luôn đủ lớn để bấm trúng trên điện thoại nhỏ
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

-- Lần lia hiện tại: từ CFrame camera này sang CFrame tiếp theo trong số giây đã cho
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false

-- Chạy mỗi khung hình trong lúc cutscene diễn ra. Focus của camera Scriptable không tự
-- đi theo thứ gì cả, nên nó cũng được đặt ở đây.
local function updateCamera()
	if camera.CameraType ~= Enum.CameraType.Scriptable then
		camera.CameraType = Enum.CameraType.Scriptable -- có thứ gì đó đã đặt lại nó, ví dụ hồi sinh
	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
		-- Một cutscene đang chạy, nên để server bỏ đóng băng người chơi ngay cho cái này
		cutsceneEvent:FireServer(id)
		return
	end
	busy = true
	skipRequested = false

	-- Ẩn danh sách người chơi, ba lô và thanh máu, nhớ lại những gì đang hiện
	local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
	for _, coreGui in HIDDEN_CORE_GUIS do
		wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
		StarterGui:SetCoreGuiEnabled(coreGui, false)
	end
	-- Trên điện thoại, ẩn cần điều khiển và nút nhảy nằm ở hai góc dưới
	local touchControlsWere = GuiService.TouchControlsEnabled
	GuiService.TouchControlsEnabled = false
	gui.Enabled = true
	controls.Enabled = true
	-- Tay cầm chỉ bấm được nút đang chọn, nên với người chơi dùng tay cầm thì chọn sẵn Skip
	if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
		GuiService.SelectedObject = skipButton
	end
	camera = workspace.CurrentCamera
	camera.CameraType = Enum.CameraType.Scriptable
	moveTo = camera.CFrame
	-- Sau lần cập nhật camera của chính Roblox một bậc, như trong hướng dẫn camera của Roblox
	RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)

	for _, shot in shots do
		moveFrom = camera.CFrame -- mỗi lần lia bắt đầu từ chỗ camera đang đứng
		moveTo = shot.cframe
		moveStart = os.clock()
		moveSeconds = shot.move
		caption.Text = shot.caption
		waitOrSkip(shot.move + shot.hold)
		if skipRequested then
			break
		end
	end

	-- Trả camera về nhân vật của người chơi
	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 = ""
	-- Chỉ bật lại những gì cutscene này đã tắt, phần còn lại không động tới
	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) -- server bỏ đóng băng người chơi ngay
	busy = false
end

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

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

LocalScript trong StarterPlayerScripts được copy cho người chơi một lần, lúc vào game, và tiếp tục chạy sau khi nhân vật hồi sinh. Vì vậy cả hai ScreenGui đều tắt ResetOnSpawn: nếu bật, Roblox sẽ xóa chúng ở lần hồi sinh đầu tiên, còn script này không tạo lại chúng. Tin nhắn remote đến trước khi script kết nối với OnClientEvent được xếp hàng và gửi sau khi kết nối, nên người chơi spawn nhanh vẫn thấy đoạn mở đầu.

Từng phần của CutscenePlayer làm gì
PhầnLàm gì
ScreenGui CutsceneHai dải đen, mỗi dải cao 12% màn hình (BAR_HEIGHT), và phụ đề trên dải dưới. ScreenInsets None kéo các dải ra sát mép màn hình, còn DisplayOrder 10 vẽ chúng đè lên các ScreenGui có DisplayOrder nhỏ hơn.
ScreenGui CutsceneControlsChỉ chứa nút Skip, bên phải dải dưới, với UISizeConstraint giữ nó không nhỏ hơn 64 x 32 pixel để dễ bấm trên điện thoại. Nó dùng ScreenInsets mặc định, nên nội dung không lấn xuống dưới các nút trên thanh trên cùng của Roblox và phần khuyết camera. Roblox chỉ khuyên dùng None cho nội dung không có gì để bấm, nên Skip không thể nằm chung ScreenGui với các dải đen.
HIDDEN_CORE_GUISẨn danh sách người chơi, ba lô và thanh máu bằng SetCoreGuiEnabled, trước đó dùng GetCoreGuiEnabled để nhớ cái nào đang bật, và cuối cùng chỉ bật lại những cái do chính nó tắt. Nếu game ẩn ba lô ở chỗ khác, nó vẫn ẩn, và script nào bật chúng trong lúc cutscene, ví dụ menu chính, cũng không bị ghi đè.
TouchControlsEnabledTrên điện thoại và máy tính bảng, play đặt GuiService.TouchControlsEnabled thành false trong suốt cutscene. Việc này ẩn cần điều khiển và nút nhảy ở hai góc dưới, cùng chỗ với Skip, và cuối cùng chúng hiện lại nếu trước đó đang bật.
updateCameraChạy mỗi khung hình trong lúc cutscene diễn ra. Tính xem đã đi được bao nhiêu phần của lần lia hiện tại, làm mượt nó bằng TweenService:GetValue, đặt camera giữa hai cảnh bằng CFrame:Lerp và đặt Focus cách 30 stud phía trước camera.
waitOrSkipChờ hết thời gian lia và dừng của cảnh, mỗi khung hình đều kiểm tra cờ Skip.
playĐặt camera thành Scriptable, chạy các cảnh theo thứ tự, rồi trả camera về (CameraType Custom, CameraSubject là Humanoid), bật lại core GUI và điều khiển cảm ứng, và gửi id cutscene cho server. Nếu cutscene thứ hai đến khi cái đầu vẫn đang chạy, nó gửi ngay id của cái thứ hai trở lại, để server không giữ người chơi đứng yên vì một cutscene mà thiết bị này không chiếu.
Nút SkipActivated kích hoạt khi click chuột, chạm, hoặc bấm nút A trên tay cầm khi nút đang được chọn. Với người chơi dùng tay cầm làm thiết bị nhập chính, play chọn Skip lúc bắt đầu cutscene và bỏ chọn khi kết thúc.

Đổi BAR_HEIGHT để dải đen mỏng hơn hoặc dày hơn, và EASING_STYLE để đổi cảm giác của các lần lia (xem Code camera làm đúng những gì). Phụ đề và nút Skip đều bật TextScaled, nên chữ to nhỏ theo màn hình.

Bước 4: Cutscene khi chạm vào part

Đoạn mở đầu tự chạy. Với cutscene ở một chỗ cụ thể trên bản đồ, ví dụ khi người chơi lần đầu tới cây cầu, hãy thêm cutscene thứ hai và một part trigger.

  1. Trong Workspace, Cutscenes, chèn một Folder tên là Bridge và đặt các cảnh quay của nó như ở bước 1, tên là 1 và 2. Trong dòng lệnh Command Bar, viết Bridge thay cho Intro.
  2. Di chuột lên Workspace và chèn một Folder tên là CutsceneTriggers.
  3. Chèn vào đó một Part tên là BridgeTrigger. Làm nó đủ lớn để người chơi không thể đi qua mà không chạm vào, ví dụ một tấm cao và rộng chắn ngang đường. Tích Anchored, bỏ tích CanCollide và CanQuery, giữ CanTouch được tích và đặt Transparency là 1. Tắt CanQuery giữ cho tấm vô hình không chặn raycast, ví dụ phát bắn trong hướng dẫn làm súng. Sự kiện chạm được điều khiển bằng CanTouch chứ không phải CanQuery, nên trigger vẫn hoạt động.
  4. Thêm cho nó attribute Cutscene kiểu string với giá trị Bridge: tên thư mục cần chạy.

CutsceneService kết nối Touched với mọi part nằm ngay trong CutsceneTriggers khi server khởi động, nên hãy thêm trigger trong Studio, đừng thêm bằng script trong lúc chơi. Trigger đã tắt CanTouch sẽ bị bỏ qua kèm một cảnh báo trong Output, vì Roblox báo lỗi khi script kết nối Touched với part như vậy.

Khi nhân vật đi xuyên qua part, Touched kích hoạt nhiều lần liên tiếp. Bảng seen và quy tắc "mỗi lần một cutscene" biến chuyện đó thành một cutscene cho mỗi người chơi trên mỗi server. Người chơi chạm vào trigger trong lúc đang có cutscene khác thì bị bỏ qua, và trigger vẫn sẵn sàng cho họ.

Đừng đặt trigger trên đường xe chạy. HumanoidRootPart của người chơi đang ngồi được hàn vào ghế, và khi một part trong nhóm được hàn bị anchor, Roblox anchor luôn các part còn lại. Vì vậy người chơi lái xe vào trigger sẽ giữ đứng yên cả chiếc xe, cùng hành khách, cho đến khi cutscene kết thúc.

Code camera làm đúng những gì

Scriptable, rồi trở lại Custom

Script camera của Roblox không di chuyển hay cập nhật camera khi CameraType là Scriptable, và chính điều đó cho phép CutscenePlayer đặt camera. Cuối cùng nó trả CameraType về Custom và đặt Humanoid của người chơi làm CameraSubject, thứ mà script camera của Roblox mặc định đi theo. Việc này cũng chạy sau khi bấm Skip, nên người chơi không bao giờ bị kẹt nhìn vào cảnh cuối.

Hai lệnh kiểm tra nhỏ giữ cho cutscene làm chủ trong lúc chạy. Nếu có thứ gì đặt CameraType sang giá trị khác giữa cutscene, hàm chạy mỗi khung hình sẽ đặt lại Scriptable ở khung tiếp theo. Còn workspace.CurrentCamera được script đọc lại ở đầu mỗi cutscene, vì Roblox tạo Camera mới nếu camera hiện tại bị xóa.

Focus, mỗi khung hình

Camera.Focus cho engine biết vùng nào cần ưu tiên cho các việc như chiếu sáng. Script camera của Roblox giữ nó ở CameraSubject, nhưng không làm vậy khi camera là Scriptable, và tài liệu Roblox nói trong trường hợp đó phải cập nhật nó mỗi khung hình: ánh sáng động từ các object như PointLight có thể không được vẽ khi ở xa focus. CutscenePlayer đặt nó cách 30 stud phía trước camera (FOCUS_DISTANCE). Hãy tăng số này nếu cảnh quay của bạn nhìn vào thứ ở xa hơn.

Hàm chạy qua RunService:BindToRenderStep, mỗi khung hình trước khi vẽ, sau lần cập nhật camera của chính Roblox một bậc ưu tiên (Enum.RenderPriority.Camera.Value + 1). Hướng dẫn camera của Roblox dùng mức ưu tiên này, nên cutscene đặt camera sau khi code camera của chính Roblox đã chạy xong.

Làm mượt bằng TweenService:GetValue

Một tween trên camera.CFrame cũng di chuyển được camera, nhưng Focus vẫn phải đặt mỗi khung hình, nên CutscenePlayer tự di chuyển camera trong cùng hàm đó. Với mỗi lần lia, nó tính xem đã trôi qua bao nhiêu phần thời gian (từ 0 đến 1), đưa giá trị đó qua TweenService:GetValue với kiểu và hướng làm mượt, rồi đặt camera ở đúng phần đường đó giữa hai cảnh bằng CFrame:Lerp, thứ di chuyển vị trí theo đường thẳng và xoay mượt. GetValue giới hạn đầu vào trong khoảng 0 đến 1, nên camera dừng đúng ở cảnh khi hết thời gian lia.

Các kiểu làm mượt hợp cho lần lia camera
EASING_STYLECảm giác của lần lia
Enum.EasingStyle.Sine (ở đây)Tốc độ theo đường hình sin, khởi đầu mềm và dừng mềm.
Enum.EasingStyle.QuadGiống Sine, nhưng đường cong gắt hơn một chút.
Enum.EasingStyle.LinearTốc độ không đổi, nên mỗi lần lia bắt đầu và kết thúc ở tốc độ tối đa.

Hướng InOut: làm mượt được áp dụng xuôi ở nửa đầu lần lia và ngược lại ở nửa sau, nên camera tăng tốc khi rời một cảnh và giảm tốc khi tới cảnh tiếp theo.

Streaming

Ở các place mới, instance streaming được bật: mặc định thiết bị người chơi chỉ giữ vùng quanh nhân vật của họ, nên cảnh quay nhìn sang đầu kia bản đồ có thể hiện ra một thế giới trống. CutsceneService yêu cầu Roblox tải vùng của từng cảnh cho người chơi đó bằng Player:RequestStreamAroundAsync: vùng của cảnh đầu tiên trước khi gửi sự kiện, chờ tối đa 2 giây, và vùng của mỗi cảnh tiếp theo 2 giây trước khi camera lia tới đó.

Roblox viết rằng làm vậy thì vùng đó có lẽ, nhưng không chắc chắn, sẽ được tải, và hiệu quả chỉ là tạm thời. Hãy giữ các cảnh quan trọng trong bán kính streaming, hoặc dùng Player:AddReplicationFocus trên server cho vùng cần luôn được tải cho đến khi bạn bỏ focus. Khi tắt streaming, thiết bị đã có cả bản đồ, còn pcall quanh mỗi yêu cầu nghĩa là một yêu cầu thất bại không thể làm dừng cutscene.

Các hướng dẫn cutscene cũ sai ở đâu

Nếu bạn so hướng dẫn này với một video hay bài viết trên diễn đàn, đây là những khác biệt quan trọng, và vì sao mỗi cách làm đó là vấn đề.

Những cách làm thường gặp trong hướng dẫn cutscene và điều hướng dẫn này làm thay
Hướng dẫn cũVấn đềHướng dẫn này
Di chuyển camera bằng camera:Interpolate()Roblox đã đánh dấu Interpolate là lỗi thời và khuyên tạo chuyển động camera bằng TweenService.Làm mượt mỗi lần lia bằng TweenService:GetValue và đặt camera mỗi khung hình.
Tween camera.CFrame và không gì khácFocus ở lại chỗ script camera để nó, gần nhân vật, nên ánh sáng động ở xa nó có thể không được vẽ (tài liệu Roblox về Camera.Focus).Đặt Focus mỗi khung hình trong render step.
Không trả camera vềNgười chơi bị kẹt nhìn vào cảnh cuối.Cuối cùng đặt CameraType thành Custom và CameraSubject về Humanoid, kể cả sau khi bấm Skip.
Khởi động cutscene từ Touched trong LocalScriptKhông gì ngăn nó lặp lại mỗi lần chạm, và quyết định được đưa ra trên thiết bị do người chơi điều khiển.Server chọn người chơi và nhớ ai đã xem.
Đọc part camera trên clientKhi bật streaming, các part ở xa nhân vật có thể chưa tồn tại trên thiết bị.Server đọc các part, gửi CFrame của chúng và yêu cầu tải vùng của mỗi cảnh ngay trước khi camera lia tới đó.

Người chơi có thể và không thể thay đổi gì

Hãy coi như kẻ gian kiểm soát mọi thứ trên thiết bị của mình: họ có thể sửa hoặc xóa CutscenePlayer và gửi CutsceneEvent với bất kỳ giá trị nào. Với cutscene thì điều đó gần như không có ý nghĩa, miễn là không có gì thật phụ thuộc vào nó.

Kẻ gian có thể thử gì và kết quả ra sao
Kẻ gian thửKết quả
Bỏ qua cutscene hoặc không chạy nó luônĐược: đó là màn hình của chính họ. Đừng bao giờ thưởng cho việc "xem hết cutscene".
Gửi CutsceneEvent với bất kỳ giá trị nàoChỉ số khớp với cutscene hiện tại của họ mới có tác dụng, và tác dụng duy nhất là bỏ đóng băng họ sớm hơn.
Chạm vào trigger từ bất kỳ đâu trên bản đồCó thể: mỗi thiết bị điều khiển nhân vật của mình, và tài liệu bảo mật của Roblox liệt kê việc giả mạo sự kiện Touched trong số những gì nó làm được. Họ sẽ xem cutscene đó một lần, và không có gì khác xảy ra.
Vẫn di chuyển trong lúc cutsceneKhông được lợi gì. Việc đóng băng giữ người chơi bình thường không bỏ đi giữa cutscene; đó không phải lớp kiểm tra bảo mật.
Qua remote chạy cutscene cho người khácKhông thể. Chỉ server mới gửi được CutsceneEvent cho người chơi, còn thứ duy nhất thiết bị gửi lại được là "cutscene này đã kết thúc".

Nếu cutscene dẫn tới điều gì đó thật, ví dụ một cánh cửa sau đó mở ra hay boss xuất hiện, hãy để server làm việc đó theo bộ đếm của riêng nó, chứ không phải khi thiết bị báo cutscene đã kết thúc.

Bước 5: Kiểm tra

  1. Đặt ba cảnh quay Intro bằng dòng lệnh Command Bar. Cho cảnh 1 Caption "Welcome to the village", cảnh 2 MoveSeconds 2.5 và Caption "Find the bridge", còn cảnh 3 để không có attribute.
  2. Bấm Play (F5). Dải đen xuất hiện, camera chuyển sang cảnh 1 cùng phụ đề, lia tới cảnh 2 trong 2.5 giây, rồi tới cảnh 3 trong 3 giây không có phụ đề. Sau đó camera trở về sau lưng nhân vật và danh sách người chơi hiện lại. Trong lúc chạy thì không đi được.
  3. Dừng test, bấm Play lần nữa và bấm Skip khi camera đang lia tới cảnh 2. Camera trở về ngay và bạn đi lại được ngay.
  4. Bước vào BridgeTrigger: cutscene Bridge chạy. Đi xuyên qua nó lần nữa: không có gì xảy ra.
  5. Chọn Server & Clients trong danh sách chế độ test, đặt 2 client và bấm Play. Khi Client 1 bước vào trigger, cutscene Bridge chỉ chạy ở Client 1, còn Client 2 vẫn đi lại được.
  6. Để Workspace.StreamingEnabled bật và đưa một cảnh quay ra xa điểm spawn. Khi camera tới nơi, cảnh vật xung quanh phải có mặt (có lẽ, nhưng không đảm bảo: xem Streaming).
  7. Với tay cầm, dừng test, bấm Play, mở Controller Emulator (tab Emulation, rồi Controller) và bước vào BridgeTrigger bằng tay cầm giả lập: Skip phải đang được chọn, nên nút A bỏ qua cutscene. Nếu bạn dùng Device Simulator trong Studio (tại thời điểm chúng tôi kiểm tra ngày 15 tháng 10 năm 2026 đây là bản beta: bật nó trong File, Beta Features, New Device Simulator rồi khởi động lại Studio), hãy chọn một điện thoại, xoay ngang và kiểm tra Skip không lấn xuống phần khuyết camera và dễ bấm, còn cần điều khiển và nút nhảy bị ẩn trong lúc cutscene chạy.
  8. Nếu bạn đã làm cả menu chính, bấm Play, rồi nút Play trong menu và để đoạn mở đầu chạy hết: sau đó danh sách người chơi phải hiện lại trên màn hình.

Luôn để cửa sổ Output mở (menu Window, rồi Output). Khi mọi thứ chạy đúng, các script này không ghi gì, nên mọi cảnh báo hay lỗi đỏ từ CutsceneService hoặc CutscenePlayer đều là vấn đề thật. Xem Lỗi thường gặp.

Cách mở rộng hệ thống

Đoạn mở đầu chỉ ở lần đầu người chơi vào game

Bảng seen chỉ sống trong một server, nên người chơi vào lại sẽ thấy đoạn mở đầu lần nữa. Để chỉ chiếu nó ở lần vào đầu tiên, hãy lưu một cờ, ví dụ SeenIntro, cùng với dữ liệu khác của người chơi bằng module PlayerData trong hướng dẫn về DataStore. Giữ nguyên INTRO_CUTSCENE và sửa phần của onCharacterAdded trong CutsceneService lo đoạn mở đầu: chờ đến khi PlayerData.Get(player) trả về dữ liệu người chơi, bỏ qua đoạn mở đầu nếu data.SeenIntro là true, và chỉ đặt data.SeenIntro = true khi playOnce(player, INTRO_CUTSCENE) trả về true. Đừng chạy đoạn mở đầu từ code tải dữ liệu: dữ liệu có thể tải xong trước khi nhân vật spawn, mà không có nhân vật thì play không làm gì, và cờ sẽ được lưu cho một đoạn mở đầu không ai xem.

Nhân vật diễn trong cutscene

Làm animation trong Animation Editor của Studio hoặc trong plugin animation bên thứ ba, ví dụ Moon Animator được nhắc tới trong tài liệu Roblox, và chạy nó trên rig NPC trong cảnh khi camera tới đó. Tài liệu Roblox về Animator nói animation của NPC chỉ được replicate nếu server tải và chạy nó, nên hãy chạy từ Script phía server nếu mọi người chơi đều cần thấy NPC diễn. Nếu tải và chạy nó trong CutscenePlayer, animation không được replicate, và như vậy hợp với cutscene chỉ một người chơi xem. Hướng dẫn về script animation chỉ cách chạy animation trên NPC từ Script phía server.

Hội thoại

Phụ đề hợp với những câu thoại ngắn tự chạy. Với cuộc nói chuyện mà người chơi trả lời và chọn phương án, xem hướng dẫn hội thoại với NPC.

Đoạn mở đầu sau menu chính

Hướng dẫn menu chính tắt CharacterAutoLoads, nên không ai spawn cho đến khi bấm Play. CutsceneService chạy đoạn mở đầu ở lần spawn đầu tiên của người chơi, nên khi có cả hai hệ thống, đoạn mở đầu chạy ở lần spawn đầu tiên sau khi bấm Play. Menu bật lại core GUI khi nhân vật xuất hiện, mà điều này có thể xảy ra khi đoạn mở đầu đã chạy, nên trong đoạn mở đầu có thể thấy danh sách người chơi. CutscenePlayer chỉ bật lại những gì chính nó đã ẩn, nên nó không động tới thay đổi của menu, và sau đoạn mở đầu chúng vẫn bật. Mẹo Command Bar trong hướng dẫn menu chính để canh part camera cũng giống ở bước 1.

Bay quanh bản đồ lúc bắt đầu vòng chơi

Để chạy cutscene từ một script server khác, ví dụ bay quanh bản đồ lúc bắt đầu vòng chơi trong hướng dẫn hệ thống vòng chơi, thêm vào ServerStorage một BindableEvent tên là PlayCutscene. Ở cuối CutsceneService, kết nối Event của nó với hàm play, rồi để script vòng chơi gọi nó với từng người chơi và tên cutscene. play bỏ qua bước kiểm tra "một lần mỗi server", nên lần bay quanh chạy ở mọi vòng.

Plugin cutscene

Bạn có thể dùng plugin cùng với hướng dẫn này. Nếu plugin cutscene tự viết script camera, hãy kiểm tra nó có trả camera về (CameraType Custom và CameraSubject) và đặt Focus khi camera là Scriptable, còn quyết định ai thấy cutscene thì để cho server, như trong hướng dẫn này.

Lỗi thường gặp và cách sửa

Mở cửa sổ Output (menu Window, rồi Output) trước khi bấm Play. Phần lớn vấn đề với cutscene hoặc ghi cảnh báo ở đó, hoặc do một cái tên không khớp.

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

CutsceneService chờ thư mục tên là Cutscenes nằm ngay trong Workspace. Tạo nó như ở bước 1 và kiểm tra chính tả cùng chữ C viết hoa. Khi chưa có nó, CutsceneService không tạo CutsceneEvent, nên CutscenePlayer cũng phải chờ.

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

CutscenePlayer chờ remote do CutsceneService tạo. Kiểm tra CutsceneService là Script chứ không phải LocalScript, nằm ngay trong ServerScriptService, không bị tắt, và Output không có lỗi hay cảnh báo nào về Cutscenes từ nó.

CutsceneService: no folder named Intro in Workspace.Cutscenes

Tên trong INTRO_CUTSCENE hoặc trong attribute Cutscene của trigger không khớp với thư mục nào trong Workspace.Cutscenes. Tên phân biệt chữ hoa chữ thường.

Không có gì chạy và Output trống

Thư mục không có part tên là 1, hoặc các part không nằm ngay trong nó (ví dụ nằm trong một Model). CutsceneService đọc part 1, 2, 3 theo thứ tự và dừng ở số đầu tiên bị thiếu. Và nhớ rằng mỗi cutscene chạy một lần cho mỗi người chơi trên mỗi server: dừng test và bấm Play lại.

Camera nhìn sai hướng

Camera nhìn theo hướng mặt trước của part cảnh quay. Đưa camera Studio tới góc nhìn cần thiết và chạy lại dòng lệnh Command Bar ở bước 1 cho cảnh đó.

Trigger không làm gì

Kiểm tra part trigger nằm ngay trong Workspace.CutsceneTriggers khi game khởi động, CanTouch được tích (nếu không Output sẽ có cảnh báo) và attribute Cutscene của nó là chuỗi chứa tên một thư mục trong Workspace.Cutscenes. Đi xuyên qua trigger lần nữa thì không có gì xảy ra, đó là chủ ý.

Sau cutscene camera vẫn ở cảnh cuối

CutscenePlayer đã dừng vì lỗi trước khi kịp trả camera về, nên hãy tìm lỗi đỏ từ nó trong Output. Cũng có thể một script khác giữ camera bằng cách liên tục đặt CameraType thành Scriptable, ví dụ camera của menu vẫn còn được bind.

Làm bằng RoCode

Nếu không muốn tự dựng bằng tay, RoCode có thể làm việc này trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả tính năng trong web chat của nó, còn plugin cho Studio của nó tạo part và script trong Explorer của bạn, nên bạn không cần copy code từ cửa sổ chat.

Bạn gõ

Thêm cutscene mở đầu: thư mục Cutscenes có thư mục Intro với các cảnh quay từ 1 đến 3, phụ đề lấy từ attribute Caption, dải đen và nút Skip, chạy một lần ở lần spawn đầu tiên của người chơi, server giữ người chơi đứng yên, và cuối cùng camera trở về.

RoCode làm
  • Có thể kiểm tra place của bạn trước bằng Search Scripts, ví dụ tìm script menu hay camera đã đặt CameraType, để chúng không xung đột
  • Tạo các thư mục và part trigger bằng Create Instance và đặt attribute trên các part, như Caption và MoveSeconds
  • Viết CutsceneService và CutscenePlayer bằng Create Script
  • Nó được dặn kiểm tra mọi script đã viết bằng Check Script, công cụ biên dịch script trong Studio mà không chạy, và nó đặt điểm hoàn tác trước và sau mỗi đợt thay đổi

Hãy tự đặt các part cảnh quay bằng cách đưa camera Studio tới từng góc nhìn, rồi mới yêu cầu viết script. Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.11 trở lên nó có thể điều khiển một nhân vật thử để kiểm tra game chạy đúng, nhưng trong lúc chơi nó không chụp màn hình, nên cutscene thì bạn phải tự xem. Thứ tự làm cả một game có ở trang cách làm game Roblox bằng AI, từng hệ thống một. Cách RoCode kết nối với Studio.

Câu hỏi thường gặp

Làm sao để cutscene chạy khi vào game?

Đặt tên thư mục cảnh quay là Intro trong Workspace.Cutscenes, hoặc đổi INTRO_CUTSCENE thành tên thư mục của bạn. CutsceneService chạy nó ở lần spawn đầu tiên của mỗi người chơi trên server. Để chỉ chiếu ở lần vào game đầu tiên, hãy lưu một cờ trong data store và chỉ đặt nó sau khi đoạn mở đầu đã bắt đầu, như mô tả ở phần Cách mở rộng hệ thống.

Có làm cutscene không cần plugin được không?

Được. Hướng dẫn này chỉ dùng part, attribute và hai script, còn dòng lệnh Command Bar đặt mỗi cảnh quay đúng chỗ camera Studio đang đứng. Các plugin như Moon Animator vẫn tiện để làm animation cho nhân vật diễn trong cutscene.

Vì sao camera không di chuyển trong cutscene?

Thường là code camera nằm trong Script phía server, trong khi chỉ LocalScript mới di chuyển được camera của người chơi, vì mỗi thiết bị có camera riêng. Một lý do hay gặp khác: CameraType không phải Scriptable, và script camera mặc định của Roblox liên tục kéo camera về nhân vật.

Làm sao để người chơi không di chuyển được trong cutscene?

Anchor HumanoidRootPart của họ trên server trong lúc cutscene chạy và bỏ anchor sau đó, như CutsceneService làm. Part đã anchor không bao giờ bị vật lý làm di chuyển. WalkSpeed không bị động tới, nên không xung đột với script chạy nhanh hay pass tốc độ.

Làm sao thêm nút Skip vào cutscene?

Đặt một TextButton lên màn hình cutscene và kết nối sự kiện Activated của nó, sự kiện kích hoạt khi click, chạm hoặc bấm nút A trên tay cầm khi nút đang được chọn. Skip trong CutscenePlayer đặt một cờ mà vòng lặp cảnh quay kiểm tra mỗi khung hình, tự được chọn cho người chơi dùng tay cầm, và nằm trong ScreenGui riêng với lề mặc định để phần khuyết camera điện thoại không che nó. Cần điều khiển và nút nhảy bị ẩn trong lúc cutscene chạy, nên chúng không nằm cạnh nó.

Vì sao thế giới trong cutscene trống trơn?

Khi bật instance streaming, thiết bị người chơi chỉ có vùng gần nhân vật của họ. Hãy để server gọi player:RequestStreamAroundAsync cho mỗi cảnh ngay trước khi camera tới đó, như CutsceneService làm. Roblox viết rằng làm vậy thì vùng đó có lẽ, nhưng không chắc chắn, sẽ được tải, nên hãy giữ các cảnh quan trọng trong bán kính streaming hoặc dùng Player:AddReplicationFocus cho vùng cần luôn được tải.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.