요약
Workspace.Cutscenes 안의 폴더에 1, 2, 3이라는 이름의 보이지 않는 고정(Anchored) 파트를 놓고, 각 파트의 앞면이 카메라가 바라볼 방향을 향하게 하세요. ServerScriptService의 Script가 파트의 CFrame을 읽고, 플레이어를 제자리에 묶어 두고, RemoteEvent로 그 플레이어에게 샷을 보냅니다. StarterPlayerScripts의 LocalScript는 workspace.CurrentCamera.CameraType을 Scriptable로 설정하고, 매 프레임 샷에서 샷으로 카메라를 움직인 뒤(TweenService:GetValue로 부드럽게), CameraType을 Custom으로, CameraSubject를 플레이어의 Humanoid로 되돌립니다.
- 카메라는 플레이어의 기기만 조종할 수 있으므로 카메라 코드는 LocalScript입니다. 서버는 누가 어떤 컷신을 언제 볼지만 정합니다.
- 카메라가 Scriptable이면 Roblox는
Camera.Focus를 더 이상 갱신하지 않습니다. 레퍼런스는 Focus를 매 프레임 갱신하라고 합니다. 그러지 않으면 예전 포커스에서 먼 곳의 동적 조명이 그려지지 않을 수 있습니다. Camera:Interpolate는 더 이상 권장되지 않습니다(deprecated). Roblox 레퍼런스는 TweenService로 카메라를 애니메이션하라고 합니다.
이 페이지의 내용
컷신이 작동하는 방식
플레이어의 기기마다 workspace.CurrentCamera에 자기 Camera 오브젝트가 있으므로 플레이어가 보는 것을 움직일 수 있는 것은 LocalScript뿐입니다. 누가 어떤 컷신을 언제 볼지 정하는 것은 서버의 일입니다. 이 가이드는 작업을 정확히 이렇게 나눕니다. 컷신 하나는 이렇게 진행됩니다:
- 서버가 플레이어가 컷신을 봐야 한다고 정합니다. 서버에 처음 스폰될 때는
Intro를, 트리거 파트에 닿으면 다른 컷신을 봅니다. - CutsceneService가 샷 파트의 CFrame과 설정을 읽고, 그 플레이어에게 첫 샷 주변 영역을 불러오도록 Roblox에 요청하고, 플레이어가 제자리에 서 있도록 HumanoidRootPart를 고정하고, id와 샷 목록을 담아 그 플레이어에게만
CutsceneEvent를 보냅니다. - 플레이어 기기의 CutscenePlayer가 검은 띠와 Skip 버튼을 보여 주고, 플레이어 목록, 백팩, 체력 바, 터치 컨트롤을 숨기고, 카메라를 Scriptable로 만들어 매 프레임 움직입니다.
- 마지막 샷이 끝나거나 플레이어가 Skip을 누르면 카메라를 캐릭터에게 돌려주고 같은 id로 서버에
CutsceneEvent를 보냅니다. - 서버가 플레이어의 고정을 풉니다. 이 메시지가 끝내 오지 않으면 컷신 길이에 2초를 더한 시간이 지났을 때 어쨌든 고정을 풉니다. 타이머는 서버가 컷신을 보낼 때 시작하는데, 접속이 느리면 기기가 인트로를 몇 초 늦게 시작할 수 있습니다. ReplicatedFirst 밖의 LocalScript는 게임이 다 불러와질 때까지 실행되지 않기 때문입니다. 그러면 플레이어 화면에서 인트로가 끝나기 전에 플레이어가 다시 움직일 수 있습니다.
| 요소 | 위치 | 하는 일 |
|---|---|---|
Script CutsceneService | ServerScriptService | 누가 어떤 컷신을 언제 볼지 정하고, 샷을 읽고, 플레이어를 제자리에 묶어 두고, 누가 무엇을 이미 봤는지 기억합니다. |
LocalScript CutscenePlayer | StarterPlayer, StarterPlayerScripts | 플레이어 화면에서 컷신을 재생합니다. 띠, 자막, Skip, 카메라 이동. 끝나면 카메라를 되돌립니다. |
RemoteEvent CutsceneEvent | ReplicatedStorage(CutsceneService가 만듭니다) | 서버에서 플레이어 한 명에게 샷을 전달하고, 반대로 "컷신이 끝났다"는 메시지를 돌려보냅니다. |
Folder Cutscenes | Workspace | 컷신마다 폴더 하나, 예를 들어 Intro, 그 안에 샷 파트 1, 2, 3. |
Folder CutsceneTriggers | Workspace(선택 사항) | 플레이어가 닿으면 컷신을 시작하는 파트. |
Workspace
Cutscenes Folder new
Intro Folder new
1 Part new
2 Part new
3 Part new
Bridge Folder new
1 Part new
2 Part new
CutsceneTriggers Folder new
BridgeTrigger Part new
ServerScriptService
CutsceneService Script new
StarterPlayer
StarterPlayerScripts
CutscenePlayer LocalScript new
1단계: 카메라 샷 배치하기
각 샷은 보이지 않는 파트입니다. 카메라는 파트의 위치를 가져오고 파트의 앞면과 같은 방향을 바라보므로, 샷을 배치하는 것은 곧 카메라를 배치하는 것입니다.
- Explorer에서 Workspace에 마우스를 올리고 + 버튼을 눌러
Cutscenes라는 이름의 Folder를 넣으세요. 그 안에Intro라는 이름의 Folder를 넣으세요. 이름의 대소문자가 중요합니다. - 사진 구도를 잡듯이 Studio 카메라를 원하는 첫 장면으로 옮기세요.
- Intro 안에 Part를 넣고 이름을
1로 바꾸세요. - Command Bar(Script 탭에서, 또는 Window, 그다음 Script)를 열고
workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame을 실행하세요. 편집 모드에서CurrentCamera는 지금 보고 있는 시점이므로 파트가 정확히 그 구도에 놓입니다. 숫자로 시작하는 이름은 점 뒤에 쓸 수 없기 때문에 대괄호와 따옴표가 필요합니다. - 파트의 Properties에서 Anchored를 켜고, CanCollide, CanTouch, CanQuery를 끄고, Transparency를 1로 설정하세요. Anchored는 파트가 맵 아래로 떨어지지 않게 하고, 나머지는 플레이어를 방해하거나, 터치 이벤트를 일으키거나, 레이캐스트를 가로막지 않게 합니다.
- 다음 장면들도 반복하면서 파트 이름을
2,3등으로 짓고 Command Bar 줄의 번호를 바꾸세요. CutsceneService는 번호 순서대로 샷을 재생하다가 처음으로 빠진 번호에서 멈추므로, 번호에 구멍이 있으면 컷신이 일찍 끝납니다.
나중에 샷을 바꾸려면 카메라를 새 장면으로 옮기고 그 샷의 번호로 같은 줄을 실행하세요. Transparency가 1이면 Studio에서도 파트가 보이지 않으니, 필요할 때는 Explorer에서 선택하세요.
각 샷에는 선택 사항인 속성이 세 개 더 있을 수 있습니다. 속성을 추가하려면 파트를 선택하고 Properties 창을 Attributes 섹션까지 내린 뒤 +를 누르고 이름을 입력하고 타입을 고른 다음 Save를 누르세요.
| 속성 | 타입 | 기본값 | 하는 일 |
|---|---|---|---|
MoveSeconds | number | 3 | 이전 샷에서 이 샷까지 카메라가 날아가는 초. 0이면 바로 전환됩니다. 샷 1은 항상 전환이므로 이 속성이 적용되지 않습니다. |
HoldSeconds | number | 1 | 카메라가 도착한 뒤 이 샷에 머무는 초. |
Caption | string | 없음 | 카메라가 이 샷으로 날아가기 시작하는 순간부터 아래 띠에 표시되는 텍스트. Caption이 없는 샷은 텍스트를 지웁니다. |
0보다 작거나 60보다 큰 숫자, 그리고 타입이 잘못된 속성은 기본값으로 바뀝니다.
2단계: 서버 스크립트 추가하기
ServerScriptService에 마우스를 올리고 CutsceneService라는 이름의 Script를 넣은 다음 아래 코드를 붙여 넣으세요. 맨 위의 설정은 바꿔도 되는 줄입니다.
-- ServerScriptService 안의 CutsceneService라는 이름의 Script.
-- 누가 어떤 컷신을 언제 볼지 정합니다. Workspace.Cutscenes의 번호가 붙은
-- 파트에서 카메라 샷을 읽고, 플레이어를 제자리에 묶어 두고, 그 플레이어의
-- 기기에 샷을 재생하라고 알립니다. 카메라 자체는 기기에서만 움직일 수 있습니다.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- 설정
local INTRO_CUTSCENE = "Intro" -- 플레이어가 처음 스폰될 때 한 번 재생; ""이면 끔
local DEFAULT_MOVE_SECONDS = 3 -- 샷에 MoveSeconds가 없을 때 그 샷까지 날아가는 시간
local DEFAULT_HOLD_SECONDS = 1 -- 샷에 HoldSeconds가 없을 때 그 샷에 머무는 시간
local MAX_SHOTS = 30
local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")
-- 이 스크립트가 CutsceneEvent를 직접 만드므로 손으로 추가하지 마세요
local cutsceneEvent = Instance.new("RemoteEvent")
cutsceneEvent.Name = "CutsceneEvent"
cutsceneEvent.Parent = ReplicatedStorage
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
local seen: { [Player]: { [string]: boolean } } = {}
local playing: { [Player]: number } = {} -- 플레이어가 보고 있는 컷신의 id
local lastId = 0
local function secondsAttribute(part: Instance, name: string, default: number): number
local value = part:GetAttribute(name)
if typeof(value) == "number" and value >= 0 and value <= 60 then
return value
end
return default
end
-- 샷은 컷신 이름의 폴더 안에 있는 파트 1, 2, 3 ...
local function readShots(name: string): { Shot }
local shots: { Shot } = {}
local folder = cutscenes:FindFirstChild(name)
if not folder then
warn(`CutsceneService: no folder named {name} in Workspace.Cutscenes`)
return shots
end
for index = 1, MAX_SHOTS do
local part = folder:FindFirstChild(tostring(index))
if not (part and part:IsA("BasePart")) then
break
end
local caption = part:GetAttribute("Caption")
table.insert(shots, {
cframe = part.CFrame,
-- 첫 샷은 전환이므로 카메라가 바로 그 샷으로 점프합니다
move = if index == 1 then 0 else secondsAttribute(part, "MoveSeconds", DEFAULT_MOVE_SECONDS),
hold = secondsAttribute(part, "HoldSeconds", DEFAULT_HOLD_SECONDS),
caption = if typeof(caption) == "string" then caption else "",
})
end
return shots
end
local function setFrozen(player: Player, frozen: boolean)
local character = player.Character
local rootPart = character and character:FindFirstChild("HumanoidRootPart")
if rootPart and rootPart:IsA("BasePart") then
rootPart.Anchored = frozen
end
end
local function finish(player: Player, id: number)
if playing[player] ~= id then
return -- 이 컷신은 이미 끝났습니다
end
playing[player] = nil
setFrozen(player, false)
end
local function play(player: Player, name: string): boolean
if playing[player] then
return false -- 한 번에 컷신 하나
end
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not humanoid or humanoid.Health <= 0 then
return false
end
local shots = readShots(name)
if #shots == 0 then
return false
end
lastId += 1
local id = lastId
playing[player] = id
-- instance streaming이 켜져 있으면 플레이어의 기기에 샷이 바라보는 영역이
-- 없을 수 있고, 요청은 영역을 잠시 동안만 불러옵니다. 첫 샷의 영역은
-- 지금 불러오고(최대 2초 대기), 다음 샷들의 영역은 카메라가
-- 그쪽으로 날아가기 2초 전에 불러옵니다.
local function request(position: Vector3)
pcall(function()
player:RequestStreamAroundAsync(position, 2)
end)
end
request(shots[1].cframe.Position)
if playing[player] ~= id or player.Parent ~= Players then
return false -- 영역을 불러오는 동안 플레이어가 나갔습니다
end
setFrozen(player, true)
cutsceneEvent:FireClient(player, id, shots)
local startsAt = 0 -- 지금부터 이 샷으로 날아가기 시작할 때까지의 초
for index, shot in shots do
if index > 1 then
task.delay(math.max(startsAt - 2, 0), function()
if playing[player] == id then
request(shot.cframe.Position)
end
end)
end
startsAt += shot.move + shot.hold
end
-- 안전장치: 플레이어의 기기가 끝내 응답하지 않아도 고정을 풉니다
task.delay(startsAt + 2, finish, player, id)
return true
end
-- 이 플레이어에게 컷신이 시작됐을 때만 true를 반환합니다
local function playOnce(player: Player, name: string): boolean
local playerSeen = seen[player]
if not playerSeen or playerSeen[name] then
return false
end
if play(player, name) then
playerSeen[name] = true
return true
end
return false
end
-- 플레이어의 기기가 컷신이 끝났거나 건너뛰었다고 알립니다
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
if typeof(id) == "number" then
finish(player, id)
end
end)
-- 트리거 파트: 닿으면 Cutscene 속성에 적힌 컷신을 시작합니다
if triggers then
for _, trigger in triggers:GetChildren() do
if not trigger:IsA("BasePart") then
continue
end
if not trigger.CanTouch then
-- CanTouch가 꺼진 파트에 Touched를 연결하면 오류가 나므로 경고만 합니다
warn(`CutsceneService: tick CanTouch on {trigger:GetFullName()} so it can start a cutscene`)
continue
end
trigger.Touched:Connect(function(otherPart: BasePart)
local name = trigger:GetAttribute("Cutscene")
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if player and typeof(name) == "string" then
playOnce(player, name)
end
end)
end
end
local function onCharacterAdded(player: Player, character: Model)
character:WaitForChild("HumanoidRootPart", 10)
if playing[player] then
setFrozen(player, true) -- 컷신 도중 리스폰, 새 캐릭터도 제자리에 묶어 둡니다
elseif INTRO_CUTSCENE ~= "" then
playOnce(player, INTRO_CUTSCENE)
end
end
local function onPlayerAdded(player: Player)
if seen[player] then
return -- 이미 설정됨
end
seen[player] = {}
player.CharacterAdded:Connect(function(character: Model)
onCharacterAdded(player, character)
end)
local character = player.Character
if character then
task.spawn(onCharacterAdded, player, character)
end
end
Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do -- 스크립트가 Cutscenes를 기다리는 동안 들어온 모든 사람
onPlayerAdded(player)
end
Players.PlayerRemoving:Connect(function(player: Player)
seen[player] = nil
playing[player] = nil
end)
CutsceneService는 Workspace.Cutscenes가 나타나자마자 RemoteEvent CutsceneEvent를 직접 만들므로, ReplicatedStorage에 손으로 넣을 것은 없습니다. 같은 이름의 RemoteEvent를 이미 만들었다면 지우세요. LocalScript가 내가 만든 것을 찾을 수 있는데, 서버에서는 아무도 그것을 듣지 않습니다.
| 설정 | 여기서의 값 | 바꾸는 것 |
|---|---|---|
INTRO_CUTSCENE | "Intro" | 플레이어가 서버에 처음 스폰될 때 재생되는 Workspace.Cutscenes 안의 폴더. 인트로를 없애려면 ""로 설정하세요. |
DEFAULT_MOVE_SECONDS | 3 | 샷에 MoveSeconds 속성이 없을 때 이동이 걸리는 시간. |
DEFAULT_HOLD_SECONDS | 1 | 샷에 HoldSeconds 속성이 없을 때 카메라가 그 샷에 머무는 시간. |
MAX_SHOTS | 30 | CutsceneService가 컷신 하나에서 찾는 가장 큰 샷 번호. |
스크립트의 나머지 부분이 하는 일을 순서대로 보면:
- 샷을 서버에서 읽습니다.
readShots가 번호가 붙은 각 파트의 CFrame과 속성을 목록으로 모읍니다. 플레이어의 기기는 이 목록을 받으므로 파트 자체가 필요 없습니다. - 한 번에 컷신 하나. 플레이어가 이미 컷신을 보고 있거나, 캐릭터에 Humanoid가 없거나 죽어 있으면
play는 아무것도 하지 않습니다. - 컷신마다 고유한 id. 컷신이 끝나거나 건너뛰면 기기가 id를 돌려보내고, 일치하는 id만 플레이어의 고정을 풉니다. 그래서 이전 컷신에서 늦게 도착한 메시지가 새 컷신을 끝낼 수 없습니다.
- 플레이어를 제자리에 묶어 둡니다. HumanoidRootPart를 고정하고, 플레이어가 컷신 도중 리스폰하면 새 캐릭터도 고정합니다. Roblox 레퍼런스에 따르면 고정된 파트는 중력, 충돌, 그 밖의 물리 때문에 위치가 바뀌지 않습니다. WalkSpeed는 건드리지 않으므로 달리기 스크립트나 속도 게임 패스와 충돌하지 않습니다. 끝날 때 스크립트는 다른 스크립트가 고정했더라도 root part의 고정을 풀기 때문에, 컷신이 재생될 수 있는 동안에는 다른 곳에서 캐릭터를 고정하지 마세요.
- 안전장치.
task.delay가 컷신 전체 길이에 2초를 더한 뒤 플레이어의 고정을 풉니다. 기기가 끝내 응답하지 않아도 마찬가지입니다. - 컷신마다 서버당 한 번.
seen테이블이 플레이어마다 어떤 컷신이 이미 시작됐는지 기억하므로, 리스폰해도 인트로가 반복되지 않고 트리거 컷신은 한 번만 재생됩니다.playOnce는 컷신이 실제로 시작됐을 때만 true를 반환합니다. - 모든 플레이어를 설정합니다. 마지막의
Players:GetPlayers()반복문이 스크립트가 Cutscenes 폴더를 기다리는 동안 들어온 사람들을 모두 챙깁니다.
샷은 작은 테이블의 목록으로, FireClient 한 번에 플레이어에게 갑니다. Roblox의 remote events 페이지는 숫자 키와 문자열 키가 섞인 테이블을 보내지 말라고 합니다. 이 목록에는 숫자 키만 있고 안의 각 샷에는 문자열 키만 있으므로, 그 페이지가 권하는 형태입니다.
3단계: 컷신을 재생하는 LocalScript 추가하기
- Explorer에서 StarterPlayer를 펼치고 StarterPlayerScripts에 마우스를 올려
CutscenePlayer라는 이름의 LocalScript를 넣으세요. - 내용을 아래 코드로 바꾸세요.
-- StarterPlayer > StarterPlayerScripts 안의 CutscenePlayer라는 이름의 LocalScript.
-- 서버가 보내는 컷신을 재생합니다: 검은 띠, 자막, Skip 버튼, 그리고
-- 샷에서 샷으로 날아가는 카메라. 그다음 카메라를 플레이어에게 돌려줍니다.
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local StarterGui = game:GetService("StarterGui")
local TweenService = game:GetService("TweenService")
local UserInputService = game:GetService("UserInputService")
local cutsceneEvent = ReplicatedStorage:WaitForChild("CutsceneEvent") :: RemoteEvent
local player = Players.LocalPlayer
local camera = workspace.CurrentCamera
local BAR_HEIGHT = 0.12 -- 각 검은 띠, 화면 높이에 대한 비율
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- Roblox가 가장 자세히 그려야 할 카메라 앞쪽 거리(스터드)
local HIDDEN_CORE_GUIS = { Enum.CoreGuiType.PlayerList, Enum.CoreGuiType.Backpack, Enum.CoreGuiType.Health }
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
type Shot = { cframe: CFrame, move: number, hold: number, caption: string }
-- 컷신 화면: 검은 띠 두 개와 자막, 가장자리에서 가장자리까지. Roblox는 ScreenInsets None을
-- 아무도 누르지 않는 것에만 쓰라고 권하므로, 아래의 Skip에는 따로 ScreenGui가 있습니다.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- 전체 화면
gui.DisplayOrder = 10
gui.Enabled = false
local topBar = Instance.new("Frame")
topBar.Size = UDim2.fromScale(1, BAR_HEIGHT)
topBar.BackgroundColor3 = Color3.new(0, 0, 0)
topBar.BorderSizePixel = 0
topBar.Parent = gui
local bottomBar = topBar:Clone()
bottomBar.Position = UDim2.fromScale(0, 1 - BAR_HEIGHT)
bottomBar.Parent = gui
local caption = Instance.new("TextLabel")
caption.Size = UDim2.fromScale(0.7, 0.5)
caption.Position = UDim2.fromScale(0.15, 0.25)
caption.BackgroundTransparency = 1
caption.TextColor3 = Color3.new(1, 1, 1)
caption.TextScaled = true
caption.FontFace = REGULAR
caption.Text = ""
caption.Parent = bottomBar
-- Skip 버튼은 기본 여백을 쓰므로 카메라 노치가 가리지 않습니다
local controls = Instance.new("ScreenGui")
controls.Name = "CutsceneControls"
controls.ResetOnSpawn = false
controls.DisplayOrder = 11
controls.Enabled = false
local skipButton = Instance.new("TextButton")
skipButton.AnchorPoint = Vector2.new(1, 0.5)
skipButton.Size = UDim2.fromScale(0.1, BAR_HEIGHT * 0.5)
skipButton.Position = UDim2.new(1, -16, 1 - BAR_HEIGHT / 2, 0) -- 아래 띠 위, 오른쪽
skipButton.BackgroundColor3 = Color3.fromRGB(60, 60, 60)
skipButton.TextColor3 = Color3.new(1, 1, 1)
skipButton.TextScaled = true
skipButton.FontFace = BOLD
skipButton.Text = "Skip"
skipButton.Parent = controls
-- 작은 휴대폰에서도 누를 수 있을 만큼 Skip을 크게 유지합니다
local skipMinSize = Instance.new("UISizeConstraint")
skipMinSize.MinSize = Vector2.new(64, 32)
skipMinSize.Parent = skipButton
local playerGui = player:WaitForChild("PlayerGui")
gui.Parent = playerGui
controls.Parent = playerGui
-- 현재 이동: 한 카메라 CFrame에서 다음 CFrame까지 정해진 초 동안
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false
-- 컷신 동안 매 프레임 실행됩니다. Scriptable 카메라의 Focus는 스스로 아무것도
-- 따라가지 않으므로 여기서 함께 설정합니다.
local function updateCamera()
if camera.CameraType ~= Enum.CameraType.Scriptable then
camera.CameraType = Enum.CameraType.Scriptable -- 무언가가 바꿔 놓았습니다, 예를 들어 리스폰
end
local alpha = if moveSeconds > 0 then (os.clock() - moveStart) / moveSeconds else 1
local eased = TweenService:GetValue(alpha, EASING_STYLE, Enum.EasingDirection.InOut)
camera.CFrame = moveFrom:Lerp(moveTo, eased)
camera.Focus = camera.CFrame * CFrame.new(0, 0, -FOCUS_DISTANCE)
end
local function waitOrSkip(seconds: number)
local endTime = os.clock() + seconds
while os.clock() < endTime and not skipRequested do
task.wait()
end
end
local function play(id: number, shots: { Shot })
if busy then
-- 이미 하나가 재생 중이므로, 이 컷신에 대해서는 서버가 바로 고정을 풀게 합니다
cutsceneEvent:FireServer(id)
return
end
busy = true
skipRequested = false
-- 플레이어 목록, 백팩, 체력 바를 숨기고, 무엇이 보였는지 기억합니다
local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
for _, coreGui in HIDDEN_CORE_GUIS do
wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
StarterGui:SetCoreGuiEnabled(coreGui, false)
end
-- 휴대폰에서는 아래 모서리에 있는 스틱과 점프 버튼을 숨깁니다
local touchControlsWere = GuiService.TouchControlsEnabled
GuiService.TouchControlsEnabled = false
gui.Enabled = true
controls.Enabled = true
-- 게임패드는 선택된 버튼만 누를 수 있으므로, 게임패드 플레이어에게는 Skip을 선택해 둡니다
if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = skipButton
end
camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable
moveTo = camera.CFrame
-- Roblox 자체 카메라 업데이트보다 한 단계 뒤, Roblox 카메라 튜토리얼과 같은 방식
RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)
for _, shot in shots do
moveFrom = camera.CFrame -- 각 이동은 카메라가 지금 있는 곳에서 시작합니다
moveTo = shot.cframe
moveStart = os.clock()
moveSeconds = shot.move
caption.Text = shot.caption
waitOrSkip(shot.move + shot.hold)
if skipRequested then
break
end
end
-- 카메라를 플레이어 캐릭터에게 돌려줍니다
RunService:UnbindFromRenderStep("Cutscene")
camera.CameraType = Enum.CameraType.Custom
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if humanoid then
camera.CameraSubject = humanoid
end
if GuiService.SelectedObject == skipButton then
GuiService.SelectedObject = nil
end
gui.Enabled = false
controls.Enabled = false
caption.Text = ""
-- 이 컷신이 끈 것만 다시 켜고, 나머지는 건드리지 않습니다
for coreGui, enabled in wasEnabled do
if enabled then
StarterGui:SetCoreGuiEnabled(coreGui, true)
end
end
if touchControlsWere then
GuiService.TouchControlsEnabled = true
end
cutsceneEvent:FireServer(id) -- 서버가 바로 플레이어의 고정을 풉니다
busy = false
end
skipButton.Activated:Connect(function()
skipRequested = true
end)
cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
play(id, shots)
end)
StarterPlayerScripts의 LocalScript는 접속할 때 플레이어에게 한 번 복사되고, 캐릭터가 리스폰한 뒤에도 계속 실행됩니다. 그래서 두 ScreenGui 모두 ResetOnSpawn이 꺼져 있습니다. 켜 두면 Roblox가 첫 리스폰 때 이것들을 지우는데, 이 스크립트는 다시 만들지 않습니다. 스크립트가 OnClientEvent에 연결되기 전에 도착한 리모트 메시지는 대기열에 쌓였다가 연결된 뒤에 전달되므로, 빨리 스폰된 플레이어도 인트로를 봅니다.
| 부분 | 하는 일 |
|---|---|
ScreenGui Cutscene | 각각 화면 높이의 12%(BAR_HEIGHT)인 검은 띠 두 개와 아래 띠 위의 자막. ScreenInsets None은 띠를 화면 끝까지 늘리고, DisplayOrder 10은 DisplayOrder가 더 낮은 ScreenGui 위에 띠를 그립니다. |
ScreenGui CutsceneControls | 아래 띠 오른쪽에 있는 Skip 버튼만 들어 있으며, UISizeConstraint가 버튼을 최소 64 x 32픽셀로 유지해 휴대폰에서 누르기 쉽게 합니다. ScreenInsets가 기본값이라 내용이 Roblox 상단 바 버튼이나 카메라 노치 아래로 들어가지 않습니다. Roblox는 누를 것이 없는 내용에만 None을 권하므로 Skip은 띠가 있는 ScreenGui에 둘 수 없습니다. |
HIDDEN_CORE_GUIS | SetCoreGuiEnabled로 플레이어 목록, 백팩, 체력 바를 숨기기 전에 GetCoreGuiEnabled로 무엇이 켜져 있었는지 기억하고, 끝날 때는 자기가 끈 것만 다시 켭니다. 게임이 다른 곳에서 백팩을 숨긴다면 숨긴 채로 남고, 컷신 도중에 이것들을 켜는 스크립트(예를 들어 메인 메뉴)를 덮어쓰지도 않습니다. |
TouchControlsEnabled | 휴대폰과 태블릿에서는 play가 컷신 동안 GuiService.TouchControlsEnabled를 false로 설정합니다. 이렇게 하면 Skip과 같은 아래 모서리에 있는 스틱과 점프 버튼이 숨겨지고, 끝나면 원래 켜져 있었을 경우 다시 나타납니다. |
updateCamera | 컷신이 재생되는 동안 매 프레임 실행됩니다. 현재 이동이 얼마나 진행됐는지 계산하고, TweenService:GetValue로 부드럽게 만든 뒤, CFrame:Lerp로 두 샷 사이에 카메라를 놓고, 카메라 앞 30스터드에 Focus를 설정합니다. |
waitOrSkip | 샷의 이동 시간과 머무는 시간을 기다리면서 매 프레임 Skip 플래그를 확인합니다. |
play | 카메라를 Scriptable로 만들고, 샷을 순서대로 재생한 뒤, 카메라를 되돌리고(CameraType은 Custom, CameraSubject는 Humanoid), core GUI와 터치 컨트롤을 다시 켜고, 서버에 컷신 id를 보냅니다. 첫 컷신이 재생되는 동안 두 번째 컷신이 오면 그 id를 바로 돌려보내, 이 기기가 보여 주지 않은 컷신 때문에 서버가 플레이어를 묶어 두지 않게 합니다. |
| Skip 버튼 | Activated는 마우스 클릭, 탭, 그리고 버튼이 선택됐을 때 게임패드의 A 버튼에 반응합니다. 주 입력이 게임패드인 플레이어에게는 play가 컷신 시작 때 Skip을 선택하고 끝날 때 선택을 해제합니다. |
띠를 더 얇거나 두껍게 하려면 BAR_HEIGHT를, 이동의 느낌을 바꾸려면 EASING_STYLE을 바꾸세요(카메라 코드가 제대로 하는 것 참고). 자막과 Skip 버튼에는 TextScaled가 켜져 있어서 글자가 화면에 맞춰 커지고 작아집니다.
4단계: 파트에 닿으면 재생되는 컷신
인트로는 저절로 재생됩니다. 맵의 특정 장소에서 재생되는 컷신, 예를 들어 플레이어가 처음으로 다리에 도착했을 때의 컷신을 만들려면 두 번째 컷신과 트리거 파트를 추가하세요.
- Workspace, Cutscenes 안에
Bridge라는 이름의 Folder를 넣고, 1단계처럼1과2라는 이름으로 샷을 배치하세요. Command Bar 줄에서는Intro대신Bridge를 쓰세요. - Workspace에 마우스를 올리고
CutsceneTriggers라는 이름의 Folder를 넣으세요. - 그 안에
BridgeTrigger라는 이름의 Part를 넣으세요. 플레이어가 닿지 않고는 지나갈 수 없을 만큼 크게 만드세요. 예를 들어 길을 가로지르는 높고 넓은 판입니다. Anchored를 켜고, CanCollide와 CanQuery를 끄고, CanTouch는 켜 둔 채로 Transparency를 1로 설정하세요. CanQuery를 끄면 보이지 않는 판이 레이캐스트, 예를 들어 총 가이드의 사격을 가로막지 않습니다. 터치 이벤트는 CanQuery가 아니라 CanTouch로 제어되므로 트리거는 그래도 작동합니다. - string 타입의
Cutscene속성을 추가하고 값을Bridge로 설정하세요. 재생할 폴더의 이름입니다.
CutsceneService는 서버가 시작될 때 CutsceneTriggers 바로 안에 있는 모든 파트에 Touched를 연결하므로, 트리거는 게임 도중 스크립트로가 아니라 Studio에서 추가하세요. CanTouch가 꺼진 트리거는 Output에 경고를 남기고 건너뜁니다. 스크립트가 그런 파트에 Touched를 연결하면 Roblox가 오류를 내기 때문입니다.
캐릭터가 파트를 통과하는 동안 Touched는 연달아 여러 번 발생합니다. seen 테이블과 "한 번에 컷신 하나" 규칙 덕분에 이것은 서버당 플레이어 한 명에게 컷신 한 번이 됩니다. 다른 컷신 도중에 트리거에 닿은 플레이어는 무시되고, 트리거는 그 플레이어를 위해 계속 준비된 상태로 남습니다.
도로에는 트리거를 두지 마세요. 앉아 있는 플레이어의 HumanoidRootPart는 좌석에 용접되어 있고, 용접된 묶음의 파트 하나가 고정되면 Roblox는 나머지도 함께 고정합니다. 그래서 트리거로 차를 몰고 들어간 플레이어는 컷신이 끝날 때까지 탈것 전체를 승객과 함께 제자리에 묶어 둡니다.
카메라 코드가 제대로 하는 것
Scriptable, 그리고 다시 Custom
Roblox 카메라 스크립트는 CameraType이 Scriptable인 동안 카메라를 움직이거나 갱신하지 않으며, 바로 그 덕분에 CutscenePlayer가 카메라를 배치할 수 있습니다. 끝날 때는 CameraType을 Custom으로 되돌리고, Roblox 카메라 스크립트가 기본으로 따라가는 CameraSubject를 플레이어의 Humanoid로 설정합니다. 이것은 Skip 뒤에도 실행되므로 플레이어가 마지막 샷을 바라본 채로 남는 일은 없습니다.
작은 확인 두 가지가 컷신이 재생되는 동안 주도권을 지킵니다. 컷신 도중 무언가가 CameraType을 다른 값으로 바꾸면, 매 프레임 실행되는 함수가 다음 프레임에 Scriptable로 되돌립니다. 또 스크립트는 컷신을 시작할 때마다 workspace.CurrentCamera를 다시 읽습니다. 현재 Camera가 지워지면 Roblox가 새 Camera를 만들기 때문입니다.
Focus, 매 프레임
Camera.Focus는 엔진에게 조명 같은 작업에서 어느 영역을 우선할지 알려 줍니다. Roblox 카메라 스크립트는 Focus를 CameraSubject에 맞춰 두지만, 카메라가 Scriptable일 때는 그렇지 않습니다. Roblox 레퍼런스는 이 경우 Focus를 매 프레임 갱신하라고 합니다. PointLight 같은 오브젝트의 동적 조명이 포커스에서 멀면 그려지지 않을 수 있기 때문입니다. CutscenePlayer는 카메라 앞 30스터드(FOCUS_DISTANCE)에 Focus를 둡니다. 샷이 더 먼 곳을 바라본다면 이 숫자를 늘리세요.
함수는 RunService:BindToRenderStep으로 매 프레임 그리기 전에, Roblox 자체 카메라 업데이트보다 우선순위 한 단계 뒤(Enum.RenderPriority.Camera.Value + 1)에서 실행됩니다. Roblox 카메라 튜토리얼이 쓰는 우선순위이며, 그래서 컷신은 Roblox 자체 카메라 코드가 실행된 뒤에 카메라를 배치합니다.
TweenService:GetValue로 부드럽게
camera.CFrame에 트윈을 걸어도 카메라는 움직이지만, Focus는 어차피 매 프레임 설정해야 하므로 CutscenePlayer는 같은 함수 안에서 카메라를 직접 움직입니다. 각 이동마다 시간이 얼마나 지났는지 비율(0에서 1)을 계산하고, 그 값을 이징 스타일과 방향과 함께 TweenService:GetValue에 넣은 뒤, CFrame:Lerp로 두 샷 사이 그 비율만큼의 지점에 카메라를 놓습니다. Lerp는 위치를 직선으로 옮기고 회전을 부드럽게 돌립니다. GetValue는 입력을 0과 1 사이로 제한하므로 이동 시간이 끝나면 카메라가 정확히 샷 위에서 멈춥니다.
| EASING_STYLE | 이동의 느낌 |
|---|---|
Enum.EasingStyle.Sine(여기서 사용) | 속도가 사인 곡선을 따라 변해서 부드럽게 출발하고 부드럽게 멈춥니다. |
Enum.EasingStyle.Quad | Sine과 비슷하지만 곡선이 조금 더 가파릅니다. |
Enum.EasingStyle.Linear | 일정한 속도라서 모든 이동이 최고 속도로 시작하고 끝납니다. |
방향 InOut: 이동의 앞 절반에는 이징이 정방향으로, 뒤 절반에는 역방향으로 적용되므로 카메라는 한 샷에서 가속하고 다음 샷을 향해 감속합니다.
스트리밍
새 플레이스에서는 instance streaming이 켜져 있습니다. 기본적으로 플레이어의 기기는 캐릭터 주변 영역만 가지고 있으므로, 맵 반대편을 바라보는 샷은 텅 빈 세상을 보여 줄 수 있습니다. CutsceneService는 Player:RequestStreamAroundAsync로 그 플레이어에게 각 샷 주변 영역을 불러오도록 Roblox에 요청합니다. 첫 샷의 영역은 이벤트를 보내기 전에 최대 2초를 기다리며 불러오고, 다음 샷들의 영역은 카메라가 그쪽으로 날아가기 2초 전에 불러옵니다.
Roblox는 이렇게 하면 영역이 불러와질 가능성이 높지만 확실하지는 않으며, 효과가 일시적이라고 밝힙니다. 중요한 샷은 스트리밍 반경 안에 두거나, 포커스를 치울 때까지 계속 불러와져 있어야 하는 영역에는 서버에서 Player:AddReplicationFocus를 쓰세요. 스트리밍이 꺼져 있으면 기기에 이미 맵 전체가 있고, 각 요청을 감싼 pcall 덕분에 요청이 실패해도 컷신이 멈추지 않습니다.
오래된 컷신 튜토리얼의 문제점
이 가이드를 영상이나 포럼 글과 비교하고 있다면, 중요한 차이점과 각 방법이 왜 문제인지는 다음과 같습니다.
| 튜토리얼 | 문제 | 이 가이드 |
|---|---|---|
camera:Interpolate()로 카메라를 움직입니다 | Roblox는 Interpolate를 더 이상 권장하지 않는다고(deprecated) 표시했고 TweenService로 카메라를 애니메이션하라고 권합니다. | 각 이동을 TweenService:GetValue로 부드럽게 만들고 매 프레임 카메라를 배치합니다. |
camera.CFrame에만 트윈을 겁니다 | Focus가 카메라 스크립트가 남겨 둔 캐릭터 근처에 그대로 있어서, 거기서 먼 동적 조명이 그려지지 않을 수 있습니다(Camera.Focus에 대한 Roblox 레퍼런스). | 렌더 스텝에서 매 프레임 Focus를 설정합니다. |
| 카메라를 되돌리지 않습니다 | 플레이어가 마지막 샷을 바라본 채로 갇힙니다. | 끝날 때 CameraType을 Custom으로, CameraSubject를 Humanoid로 설정하며, Skip 뒤에도 마찬가지입니다. |
LocalScript의 Touched에서 컷신을 시작합니다 | 닿을 때마다 반복되는 것을 막을 방법이 없고, 결정이 플레이어가 조종하는 기기에서 내려집니다. | 서버가 플레이어를 고르고 누가 이미 봤는지 기억합니다. |
| 카메라 파트를 클라이언트에서 읽습니다 | 스트리밍이 켜져 있으면 캐릭터에서 먼 파트가 기기에 아직 없을 수 있습니다. | 서버가 파트를 읽고 CFrame을 보내며, 카메라가 도착하기 조금 전에 각 샷 주변 영역을 요청합니다. |
플레이어가 바꿀 수 있는 것과 없는 것
치터가 자기 기기의 모든 것을 조종한다고 가정하세요. CutscenePlayer를 바꾸거나 지울 수 있고, 아무 값으로나 CutsceneEvent를 보낼 수 있습니다. 컷신에 실제로 걸린 것이 없다면 이것은 거의 아무 의미가 없습니다.
| 치터의 시도 | 결과 |
|---|---|
| 컷신을 건너뛰거나 아예 재생하지 않기 | 가능합니다. 자기 화면이니까요. "컷신을 끝까지 봤다"는 이유로 보상을 주지 마세요. |
아무 값으로나 CutsceneEvent 보내기 | 현재 컷신과 일치하는 숫자만 효과가 있고, 그 효과는 고정이 더 일찍 풀리는 것뿐입니다. |
| 맵 어디에서든 트리거에 닿기 | 가능합니다. 각 기기가 자기 캐릭터를 조종하며, Roblox 보안 문서도 Touched 이벤트 위조를 기기가 할 수 있는 일로 꼽습니다. 그 컷신을 한 번 보게 될 뿐, 다른 일은 일어나지 않습니다. |
| 컷신 도중에 어쨌든 움직이기 | 얻을 것이 없습니다. 고정은 정직한 플레이어가 컷신 도중 걸어가 버리지 않게 할 뿐, 보안 검사가 아닙니다. |
| 리모트로 다른 사람에게 컷신 시작하기 | 불가능합니다. 플레이어에게 CutsceneEvent를 보낼 수 있는 것은 서버뿐이고, 기기가 돌려보낼 수 있는 것은 "이 컷신이 끝났다"뿐입니다. |
컷신이 실제 무언가로 이어진다면, 예를 들어 나중에 열리는 문이나 보스 등장이라면, 기기가 컷신이 끝났다고 알릴 때가 아니라 서버가 자기 타이머에 맞춰 처리하게 하세요.
5단계: 테스트하기
- Command Bar 줄로 Intro 샷 세 개를 배치하세요. 샷 1에는
Caption"Welcome to the village"를, 샷 2에는MoveSeconds2.5와Caption"Find the bridge"를 주고, 샷 3에는 속성을 넣지 마세요. - Play(F5)를 누르세요. 검은 띠가 나타나고, 카메라가 자막과 함께 샷 1로 전환된 뒤 2.5초 동안 샷 2로 날아가고, 이어서 3초 동안 자막 없이 샷 3으로 날아갑니다. 그다음 카메라가 캐릭터 뒤로 돌아오고 플레이어 목록이 다시 나타납니다. 재생되는 동안에는 걸을 수 없습니다.
- 테스트를 멈추고 다시 Play를 누른 뒤, 카메라가 샷 2로 날아가는 동안 Skip을 누르세요. 카메라가 바로 돌아오고 바로 걸을 수 있습니다.
- BridgeTrigger 안으로 걸어 들어가세요. Bridge 컷신이 재생됩니다. 다시 한 번 통과하면 아무 일도 일어나지 않습니다.
- 테스트 모드 드롭다운에서 Server & Clients를 고르고 클라이언트를 2로 설정한 뒤 Play를 누르세요. Client 1이 트리거로 들어가면 Bridge 컷신은 Client 1에서만 재생되고 Client 2는 걸어 다닐 수 있습니다.
Workspace.StreamingEnabled를 켜 둔 채로 샷 하나를 스폰에서 멀리 옮기세요. 카메라가 도착했을 때 주변 환경이 있어야 합니다(가능성이 높지만 보장되지는 않습니다. 스트리밍 참고).- 게임패드는 테스트를 멈추고 Play를 누른 뒤 Controller Emulator(Emulation 탭, 그다음 Controller)를 열고 에뮬레이트한 게임패드로 BridgeTrigger에 들어가세요. Skip이 선택되어 있어야 하므로 A로 컷신을 건너뛸 수 있습니다. Studio의 Device Simulator를 쓴다면(우리가 확인한 2026년 10월 15일 기준 베타입니다. File, Beta Features, New Device Simulator에서 켜고 Studio를 다시 시작하세요), 휴대폰을 고르고 가로로 돌린 뒤 Skip이 카메라 노치 아래로 들어가지 않고 누르기 쉬운지, 컷신 동안 스틱과 점프 버튼이 숨겨지는지 확인하세요.
- 메인 메뉴도 만들었다면 Play를 누르고, 메뉴의 Play 버튼을 누른 뒤 인트로를 끝까지 보세요. 끝난 뒤 플레이어 목록이 다시 화면에 있어야 합니다.
Output 창(Window 메뉴, 그다음 Output)을 계속 열어 두세요. 모든 것이 작동하면 이 스크립트들은 아무것도 출력하지 않으므로, CutsceneService나 CutscenePlayer에서 나온 경고나 빨간 오류는 모두 실제 문제입니다. 자주 생기는 오류를 보세요.
시스템 확장하기
플레이어가 처음 접속할 때만 인트로 보여 주기
seen 테이블은 서버 하나 동안만 유지되므로 다시 접속한 플레이어는 인트로를 또 봅니다. 처음 접속할 때만 보여 주려면 DataStore 튜토리얼의 PlayerData 모듈로 다른 플레이어 데이터와 함께 SeenIntro 같은 플래그를 저장하세요. INTRO_CUTSCENE는 그대로 두고, CutsceneService의 onCharacterAdded에서 인트로를 담당하는 부분을 바꾸세요. PlayerData.Get(player)가 플레이어 데이터를 반환할 때까지 기다리고, data.SeenIntro가 true이면 인트로를 건너뛰고, playOnce(player, INTRO_CUTSCENE)가 true를 반환했을 때만 data.SeenIntro = true로 설정하세요. 데이터를 불러오는 코드에서 인트로를 시작하지 마세요. 데이터가 캐릭터가 스폰되기 전에 불러와질 수 있는데, 캐릭터가 없으면 play는 아무것도 하지 않고, 아무도 보지 않은 인트로에 대해 플래그가 저장됩니다.
컷신에서 연기하는 캐릭터
Studio의 Animation Editor나 Roblox 문서에도 언급되는 Moon Animator 같은 서드파티 애니메이션 플러그인으로 애니메이션을 만들고, 카메라가 그 샷에 도착하면 샷 안의 NPC 리그에서 재생하세요. Animator에 대한 Roblox 레퍼런스에 따르면 NPC 애니메이션은 서버가 불러오고 재생할 때만 복제되므로, 모든 플레이어가 NPC의 연기를 봐야 한다면 서버 Script에서 재생하세요. CutscenePlayer에서 불러오고 재생하면 애니메이션이 복제되지 않는데, 플레이어 한 명만 보는 컷신에는 그것으로 충분합니다. 애니메이션 스크립트 가이드에서 서버 Script로 NPC 애니메이션을 재생하는 방법을 보여 줍니다.
대화
자막은 저절로 흘러가는 짧은 대사에 어울립니다. 플레이어가 대답하고 선택지를 고르는 대화라면 NPC 대화 가이드를 보세요.
메인 메뉴 다음의 인트로
메인 메뉴 가이드는 CharacterAutoLoads를 끄므로, Play를 누르기 전에는 아무도 스폰되지 않습니다. CutsceneService는 플레이어가 처음 스폰될 때 인트로를 재생하므로, 두 시스템을 함께 쓰면 Play 뒤 첫 스폰 때 인트로가 재생됩니다. 메뉴는 캐릭터가 나타날 때 core GUI를 다시 켜는데, 이는 인트로가 이미 재생 중일 때 일어날 수 있으므로 인트로 도중에 플레이어 목록이 보일 수 있습니다. CutscenePlayer는 자기가 숨긴 것만 다시 켜기 때문에 메뉴의 변경은 건드리지 않고, 인트로가 끝난 뒤에도 켜진 채로 남습니다. 메인 메뉴 가이드에서 카메라 파트를 맞추는 Command Bar 요령은 1단계의 것과 같습니다.
라운드 시작 때 맵 둘러보기
다른 서버 스크립트에서 컷신을 시작하려면, 예를 들어 라운드 시스템 가이드에서 라운드 시작 때 맵을 둘러보려면, ServerStorage에 PlayCutscene이라는 이름의 BindableEvent를 추가하세요. CutsceneService 끝에서 그 Event를 play 함수에 연결하고, 라운드 스크립트가 각 플레이어와 컷신 이름으로 그것을 호출하게 하세요. play는 "서버당 한 번" 확인을 건너뛰므로 둘러보기는 매 라운드 재생됩니다.
컷신 플러그인
플러그인은 이 가이드와 함께 쓸 수 있습니다. 컷신 플러그인이 자체 카메라 스크립트를 작성한다면, 카메라를 되돌리는지(CameraType Custom과 CameraSubject), 카메라가 Scriptable인 동안 Focus를 설정하는지 확인하고, 누가 컷신을 볼지는 이 가이드처럼 서버가 정하게 두세요.
자주 발생하는 오류와 해결 방법
Play를 누르기 전에 Output 창(Window 메뉴, 그다음 Output)을 여세요. 컷신 문제 대부분은 거기에 경고를 남기거나, 이름이 일치하지 않아서 생깁니다.
Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'
CutsceneService가 Workspace 바로 안에서 Cutscenes라는 이름의 폴더를 기다리고 있습니다. 1단계처럼 만들고 철자와 대문자 C를 확인하세요. 폴더가 없는 동안 CutsceneService는 CutsceneEvent를 만들지 않으므로 CutscenePlayer도 기다립니다.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'
CutscenePlayer가 CutsceneService가 만드는 리모트를 기다리고 있습니다. CutsceneService가 LocalScript가 아니라 Script인지, ServerScriptService 바로 안에 있는지, 꺼져 있지 않은지, Output에 Cutscenes에 관한 오류나 경고를 남기지 않았는지 확인하세요.
CutsceneService: no folder named Intro in Workspace.Cutscenes
INTRO_CUTSCENE나 트리거의 Cutscene 속성에 적힌 이름이 Workspace.Cutscenes 안의 어떤 폴더와도 일치하지 않습니다. 이름의 대소문자가 중요합니다.
아무것도 재생되지 않고 Output도 비어 있습니다
폴더에 1이라는 이름의 파트가 없거나, 파트가 폴더 바로 안에 있지 않습니다(예를 들어 Model 안에 있음). CutsceneService는 파트 1, 2, 3을 순서대로 읽다가 처음 빠진 번호에서 멈춥니다. 또 각 컷신은 서버당 플레이어 한 명에게 한 번만 재생된다는 점을 기억하세요. 테스트를 멈추고 다시 Play를 누르세요.
카메라가 엉뚱한 곳을 봅니다
카메라는 샷 파트의 앞면과 같은 방향을 봅니다. Studio 카메라를 원하는 장면으로 옮기고 그 샷에 대해 1단계의 Command Bar 줄을 다시 실행하세요.
트리거가 아무것도 하지 않습니다
게임이 시작될 때 트리거 파트가 Workspace.CutsceneTriggers 바로 안에 있는지, CanTouch가 켜져 있는지(꺼져 있으면 Output에 경고가 나옵니다), Cutscene 속성이 Workspace.Cutscenes 안 폴더 이름의 문자열인지 확인하세요. 트리거를 다시 통과해도 아무 일도 없는 것은 의도된 동작입니다.
컷신이 끝난 뒤 카메라가 마지막 샷에 남아 있습니다
CutscenePlayer가 카메라를 되돌리기 전에 오류로 멈췄으니 Output에서 그 스크립트의 빨간 오류를 찾으세요. 계속 CameraType을 Scriptable로 설정하는 다른 스크립트, 예를 들어 아직 연결되어 있는 메뉴 카메라가 카메라를 붙잡고 있을 수도 있습니다.
RoCode로 만들기
직접 만들고 싶지 않다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox와 무관한 독립 제품으로, Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 기능을 설명하면 Studio 플러그인이 내 Explorer에 파트와 스크립트를 만들어 주므로, 채팅 창에서 코드를 복사할 필요가 없습니다.
시작 컷신을 추가해 줘: Intro 폴더와 샷 1부터 3까지 있는 Cutscenes 폴더, Caption 속성에서 가져오는 자막, 검은 띠와 Skip 버튼, 플레이어가 처음 스폰될 때 한 번 재생, 서버가 플레이어를 제자리에 묶어 두고, 끝나면 카메라가 돌아오게.
- 먼저 Search Scripts로 내 플레이스를 살펴볼 수 있습니다. 예를 들어 이미
CameraType을 설정하는 메뉴나 카메라 스크립트가 있는지 확인해 서로 충돌하지 않게 합니다 - Create Instance로 폴더와 트리거 파트를 만들고, 파트에 Caption과 MoveSeconds 같은 속성을 설정합니다
- Create Script로 CutsceneService와 CutscenePlayer를 작성합니다
- 작성한 모든 스크립트를 실행하지 않고 Studio에서 컴파일하는 Check Script로 확인하도록 지시받으며, 변경 묶음마다 앞뒤로 실행 취소 지점을 만듭니다
샷 파트는 Studio 카메라를 각 장면으로 옮겨 가며 직접 배치하고, 그다음 스크립트를 요청하세요. 플러그인 3.9 이상에서는 RoCode가 짧은 플레이 테스트를 실행하고 오류를 읽을 수 있고, 플러그인 3.9.11 이상에서는 테스트 캐릭터를 조종해 게임이 작동하는지 확인할 수 있습니다. 하지만 게임 도중에는 스크린샷을 찍지 않으므로 컷신은 직접 봐야 합니다. 게임 전체를 만드는 순서는 AI로 Roblox 게임을 시스템별로 만드는 방법 페이지에 있습니다. RoCode가 Studio에 연결되는 방법.
자주 묻는 질문
게임에 들어올 때 컷신이 재생되게 하려면 어떻게 하나요?
Workspace.Cutscenes 안의 샷 폴더 이름을 Intro로 하거나 INTRO_CUTSCENE을 내 폴더 이름으로 바꾸세요. CutsceneService가 각 플레이어가 서버에 처음 스폰될 때 재생합니다. 맨 처음 접속할 때만 보여 주려면 데이터 스토어에 플래그를 저장하되, 시스템 확장하기에 설명한 대로 인트로가 시작된 뒤에만 설정하세요.
플러그인 없이 컷신을 만들 수 있나요?
네. 이 가이드는 파트, 속성, 스크립트 두 개만 쓰고, Command Bar 줄이 각 샷을 Studio 카메라가 있는 바로 그 자리에 놓습니다. 그래도 컷신에서 연기하는 캐릭터를 애니메이션할 때는 Moon Animator 같은 플러그인이 편리합니다.
컷신에서 카메라가 왜 움직이지 않나요?
보통 카메라 코드가 서버 Script에 있기 때문입니다. 기기마다 자기 카메라가 있으므로 플레이어의 카메라를 움직일 수 있는 것은 LocalScript뿐입니다. 또 다른 흔한 원인은 CameraType이 Scriptable이 아니어서 Roblox 기본 카메라 스크립트가 계속 카메라를 캐릭터에게 되돌리는 경우입니다.
컷신 동안 플레이어가 움직이지 못하게 하려면 어떻게 하나요?
컷신이 재생되는 동안 서버에서 HumanoidRootPart를 고정하고, 끝나면 고정을 푸세요. CutsceneService가 그렇게 합니다. 고정된 파트는 물리 때문에 움직이지 않습니다. WalkSpeed는 건드리지 않으므로 달리기 스크립트나 속도 게임 패스와 충돌하지 않습니다.
컷신에 Skip 버튼을 추가하려면 어떻게 하나요?
컷신 화면에 TextButton을 놓고 Activated 이벤트를 연결하세요. 이 이벤트는 클릭, 탭, 그리고 버튼이 선택됐을 때 게임패드의 A 버튼에 반응합니다. CutscenePlayer의 Skip은 샷 반복문이 매 프레임 확인하는 플래그를 설정하고, 게임패드 플레이어에게는 스스로 선택되며, 휴대폰의 카메라 노치가 가리지 않도록 기본 여백을 쓰는 별도의 ScreenGui에 있습니다. 컷신 동안에는 스틱과 점프 버튼이 숨겨지므로 Skip 옆에 겹치지 않습니다.
컷신에서 왜 세상이 텅 비어 있나요?
instance streaming이 켜져 있으면 플레이어의 기기에는 캐릭터 근처 영역만 있습니다. CutsceneService처럼 카메라가 도착하기 조금 전에 서버가 각 샷에 대해 player:RequestStreamAroundAsync를 호출하게 하세요. Roblox는 이렇게 하면 영역이 불러와질 가능성이 높지만 확실하지는 않다고 밝히므로, 중요한 샷은 스트리밍 반경 안에 두거나 계속 불러와져 있어야 하는 영역에는 Player:AddReplicationFocus를 쓰세요.
출처와 더 읽을거리
- Roblox Creator Docs: Customize the camera (영어). 클라이언트마다 따로 있는 Camera, Scriptable, CFrame과 Focus
- Roblox Engine API: Camera (영어). CameraType, CameraSubject, 매 프레임 Focus, 더 이상 권장되지 않는 Interpolate
- Roblox Creator Docs: Control the user's camera (영어). 카메라보다 우선순위 한 단계 뒤의 BindToRenderStep
- Roblox Engine API: TweenService:GetValue (영어). 0과 1 사이로 제한된 이징 alpha
- Roblox Engine API: ScreenGui.ScreenInsets (영어). 왜 None은 누를 것이 없는 내용에만 쓰는지
- Roblox Creator Docs: Instance streaming (영어). 새 플레이스에서 기본으로 켜짐, replication focus
- Roblox Creator Docs: Streaming techniques (영어). 이벤트를 보내기 전에 영역 미리 불러오기
- Roblox Engine API: Player:RequestStreamAroundAsync (영어). 보장 없는 일시적 요청
- Roblox Creator Docs: Remote events and callbacks (영어). 메시지 대기열과 보낼 수 있는 테이블
- Roblox Creator Docs: Network ownership, movement validation, and physics (영어). 클라이언트가 자기 캐릭터로 할 수 있는 일, Touched 이벤트 위조 포함
- Roblox Engine API: Animator:LoadAnimation (영어). 어떤 애니메이션이 복제되는지
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.