Tutorial · Sistemas de jogo

Como fazer uma tela de carregamento personalizada no Roblox Studio

Uma tela de carregamento personalizada é uma ScreenGui que um LocalScript no ReplicatedFirst mostra no momento em que o jogador entra, antes de o resto do jogo chegar. Este guia monta uma pelo código: o seu título, uma barra de progresso enquanto imagens e sons pré-carregam, um botão Skip para conexões lentas e um fade para dentro do jogo.

Atualizado em 12 de novembro de 20265 min de leituraEscrito por

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
  1. Como funciona
  2. 1. O script
  3. 2. Seu próprio design
  4. 3. Testar
  5. Erros comuns
  6. Com o RoCode
  7. Perguntas frequentes
  8. Fontes e leitura extra

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.

O que um script de tela de carregamento usa
PeçaO que faz
ReplicatedFirstOs 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.LoadedAvisam 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 IgnoreGuiInsetA 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

  1. No Explorer, passe o mouse sobre ReplicatedFirst, clique em + e insira um LocalScript.
  2. Renomeie para LoadingScreen e cole o código abaixo.
  3. Troque TITLE pelo nome do seu jogo e aperte Play.
LocalScript em ReplicatedFirst chamado LoadingScreen
-- 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 em ReplicatedFirst chamado LoadingScreen
-- 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

  1. 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.
  2. O Studio já tem todos os assets no seu computador, então a barra enche quase na hora. Mude MIN_SECONDS para 8 e jogue de novo para conferir se o botão Skip aparece e funciona.
  3. 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.

Você digita

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.

O RoCode faz
  • 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

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.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.