Eğitim · Oyun sistemleri

Roblox Studio'da özel yükleme ekranı nasıl yapılır

Özel bir yükleme ekranı, ReplicatedFirst içindeki bir LocalScript'in oyuncu girer girmez, oyununun geri kalanı gelmeden önce gösterdiği bir ScreenGui'dir. Bu rehber onu kodla kuruyor: senin başlığın, resimler ve sesler önceden yüklenirken bir ilerleme çubuğu, yavaş bağlantılar için bir Skip butonu ve oyuna doğru bir solma efekti.

Güncellendi: 20 Kasım 20264 dk okumaYazan:

Kısaca

ReplicatedFirst içine bir LocalScript koy. Oyuncuya başka herhangi bir şey ulaşmadan önce çalışır. İçinde IgnoreGuiInset açık bir ScreenGui oluştur, onu oyuncunun PlayerGui'sinin child'ı yap ve ReplicatedFirst:RemoveDefaultLoadingScreen()'u çağır. Sonra game.Loaded'ı bekle, önemli şeyleri ContentProvider:PreloadAsync() ile önceden yükle ve işin bitince ScreenGui'yi yok et.

  • Yeterince erken çalışan tek şey ReplicatedFirst içindeki bir LocalScript. StarterGui ya da StarterPlayerScripts içinde, oyunun neredeyse tamamı yüklendiğinde başlar, yani ekran çok geç görünür.
  • Ekranı kodla kur ya da tasarladığın ScreenGui'yi scriptin içinde sakla. Script başladığında StarterGui'deki şeyler henüz gelmemiş olur.
  • Bütün oyunu nesne nesne önceden yükleme. Gruplar halinde ya da sadece oyuncunun ilk gördüğü resimleri ve sesleri önceden yükle.
Bu sayfada
  1. Nasıl çalışır
  2. 1. Script
  3. 2. Kendi tasarımın
  4. 3. Test
  5. Common errors
  6. With RoCode
  7. Sık sorulan sorular
  8. Kaynaklar ve ek okumalar

Roblox'ta yükleme nasıl çalışır

Bir oyuncu girdiğinde Roblox, sunucu oyununun bir kopyasını oyuncunun cihazına gönderirken kendi yükleme ekranını gösterir. Oyunundaki scriptlerin çoğu bu kopya geldikten sonra başlar, yani bekleme sırasında bir şey göstermek için çok geç. ReplicatedFirst istisnadır: Roblox içeriğini oyuncuya her şeyden önce gönderir ve içindeki bir LocalScript hemen başlar.

Bir yükleme ekranı scriptinin kullandıkları
ParçaNe yapar
ReplicatedFirstİçindeki LocalScript'ler oyuncuya ilk ulaşır ve oyunun geri kalanı yüklenmeden önce çalışır.
ReplicatedFirst:RemoveDefaultLoadingScreen()Roblox'un varsayılan yükleme ekranını kaldırır, böylece oyuncular seninkini görür.
game:IsLoaded() ve game.LoadedOyunun ilk kopyasının ne zaman geldiğini söyler.
ContentProvider:PreloadAsync()Verdiğin nesnelerin resimleri, mesh'leri ve sesleri inene kadar bekler, böylece oyun gri dokularla açılmaz.
IgnoreGuiInset açık bir ScreenGuiEkranın kendisi; üstteki şerit dahil bütün pencereyi kaplar.

Bir yükleme ekranı oyunun daha hızlı yüklenmesini sağlamaz. Yüklemeyi gizler ve oyunculara bakacak bir şey verir; bu en çok, varsayılan ekranın uzun süre kalabildiği telefonlarda ve yavaş bağlantılarda önemlidir.

1. adım: yükleme ekranı scriptini ekle

  1. Explorer'da fareyle ReplicatedFirst üzerine gel, +'ya tıkla ve bir LocalScript ekle.
  2. Adını LoadingScreen yap ve aşağıdaki kodu yapıştır.
  3. TITLE'ı oyununun adıyla değiştir ve Play'e bas.
LocalScript konum: ReplicatedFirst adı: LoadingScreen
-- ReplicatedFirst içinde LoadingScreen adlı LocalScript.
-- Roblox'un varsayılan yükleme ekranını kendi ekranınla değiştirir: bir başlık, bir ilerleme çubuğu,
-- yavaş bağlantılar için bir Skip butonu ve oyun hazır olunca bir solma efekti.
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 -- ekranı en az bu kadar göster, böylece asla sadece bir göz kırpması olmaz
local SKIP_AFTER_SECONDS = 8 -- yükleme bundan uzun sürerse bir Skip butonu göster
local STEPS = 20 -- asset'ler önceden yüklenirken çubuğun kaç kez ilerleyeceği

local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui") :: PlayerGui

-- Ekran kodla kuruluyor, yani oyunun başka herhangi bir şeyi yüklenmeden önce var oluyor
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- ekranın üstündeki şeridi de kaplar
gui.DisplayOrder = 100 -- diğer tüm ScreenGui'lerin önünde
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)

-- Oyunun ilk kopyasının sunucudan gelmesini bekle
if not game:IsLoaded() then
	game.Loaded:Wait()
end

-- Workspace'teki resimleri, mesh'leri ve sesleri STEPS grup halinde önceden yükle ve her gruptan sonra çubuğu ilerlet
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

-- Her şeyi soldur, sonra ekranı kaldır
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 aldığı nesnelerin tüm asset'lerini bekler. Bütün Workspace'i tek bir çağrıda vermek çubuğu sonuna kadar %0'da takılı bırakırdı, bu yüzden script onu STEPS gruba bölüyor ve her gruptan sonra çubuğu ilerletiyor.

Ekran doğrudan PlayerGui'ye gidiyor, çünkü bu script çalıştığında StarterGui henüz oyuncuya kopyalanmamıştır. ResetOnSpawn kapalı, böylece karakter altında doğduğunda ekran yerinde kalır.

2. adım: Studio'da tasarladığın bir ekranı kullan

Ekranı kodla kurmak hızlı, ama belki onu Studio'da resimlerle ve kendi düzeninle tasarlamayı tercih edersin. StarterGui'de bir ScreenGui olarak tasarla, adını LoadingScreen koy ve ReplicatedFirst'teki LoadingScreen LocalScript'inin üzerine sürükle; böylece scriptin child'ı olur ve onunla birlikte gelir. 1. adımdakinin yerine bu daha kısa scripti kullan:

LocalScript konum: ReplicatedFirst adı: LoadingScreen
-- ReplicatedFirst içinde LoadingScreen adlı LocalScript, içinde LoadingScreen adlı
-- kendi ScreenGui'n var (StarterGui'de tasarla, sonra bu scriptin üzerine sürükle).
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()

Roblox'un kendi butonları, yani üstteki menü ve sohbet ikonları ile alttaki araç çubuğu, her zaman tüm ScreenGui'lerin önünde çizilir, bu yüzden yükleme ekranının üstünde görünmeye devam ederler. Bu normal ve oyuncular oyun yüklenirken menüyü açabilir.

3. adım: test et

  1. Output penceresini aç (Window menüsü, sonra Output) ve Play'e bas. Ekranın görünmeli, çubuk dolmalı ve yaklaşık MIN_SECONDS sonra ekran solmalı.
  2. Studio'da tüm asset'ler zaten bilgisayarında, bu yüzden çubuk neredeyse anında dolar. Skip butonunun göründüğünü ve çalıştığını kontrol etmek için MIN_SECONDS'u 8 yap ve tekrar oyna.
  3. Ekranı oyuncuların göreceği gibi görmek için yayınla ve bir telefonda Roblox uygulamasından gir.

Sık yapılan hatalar ve çözümleri

Varsayılan yükleme ekranı hâlâ çıkıyorsa ya da seninki hiç kalkmıyorsa önce bunlara bak.

Roblox'un varsayılan yükleme ekranı hâlâ çıkıyor

Script ReplicatedFirst içinde bir LocalScript değil ya da RemoveDefaultLoadingScreen()'a ulaşmadan önce hata veriyor. Output penceresinde LoadingScreen'i anan kırmızı bir satır ara.

Ekranım geç çıkıyor, oyun zaten görünürken

Script StarterGui ya da StarterPlayerScripts içinde. Onu ReplicatedFirst'e taşı.

Infinite yield possible on 'ReplicatedFirst.LoadingScreen:WaitForChild("LoadingScreen")'

2. adımdaki script ScreenGui'ni bulamıyor. Scriptin child'ı olmalı ve adı tam olarak LoadingScreen olmalı.

Ekran hiç kalkmıyor

game.Loaded'dan sonraki bir şey hata verdi ya da hiç bitmedi. Output'a bak; 1. adımdaki Skip butonu da hiçbir oyuncu takılı kalmasın diye orada.

Ekranın üstünde bir boşluk görünüyor

ScreenGui'de IgnoreGuiInset'i true yap, iki scriptin de yaptığı gibi.

RoCode ile yap

RoCode, bir plugin aracılığıyla Roblox Studio içinde çalışan bir yapay zeka ajanı. İstediğin ekranı anlatırsın, o da açık olan place'inde kurar.

Sen yazarsın

Oyunumun adını, mor bir ilerleme çubuğunu ve bir Skip butonunu gösteren, yükleme bitince oyuna doğru solan bir yükleme ekranı ekle.

RoCode yapar
  • LocalScript'i ReplicatedFirst'e yazar ve ScreenGui'yi kurar
  • İstediğin renkleri ve fontu kullanır, daha önce tasarladığın bir ScreenGui'yi de yeniden kullanabilir
  • Bitirmeden önce yazdığı scriptleri Studio içinde kontrol eder

Play'e basmak ve ekranın telefonda ve bilgisayarda iyi göründüğünü kontrol etmek yine sana kalıyor. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox'ta yükleme ekranı scriptini nereye koyarım?

ReplicatedFirst'e, LocalScript olarak. Bir scriptin oyunun geri kalanı yüklenmeden önce çalıştığı tek yer orası.

Roblox'un varsayılan yükleme ekranını nasıl kaldırırım?

Kendi ekranın zaten görünürken, ReplicatedFirst içindeki bir LocalScript'ten game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen()'u çağır.

Yükleme ekranı oyunumun daha hızlı yüklenmesini sağlar mı?

Hayır. Beklemeyi örter. Beklemeyi kısaltmak için spawn yakınında daha az ve daha küçük resim, mesh ve ses kullan.

Yükleme ekranım Studio'da neden sadece bir an görünüyor?

Studio testinde her şey zaten bilgisayarında. Test ederken MIN_SECONDS'u artır ya da yayınlanmış oyunu bir telefonda dene.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.