重點摘要
把 LocalScript 放在 ReplicatedFirst。它會比其他所有東西更早送到玩家那裡並執行。在裡面建立一個開啟 IgnoreGuiInset 的 ScreenGui,放進玩家的 PlayerGui,然後呼叫 ReplicatedFirst:RemoveDefaultLoadingScreen()。接著等待 game.Loaded,用 ContentProvider:PreloadAsync() 預先載入重要的內容,完成後刪除 ScreenGui。
- 只有 ReplicatedFirst 中的 LocalScript 啟動得夠早。放在 StarterGui 或 StarterPlayerScripts 中,它會在大部分遊戲載入後才啟動,畫面出現得太晚。
- 用程式碼組出畫面,或把你做好的 ScreenGui 放在 Script 裡面。Script 啟動時,StarterGui 中的任何東西都還沒送到。
- 不要一個物件一個物件地預先載入整個遊戲。請分批預先載入,或只載入玩家最先看到的圖片與音效。
Roblox 的載入是怎麼運作的
玩家進入時,Roblox 會在伺服器把你的遊戲副本傳到他的裝置期間,顯示自己的載入畫面。你遊戲中的 Script 大多要等這份副本送達後才會執行,這時才要在等待期間顯示東西已經太晚了。ReplicatedFirst 是例外:Roblox 會比其他東西更早把它的內容送給玩家,裡面的 LocalScript 會立刻執行。
| 項目 | 用途 |
|---|---|
ReplicatedFirst | 其中的 LocalScript 最先送到玩家那裡,並在遊戲其他部分載入前執行。 |
ReplicatedFirst:RemoveDefaultLoadingScreen() | 移除 Roblox 的預設載入畫面,讓玩家看到你的畫面。 |
game:IsLoaded() 與 game.Loaded | 告訴你遊戲的第一份副本什麼時候送達。 |
ContentProvider:PreloadAsync() | 等待傳入物件的圖片、網格與音效下載完成,讓遊戲不會帶著灰色材質出現。 |
開啟 IgnoreGuiInset 的 ScreenGui | 畫面本身,蓋住整個視窗,包括上方的列。 |
載入畫面不會讓遊戲載入得更快。它把載入過程遮起來,讓玩家有東西可看,這在手機與慢速連線上最重要,因為預設畫面可能會掛很久。
步驟 1:加入載入畫面 Script
- 在 Explorer 中把游標移到 ReplicatedFirst 上,按 +,插入一個 LocalScript。
- 把它改名為
LoadingScreen,並貼上下面的程式碼。 - 把
TITLE換成你的遊戲名稱,然後按 Play。
-- ReplicatedFirst 中名為 LoadingScreen 的 LocalScript。
-- 用你的畫面取代 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% 直到最後,所以 Script 把它分成 STEPS 批,每批完成後推進一次進度條。
畫面直接放進 PlayerGui,因為這個 Script 執行時,StarterGui 還沒複製給玩家。ResetOnSpawn 是關閉的,讓畫面在下方的角色重生時仍然保留。
步驟 2:使用在 Studio 中設計的畫面
用程式碼組畫面很快,但你可能想在 Studio 中用圖片和自己的版面來設計它。請在 StarterGui 中把它做成一個 ScreenGui,命名為 LoadingScreen,然後拖到 ReplicatedFirst 中的 LocalScript LoadingScreen 上,讓它成為 Script 的子物件並跟著一起送達。用這段較短的 Script 取代步驟 1 的 Script:
-- ReplicatedFirst 中名為 LoadingScreen 的 LocalScript,裡面放著名為
-- LoadingScreen 的 ScreenGui(在 StarterGui 中設計好,再拖到這個 Script 上)。
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 的預設載入畫面
Script 不是 ReplicatedFirst 中的 LocalScript,或者在呼叫 RemoveDefaultLoadingScreen() 之前就出錯了。請在 Output 視窗中尋找帶有 LoadingScreen 名稱的紅色訊息。
我的畫面出現得太晚,遊戲已經看得到了
Script 放在 StarterGui 或 StarterPlayerScripts 中。請把它移到 ReplicatedFirst。
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
步驟 2 的 Script 找不到你的 ScreenGui。它必須是 Script 的子物件,名稱必須正好是 LoadingScreen。
畫面一直不消失
game.Loaded 之後的某個地方出錯了,或一直沒有完成。請檢查 Output;步驟 1 的 Skip 按鈕也是為了讓玩家永遠不會卡住。
畫面上方有一條縫隙
把 ScreenGui 的 IgnoreGuiInset 設為 true,兩個 Script 都是這樣做的。
用 RoCode 來做
RoCode 是透過外掛程式在 Roblox Studio 中工作的 AI 代理。你描述想要的畫面,它就會在你開啟的場景中組出來。
加入一個載入畫面,顯示我的遊戲名稱、紫色進度條和 Skip 按鈕,遊戲載入完成時平順地切換進遊戲。
- 在 ReplicatedFirst 中撰寫 LocalScript,並組出 ScreenGui
- 套用你要求的顏色與字型,也能使用你已經設計好的 ScreenGui
- 結束前在 Studio 中檢查寫好的 Script
按下 Play,確認畫面在手機與電腦上看起來都不錯,仍然是你的工作。RoCode 如何連接 Studio。
常見問題
Roblox 的載入畫面 Script 要放在哪裡?
以 LocalScript 的形式放在 ReplicatedFirst。這是唯一能讓 Script 在遊戲其他部分載入前執行的地方。
要怎麼移除 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
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。