Útmutató · Játékrendszerek

Hogyan készíts saját betöltőképernyőt a Roblox Studióban

A saját betöltőképernyő egy ScreenGui, amelyet egy LocalScript a ReplicatedFirst alatt abban a pillanatban mutat meg, amikor a játékos belép, még mielőtt a játék többi része megérkezne. Ebben az útmutatóban kódból építed fel: a saját címed, egy folyamatjelző sáv, amíg a képek és hangok előre betöltődnek, egy Skip gomb lassú kapcsolathoz, és egy sima átmenet a játékba.

Frissítve 2026. november 20.4 perc olvasásSzerző:

Röviden

Tegyél egy LocalScriptet a ReplicatedFirst alá. Ez hamarabb fut le, mint ahogy bármi más eljutna a játékoshoz. Hozz létre benne egy ScreenGui-t bekapcsolt IgnoreGuiInset-tel, tedd a játékos PlayerGui-jába, és hívd meg a ReplicatedFirst:RemoveDefaultLoadingScreen() függvényt. Ezután várd meg a game.Loaded eseményt, töltsd be előre a fontos dolgokat a ContentProvider:PreloadAsync() segítségével, és ha végeztél, semmisítsd meg a ScreenGui-t.

  • Elég korán csak a ReplicatedFirst alatti LocalScript indul el. A StarterGui-ban vagy a StarterPlayerScripts-ben akkor indul, amikor a játék nagy része már betöltődött, és a képernyő túl későn jelenik meg.
  • A képernyőt kódból építsd fel, vagy a kész ScreenGui-dat a scripten belül tárold. Ami a StarterGui-ban van, az a script indulásakor még nem érkezett meg.
  • Ne objektumonként töltsd be előre az egész játékot. Csomagokban töltsd be, vagy csak azokat a képeket és hangokat, amelyeket a játékos először lát.
Ezen az oldalon
  1. Hogyan működik
  2. 1. Script
  3. 2. Saját design
  4. 3. Teszt
  5. Common errors
  6. With RoCode
  7. Gyakori kérdések
  8. Források és további olvasnivaló

Hogyan működik a betöltés Robloxban

Amikor a játékos belép, a Roblox a saját betöltőképernyőjét mutatja, amíg a szerver elküldi a játékod másolatát az eszközére. A játékod scriptjei többnyire akkor indulnak, amikor ez a másolat már megérkezett, és ez túl késő ahhoz, hogy várakozás közben bármit mutass. A ReplicatedFirst a kivétel: a Roblox a tartalmát mindennél előbb küldi el a játékosnak, és a benne lévő LocalScript azonnal elindul.

Mit használ a betöltőképernyő scriptje
ElemMit csinál
ReplicatedFirstA LocalScriptjei érkeznek meg elsőként a játékoshoz, és még a játék többi részének betöltése előtt elindulnak.
ReplicatedFirst:RemoveDefaultLoadingScreen()Eltávolítja a Roblox alapértelmezett betöltőképernyőjét, hogy a játékosok a tiédet lássák.
game:IsLoaded() és game.LoadedJelzik, amikor megérkezett a játék első másolata.
ContentProvider:PreloadAsync()Megvárja, amíg az átadott objektumok képei, meshei és hangjai letöltődnek, hogy a játék ne szürke textúrákkal jelenjen meg.
ScreenGui IgnoreGuiInset-telMaga a képernyő, amely az egész ablakot lefedi, a felső sávot is.

A betöltőképernyő nem gyorsítja a játék betöltését. Elrejti a betöltést, és ad valamit, amit a játékosok nézhetnek, és ez leginkább telefonon és lassú kapcsolatnál fontos, ahol az alapértelmezett képernyő elég sokáig fennmaradhat.

1. lépés: add hozzá a betöltőképernyő scriptjét

  1. Az Explorerben vidd az egeret a ReplicatedFirst fölé, nyomd meg a + gombot, és szúrj be egy LocalScriptet.
  2. Nevezd át LoadingScreen-re, és illeszd be az alábbi kódot.
  3. Cseréld a TITLE értékét a játékod nevére, és nyomd meg a Play gombot.
LocalScript helye: ReplicatedFirst neve: LoadingScreen
-- LocalScript a ReplicatedFirst alatt LoadingScreen néven.
-- A Roblox alapértelmezett betöltőképernyőjét a tiédre cseréli: cím, folyamatjelző sáv,
-- Skip gomb lassú kapcsolathoz és sima elhalványulás, amikor a játék kész.
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 -- legalább ennyi ideig mutasd a képernyőt, hogy ne villanjon fel
local SKIP_AFTER_SECONDS = 8 -- mutasd a Skip gombot, ha a betöltés ennél tovább tart
local STEPS = 20 -- hányszor lép előre a sáv, amíg az assetek előre betöltődnek

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

-- A képernyő kódból épül fel, ezért előbb létezik, mint ahogy bármi más betöltődne a játékban
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- a képernyő tetején lévő sávot is takarja
gui.DisplayOrder = 100 -- minden más ScreenGui fölött
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)

-- Megvárjuk, amíg a szerverről megérkezik a játék első másolata
if not game:IsLoaded() then
	game.Loaded:Wait()
end

-- A Workspace képeit, mesheit és hangjait STEPS csomagban töltjük be előre, mindegyik után léptetve a sávot
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

-- Mindent simán elhalványítunk, aztán töröljük a képernyőt
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()

A PreloadAsync az átadott objektumok minden assetjére vár. Ha az egész Workspace-t egyetlen hívásban adod át, a sáv a legvégéig 0%-on áll, ezért a script STEPS csomagra osztja, és mindegyik után léptet a sávon.

A képernyő közvetlenül a PlayerGui-ba kerül, mert a script indulásakor a StarterGui még nincs a játékoshoz másolva. A ResetOnSpawn ki van kapcsolva, hogy a képernyő túlélje az alatta megjelenő karaktert.

2. lépés: használj a Studióban megrajzolt képernyőt

Kódból gyorsan felépíthető a képernyő, de lehet, hogy a Studióban szeretnéd megrajzolni képekkel és saját elrendezéssel. Készítsd el ScreenGui-ként a StarterGui-ban, nevezd el LoadingScreen-nek, aztán húzd rá a ReplicatedFirst alatti LoadingScreen LocalScriptre, hogy a script gyermekobjektuma legyen, és vele együtt érkezzen. Az 1. lépés scriptje helyett ezt a rövidebb scriptet használd:

LocalScript helye: ReplicatedFirst neve: LoadingScreen
-- LocalScript a ReplicatedFirst alatt LoadingScreen néven, benne a ScreenGui-d
-- LoadingScreen néven (rajzold meg a StarterGui-ban, aztán húzd rá erre a scriptre).
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()

A Roblox saját gombjai, a menü és a chat ikonjai fent, valamint az eszköztár lent, mindig minden ScreenGui fölé rajzolódnak, ezért a betöltőképernyőd fölött is látszanak. Ez normális, és a játékosok megnyithatják a menüt, amíg a játék töltődik.

3. lépés: teszteld

  1. Nyisd meg az Output ablakot (Window menü, aztán Output), és nyomd meg a Play gombot. Meg kell jelennie a képernyődnek, a sávnak meg kell telnie, és nagyjából MIN_SECONDS után a képernyő simán elhalványul.
  2. A Studióban már minden asset ott van a számítógépeden, ezért a sáv szinte azonnal megtelik. Állítsd a MIN_SECONDS értékét 8-ra, és futtasd újra, hogy ellenőrizd, megjelenik és működik a Skip gomb.
  3. Publikáld a játékot, és lépj be a telefonos Roblox alkalmazásból, hogy úgy lásd a képernyőt, ahogy a játékosok fogják.

Gyakori hibák és megoldásaik

Ha még mindig az alapértelmezett betöltőképernyő jelenik meg, vagy a tiéd soha nem tűnik el, először ezeket nézd meg.

Még mindig a Roblox alapértelmezett betöltőképernyője jelenik meg

A script nem LocalScript a ReplicatedFirst alatt, vagy hibával leáll a RemoveDefaultLoadingScreen() hívása előtt. Keress az Output ablakban piros sort LoadingScreen névvel.

A képernyőm későn jelenik meg, amikor a játék már látszik

A script a StarterGui-ban vagy a StarterPlayerScripts-ben van. Helyezd át a ReplicatedFirst alá.

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

A 2. lépés scriptje nem találja a ScreenGui-dat. A script gyermekobjektumának kell lennie, és pontosan LoadingScreen nevűnek.

A képernyő soha nem tűnik el

Valami a game.Loaded után hibával leállt, vagy soha nem fejeződött be. Nézd meg az Outputot; az 1. lépés Skip gombja többek között arra is való, hogy a játékos soha ne ragadjon be.

A képernyő tetején rés látszik

Állítsd a ScreenGui IgnoreGuiInset tulajdonságát true-ra, ahogy mindkét script teszi.

Építsd meg a RoCode-dal

A RoCode egy AI-ügynök, amely egy pluginon keresztül a Roblox Studióban dolgozik. Leírod, milyen képernyőt szeretnél, és megépíti a nálad nyitott place-ben.

Te írod

Adj hozzá egy betöltőképernyőt a játékom nevével, lila folyamatjelző sávval és Skip gombbal, amely simán átvált a játékba, amikor az betöltődött.

A RoCode elvégzi
  • Megírja a LocalScriptet a ReplicatedFirst alá, és felépíti a ScreenGui-t
  • A kért színeket és betűtípust választja, és használhat egy ScreenGui-t, amelyet már megrajzoltál
  • A megírt scripteket a Studióban ellenőrzi, mielőtt befejezi

A Play megnyomása és annak ellenőrzése, hogy a képernyő jól néz ki telefonon és számítógépen, továbbra is a te feladatod. Hogyan csatlakozik a RoCode a Studióhoz.

Gyakori kérdések

Hová tegyem a betöltőképernyő scriptjét Robloxban?

A ReplicatedFirst alá, LocalScriptként. Ez az egyetlen hely, ahol a script a játék többi részének betöltése előtt elindul.

Hogyan távolítsam el a Roblox alapértelmezett betöltőképernyőjét?

Hívd meg a game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() függvényt egy ReplicatedFirst alatti LocalScriptből, amikor a saját képernyőd már látszik.

Gyorsítja a betöltőképernyő a játék betöltését?

Nem. Csak eltakarja a várakozást. Ha rövidíteni akarod, használj kevesebb képet, mesht és hangot a megjelenési pont közelében, és legyenek könnyebbek.

Miért csak egy pillanatra jelenik meg a betöltőképernyőm a Studióban?

A Studio playtestjében már minden ott van a számítógépeden. Tesztelés közben növeld a MIN_SECONDS értékét, vagy próbáld ki a publikált játékot telefonon.

Források és további olvasnivaló

Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.