Pe scurt
Pune un LocalScript în ReplicatedFirst. Rulează înainte ca restul să ajungă la jucător. În el creează un ScreenGui cu IgnoreGuiInset activat, pune-l în PlayerGui-ul jucătorului și apelează ReplicatedFirst:RemoveDefaultLoadingScreen(). Apoi așteaptă game.Loaded, preîncarcă ce e important prin ContentProvider:PreloadAsync() și distruge ScreenGui-ul când termini.
- Destul de devreme rulează doar un LocalScript din ReplicatedFirst. Din StarterGui sau StarterPlayerScripts pornește când cea mai mare parte a jocului s-a încărcat deja, iar ecranul apare prea târziu.
- Construiește ecranul în cod sau ține propriul ScreenGui gata făcut în interiorul scriptului. Tot ce stă în StarterGui nu a sosit încă în momentul pornirii scriptului.
- Nu preîncărca tot jocul obiect cu obiect. Preîncarcă pe loturi sau doar imaginile și sunetele pe care jucătorul le vede primele.
Pe această pagină
Cum funcționează încărcarea în Roblox
Când un jucător intră, Roblox își arată propriul ecran de încărcare cât serverul trimite o copie a jocului tău pe dispozitivul lui. Scripturile jocului tău pornesc în principal după ce această copie a sosit, prea târziu ca să arate ceva în timpul așteptării. ReplicatedFirst e excepția: Roblox îi trimite conținutul jucătorului înaintea oricărui altceva, iar un LocalScript din el pornește imediat.
| Piesă | Ce face |
|---|---|
ReplicatedFirst | LocalScript-urile lui ajung primele la jucător și pornesc înainte să se încarce restul jocului. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Scoate ecranul de încărcare standard Roblox, ca jucătorii să-l vadă pe al tău. |
game:IsLoaded() și game.Loaded | Spun când a sosit prima copie a jocului. |
ContentProvider:PreloadAsync() | Așteaptă să se descarce imaginile, mesh-urile și sunetele obiectelor transmise, ca jocul să nu apară cu texturi gri. |
ScreenGui cu IgnoreGuiInset | Ecranul însuși, care acoperă toată fereastra, inclusiv bara de sus. |
Un ecran de încărcare nu face jocul să se încarce mai repede. Ascunde încărcarea și le dă jucătorilor ceva la care să se uite, iar asta contează cel mai mult pe telefoane și la conexiuni lente, unde ecranul standard poate sta destul de mult.
Pasul 1: adaugă scriptul ecranului de încărcare
- În Explorer treci cu mouse-ul peste ReplicatedFirst, apasă + și inserează un LocalScript.
- Redenumește-l în
LoadingScreenși lipește codul de mai jos. - Înlocuiește
TITLEcu numele jocului tău și apasă Play.
-- LocalScript în ReplicatedFirst cu numele LoadingScreen.
-- Înlocuiește ecranul de încărcare standard Roblox cu al tău: titlu, bară de progres,
-- buton Skip pentru conexiuni lente și o dispariție lină când jocul e gata.
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 -- arătăm ecranul cel puțin atât, ca să nu clipească
local SKIP_AFTER_SECONDS = 8 -- arătăm butonul Skip dacă încărcarea durează mai mult
local STEPS = 20 -- de câte ori avansează bara cât se preîncarcă asset-urile
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- Ecranul se construiește în cod, așa că există înainte să se încarce orice altceva din joc
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- acoperim și bara din partea de sus a ecranului
gui.DisplayOrder = 100 -- peste toate celelalte ScreenGui-uri
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)
-- Așteptăm să vină de la server prima copie a jocului
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Preîncărcăm imaginile, mesh-urile și sunetele din Workspace în STEPS loturi, avansând bara după fiecare
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
-- Ascundem lin totul, apoi ștergem ecranul
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 așteaptă fiecare asset din obiectele transmise. Dacă dai tot Workspace-ul într-un singur apel, bara stă la 0% până la final, așa că scriptul îl împarte în STEPS loturi și avansează bara după fiecare.
Ecranul se pune direct în PlayerGui, pentru că în momentul în care rulează acest script StarterGui încă nu a fost copiat la jucător. ResetOnSpawn e dezactivat, ca ecranul să supraviețuiască apariției personajului de sub el.
Pasul 2: folosește un ecran desenat în Studio
Să construiești ecranul în cod e rapid, dar poate vrei să-l desenezi în Studio, cu imagini și propriul layout. Fă-l ca ScreenGui în StarterGui, numește-l LoadingScreen, apoi trage-l pe LocalScript-ul LoadingScreen din ReplicatedFirst, ca să devină obiect copil al scriptului și să vină împreună cu el. Folosește acest script mai scurt în locul celui de la pasul 1:
-- LocalScript în ReplicatedFirst cu numele LoadingScreen, iar în el ScreenGui-ul tău numit
-- LoadingScreen (desenează-l în StarterGui, apoi trage-l pe acest 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()
Butoanele proprii ale Roblox, iconițele de meniu și de chat de sus și bara de instrumente de jos, se desenează mereu peste orice ScreenGui, așa că rămân vizibile peste ecranul tău de încărcare. E normal, iar jucătorii pot deschide meniul cât se încarcă jocul.
Pasul 3: verifică
- Deschide fereastra Output (meniul Window, apoi Output) și apasă Play. Trebuie să apară ecranul tău, bara să se umple, iar după aproximativ
MIN_SECONDSecranul să dispară lin. - Studio are deja toate asset-urile pe calculatorul tău, așa că bara se umple aproape imediat. Setează
MIN_SECONDSla 8 și pornește din nou, ca să verifici că butonul Skip apare și funcționează. - Publică jocul și intră din aplicația Roblox pe telefon, ca să vezi ecranul așa cum îl vor vedea jucătorii.
Erori frecvente și soluții
Dacă încă apare ecranul de încărcare standard sau al tău nu dispare niciodată, verifică întâi punctele acestea.
Încă apare ecranul de încărcare standard Roblox
Scriptul nu e un LocalScript în ReplicatedFirst sau cade cu o eroare înainte de apelul RemoveDefaultLoadingScreen(). Caută în fereastra Output un rând roșu cu numele LoadingScreen.
Ecranul meu apare târziu, când jocul se vede deja
Scriptul stă în StarterGui sau StarterPlayerScripts. Mută-l în ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Scriptul de la pasul 2 nu-ți găsește ScreenGui-ul. Trebuie să fie obiect copil al scriptului și să se numească exact LoadingScreen.
Ecranul nu dispare niciodată
Ceva de după game.Loaded a căzut cu o eroare sau nu s-a terminat niciodată. Verifică Output; butonul Skip de la pasul 1 există și ca jucătorul să nu rămână niciodată blocat.
În partea de sus a ecranului se vede un spațiu
Setează IgnoreGuiInset la true pe ScreenGui, cum fac ambele scripturi.
Construiește asta cu RoCode
RoCode este un agent AI care lucrează în Roblox Studio printr-un plugin. Descrii ecranul de care ai nevoie, iar el îl construiește în place-ul pe care îl ai deschis.
Adaugă un ecran de încărcare cu numele jocului meu, o bară de progres mov și un buton Skip, care trece lin în joc când acesta s-a încărcat.
- Scrie LocalScript-ul în ReplicatedFirst și construiește ScreenGui-ul
- Alege culorile și fontul pe care le ceri și poate folosi un ScreenGui pe care l-ai desenat deja
- Verifică scripturile scrise în Studio înainte să termine
Să apeși Play și să verifici că ecranul arată bine pe telefon și pe calculator tot tu trebuie. Cum se conectează RoCode la Studio.
Întrebări frecvente
Unde pun scriptul ecranului de încărcare în Roblox?
În ReplicatedFirst, ca LocalScript. E singurul loc unde un script rulează înainte să se încarce restul jocului.
Cum scot ecranul de încărcare standard Roblox?
Apelează game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() dintr-un LocalScript din ReplicatedFirst, când propriul tău ecran e deja afișat.
Face ecranul de încărcare jocul să se încarce mai repede?
Nu. Acoperă așteptarea. Ca s-o scurtezi, folosește mai puține imagini, mesh-uri și sunete lângă punctul de apariție și fă-le mai ușoare.
De ce în Studio ecranul meu de încărcare apare doar o clipă?
Într-un playtest Studio totul e deja pe calculatorul tău. În timpul testelor mărește MIN_SECONDS sau verifică jocul publicat pe un telefon.
Surse și lecturi suplimentare
- Roblox Creator Docs: ReplicatedFirst (în engleză). ce rulează primul și RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (în engleză). PreloadAsync
- Roblox Creator Docs: DataModel (în engleză). IsLoaded și evenimentul Loaded
- Roblox Creator Docs: ScreenGui (în engleză). IgnoreGuiInset, DisplayOrder și ResetOnSpawn
Cum a fost verificat codul: fiecare script de pe această pagină trece printr-o verificare strictă a tipurilor Luau cu definițiile API Roblox (luau-lsp, 20 noiembrie 2026). Verificarea tipurilor prinde nume greșite de API și tipuri greșite, dar nu și greșelile de logică a jocului, așa că testează totul în Studio înainte să publici.