باختصار
ضع LocalScript في ReplicatedFirst. فهو يعمل قبل أن يصل أي شيء آخر إلى اللاعب. أنشئ داخله ScreenGui مع تفعيل IgnoreGuiInset، وضعه في PlayerGui الخاص باللاعب، واستدعِ ReplicatedFirst:RemoveDefaultLoadingScreen(). ثم انتظر game.Loaded، وحمّل المهم مسبقًا عبر ContentProvider:PreloadAsync()، ودمّر الـ ScreenGui عند الانتهاء.
- وحده LocalScript في ReplicatedFirst يعمل مبكرًا بما يكفي. في StarterGui أو StarterPlayerScripts يبدأ بعد أن يكون معظم اللعبة قد تحمّل، فتظهر الشاشة متأخرة جدًا.
- ابنِ الشاشة بالكود أو احتفظ بـ ScreenGui الجاهز الخاص بك داخل السكربت. فكل ما في StarterGui لم يصل بعد لحظة بدء السكربت.
- لا تحمّل اللعبة كلها مسبقًا كائنًا كائنًا. حمّلها على دفعات، أو حمّل فقط الصور والأصوات التي يراها اللاعب أولًا.
في هذه الصفحة
كيف يعمل التحميل في Roblox
عندما يدخل اللاعب، يعرض Roblox شاشة التحميل الخاصة به بينما يرسل الخادم نسخة من لعبتك إلى جهازه. وتعمل سكربتات لعبتك في الغالب بعد وصول هذه النسخة، وهذا متأخر جدًا لعرض أي شيء أثناء الانتظار. ReplicatedFirst هو الاستثناء: يرسل Roblox محتواه إلى اللاعب قبل كل شيء آخر، ويعمل الـ LocalScript داخله فورًا.
| العنصر | ما يفعله |
|---|---|
ReplicatedFirst | تصل سكربتات LocalScript فيه إلى اللاعب أولًا، وتعمل قبل أن يتحمّل باقي اللعبة. |
ReplicatedFirst:RemoveDefaultLoadingScreen() | يزيل شاشة تحميل Roblox الافتراضية ليرى اللاعبون شاشتك. |
game:IsLoaded() وgame.Loaded | يخبرانك متى وصلت النسخة الأولى من اللعبة. |
ContentProvider:PreloadAsync() | ينتظر حتى تُنزَّل الصور والمجسمات والأصوات للكائنات الممررة إليه، كي لا تظهر اللعبة بخامات رمادية. |
ScreenGui مع IgnoreGuiInset | الشاشة نفسها، وهي تغطي النافذة كلها بما فيها الشريط العلوي. |
شاشة التحميل لا تسرّع تحميل اللعبة. هي تخفي التحميل وتعطي اللاعبين شيئًا يشاهدونه، وهذا أهم ما يكون على الهواتف ومع الاتصال البطيء، حيث قد تبقى الشاشة الافتراضية ظاهرة وقتًا طويلًا.
الخطوة 1: أضف سكربت شاشة التحميل
- في Explorer مرّر المؤشر فوق ReplicatedFirst، واضغط + وأدرج LocalScript.
- أعد تسميته إلى
LoadingScreenوالصق الكود أدناه. - استبدل
TITLEباسم لعبتك واضغط Play.
-- 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، وداخله الـ 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: اختبرها
- افتح نافذة Output (قائمة Window ثم Output) واضغط Play. يجب أن تظهر شاشتك ويمتلئ الشريط، ثم تختفي الشاشة تدريجيًا بعد نحو
MIN_SECONDS. - لدى Studio كل الأصول على حاسوبك مسبقًا، لذا يمتلئ الشريط فورًا تقريبًا. اضبط
MIN_SECONDSعلى 8 وشغّل مرة أخرى للتأكد من أن زر Skip يظهر ويعمل. - انشر اللعبة وادخلها من تطبيق 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، تنتقل بسلاسة إلى اللعبة عندما تتحمّل.
- يكتب LocalScript في ReplicatedFirst ويبني الـ ScreenGui
- يختار الألوان والخط اللذين تطلبهما، ويمكنه استخدام ScreenGui صمّمته من قبل
- يفحص السكربتات التي كتبها داخل Studio قبل أن ينتهي
الضغط على Play والتأكد من أن الشاشة تبدو جيدة على الهاتف والحاسوب يبقى من عملك. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
أين أضع سكربت شاشة التحميل في Roblox؟
في ReplicatedFirst، على شكل LocalScript. إنه المكان الوحيد الذي يعمل فيه السكربت قبل تحميل باقي اللعبة.
كيف أزيل شاشة تحميل Roblox الافتراضية؟
استدعِ game:GetService("ReplicatedFirst"):RemoveDefaultLoadingScreen() من LocalScript في ReplicatedFirst بعد أن تُعرض شاشتك الخاصة.
هل تسرّع شاشة التحميل تحميل اللعبة؟
لا. هي تغطي الانتظار. ولتقصيره استخدم عددًا أقل من الصور والمجسمات والأصوات قرب نقطة الظهور واجعلها أخف.
لماذا تظهر شاشة التحميل في Studio للحظة فقط؟
في اختبار اللعب داخل Studio كل شيء موجود مسبقًا على حاسوبك. أثناء الاختبار زِد MIN_SECONDS أو جرّب اللعبة المنشورة على الهاتف.
المصادر والقراءات
- Roblox Creator Docs: ReplicatedFirst (بالإنجليزية). ما يعمل أولًا وRemoveDefaultLoadingScreen
- Roblox Creator Docs: ContentProvider (بالإنجليزية). PreloadAsync
- Roblox Creator Docs: DataModel (بالإنجليزية). IsLoaded والحدث Loaded
- Roblox Creator Docs: ScreenGui (بالإنجليزية). IgnoreGuiInset وDisplayOrder وResetOnSpawn
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.