W skrócie
Umieść LocalScript w ReplicatedFirst. Uruchamia się wcześniej, niż do gracza dotrze cała reszta. W nim utwórz ScreenGui z włączonym IgnoreGuiInset, umieść go w PlayerGui gracza i wywołaj ReplicatedFirst:RemoveDefaultLoadingScreen(). Potem poczekaj na game.Loaded, wczytaj z wyprzedzeniem to, co ważne, przez ContentProvider:PreloadAsync() i zniszcz ScreenGui, gdy skończysz.
- Wystarczająco wcześnie uruchamia się tylko LocalScript w ReplicatedFirst. W StarterGui albo StarterPlayerScripts startuje, gdy większa część gry już się wczytała, i ekran pojawia się za późno.
- Buduj ekran w kodzie albo trzymaj swój gotowy ScreenGui wewnątrz skryptu. Wszystko, co leży w StarterGui, w chwili startu skryptu jeszcze nie dotarło.
- Nie wczytuj całej gry obiekt po obiekcie. Wczytuj paczkami albo tylko te obrazy i dźwięki, które gracz widzi najpierw.
Na tej stronie
Jak działa ładowanie w Roblox
Gdy gracz wchodzi, Roblox pokazuje swój ekran ładowania, a serwer w tym czasie wysyła kopię twojej gry na jego urządzenie. Skrypty twojej gry w większości uruchamiają się, gdy ta kopia już dotarła, a to za późno, żeby coś pokazać w trakcie czekania. ReplicatedFirst to wyjątek: Roblox wysyła jego zawartość graczowi przed wszystkim innym, a LocalScript w środku uruchamia się od razu.
| Element | Co robi |
|---|---|
ReplicatedFirst | Jego LocalScripty trafiają do gracza pierwsze i uruchamiają się, zanim wczyta się reszta gry. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Usuwa domyślny ekran ładowania Roblox, żeby gracze widzieli twój. |
game:IsLoaded() i game.Loaded | Informują, kiedy dotarła pierwsza kopia gry. |
ContentProvider:PreloadAsync() | Czeka, aż pobiorą się obrazy, meshe i dźwięki przekazanych obiektów, żeby gra nie pojawiła się z szarymi teksturami. |
ScreenGui z IgnoreGuiInset | Sam ekran, który zakrywa całe okno, łącznie z paskiem na górze. |
Ekran ładowania nie przyspiesza wczytywania gry. Ukrywa ładowanie i daje graczom na co popatrzeć, a najważniejsze jest to na telefonach i przy wolnym łączu, gdzie domyślny ekran może wisieć dość długo.
Krok 1: dodaj skrypt ekranu ładowania
- W Explorerze najedź kursorem na ReplicatedFirst, kliknij + i wstaw LocalScript.
- Zmień jego nazwę na
LoadingScreeni wklej kod poniżej. - Zamień
TITLEna nazwę swojej gry i kliknij Play.
-- LocalScript w ReplicatedFirst o nazwie LoadingScreen.
-- Zastępuje domyślny ekran ładowania Roblox twoim: tytuł, pasek postępu,
-- przycisk Skip na wolne łącze i płynne zanikanie, gdy gra jest gotowa.
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 -- pokazuj ekran co najmniej tyle, żeby nie mignął
local SKIP_AFTER_SECONDS = 8 -- pokaż przycisk Skip, jeśli ładowanie trwa dłużej
local STEPS = 20 -- ile razy przesuwa się pasek, gdy wczytują się assety
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- Ekran jest budowany w kodzie, więc istnieje, zanim wczyta się cokolwiek innego w grze
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- zakrywaj też pasek na górze ekranu
gui.DisplayOrder = 100 -- nad wszystkimi innymi 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)
-- Czekamy, aż z serwera dotrze pierwsza kopia gry
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Wczytujemy obrazy, meshe i dźwięki z Workspace w STEPS paczkach, przesuwając pasek po każdej
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
-- Płynnie ukrywamy wszystko, potem usuwamy ekran
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 czeka na każdy asset w przekazanych obiektach. Jeśli przekażesz cały Workspace jednym wywołaniem, pasek będzie stał na 0% do samego końca, więc skrypt dzieli go na STEPS paczek i przesuwa pasek po każdej.
Ekran trafia prosto do PlayerGui, bo w chwili uruchomienia tego skryptu StarterGui nie jest jeszcze skopiowany do gracza. ResetOnSpawn jest wyłączony, żeby ekran przetrwał pojawienie się postaci pod nim.
Krok 2: użyj ekranu narysowanego w Studio
Zbudowanie ekranu w kodzie jest szybkie, ale możesz chcieć narysować go w Studio z obrazami i własnym układem. Zrób go jako ScreenGui w StarterGui, nazwij LoadingScreen, potem przeciągnij na LocalScript LoadingScreen w ReplicatedFirst, żeby stał się dzieckiem skryptu i docierał razem z nim. Użyj tego krótszego skryptu zamiast skryptu z kroku 1:
-- LocalScript w ReplicatedFirst o nazwie LoadingScreen, a w nim twój ScreenGui o nazwie
-- LoadingScreen (narysuj go w StarterGui, potem przeciągnij na ten skrypt).
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()
Własne przyciski Roblox, ikony menu i czatu na górze i pasek narzędzi na dole, zawsze są rysowane nad każdym ScreenGui, więc zostają widoczne nad twoim ekranem ładowania. To normalne i gracze mogą otworzyć menu, gdy gra się wczytuje.
Krok 3: sprawdź
- Otwórz okno Output (menu Window, potem Output) i kliknij Play. Powinien pojawić się twój ekran, pasek powinien się zapełnić, a po około
MIN_SECONDSekran płynnie zniknie. - Studio ma już wszystkie assety na twoim komputerze, więc pasek zapełnia się prawie od razu. Ustaw
MIN_SECONDSna 8 i uruchom ponownie, żeby sprawdzić, czy przycisk Skip się pojawia i działa. - Opublikuj grę i wejdź z aplikacji Roblox na telefonie, żeby zobaczyć ekran tak, jak zobaczą go gracze.
Częste błędy i rozwiązania
Jeśli nadal widać domyślny ekran ładowania albo twój nigdy nie znika, najpierw sprawdź te punkty.
Nadal widać domyślny ekran ładowania Roblox
Skrypt nie jest LocalScript w ReplicatedFirst albo wywala się z błędem przed wywołaniem RemoveDefaultLoadingScreen(). Poszukaj w oknie Output czerwonej linii z nazwą LoadingScreen.
Mój ekran pojawia się późno, gdy gra jest już widoczna
Skrypt leży w StarterGui albo StarterPlayerScripts. Przenieś go do ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Skrypt z kroku 2 nie znajduje twojego ScreenGui. Musi być dzieckiem skryptu i nazywać się dokładnie LoadingScreen.
Ekran nigdy nie znika
Coś po game.Loaded wywaliło się z błędem albo nigdy się nie zakończyło. Sprawdź Output; przycisk Skip z kroku 1 jest potrzebny także po to, żeby gracz nigdy nie utknął.
Na górze ekranu widać szparę
Ustaw IgnoreGuiInset na true w ScreenGui, tak jak robią oba skrypty.
Zbuduj to z RoCode
RoCode to agent AI, który działa wewnątrz Roblox Studio przez plugin. Opisujesz ekran, jakiego potrzebujesz, a on buduje go w grze, którą masz otwartą.
Dodaj ekran ładowania z nazwą mojej gry, fioletowym paskiem postępu i przyciskiem Skip, który płynnie przechodzi do gry, gdy się wczyta.
- Pisze LocalScript w ReplicatedFirst i buduje ScreenGui
- Dobiera kolory i czcionkę, o które prosisz, i może użyć ScreenGui, który już narysowałeś
- Sprawdza napisane skrypty wewnątrz Studio, zanim skończy
Kliknąć Play i sprawdzić, czy ekran dobrze wygląda na telefonie i na komputerze, i tak musisz sam. Jak RoCode łączy się ze Studio.
Najczęstsze pytania
Gdzie włożyć skrypt ekranu ładowania w Roblox?
Do ReplicatedFirst, jako LocalScript. To jedyne miejsce, gdzie skrypt uruchamia się przed wczytaniem reszty gry.
Jak usunąć domyślny ekran ładowania Roblox?
Wywołaj game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() z LocalScript w ReplicatedFirst, gdy twój własny ekran jest już pokazany.
Czy ekran ładowania przyspiesza wczytywanie gry?
Nie. Zakrywa czekanie. Żeby je skrócić, używaj mniej obrazów, meshy i dźwięków przy punkcie pojawienia się i rób je lżejszymi.
Dlaczego w Studio mój ekran ładowania pokazuje się tylko na chwilę?
W playteście Studio wszystko jest już na twoim komputerze. Podczas testów zwiększ MIN_SECONDS albo sprawdź opublikowaną grę na telefonie.
Źródła i dalsza lektura
- Roblox Creator Docs: ReplicatedFirst (po angielsku). co uruchamia się pierwsze i RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (po angielsku). PreloadAsync
- Roblox Creator Docs: DataModel (po angielsku). IsLoaded i event Loaded
- Roblox Creator Docs: ScreenGui (po angielsku). IgnoreGuiInset, DisplayOrder i ResetOnSpawn
Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.