요약
ReplicatedFirst에 LocalScript를 넣으세요. 이 스크립트는 다른 모든 것이 플레이어에게 도착하기 전에 실행됩니다. 그 안에서 IgnoreGuiInset을 켠 ScreenGui를 만들어 플레이어의 PlayerGui에 넣고 ReplicatedFirst:RemoveDefaultLoadingScreen()을 호출합니다. 그다음 game.Loaded를 기다리고, 중요한 것을 ContentProvider:PreloadAsync()로 미리 불러온 뒤, 끝나면 ScreenGui를 없앱니다.
- 충분히 일찍 실행되는 것은 ReplicatedFirst 안의 LocalScript뿐입니다. StarterGui나 StarterPlayerScripts에 두면 게임 대부분이 이미 불러와진 뒤에 시작되어 화면이 너무 늦게 나타납니다.
- 화면은 코드로 만들거나, 직접 만든 ScreenGui를 스크립트 안에 넣어 두세요. StarterGui에 있는 것은 스크립트가 시작될 때 아직 도착하지 않았습니다.
- 게임 전체를 오브젝트 하나씩 미리 불러오지 마세요. 묶음으로 불러오거나, 플레이어가 가장 먼저 보는 이미지와 사운드만 불러오세요.
Roblox에서 로딩이 작동하는 방식
플레이어가 들어오면 Roblox는 서버가 게임 사본을 플레이어 기기로 보내는 동안 자체 로딩 화면을 보여 줍니다. 게임의 스크립트는 대부분 이 사본이 도착한 뒤에 실행되는데, 그때는 기다리는 동안 무언가를 보여 주기엔 너무 늦습니다. ReplicatedFirst는 예외입니다. Roblox는 그 내용을 다른 무엇보다 먼저 플레이어에게 보내고, 그 안의 LocalScript는 바로 실행됩니다.
| 요소 | 하는 일 |
|---|---|
ReplicatedFirst | 그 안의 LocalScript가 가장 먼저 플레이어에게 도착하고, 게임의 나머지가 불러와지기 전에 실행됩니다. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Roblox 기본 로딩 화면을 없애서 플레이어가 내 화면을 보게 합니다. |
game:IsLoaded()와 game.Loaded | 게임의 첫 사본이 도착했는지 알려 줍니다. |
ContentProvider:PreloadAsync() | 넘겨준 오브젝트의 이미지, 메시, 사운드가 다 내려받아질 때까지 기다려서 게임이 회색 텍스처로 나타나지 않게 합니다. |
IgnoreGuiInset을 켠 ScreenGui | 위쪽 바까지 포함해 창 전체를 덮는 화면 자체입니다. |
로딩 화면이 게임 로딩을 빠르게 하지는 않습니다. 로딩을 가리고 플레이어에게 볼거리를 줄 뿐입니다. 이것이 가장 중요한 곳은 휴대폰과 느린 연결 환경으로, 기본 화면이 꽤 오래 떠 있을 수 있습니다.
1단계: 로딩 화면 스크립트 추가하기
- Explorer에서 ReplicatedFirst에 마우스를 올리고 +를 눌러 LocalScript를 넣으세요.
- 이름을
LoadingScreen으로 바꾸고 아래 코드를 붙여 넣으세요. TITLE을 내 게임 이름으로 바꾸고 Play를 누르세요.
-- ReplicatedFirst 안의 LocalScript, 이름은 LoadingScreen.
-- Roblox 기본 로딩 화면을 내 화면으로 바꿉니다: 제목, 진행 바,
-- 느린 연결을 위한 Skip 버튼, 게임이 준비되면 부드럽게 사라지는 효과.
local ContentProvider = game:GetService("ContentProvider")
local Players = game:GetService("Players")
local ReplicatedFirst = game:GetService("ReplicatedFirst")
local TweenService = game:GetService("TweenService")
local TITLE = "My Game"
local MIN_SECONDS = 2 -- 화면이 깜빡이지 않도록 최소한 이만큼은 보여 줌
local SKIP_AFTER_SECONDS = 8 -- 로딩이 이보다 오래 걸리면 Skip 버튼 표시
local STEPS = 20 -- 에셋을 미리 불러오는 동안 바가 움직이는 횟수
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- 화면을 코드로 만들기 때문에 게임의 다른 무엇보다 먼저 존재함
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- 화면 위쪽 바까지 덮기
gui.DisplayOrder = 100 -- 다른 모든 ScreenGui 위에 표시
gui.ResetOnSpawn = false
local background = Instance.new("Frame")
background.Size = UDim2.fromScale(1, 1)
background.BackgroundColor3 = Color3.fromRGB(20, 16, 32)
background.BorderSizePixel = 0
background.Parent = gui
local title = Instance.new("TextLabel")
title.Text = TITLE
title.Font = Enum.Font.GothamBold
title.TextSize = 42
title.TextColor3 = Color3.new(1, 1, 1)
title.BackgroundTransparency = 1
title.AnchorPoint = Vector2.new(0.5, 0.5)
title.Position = UDim2.fromScale(0.5, 0.42)
title.Size = UDim2.fromOffset(600, 60)
title.Parent = background
local barBack = Instance.new("Frame")
barBack.AnchorPoint = Vector2.new(0.5, 0.5)
barBack.Position = UDim2.fromScale(0.5, 0.54)
barBack.Size = UDim2.fromOffset(320, 10)
barBack.BackgroundColor3 = Color3.fromRGB(60, 52, 84)
barBack.BorderSizePixel = 0
barBack.Parent = background
local barFill = Instance.new("Frame")
barFill.Size = UDim2.fromScale(0, 1)
barFill.BackgroundColor3 = Color3.fromRGB(160, 120, 255)
barFill.BorderSizePixel = 0
barFill.Parent = barBack
local status = Instance.new("TextLabel")
status.Text = "Loading..."
status.Font = Enum.Font.Gotham
status.TextSize = 18
status.TextColor3 = Color3.fromRGB(200, 190, 230)
status.BackgroundTransparency = 1
status.AnchorPoint = Vector2.new(0.5, 0)
status.Position = UDim2.fromScale(0.5, 0.57)
status.Size = UDim2.fromOffset(320, 24)
status.Parent = background
local skip = Instance.new("TextButton")
skip.Text = "Skip"
skip.Font = Enum.Font.GothamBold
skip.TextSize = 18
skip.TextColor3 = Color3.new(1, 1, 1)
skip.BackgroundColor3 = Color3.fromRGB(60, 52, 84)
skip.AnchorPoint = Vector2.new(0.5, 0)
skip.Position = UDim2.fromScale(0.5, 0.64)
skip.Size = UDim2.fromOffset(120, 36)
skip.Visible = false
skip.Parent = background
gui.Parent = playerGui
ReplicatedFirst:RemoveDefaultLoadingScreen()
local started = os.clock()
local skipped = false
skip.Activated:Connect(function()
skipped = true
end)
task.delay(SKIP_AFTER_SECONDS, function()
skip.Visible = true
end)
-- 서버에서 게임의 첫 사본이 도착할 때까지 기다림
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Workspace의 이미지, 메시, 사운드를 STEPS개 묶음으로 미리 불러오고, 묶음마다 바를 움직임
local items = workspace:GetDescendants()
local perStep = math.max(1, math.ceil(#items / STEPS))
for first = 1, #items, perStep do
if skipped then
break
end
ContentProvider:PreloadAsync(table.move(items, first, math.min(first + perStep - 1, #items), 1, {}))
local done = math.min(first + perStep - 1, #items) / #items
barFill.Size = UDim2.fromScale(done, 1)
status.Text = string.format("Loading %d%%", math.floor(done * 100))
end
local shownFor = os.clock() - started
if shownFor < MIN_SECONDS and not skipped then
task.wait(MIN_SECONDS - shownFor)
end
-- 모든 것을 부드럽게 숨긴 다음 화면을 삭제
local fade = TweenInfo.new(0.5)
for _, object in gui:GetDescendants() do
if object:IsA("TextLabel") or object:IsA("TextButton") then
TweenService:Create(object, fade, { TextTransparency = 1, BackgroundTransparency = 1 }):Play()
elseif object:IsA("Frame") then
TweenService:Create(object, fade, { BackgroundTransparency = 1 }):Play()
end
end
task.wait(0.5)
gui:Destroy()
PreloadAsync는 넘겨준 오브젝트 안의 에셋을 하나하나 다 기다립니다. Workspace 전체를 한 번에 넘기면 바가 끝날 때까지 0%에 머물러 있으므로, 스크립트는 이를 STEPS개 묶음으로 나누고 묶음마다 바를 움직입니다.
이 스크립트가 실행될 때는 StarterGui가 아직 플레이어에게 복사되지 않았기 때문에 화면을 PlayerGui에 바로 넣습니다. ResetOnSpawn을 꺼서 화면 아래에서 캐릭터가 스폰되어도 화면이 사라지지 않게 합니다.
2단계: Studio에서 디자인한 화면 쓰기
코드로 화면을 만들면 빠르지만, 이미지와 원하는 레이아웃으로 Studio에서 직접 디자인하고 싶을 수도 있습니다. StarterGui에 ScreenGui로 만들고 이름을 LoadingScreen으로 한 다음, ReplicatedFirst의 LoadingScreen LocalScript 위로 끌어다 놓으세요. 그러면 스크립트의 자식이 되어 스크립트와 함께 도착합니다. 1단계 스크립트 대신 이 더 짧은 스크립트를 쓰세요.
-- ReplicatedFirst 안의 LocalScript, 이름은 LoadingScreen이고, 그 안에 이름이
-- LoadingScreen인 내 ScreenGui가 있음 (StarterGui에서 디자인한 뒤 이 스크립트 위로 끌어다 놓기).
local Players = game:GetService("Players")
local ReplicatedFirst = game:GetService("ReplicatedFirst")
local MIN_SECONDS = 2
local playerGui = Players.LocalPlayer:WaitForChild("PlayerGui") :: PlayerGui
local gui = (script:WaitForChild("LoadingScreen") :: ScreenGui):Clone()
gui.IgnoreGuiInset = true
gui.DisplayOrder = 100
gui.ResetOnSpawn = false
gui.Parent = playerGui
ReplicatedFirst:RemoveDefaultLoadingScreen()
local started = os.clock()
if not game:IsLoaded() then
game.Loaded:Wait()
end
local shownFor = os.clock() - started
if shownFor < MIN_SECONDS then
task.wait(MIN_SECONDS - shownFor)
end
gui:Destroy()
Roblox 자체 버튼, 즉 위쪽의 메뉴와 채팅 아이콘, 아래쪽 툴바는 항상 어떤 ScreenGui보다 위에 그려지므로 로딩 화면 위에도 보입니다. 이것은 정상이며, 플레이어는 게임이 불러와지는 동안 메뉴를 열 수 있습니다.
3단계: 테스트하기
- Output 창을 열고(Window 메뉴, 그다음 Output) Play를 누르세요. 내 화면이 나타나고 바가 채워진 뒤, 대략
MIN_SECONDS가 지나면 화면이 부드럽게 사라져야 합니다. - Studio는 이미 모든 에셋을 내 컴퓨터에 가지고 있으므로 바가 거의 바로 채워집니다.
MIN_SECONDS를 8로 설정하고 다시 실행해서 Skip 버튼이 나타나고 작동하는지 확인하세요. - 게임을 퍼블리시하고 휴대폰의 Roblox 앱으로 들어가서 플레이어가 보게 될 화면을 직접 확인하세요.
자주 발생하는 오류와 해결 방법
여전히 기본 로딩 화면이 나오거나 내 화면이 사라지지 않는다면 먼저 다음을 확인하세요.
여전히 Roblox 기본 로딩 화면이 나옵니다
스크립트가 ReplicatedFirst 안의 LocalScript가 아니거나, RemoveDefaultLoadingScreen()을 호출하기 전에 오류로 멈춥니다. Output 창에서 LoadingScreen이라는 이름이 있는 빨간 줄을 찾아보세요.
게임이 이미 보인 뒤에야 내 화면이 늦게 나타납니다
스크립트가 StarterGui나 StarterPlayerScripts에 있습니다. ReplicatedFirst로 옮기세요.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
2단계 스크립트가 내 ScreenGui를 찾지 못합니다. ScreenGui는 스크립트의 자식이어야 하고 이름이 정확히 LoadingScreen이어야 합니다.
화면이 절대 사라지지 않습니다
game.Loaded 이후의 무언가가 오류로 멈췄거나 끝나지 않았습니다. Output을 확인하세요. 1단계의 Skip 버튼은 플레이어가 절대 갇히지 않게 하려는 목적도 있습니다.
화면 위쪽에 틈이 보입니다
두 스크립트처럼 ScreenGui의 IgnoreGuiInset을 true로 설정하세요.
RoCode로 만들어 보기
RoCode는 플러그인을 통해 Roblox Studio 안에서 작동하는 AI 에이전트입니다. 원하는 화면을 설명하면 지금 열려 있는 플레이스에 만들어 줍니다.
내 게임 이름, 보라색 진행 바, Skip 버튼이 있고 게임이 불러와지면 부드럽게 게임으로 넘어가는 로딩 화면을 추가해 줘.
- ReplicatedFirst에 LocalScript를 작성하고 ScreenGui를 만듭니다
- 요청한 색상과 글꼴을 맞추고, 이미 디자인해 둔 ScreenGui를 쓸 수도 있습니다
- 끝내기 전에 작성한 스크립트를 Studio 안에서 검사합니다
Play를 눌러 화면이 휴대폰과 컴퓨터에서 잘 보이는지 확인하는 것은 여전히 직접 해야 합니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
Roblox에서 로딩 화면 스크립트는 어디에 넣나요?
ReplicatedFirst에 LocalScript로 넣으세요. 게임의 나머지가 불러와지기 전에 스크립트가 실행되는 유일한 곳입니다.
Roblox 기본 로딩 화면은 어떻게 없애나요?
내 화면을 이미 보여 준 상태에서, ReplicatedFirst 안의 LocalScript에서 game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen()을 호출하세요.
로딩 화면이 게임 로딩을 빠르게 하나요?
아니요. 기다리는 시간을 가릴 뿐입니다. 기다리는 시간을 줄이려면 스폰 지점 근처의 이미지, 메시, 사운드를 줄이고 더 가볍게 만드세요.
Studio에서 왜 로딩 화면이 잠깐만 보이나요?
Studio 플레이테스트에서는 모든 것이 이미 내 컴퓨터에 있습니다. 테스트하는 동안 MIN_SECONDS를 늘리거나, 퍼블리시한 게임을 휴대폰에서 확인하세요.
출처와 더 읽을거리
- Roblox Creator Docs: ReplicatedFirst (영어). 가장 먼저 실행되는 것과 RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (영어). PreloadAsync
- Roblox Creator Docs: DataModel (영어). IsLoaded와 Loaded 이벤트
- Roblox Creator Docs: ScreenGui (영어). IgnoreGuiInset, DisplayOrder, ResetOnSpawn
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.