Kort fortalt
Læg et LocalScript i ReplicatedFirst. Det starter, før alt andet når frem til spilleren. Opret i det en ScreenGui med IgnoreGuiInset slået til, læg den i spillerens PlayerGui, og kald ReplicatedFirst:RemoveDefaultLoadingScreen(). Vent derefter på game.Loaded, forudindlæs det vigtige med ContentProvider:PreloadAsync(), og fjern ScreenGui, når du er færdig.
- Kun et LocalScript i ReplicatedFirst starter tidligt nok. I StarterGui eller StarterPlayerScripts starter det, når det meste af spillet allerede er indlæst, og skærmen kommer for sent.
- Byg skærmen i kode, eller gem din færdige ScreenGui inde i scriptet. Alt i StarterGui er endnu ikke ankommet, når scriptet starter.
- Forudindlæs ikke hele spillet ét objekt ad gangen. Forudindlæs i portioner eller kun de billeder og lyde, spilleren ser først.
På denne side
Sådan foregår indlæsningen i Roblox
Når en spiller kommer ind, viser Roblox sin egen loading screen, mens serveren sender en kopi af dit spil til spillerens enhed. Dit spils scripts starter for det meste, når den kopi er ankommet, og det er for sent til at vise noget under ventetiden. ReplicatedFirst er undtagelsen: Roblox sender dens indhold til spilleren før alt andet, og et LocalScript inde i den starter med det samme.
| Del | Hvad den gør |
|---|---|
ReplicatedFirst | Dens LocalScripts når først frem til spilleren og starter, før resten af spillet er indlæst. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Fjerner Roblox' standard-loading screen, så spillerne ser din. |
game:IsLoaded() og game.Loaded | Fortæller, hvornår den første kopi af spillet er ankommet. |
ContentProvider:PreloadAsync() | Venter, til billeder, meshes og lyde for de givne objekter er downloadet, så spillet ikke dukker op med grå teksturer. |
ScreenGui med IgnoreGuiInset | Selve skærmen, der dækker hele vinduet, inklusive bjælken øverst. |
En loading screen gør ikke spillet hurtigere at indlæse. Den skjuler indlæsningen og giver spillerne noget at se på, og det betyder mest på telefoner og ved langsomme forbindelser, hvor standardskærmen kan hænge et godt stykke tid.
Trin 1: tilføj loading screen-scriptet
- Hold musen over ReplicatedFirst i Explorer, klik på +, og indsæt et LocalScript.
- Omdøb det til
LoadingScreen, og sæt koden nedenfor ind. - Erstat
TITLEmed navnet på dit spil, og tryk på Play.
-- LocalScript i ReplicatedFirst med navnet LoadingScreen.
-- Erstatter Roblox' standard-loading screen med din: titel, statuslinje,
-- Skip-knap til langsomme forbindelser og en blød fade, når spillet er klar.
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 -- vis skærmen mindst så længe, så den ikke bare blinker
local SKIP_AFTER_SECONDS = 8 -- vis Skip-knappen, hvis indlæsningen tager længere tid
local STEPS = 20 -- hvor mange gange linjen rykker, mens assets forudindlæses
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- Skærmen bygges i kode, så den findes, før noget andet i spillet er indlæst
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- dæk også bjælken øverst på skærmen
gui.DisplayOrder = 100 -- oven over alle andre ScreenGuis
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)
-- Vent, til den første kopi af spillet er ankommet fra serveren
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Forudindlæs billeder, meshes og lyde i Workspace i STEPS portioner, og ryk linjen efter hver
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
-- Fade det hele blødt ud, og fjern derefter skærmen
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 venter på hvert asset i de givne objekter. Hvis du giver hele Workspace i ét kald, står linjen på 0% helt til slutningen, så scriptet deler det i STEPS portioner og rykker linjen efter hver.
Skærmen lægges direkte i PlayerGui, fordi StarterGui endnu ikke er kopieret til spilleren, når dette script starter. ResetOnSpawn er slået fra, så skærmen overlever, at karakteren spawner nedenunder.
Trin 2: brug en skærm, du har tegnet i Studio
Det går hurtigt at bygge skærmen i kode, men måske vil du tegne den i Studio med billeder og dit eget layout. Lav den som en ScreenGui i StarterGui, kald den LoadingScreen, og træk den derefter over på LocalScriptet LoadingScreen i ReplicatedFirst, så den bliver et barn af scriptet og ankommer sammen med det. Brug dette kortere script i stedet for scriptet fra trin 1:
-- LocalScript i ReplicatedFirst med navnet LoadingScreen og inde i det din ScreenGui med navnet
-- LoadingScreen (tegn den i StarterGui, og træk den derefter over på dette 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' egne knapper, menu- og chatikonerne øverst og værktøjslinjen nederst, tegnes altid oven over enhver ScreenGui, så de forbliver synlige over din loading screen. Det er helt normalt, og spillerne kan åbne menuen, mens spillet indlæses.
Trin 3: test det
- Åbn vinduet Output (menuen Window og derefter Output), og tryk på Play. Din skærm skal dukke op, linjen fyldes, og efter cirka
MIN_SECONDSfader skærmen blødt ud. - Studio har allerede alle assets på din computer, så linjen fyldes næsten med det samme. Sæt
MIN_SECONDStil 8, og kør igen for at tjekke, at Skip-knappen dukker op og virker. - Udgiv spillet, og gå ind fra Roblox-appen på en telefon for at se skærmen, som spillerne vil se den.
Almindelige fejl og løsninger
Hvis standardskærmen stadig vises, eller din aldrig forsvinder, så tjek først disse punkter.
Roblox' standard-loading screen vises stadig
Scriptet er ikke et LocalScript i ReplicatedFirst, eller det fejler, før RemoveDefaultLoadingScreen() bliver kaldt. Kig efter en rød linje med navnet LoadingScreen i vinduet Output.
Min skærm kommer sent, når spillet allerede er synligt
Scriptet ligger i StarterGui eller StarterPlayerScripts. Flyt det til ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Scriptet fra trin 2 kan ikke finde din ScreenGui. Den skal være et barn af scriptet og hedde præcis LoadingScreen.
Skærmen forsvinder aldrig
Noget efter game.Loaded fejlede eller blev aldrig færdigt. Tjek Output; Skip-knappen i trin 1 er blandt andet til for, at en spiller aldrig sidder fast.
Der er et mellemrum øverst på skærmen
Sæt IgnoreGuiInset til true på ScreenGui, som begge scripts gør.
Byg det med RoCode
RoCode er en AI-agent, der arbejder inde i Roblox Studio via et plugin. Du beskriver den skærm, du vil have, og den bygger den i det place, du har åbent.
Tilføj en loading screen med mit spils navn, en lilla statuslinje og en Skip-knap, der går blødt over i spillet, når det er indlæst.
- Skriver et LocalScript i ReplicatedFirst og bygger ScreenGui
- Vælger de farver og den skrifttype, du beder om, og kan bruge en ScreenGui, du allerede har tegnet
- Tjekker de skrevne scripts inde i Studio, før den slutter
Du skal stadig selv trykke på Play og tjekke, at skærmen ser godt ud på telefon og computer. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvor skal loading screen-scriptet ligge i Roblox?
I ReplicatedFirst, som et LocalScript. Det er det eneste sted, hvor et script starter, før resten af spillet er indlæst.
Hvordan fjerner man Roblox' standard-loading screen?
Kald game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() fra et LocalScript i ReplicatedFirst, når din egen skærm allerede vises.
Gør en loading screen spillet hurtigere at indlæse?
Nej. Den dækker ventetiden. For at gøre den kortere skal du bruge færre billeder, meshes og lyde nær spawnpunktet og gøre dem lettere.
Hvorfor vises min loading screen kun et øjeblik i Studio?
I en playtest i Studio ligger alt allerede på din computer. Hæv MIN_SECONDS under testene, eller tjek det udgivne spil på en telefon.
Kilder og videre læsning
- Roblox Creator Docs: ReplicatedFirst (på engelsk). hvad der starter først, og RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (på engelsk). PreloadAsync
- Roblox Creator Docs: DataModel (på engelsk). IsLoaded og eventet Loaded
- Roblox Creator Docs: ScreenGui (på engelsk). IgnoreGuiInset, DisplayOrder og ResetOnSpawn
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.