In breve
Metti un LocalScript in ReplicatedFirst. Parte prima che al giocatore arrivi tutto il resto. Al suo interno crea una ScreenGui con IgnoreGuiInset attivo, mettila nella PlayerGui del giocatore e chiama ReplicatedFirst:RemoveDefaultLoadingScreen(). Poi aspetta game.Loaded, precarica le cose importanti con ContentProvider:PreloadAsync() e distruggi la ScreenGui quando hai finito.
- Solo un LocalScript in ReplicatedFirst parte abbastanza presto. In StarterGui o StarterPlayerScripts si avvia quando gran parte del gioco è già caricata, e la schermata appare troppo tardi.
- Costruisci la schermata nel codice oppure tieni la tua ScreenGui già pronta dentro lo script. Tutto ciò che sta in StarterGui non è ancora arrivato quando lo script parte.
- Non precaricare tutto il gioco un oggetto alla volta. Precarica a blocchi, oppure solo le immagini e i suoni che il giocatore vede per primi.
In questa pagina
Come funziona il caricamento su Roblox
Quando un giocatore entra, Roblox mostra la sua schermata di caricamento mentre il server invia una copia del tuo gioco al suo dispositivo. Gli script del tuo gioco partono per lo più quando questa copia è già arrivata, ed è troppo tardi per mostrare qualcosa durante l'attesa. ReplicatedFirst è l'eccezione: Roblox invia il suo contenuto al giocatore prima di tutto il resto, e un LocalScript al suo interno parte subito.
| Elemento | Cosa fa |
|---|---|
ReplicatedFirst | I suoi LocalScript arrivano al giocatore per primi e partono prima che si carichi il resto del gioco. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Toglie la schermata di caricamento predefinita di Roblox, così i giocatori vedono la tua. |
game:IsLoaded() e game.Loaded | Dicono quando è arrivata la prima copia del gioco. |
ContentProvider:PreloadAsync() | Aspetta che vengano scaricati immagini, mesh e suoni degli oggetti passati, così il gioco non appare con texture grigie. |
ScreenGui con IgnoreGuiInset | La schermata stessa, che copre tutta la finestra, compresa la barra in alto. |
Una schermata di caricamento non rende più veloce il caricamento del gioco. Nasconde il caricamento e dà ai giocatori qualcosa da guardare, e conta soprattutto sui telefoni e con connessioni lente, dove la schermata predefinita può restare a lungo.
Passo 1: aggiungi lo script della schermata di caricamento
- Nell'Explorer passa il mouse su ReplicatedFirst, clicca su + e inserisci un LocalScript.
- Rinominalo in
LoadingScreene incolla il codice qui sotto. - Sostituisci
TITLEcon il nome del tuo gioco e premi Play.
-- LocalScript in ReplicatedFirst chiamato LoadingScreen.
-- Sostituisce la schermata di caricamento predefinita di Roblox con la tua: titolo, barra di avanzamento,
-- pulsante Skip per le connessioni lente e dissolvenza quando il gioco è pronto.
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 -- mostra la schermata almeno per questo tempo, così non lampeggia
local SKIP_AFTER_SECONDS = 8 -- mostra il pulsante Skip se il caricamento dura di più
local STEPS = 20 -- quante volte avanza la barra mentre si precaricano gli asset
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- La schermata è costruita nel codice, quindi esiste prima che si carichi qualsiasi altra cosa del gioco
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- copri anche la barra in cima allo schermo
gui.DisplayOrder = 100 -- sopra tutte le altre 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)
-- Aspettiamo che dal server arrivi la prima copia del gioco
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Precarichiamo immagini, mesh e suoni del Workspace in STEPS blocchi, facendo avanzare la barra dopo ognuno
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
-- Nascondiamo tutto con una dissolvenza, poi eliminiamo la schermata
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 aspetta ogni asset negli oggetti passati. Se passi tutto il Workspace in una sola chiamata, la barra resta ferma allo 0% fino alla fine, quindi lo script lo divide in STEPS blocchi e fa avanzare la barra dopo ognuno.
La schermata va direttamente nella PlayerGui, perché quando questo script parte StarterGui non è ancora stato copiato al giocatore. ResetOnSpawn è disattivato, così la schermata sopravvive alla comparsa del personaggio sotto di essa.
Passo 2: usa una schermata disegnata in Studio
Costruire la schermata nel codice è veloce, ma potresti volerla disegnare in Studio con immagini e un layout tuo. Creala come ScreenGui in StarterGui, chiamala LoadingScreen, poi trascinala sul LocalScript LoadingScreen in ReplicatedFirst, così diventa figlia dello script e arriva insieme a lui. Usa questo script più breve al posto di quello del passo 1:
-- LocalScript in ReplicatedFirst chiamato LoadingScreen, e al suo interno la tua ScreenGui chiamata
-- LoadingScreen (disegnala in StarterGui, poi trascinala su questo 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()
I pulsanti di Roblox stesso, le icone del menu e della chat in alto e la barra degli strumenti in basso, vengono sempre disegnati sopra qualsiasi ScreenGui, quindi restano visibili sopra la tua schermata di caricamento. È normale, e i giocatori possono aprire il menu mentre il gioco si carica.
Passo 3: provala
- Apri la finestra Output (menu Window, poi Output) e premi Play. Deve apparire la tua schermata, la barra si riempie e dopo circa
MIN_SECONDSla schermata svanisce. - Studio ha già tutti gli asset sul tuo computer, quindi la barra si riempie quasi subito. Imposta
MIN_SECONDSa 8 e avvia di nuovo per controllare che il pulsante Skip compaia e funzioni. - Pubblica il gioco ed entra dall'app Roblox sul telefono per vedere la schermata come la vedranno i giocatori.
Errori comuni e soluzioni
Se appare ancora la schermata di caricamento predefinita o la tua non sparisce mai, controlla prima questi punti.
Appare ancora la schermata di caricamento predefinita di Roblox
Lo script non è un LocalScript in ReplicatedFirst, oppure va in errore prima di chiamare RemoveDefaultLoadingScreen(). Cerca nella finestra Output una riga rossa con il nome LoadingScreen.
La mia schermata appare tardi, quando il gioco è già visibile
Lo script è in StarterGui o StarterPlayerScripts. Spostalo in ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
Lo script del passo 2 non trova la tua ScreenGui. Deve essere figlia dello script e chiamarsi esattamente LoadingScreen.
La schermata non sparisce mai
Qualcosa dopo game.Loaded è andato in errore o non è mai finito. Controlla l'Output; il pulsante Skip del passo 1 serve anche a far sì che il giocatore non resti mai bloccato.
In cima allo schermo si vede uno spazio vuoto
Imposta IgnoreGuiInset a true nella ScreenGui, come fanno entrambi gli script.
Costruiscilo con RoCode
RoCode è un agente IA che lavora dentro Roblox Studio tramite un plugin. Descrivi la schermata che vuoi e la costruisce nel place che hai aperto.
Aggiungi una schermata di caricamento con il nome del mio gioco, una barra di avanzamento viola e un pulsante Skip, che passi gradualmente al gioco quando è caricato.
- Scrive il LocalScript in ReplicatedFirst e costruisce la ScreenGui
- Usa i colori e il font che chiedi, e può usare una ScreenGui che hai già disegnato
- Controlla gli script che ha scritto dentro Studio prima di finire
Premere Play e controllare che la schermata stia bene su telefono e computer tocca comunque a te. Come RoCode si collega a Studio.
Domande frequenti
Dove metto lo script della schermata di caricamento su Roblox?
In ReplicatedFirst, come LocalScript. È l'unico posto in cui uno script parte prima che si carichi il resto del gioco.
Come tolgo la schermata di caricamento predefinita di Roblox?
Chiama game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() da un LocalScript in ReplicatedFirst quando la tua schermata è già visibile.
Una schermata di caricamento rende più veloce il caricamento del gioco?
No. Copre l'attesa. Per ridurla, usa meno immagini, mesh e suoni vicino al punto di spawn e rendili più leggeri.
Perché in Studio la mia schermata di caricamento si vede solo per un attimo?
Nel playtest di Studio è già tutto sul tuo computer. Durante i test aumenta MIN_SECONDS oppure prova il gioco pubblicato sul telefono.
Fonti e letture
- Roblox Creator Docs: ReplicatedFirst (in inglese). cosa parte per primo e RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (in inglese). PreloadAsync
- Roblox Creator Docs: DataModel (in inglese). IsLoaded e l'evento Loaded
- Roblox Creator Docs: ScreenGui (in inglese). IgnoreGuiInset, DisplayOrder e ResetOnSpawn
Come è stato controllato il codice: ogni script di questa pagina supera il controllo dei tipi rigoroso di Luau con le definizioni dell'API di Roblox (luau-lsp, 20 novembre 2026). Il controllo dei tipi trova API scritte male e tipi sbagliati, non la logica del gioco, quindi provalo in Studio prima di pubblicare.