Tutorial · Sistemi di gioco

Come fare una schermata di caricamento personalizzata in Roblox Studio

Una schermata di caricamento personalizzata è una ScreenGui che un LocalScript in ReplicatedFirst mostra nel momento in cui il giocatore entra, prima ancora che arrivi il resto del gioco. In questa guida la costruisci nel codice: il tuo titolo, una barra di avanzamento mentre si precaricano immagini e suoni, un pulsante Skip per le connessioni lente e un passaggio graduale al gioco.

Aggiornato il 20 novembre 20265 min di letturaScritto da

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
  1. Come funziona
  2. 1. Lo script
  3. 2. Il tuo design
  4. 3. Prova
  5. Common errors
  6. With RoCode
  7. Domande frequenti
  8. Fonti e letture

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.

Cosa usa lo script della schermata di caricamento
ElementoCosa fa
ReplicatedFirstI 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.LoadedDicono 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 IgnoreGuiInsetLa 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

  1. Nell'Explorer passa il mouse su ReplicatedFirst, clicca su + e inserisci un LocalScript.
  2. Rinominalo in LoadingScreen e incolla il codice qui sotto.
  3. Sostituisci TITLE con il nome del tuo gioco e premi Play.
LocalScript in ReplicatedFirst chiamato LoadingScreen
-- 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
-- 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

  1. Apri la finestra Output (menu Window, poi Output) e premi Play. Deve apparire la tua schermata, la barra si riempie e dopo circa MIN_SECONDS la schermata svanisce.
  2. Studio ha già tutti gli asset sul tuo computer, quindi la barra si riempie quasi subito. Imposta MIN_SECONDS a 8 e avvia di nuovo per controllare che il pulsante Skip compaia e funzioni.
  3. 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.

Tu scrivi

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.

RoCode fa
  • 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

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.

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.