要点
把一个 LocalScript 放进 ReplicatedFirst。它会在其他所有内容到达玩家之前运行。在里面创建一个启用了 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 中名为 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
-- 分 STEPS 批预加载 Workspace 中的图片、网格和声音,每批之后推进进度条
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 批,每批之后推进进度条。
界面直接放进 PlayerGui,因为这个脚本运行时,StarterGui 还没有复制给玩家。ResetOnSpawn 是关闭的,这样界面在下方角色出生时也不会消失。
第 2 步:使用在 Studio 中设计的界面
用代码搭建界面很快,但你可能想在 Studio 中用图片和自己的布局来设计它。把它做成 StarterGui 中的一个 ScreenGui,命名为 LoadingScreen,然后拖到 ReplicatedFirst 中的 LoadingScreen LocalScript 上,让它成为脚本的子对象并随脚本一起到达。用下面这个更短的脚本代替第 1 步的脚本:
-- ReplicatedFirst 中名为 LoadingScreen 的 LocalScript,里面是你名为
-- 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。它必须是脚本的子对象,名字必须正好是 LoadingScreen。
界面一直不消失
game.Loaded 之后的某些代码出错了或者一直没有完成。检查 Output;第 1 步中的 Skip 按钮也是为了让玩家永远不会被卡住。
界面顶部有一条空隙
像两个脚本那样,把 ScreenGui 的 IgnoreGuiInset 设为 true。
用 RoCode 构建
RoCode 是通过插件在 Roblox Studio 内工作的 AI 代理。你描述想要的界面,它就会在你打开的场景中把它搭建出来。
添加一个加载界面,显示我的游戏名称、紫色进度条和 Skip 按钮,游戏加载完成后平滑过渡到游戏中。
- 在 ReplicatedFirst 中编写 LocalScript 并搭建 ScreenGui
- 使用你要求的颜色和字体,也可以使用你已经设计好的 ScreenGui
- 完成之前在 Studio 内检查所写的脚本
点击 Play 并检查界面在手机和电脑上是否好看,仍然需要你自己来做。RoCode 如何连接 Studio。
常见问题
Roblox 加载界面的脚本应该放在哪里?
作为 LocalScript 放在 ReplicatedFirst 中。这是唯一一个脚本会在游戏其余部分加载之前运行的地方。
怎么移除 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-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。