درس · أنظمة اللعب

كيف تصنع شاشة تحميل خاصة بك في Roblox Studio

شاشة التحميل الخاصة بك هي ScreenGui يعرضه LocalScript في ReplicatedFirst لحظة دخول اللاعب، قبل أن يصل باقي اللعبة. في هذا الدليل ستبنيها بالكود: عنوانك، وشريط تقدم أثناء التحميل المسبق للصور والأصوات، وزر Skip للاتصال البطيء، وانتقال سلس إلى اللعبة.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 4 دبقلم

باختصار

ضع LocalScript في ReplicatedFirst. فهو يعمل قبل أن يصل أي شيء آخر إلى اللاعب. أنشئ داخله ScreenGui مع تفعيل IgnoreGuiInset، وضعه في PlayerGui الخاص باللاعب، واستدعِ ReplicatedFirst:RemoveDefaultLoadingScreen(). ثم انتظر game.Loaded، وحمّل المهم مسبقًا عبر ContentProvider:PreloadAsync()، ودمّر الـ ScreenGui عند الانتهاء.

  • وحده LocalScript في ReplicatedFirst يعمل مبكرًا بما يكفي. في StarterGui أو StarterPlayerScripts يبدأ بعد أن يكون معظم اللعبة قد تحمّل، فتظهر الشاشة متأخرة جدًا.
  • ابنِ الشاشة بالكود أو احتفظ بـ ScreenGui الجاهز الخاص بك داخل السكربت. فكل ما في StarterGui لم يصل بعد لحظة بدء السكربت.
  • لا تحمّل اللعبة كلها مسبقًا كائنًا كائنًا. حمّلها على دفعات، أو حمّل فقط الصور والأصوات التي يراها اللاعب أولًا.
في هذه الصفحة
  1. طريقة العمل
  2. 1. السكربت
  3. 2. تصميمك الخاص
  4. 3. الاختبار
  5. Common errors
  6. With RoCode
  7. الأسئلة الشائعة
  8. المصادر والقراءات

كيف يعمل التحميل في Roblox

عندما يدخل اللاعب، يعرض Roblox شاشة التحميل الخاصة به بينما يرسل الخادم نسخة من لعبتك إلى جهازه. وتعمل سكربتات لعبتك في الغالب بعد وصول هذه النسخة، وهذا متأخر جدًا لعرض أي شيء أثناء الانتظار. ReplicatedFirst هو الاستثناء: يرسل Roblox محتواه إلى اللاعب قبل كل شيء آخر، ويعمل الـ LocalScript داخله فورًا.

ما يستخدمه سكربت شاشة التحميل
العنصرما يفعله
ReplicatedFirstتصل سكربتات LocalScript فيه إلى اللاعب أولًا، وتعمل قبل أن يتحمّل باقي اللعبة.
ReplicatedFirst:RemoveDefaultLoadingScreen()يزيل شاشة تحميل Roblox الافتراضية ليرى اللاعبون شاشتك.
game:IsLoaded() وgame.Loadedيخبرانك متى وصلت النسخة الأولى من اللعبة.
ContentProvider:PreloadAsync()ينتظر حتى تُنزَّل الصور والمجسمات والأصوات للكائنات الممررة إليه، كي لا تظهر اللعبة بخامات رمادية.
ScreenGui مع IgnoreGuiInsetالشاشة نفسها، وهي تغطي النافذة كلها بما فيها الشريط العلوي.

شاشة التحميل لا تسرّع تحميل اللعبة. هي تخفي التحميل وتعطي اللاعبين شيئًا يشاهدونه، وهذا أهم ما يكون على الهواتف ومع الاتصال البطيء، حيث قد تبقى الشاشة الافتراضية ظاهرة وقتًا طويلًا.

الخطوة 1: أضف سكربت شاشة التحميل

  1. في Explorer مرّر المؤشر فوق ReplicatedFirst، واضغط + وأدرج LocalScript.
  2. أعد تسميته إلى LoadingScreen والصق الكود أدناه.
  3. استبدل TITLE باسم لعبتك واضغط Play.
LocalScript في ReplicatedFirst باسم LoadingScreen
-- LocalScript في ReplicatedFirst باسم LoadingScreen.
-- يستبدل شاشة تحميل Roblox الافتراضية بشاشتك: عنوان وشريط تقدم،
-- وزر Skip للاتصال البطيء واختفاء تدريجي عندما تصبح اللعبة جاهزة.
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 -- اعرض الشاشة هذه المدة على الأقل كي لا تومض
local SKIP_AFTER_SECONDS = 8 -- أظهر زر Skip إذا استغرق التحميل أطول من ذلك
local STEPS = 20 -- عدد مرات تقدّم الشريط أثناء التحميل المسبق للأصول

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

-- تُبنى الشاشة بالكود، لذا فهي موجودة قبل أن يتحمّل أي شيء آخر في اللعبة
local gui = Instance.new("ScreenGui")
gui.Name = "LoadingScreen"
gui.IgnoreGuiInset = true -- غطِّ الشريط أعلى الشاشة أيضًا
gui.DisplayOrder = 100 -- فوق كل 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)

-- ننتظر حتى تصل النسخة الأولى من اللعبة من الخادم
if not game:IsLoaded() then
	game.Loaded:Wait()
end

-- نحمّل مسبقًا الصور والمجسمات والأصوات في Workspace على STEPS دفعة، ونقدّم الشريط بعد كل دفعة
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

-- نخفي كل شيء تدريجيًا، ثم نحذف الشاشة
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 كل أصل في الكائنات الممررة إليه. وإذا مررت Workspace كله في استدعاء واحد فسيبقى الشريط على 0% حتى النهاية، لذا يقسمه السكربت إلى STEPS دفعة ويقدّم الشريط بعد كل دفعة.

توضع الشاشة مباشرة في PlayerGui، لأن StarterGui لم يُنسخ إلى اللاعب بعد لحظة تشغيل هذا السكربت. وResetOnSpawn معطّل كي تبقى الشاشة بعد ظهور الشخصية تحتها.

الخطوة 2: استخدم شاشة صمّمتها في Studio

بناء الشاشة بالكود سريع، لكنك قد ترغب في تصميمها في Studio مع صور وتخطيط خاص بك. اصنعها كـ ScreenGui في StarterGui وسمّها LoadingScreen، ثم اسحبها إلى الـ LocalScript المسمى LoadingScreen في ReplicatedFirst لتصبح كائنًا تابعًا للسكربت وتصل معه. واستخدم هذا السكربت الأقصر بدل سكربت الخطوة 1:

LocalScript في ReplicatedFirst باسم LoadingScreen
-- LocalScript في ReplicatedFirst باسم LoadingScreen، وداخله الـ ScreenGui الخاص بك باسم
-- LoadingScreen (صمّمه في StarterGui، ثم اسحبه إلى هذا السكربت).
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 نفسها، أي أيقونتا القائمة والدردشة في الأعلى وشريط الأدوات في الأسفل، تُرسم دائمًا فوق أي ScreenGui، لذا تبقى ظاهرة فوق شاشة التحميل. هذا طبيعي، ويمكن للاعبين فتح القائمة أثناء تحميل اللعبة.

الخطوة 3: اختبرها

  1. افتح نافذة Output (قائمة Window ثم Output) واضغط Play. يجب أن تظهر شاشتك ويمتلئ الشريط، ثم تختفي الشاشة تدريجيًا بعد نحو MIN_SECONDS.
  2. لدى Studio كل الأصول على حاسوبك مسبقًا، لذا يمتلئ الشريط فورًا تقريبًا. اضبط MIN_SECONDS على 8 وشغّل مرة أخرى للتأكد من أن زر Skip يظهر ويعمل.
  3. انشر اللعبة وادخلها من تطبيق Roblox على الهاتف لترى الشاشة كما سيراها اللاعبون.

الأخطاء الشائعة وحلولها

إذا كانت الشاشة الافتراضية ما زالت تظهر أو كانت شاشتك لا تختفي أبدًا، فتحقق من هذه النقاط أولًا.

ما زالت شاشة تحميل Roblox الافتراضية تظهر

السكربت ليس LocalScript في ReplicatedFirst، أو يتعطل بخطأ قبل استدعاء RemoveDefaultLoadingScreen(). ابحث في نافذة Output عن سطر أحمر يحمل الاسم LoadingScreen.

شاشتي تظهر متأخرة بعد أن تصبح اللعبة مرئية

السكربت موجود في StarterGui أو StarterPlayerScripts. انقله إلى ReplicatedFirst.

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

سكربت الخطوة 2 لا يجد الـ ScreenGui الخاص بك. يجب أن يكون تابعًا للسكربت واسمه LoadingScreen بالضبط.

الشاشة لا تختفي أبدًا

شيء ما بعد game.Loaded تعطل بخطأ أو لم ينتهِ أبدًا. تحقق من Output؛ فزر Skip في الخطوة 1 موجود أيضًا كي لا يعلق اللاعب أبدًا.

تظهر فجوة أعلى الشاشة

اضبط IgnoreGuiInset على true في الـ ScreenGui، كما يفعل السكربتان كلاهما.

ابنِه باستخدام RoCode

RoCode وكيل ذكاء اصطناعي يعمل داخل Roblox Studio عبر إضافة. تصف الشاشة التي تريدها، فيبنيها في المكان المفتوح عندك.

ما تكتبه

أضف شاشة تحميل باسم لعبتي، مع شريط تقدم بنفسجي وزر Skip، تنتقل بسلاسة إلى اللعبة عندما تتحمّل.

ما يفعله RoCode
  • يكتب LocalScript في ReplicatedFirst ويبني الـ ScreenGui
  • يختار الألوان والخط اللذين تطلبهما، ويمكنه استخدام ScreenGui صمّمته من قبل
  • يفحص السكربتات التي كتبها داخل Studio قبل أن ينتهي

الضغط على Play والتأكد من أن الشاشة تبدو جيدة على الهاتف والحاسوب يبقى من عملك. كيف يتصل RoCode بـ Studio.

الأسئلة الشائعة

أين أضع سكربت شاشة التحميل في Roblox؟

في ReplicatedFirst، على شكل LocalScript. إنه المكان الوحيد الذي يعمل فيه السكربت قبل تحميل باقي اللعبة.

كيف أزيل شاشة تحميل Roblox الافتراضية؟

استدعِ game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() من LocalScript في ReplicatedFirst بعد أن تُعرض شاشتك الخاصة.

هل تسرّع شاشة التحميل تحميل اللعبة؟

لا. هي تغطي الانتظار. ولتقصيره استخدم عددًا أقل من الصور والمجسمات والأصوات قرب نقطة الظهور واجعلها أخف.

لماذا تظهر شاشة التحميل في Studio للحظة فقط؟

في اختبار اللعب داخل Studio كل شيء موجود مسبقًا على حاسوبك. أثناء الاختبار زِد MIN_SECONDS أو جرّب اللعبة المنشورة على الهاتف.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.