Resumo
Coloque um LocalScript no ReplicatedFirst. Ele roda antes de qualquer outra coisa chegar ao jogador. Nele, crie uma ScreenGui com IgnoreGuiInset ligado, coloque como filha do PlayerGui do jogador e chame ReplicatedFirst:RemoveDefaultLoadingScreen(). Depois espere o game.Loaded, pré-carregue o que importa com ContentProvider:PreloadAsync() e destrua a ScreenGui quando terminar.
- Só um LocalScript no ReplicatedFirst roda cedo o bastante. No StarterGui ou no StarterPlayerScripts ele começa depois que a maior parte do jogo já carregou, então a tela aparece tarde demais.
- Monte a tela pelo código, ou guarde a sua ScreenGui desenhada dentro do script. Nada no StarterGui chegou ainda quando o script começa.
- Não pré-carregue o jogo inteiro um objeto de cada vez. Pré-carregue em lotes, ou só as imagens e os sons que o jogador vê primeiro.
Nesta página
Como o carregamento funciona no Roblox
Quando um jogador entra, o Roblox mostra a própria tela de carregamento enquanto o servidor envia uma cópia do seu jogo para o dispositivo dele. A maioria dos scripts do seu jogo só começa quando essa cópia chega, o que é tarde demais para mostrar algo durante a espera. O ReplicatedFirst é a exceção: o Roblox envia o conteúdo dele ao jogador antes de tudo, e um LocalScript dentro dele começa na hora.
| Peça | O que faz |
|---|---|
ReplicatedFirst | Os LocalScripts dele chegam primeiro ao jogador e rodam antes de o resto do jogo carregar. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | Remove a tela de carregamento padrão do Roblox, para que a sua seja a que os jogadores veem. |
game:IsLoaded() e game.Loaded | Avisam quando a primeira cópia do jogo chegou. |
ContentProvider:PreloadAsync() | Espera até as imagens, meshes e sons dos objetos que você passar terminarem de baixar, para o jogo não aparecer com texturas cinzas. |
Uma ScreenGui com IgnoreGuiInset | A própria tela, cobrindo a janela inteira, incluindo a faixa do topo. |
Uma tela de carregamento não faz o jogo carregar mais rápido. Ela esconde o carregamento e dá aos jogadores algo para olhar, o que importa mais em celulares e conexões lentas, onde a tela padrão pode ficar um bom tempo.
Passo 1: Adicione o script da tela de carregamento
- No Explorer, passe o mouse sobre ReplicatedFirst, clique em + e insira um LocalScript.
- Renomeie para
LoadingScreene cole o código abaixo. - Troque
TITLEpelo nome do seu jogo e aperte Play.
-- LocalScript no ReplicatedFirst chamado LoadingScreen.
-- Troca a tela de carregamento padrão do Roblox pela sua: um título, uma barra de progresso,
-- um botão Skip para conexões lentas e um fade quando o jogo está 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 a tela pelo menos por este tempo, para ela nunca só piscar
local SKIP_AFTER_SECONDS = 8 -- oferece um botão Skip quando o carregamento demora mais que isso
local STEPS = 20 -- quantas vezes a barra anda enquanto os assets pré-carregam
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui
-- A tela é montada no código, então existe antes de qualquer outra coisa do jogo carregar
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- cobre também a faixa no topo da tela
gui.DisplayOrder = 100 -- na frente de todas as outras 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)
-- Espera até a primeira cópia do jogo chegar do servidor
if not game:IsLoaded() then
game.Loaded:Wait()
end
-- Pré-carrega as imagens, meshes e sons do Workspace em STEPS lotes, movendo a barra depois de cada um
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
-- Faz tudo sumir em fade, depois remove a tela
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()
O PreloadAsync espera por todos os assets dos objetos que recebe. Passar o Workspace inteiro em uma chamada deixaria a barra parada em 0% até o fim, então o script divide em STEPS lotes e move a barra depois de cada um.
A tela vai direto para o PlayerGui porque o StarterGui ainda não foi copiado para o jogador quando este script roda. O ResetOnSpawn fica desligado para a tela sobreviver ao personagem nascendo por baixo dela.
Passo 2: Use uma tela que você desenhou no Studio
Montar a tela pelo código é rápido, mas talvez você queira desenhá-la no Studio com imagens e o seu próprio layout. Desenhe como uma ScreenGui no StarterGui, chame de LoadingScreen e arraste para cima do LocalScript LoadingScreen no ReplicatedFirst, para ela virar filha do script e chegar junto com ele. Use este script mais curto no lugar do Passo 1:
-- LocalScript no ReplicatedFirst chamado LoadingScreen, com a sua própria ScreenGui chamada
-- LoadingScreen dentro dele (desenhe no StarterGui e depois arraste para cima deste 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()
Os botões do próprio Roblox, os ícones de menu e chat no topo e a barra de ferramentas embaixo, sempre aparecem na frente de toda ScreenGui, então continuam visíveis sobre a sua tela de carregamento. Isso é normal, e os jogadores ainda podem abrir o menu enquanto o jogo carrega.
Passo 3: Teste
- Abra a janela Output (menu Window, depois Output) e aperte Play. A sua tela deve aparecer, a barra deve encher, e a tela deve sumir depois de mais ou menos
MIN_SECONDS. - O Studio já tem todos os assets no seu computador, então a barra enche quase na hora. Mude
MIN_SECONDSpara 8 e jogue de novo para conferir se o botão Skip aparece e funciona. - Publique e entre pelo app do Roblox em um celular para ver a tela como os jogadores vão ver.
Erros comuns e como resolver
Se a tela de carregamento padrão ainda aparece, ou se a sua nunca some, confira estes pontos primeiro.
A tela de carregamento padrão do Roblox ainda aparece
O script não é um LocalScript no ReplicatedFirst, ou ele dá erro antes de chegar ao RemoveDefaultLoadingScreen(). Procure no Output uma linha vermelha com o nome LoadingScreen.
A minha tela aparece tarde, depois que o jogo já está visível
O script está no StarterGui ou no StarterPlayerScripts. Mova para o ReplicatedFirst.
Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'
O script do Passo 2 não acha a sua ScreenGui. Ela precisa ser filha do script e se chamar exatamente LoadingScreen.
A tela nunca some
Algo depois do game.Loaded deu erro ou nunca terminou. Confira o Output; o botão Skip do Passo 1 também existe para nenhum jogador ficar preso.
Aparece um espaço no topo da tela
Defina IgnoreGuiInset como true na ScreenGui, como os dois scripts fazem.
Crie com o RoCode
O RoCode é um agente de IA que trabalha dentro do Roblox Studio por meio de um plugin. Você descreve a tela que quer, e ele a constrói no jogo que você tem aberto.
Adicione uma tela de carregamento com o nome do meu jogo, uma barra de progresso roxa e um botão Skip, que some em fade para dentro do jogo quando ele carregar.
- Escreve o LocalScript no ReplicatedFirst e monta a ScreenGui
- Usa as cores e a fonte que você pedir, e pode reaproveitar uma ScreenGui que você já desenhou
- Confere os scripts que escreveu dentro do Studio antes de terminar
Você ainda aperta Play e confere se a tela fica boa no celular e no computador. Como o RoCode se conecta ao Studio.
Perguntas frequentes
Onde eu coloco o script de tela de carregamento no Roblox?
No ReplicatedFirst, como LocalScript. É o único lugar em que um script roda antes de o resto do jogo carregar.
Como eu tiro a tela de carregamento padrão do Roblox?
Chame game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() de um LocalScript no ReplicatedFirst, depois que a sua tela estiver aparecendo.
Uma tela de carregamento faz o meu jogo carregar mais rápido?
Não. Ela cobre a espera. Para encurtar a espera, use menos imagens, meshes e sons, e menores, perto do spawn.
Por que a minha tela de carregamento só aparece por um instante no Studio?
Em um teste no Studio tudo já está no seu computador. Aumente MIN_SECONDS enquanto testa, ou teste o jogo publicado em um celular.
Fontes e leitura extra
- Roblox Creator Docs: ReplicatedFirst (em inglês). o que roda primeiro e o RemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (em inglês). PreloadAsync
- Roblox Creator Docs: DataModel (em inglês). IsLoaded e o evento Loaded
- Roblox Creator Docs: ScreenGui (em inglês). IgnoreGuiInset, DisplayOrder e ResetOnSpawn
Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 12 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.