Коротко
Помістіть LocalScript у ReplicatedFirst. Він запускається раніше, ніж до гравця доходить усе інше. У ньому створіть ScreenGui з увімкненим IgnoreGuiInset, помістіть його в PlayerGui гравця і викличте ReplicatedFirst:RemoveDefaultLoadingScreen(). Потім дочекайтеся game.Loaded, попередньо завантажте важливе через ContentProvider:PreloadAsync() і знищте ScreenGui, коли закінчите.
- Досить рано запускається лише LocalScript у ReplicatedFirst. У StarterGui або StarterPlayerScripts він стартує, коли більша частина гри вже завантажилася, і екран з'являється надто пізно.
- Збирайте екран у коді або зберігайте свій готовий ScreenGui всередині скрипту. Усе, що лежить у StarterGui, на момент старту скрипту ще не прийшло.
- Не завантажуйте попередньо всю гру по одному об'єкту. Завантажуйте пачками або лише ті зображення та звуки, які гравець бачить першими.
На цій сторінці
Як влаштоване завантаження в Roblox
Коли гравець заходить, Roblox показує свій екран завантаження, поки сервер надсилає копію вашої гри на його пристрій. Скрипти вашої гри здебільшого запускаються, коли ця копія вже прийшла, а це надто пізно, щоб щось показати під час очікування. ReplicatedFirst це виняток: Roblox надсилає його вміст гравцеві раніше за все інше, і LocalScript усередині нього запускається одразу.
| Деталь | Що робить |
|---|---|
ReplicatedFirst | Його LocalScript потрапляють до гравця першими і запускаються до того, як завантажиться решта гри. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Прибирає стандартний екран завантаження Roblox, щоб гравці бачили ваш. |
game:IsLoaded() і game.Loaded | Повідомляють, коли прийшла перша копія гри. |
ContentProvider:PreloadAsync() | Чекає, поки завантажаться зображення, меші та звуки переданих об'єктів, щоб гра не з'явилася із сірими текстурами. |
ScreenGui з IgnoreGuiInset | Сам екран, який закриває все вікно, включно зі смугою зверху. |
Екран завантаження не пришвидшує завантаження гри. Він приховує завантаження і дає гравцям на що подивитися, а найважливіше це на телефонах і при повільному з'єднанні, де стандартний екран може висіти досить довго.
Крок 1: додайте скрипт екрана завантаження
- В Explorer наведіть курсор на ReplicatedFirst, натисніть + і вставте LocalScript.
- Перейменуйте його на
LoadingScreenі вставте код нижче. - Замініть
TITLEна назву своєї гри і натисніть Play.
-- LocalScript у ReplicatedFirst з назвою 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 пачок і зсуває смугу після кожної.
Екран поміщається просто в PlayerGui, бо на момент запуску цього скрипту StarterGui ще не скопійовано гравцеві. ResetOnSpawn вимкнено, щоб екран пережив появу персонажа під ним.
Крок 2: використайте екран, намальований у Studio
Зібрати екран у коді швидко, але, можливо, ви захочете намалювати його в Studio із зображеннями та своїм розташуванням елементів. Зробіть його як ScreenGui у StarterGui, назвіть LoadingScreen, потім перетягніть на LocalScript LoadingScreen у ReplicatedFirst, щоб він став дочірнім об'єктом скрипту і приходив разом із ним. Використайте цей коротший скрипт замість скрипту з кроку 1:
-- LocalScript у ReplicatedFirst з назвою LoadingScreen, а всередині нього ваш ScreenGui з назвою
-- LoadingScreen (намалюйте його в 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
Скрипт не є LocalScript у ReplicatedFirst або падає з помилкою до виклику RemoveDefaultLoadingScreen(). Пошукайте у вікні Output червоний рядок із назвою LoadingScreen.
Мій екран з'являється пізно, коли гру вже видно
Скрипт лежить у StarterGui або StarterPlayerScripts. Перенесіть його в ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Скрипт із кроку 2 не знаходить ваш ScreenGui. Він має бути дочірнім об'єктом скрипту і називатися точно LoadingScreen.
Екран ніколи не зникає
Щось після game.Loaded упало з помилкою або так і не завершилося. Перевірте Output; кнопка Skip у кроці 1 потрібна зокрема для того, щоб гравець ніколи не застряг.
Зверху екрана видно проміжок
Поставте IgnoreGuiInset у true у ScreenGui, як роблять обидва скрипти.
Зберіть це з RoCode
RoCode це ШІ-агент, який працює всередині Roblox Studio через плагін. Ви описуєте потрібний екран, і він збирає його у відкритому у вас плейсі.
Додай екран завантаження з назвою моєї гри, фіолетовою смугою прогресу і кнопкою Skip, який плавно переходить у гру, коли вона завантажиться.
- Пише LocalScript у ReplicatedFirst і збирає ScreenGui
- Добирає кольори та шрифт, які ви просите, і може використати ScreenGui, який ви вже намалювали
- Перевіряє написані скрипти всередині Studio, перш ніж закінчити
Натиснути Play і перевірити, що екран добре виглядає на телефоні та на комп'ютері, однаково маєте ви. Як RoCode підключається до Studio.
Поширені запитання
Куди покласти скрипт екрана завантаження в Roblox?
У ReplicatedFirst, як LocalScript. Це єдине місце, де скрипт запускається до завантаження решти гри.
Як прибрати стандартний екран завантаження Roblox?
Викличте game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() з LocalScript у ReplicatedFirst, коли ваш власний екран уже показано.
Чи пришвидшує екран завантаження завантаження гри?
Ні. Він закриває очікування. Щоб скоротити його, використовуйте менше зображень, мешів і звуків біля точки появи та робіть їх легшими.
Чому в 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
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.