Lyhyesti
Laita LocalScript ReplicatedFirstiin. Se käynnistyy ennen kuin mikään muu tavoittaa pelaajan. Luo siinä ScreenGui, jossa IgnoreGuiInset on päällä, laita se pelaajan PlayerGuihin ja kutsu ReplicatedFirst:RemoveDefaultLoadingScreen(). Odota sitten game.Loaded-tapahtumaa, esilataa tärkeät asiat kutsulla ContentProvider:PreloadAsync() ja tuhoa ScreenGui, kun olet valmis.
- Riittävän aikaisin käynnistyy vain LocalScript ReplicatedFirstissä. StarterGuissa tai StarterPlayerScriptsissä se käynnistyy, kun suurin osa pelistä on jo latautunut, ja näyttö ilmestyy liian myöhään.
- Kokoa näyttö koodissa tai säilytä oma valmis ScreenGuisi skriptin sisällä. Mikään StarterGuissa oleva ei ole vielä saapunut, kun skripti käynnistyy.
- Älä esilataa koko peliä objekti kerrallaan. Esilataa erissä tai vain ne kuvat ja äänet, jotka pelaaja näkee ensimmäisinä.
Tällä sivulla
Miten lataus toimii Robloxissa
Kun pelaaja liittyy, Roblox näyttää oman latausnäyttönsä sillä aikaa, kun palvelin lähettää pelisi kopion hänen laitteelleen. Pelisi skriptit käynnistyvät enimmäkseen vasta, kun tämä kopio on saapunut, ja silloin on liian myöhäistä näyttää mitään odotuksen aikana. ReplicatedFirst on poikkeus: Roblox lähettää sen sisällön pelaajalle ennen kaikkea muuta, ja sen sisällä oleva LocalScript käynnistyy heti.
| Osa | Mitä se tekee |
|---|---|
ReplicatedFirst | Sen LocalScriptit tavoittavat pelaajan ensimmäisinä ja käynnistyvät ennen kuin muu peli latautuu. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Poistaa Robloxin oletuslatausnäytön, jotta pelaajat näkevät sinun näyttösi. |
game:IsLoaded() ja game.Loaded | Kertovat, milloin pelin ensimmäinen kopio on saapunut. |
ContentProvider:PreloadAsync() | Odottaa, kunnes annettujen objektien kuvat, meshit ja äänet on ladattu, jotta peli ei ilmesty harmain tekstuurein. |
ScreenGui, jossa IgnoreGuiInset | Itse näyttö, joka peittää koko ikkunan, myös yläpalkin. |
Latausnäyttö ei nopeuta pelin latautumista. Se peittää latauksen ja antaa pelaajille jotain katsottavaa, ja tärkeintä se on puhelimilla ja hitaalla yhteydellä, joilla oletusnäyttö voi roikkua pitkäänkin.
Vaihe 1: lisää latausnäytön skripti
- Vie Explorerissa osoitin ReplicatedFirstin päälle, paina + ja lisää LocalScript.
- Nimeä se uudelleen
LoadingScreenja liitä alla oleva koodi. - Korvaa
TITLEpelisi nimellä ja paina Play.
-- LocalScript ReplicatedFirstissä nimeltä LoadingScreen.
-- Korvaa Robloxin oletuslatausnäytön omallasi: otsikko, edistymispalkki,
-- Skip-painike hitaalle yhteydelle ja pehmeä häivytys, kun peli on valmis.
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 -- näytä näyttöä vähintään näin kauan, ettei se välähdä
local SKIP_AFTER_SECONDS = 8 -- näytä Skip-painike, jos lataus kestää tätä kauemmin
local STEPS = 20 -- kuinka monta kertaa palkki siirtyy assettien esilatauksen aikana
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- Näyttö kootaan koodissa, joten se on olemassa ennen kuin mitään muuta pelissä latautuu
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- peitä myös näytön yläpalkki
gui.DisplayOrder = 100 -- kaikkien muiden ScreenGuiden päällä
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)
-- Odotetaan, kunnes pelin ensimmäinen kopio saapuu palvelimelta
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Esiladataan Workspacen kuvat, meshit ja äänet STEPS erässä ja siirretään palkkia jokaisen jälkeen
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
-- Häivytetään kaikki pehmeästi ja poistetaan sitten näyttö
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 odottaa jokaista annettujen objektien assettia. Jos annat koko Workspacen yhdellä kutsulla, palkki pysyy 0 %:ssa loppuun asti, joten skripti jakaa sen STEPS erään ja siirtää palkkia jokaisen jälkeen.
Näyttö laitetaan suoraan PlayerGuihin, koska StarterGuita ei ole vielä kopioitu pelaajalle, kun tämä skripti käynnistyy. ResetOnSpawn on pois päältä, jotta näyttö säilyy, kun hahmo ilmestyy sen alle.
Vaihe 2: käytä Studiossa piirrettyä näyttöä
Näytön kokoaminen koodissa on nopeaa, mutta saatat haluta piirtää sen Studiossa kuvilla ja omalla asettelulla. Tee se ScreenGuina StarterGuihin, nimeä se LoadingScreen ja vedä se sitten ReplicatedFirstissä olevan LoadingScreen-LocalScriptin päälle, jotta siitä tulee skriptin lapsiobjekti ja se saapuu skriptin mukana. Käytä tätä lyhyempää skriptiä vaiheen 1 skriptin sijaan:
-- LocalScript ReplicatedFirstissä nimeltä LoadingScreen, ja sen sisällä ScreenGuisi nimeltä
-- LoadingScreen (piirrä se StarterGuissa ja vedä se sitten tämän skriptin päälle).
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()
Robloxin omat painikkeet, ylhäällä valikon ja chatin kuvakkeet ja alhaalla työkalupalkki, piirretään aina minkä tahansa ScreenGuin päälle, joten ne näkyvät latausnäyttösi yllä. Tämä on normaalia, ja pelaajat voivat avata valikon pelin latautuessa.
Vaihe 3: testaa
- Avaa Output-ikkuna (Window-valikko, sitten Output) ja paina Play. Näyttösi pitäisi ilmestyä, palkin täyttyä, ja noin
MIN_SECONDSjälkeen näyttö häivytetään pehmeästi. - Studiolla on jo kaikki assetit tietokoneellasi, joten palkki täyttyy lähes heti. Aseta
MIN_SECONDSarvoon 8 ja käynnistä uudelleen tarkistaaksesi, että Skip-painike ilmestyy ja toimii. - Julkaise peli ja liity puhelimen Roblox-sovelluksesta nähdäksesi näytön niin kuin pelaajat sen näkevät.
Yleiset virheet ja ratkaisut
Jos oletuslatausnäyttö näkyy yhä tai omasi ei koskaan katoa, tarkista ensin nämä kohdat.
Robloxin oletuslatausnäyttö näkyy yhä
Skripti ei ole LocalScript ReplicatedFirstissä tai kaatuu virheeseen ennen RemoveDefaultLoadingScreen()-kutsua. Etsi Output-ikkunasta punainen rivi, jossa on nimi LoadingScreen.
Näyttöni ilmestyy myöhään, kun peli näkyy jo
Skripti on StarterGuissa tai StarterPlayerScriptsissä. Siirrä se ReplicatedFirstiin.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Vaiheen 2 skripti ei löydä ScreenGuitasi. Sen täytyy olla skriptin lapsiobjekti ja nimeltään tarkalleen LoadingScreen.
Näyttö ei koskaan katoa
Jokin game.Loaded-tapahtuman jälkeen kaatui virheeseen tai ei koskaan valmistunut. Tarkista Output; vaiheen 1 Skip-painike on olemassa muun muassa siksi, ettei pelaaja koskaan jää jumiin.
Näytön yläreunassa näkyy rako
Aseta ScreenGuin IgnoreGuiInset arvoon true, kuten molemmat skriptit tekevät.
Rakenna tämä RoCodella
RoCode on tekoälyagentti, joka toimii Roblox Studion sisällä lisäosan kautta. Kuvailet haluamasi näytön, ja se kokoaa sen paikkaan, joka sinulla on auki.
Lisää latausnäyttö, jossa on pelini nimi, violetti edistymispalkki ja Skip-painike ja joka siirtyy pehmeästi peliin, kun se on latautunut.
- Kirjoittaa LocalScriptin ReplicatedFirstiin ja kokoaa ScreenGuin
- Valitsee pyytämäsi värit ja fontin ja voi käyttää ScreenGuita, jonka olet jo piirtänyt
- Tarkistaa kirjoittamansa skriptit Studiossa ennen kuin lopettaa
Playn painaminen ja sen tarkistaminen, että näyttö näyttää hyvältä puhelimella ja tietokoneella, jää silti sinulle. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Mihin latausnäytön skripti laitetaan Robloxissa?
ReplicatedFirstiin LocalScriptinä. Se on ainoa paikka, jossa skripti käynnistyy ennen kuin muu peli latautuu.
Miten Robloxin oletuslatausnäyttö poistetaan?
Kutsu game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() ReplicatedFirstissä olevasta LocalScriptistä, kun oma näyttösi on jo esillä.
Nopeuttaako latausnäyttö pelin latautumista?
Ei. Se peittää odotuksen. Lyhentääksesi sitä käytä vähemmän kuvia, meshejä ja ääniä syntymäpisteen lähellä ja tee niistä kevyempiä.
Miksi latausnäyttöni näkyy Studiossa vain hetken?
Studion pelitestissä kaikki on jo tietokoneellasi. Kasvata testien ajaksi MIN_SECONDS-arvoa tai tarkista julkaistu peli puhelimella.
Lähteet ja lisälukemista
- Roblox Creator Docs: ReplicatedFirst (englanniksi). mikä käynnistyy ensin ja RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (englanniksi). PreloadAsync
- Roblox Creator Docs: DataModel (englanniksi). IsLoaded ja Loaded-tapahtuma
- Roblox Creator Docs: ScreenGui (englanniksi). IgnoreGuiInset, DisplayOrder ja ResetOnSpawn
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.