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

كيف تصنع قائمة رئيسية في Roblox Studio

القائمة الرئيسية في Roblox Studio، وتُسمّى أيضًا قائمة البداية أو شاشة العنوان، هي ScreenGui فيها زر Play. لكن الإحساس باللعبة المكتملة تصنعه أشياء أخرى: يجب ألا يظهر اللاعب حتى يضغط Play، ويجب أن تعرض الكاميرا الخريطة ثم تعود إلى الشخصية، ويجب ألا تظهر القائمة مرة أخرى أبدًا بعد الموت. في هذا الدليل نجمع كل ذلك في سكربتين يعملان مع الفأرة وعلى شاشة اللمس ومع يد التحكم.

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

باختصار

عطّل CharacterAutoLoads في خدمة Players كي لا يظهر أحد عند الدخول. يبني LocalScript في StarterPlayerScripts القائمة (العنوان وزر Play وإطارًا أسود للتعتيم) داخل ScreenGui يكون فيه ResetOnSpawn معطّلًا، ويوجّه الكاميرا إلى قطعة اسمها MenuCamera عبر CameraType بقيمة Scriptable، وعند الضغط على Play يرسل RemoteEvent. يرد Script في ServerScriptService باستدعاء Player:LoadCharacterAsync()، ويعيد LocalScript الكاميرا (CameraType بقيمة Custom، وCameraSubject هو Humanoid) ويزيل القائمة.

  • استخدم Activated لا MouseButton1Click، كي يعمل Play بالنقر واللمس ويد التحكم، وحدّد الزر للاعبي يد التحكم كي يتمكنوا من الضغط عليه.
  • مع تعطيل CharacterAutoLoads لا يُنسخ StarterGui إلى PlayerGui الخاص باللاعب إلا حين تظهر شخصيته، لذا يبني القائمة LocalScript في StarterPlayerScripts.
  • مع تعطيل CharacterAutoLoads تتوقف Roblox أيضًا عن إعادة إظهار اللاعبين، لذا يعيد سكربت الخادم إظهارهم بنفسه بعد الموت أو السقوط من الخريطة، بعد انتظار Players.RespawnTime (5 ثوانٍ افتراضيًا).
في هذه الصفحة
  1. كيف تعمل
  2. 1. التجهيز
  3. 2. سكربت الخادم
  4. 3. سكربت القائمة
  5. ما يقرره الخادم
  6. 4. التصميم
  7. 5. الاختبار
  8. مع الأنظمة الأخرى
  9. لماذا تتعطل قوائم الآخرين
  10. Common errors
  11. مع RoCode
  12. الأسئلة الشائعة
  13. المصادر والقراءات

كيف تعمل القائمة الرئيسية

رسم توضيحيالقائمة الجاهزة في لعبة تعمل، مع تسريع انتظار الخادم: يعتّم Play الشاشة، ويُظهر الخادم الشخصية، وتعود الكاميرا إليها.

للقائمة جانبان. جهاز اللاعب يرسم العنوان والزر ويحرّك الكاميرا. والخادم يقرر متى تظهر الشخصية. القائمة نفسها مجرد صورة على شاشة واحدة: التغيير الحقيقي يحدث حين يُظهر الخادم الشخصية، والخادم وحده يستطيع ذلك.

مما تتكوّن القائمة
الجزءأين يوجدماذا يفعل
MenuService ScriptServerScriptServiceيعطّل الظهور التلقائي، وينشئ PlayRequest، ويُظهر اللاعب الذي ضغط Play، ويعيد إظهار اللاعبين بعد الموت أو السقوط.
MainMenu LocalScriptStarterPlayerScriptsيبني العنوان وزر Play والتعتيم، ويدير لقطة الكاميرا، ويطلب من الخادم شخصية، ويعيد الكاميرا.
PlayRequest RemoteEventReplicatedStorage (ينشئه MenuService، فلا تضفه يدويًا)ينقل إلى الخادم رسالة واحدة: هذا اللاعب ضغط Play. لا قيم فيه.
MenuCamera PartWorkspace (تضعه أنت)مكان كاميرا القائمة والجهة التي تنظر إليها.
CharacterAutoLoadsخاصية في خدمة Playersمعطّلة، لذا لا يظهر أحد حتى يستدعي الخادم LoadCharacterAsync.
نافذة Explorer حين تكتمل القائمة. يظهر PlayRequest عند تشغيل اللعبة: ينشئه MenuService، فلا تضفه يدويًا.
Workspace
  MenuCamera Part new
ReplicatedStorage
  PlayRequest RemoteEvent new
ServerScriptService
  MenuService Script new
StarterPlayer
  StarterPlayerScripts
    MainMenu LocalScript new

الخطوة 1: عطّل الظهور التلقائي وضع كاميرا القائمة

  1. في Explorer حدّد Players. وفي نافذة Properties أزل علامة CharacterAutoLoads. يعطّلها MenuService أيضًا، لكن العلامة تضمن ألا يظهر أحد في اللحظة التي تسبق تشغيل السكربت.
  2. مرّر المؤشر فوق Workspace، واضغط زر + وأدرج Part. أعد تسميته إلى MenuCamera (حالة الأحرف في الأسماء مهمة) وأبقه مباشرة في Workspace، لا داخل مجلد أو نموذج.
  3. في Properties الخاصة به فعّل Anchored، وألغِ CanCollide، واضبط Transparency على 1. التثبيت مهم: القطعة غير المثبتة التي لا تصطدم بشيء تسقط عبر الخريطة، وRoblox تحذف القطع التي تسقط تحت Workspace.FallenPartsDestroyHeight.
  4. حرّك القطعة وأدرها بحيث يكون وجهها الأمامي نحو المنظر الذي تريده. تأخذ الكاميرا موضع القطعة وتنظر إلى حيث ينظر وجهها الأمامي.

أسرع طريقة لتوجيهها: حلّق بكاميرا Studio إلى اللقطة التي تريدها، وافتح Command Bar (في تبويب Script أو عبر Window ثم Script) ونفّذ workspace.MenuCamera.CFrame = workspace.CurrentCamera.CFrame. في وضع التحرير يكون CurrentCamera هو المنظر الذي تنظر منه، لذا تقفز القطعة إلى هذه اللقطة تمامًا.

اترك Workspace.StreamingEnabled كما هو. في الأماكن الجديدة يكون بث الكائنات (instance streaming) مفعّلًا، والسكربتات أدناه مكتوبة مع أخذ ذلك في الحسبان.

الخطوة 2: نُظهر اللاعبين عند الضغط على Play

مرّر المؤشر فوق ServerScriptService، وأدرج Script، وسمّه MenuService والصق هذا الكود:

Script في ServerScriptService باسم MenuService
-- Script في ServerScriptService باسم MenuService.
-- يدخل اللاعبون دون شخصية. ينشئها الخادم حين يطلبها زر Play في القائمة،
-- ويعيد إظهار اللاعبين بعد الموت، لأن الظهور التلقائي معطّل.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- وأزل أيضًا علامة CharacterAutoLoads من خدمة Players في نافذة Properties،
-- كي لا يظهر أحد في اللحظة التي تسبق تشغيل هذا السكربت.
Players.CharacterAutoLoads = false

-- هذا السكربت ينشئ PlayRequest بنفسه، فلا تضفه إلى ReplicatedStorage يدويًا
local playRequest = Instance.new("RemoteEvent")
playRequest.Name = "PlayRequest"
playRequest.Parent = ReplicatedStorage

local spawning: { [Player]: boolean } = {}

local function spawnCharacter(player: Player)
	if spawning[player] then
		return -- نقرة ثانية على Play بينما الظهور الأول ما زال يُحمَّل
	end
	spawning[player] = true
	local oldCharacter = player.Character
	local ok, err = pcall(function()
		player:LoadCharacterAsync()
	end)
	spawning[player] = nil
	if not ok then
		warn(`MenuService: could not spawn {player.Name}: {err}`)
		-- إعادة ظهور فاشلة ستترك اللاعب الميت عالقًا، لذا نحاول مجددًا بعد مهلة قصيرة.
		-- لا داعي لتكرار الظهور الأول الفاشل: زر القائمة يكتب Try again.
		if oldCharacter then
			task.delay(Players.RespawnTime, function()
				local current = player.Character
				if player.Parent == Players and (current == oldCharacter or current == nil) then
					spawnCharacter(player)
				end
			end)
		end
	elseif oldCharacter and oldCharacter ~= player.Character then
		oldCharacter:Destroy() -- يحرر اتصالات الشخصية القديمة
	end
end

-- لا يطلب الظهور إلا لاعب ما زال في القائمة (لا شخصية له بعد). اللاعب الميت
-- ما زالت لديه شخصية، لذا لا يمكنه بهذه الطريقة تخطي انتظار إعادة الظهور.
playRequest.OnServerEvent:Connect(function(player: Player)
	if player.Character == nil then
		spawnCharacter(player)
	end
end)

-- مع تعطيل CharacterAutoLoads لا أحد يعيد إظهار اللاعبين بعد الموت، لذا نفعل ذلك هنا
local function onCharacterAdded(player: Player, character: Model)
	local respawning = false
	local function respawnLater()
		if respawning then
			return
		end
		respawning = true
		task.wait(Players.RespawnTime)
		-- نعيد الإظهار فقط إن كان اللاعب ما زال هنا ولم يُظهره أحد منذ ذلك الحين
		local current = player.Character
		if player.Parent == Players and (current == character or current == nil) then
			spawnCharacter(player)
		end
	end
	local humanoid = character:WaitForChild("Humanoid") :: Humanoid
	humanoid.Died:Connect(respawnLater)
	-- السقوط من الخريطة قد يُخرج الشخصية من Workspace، وDied لا ينطلق إلا
	-- ما دام Humanoid داخل Workspace، لذا نلتقط هذه الحالة هنا أيضًا
	character.AncestryChanged:Connect(function()
		if not character:IsDescendantOf(workspace) then
			respawnLater()
		end
	end)
end

local function onPlayerAdded(player: Player)
	player.CharacterAdded:Connect(function(character: Model)
		onCharacterAdded(player, character)
	end)

	-- مع البث تُحمَّل الخريطة حول شخصية اللاعب، واللاعب في
	-- القائمة ليست لديه شخصية بعد. نضيف محور تكرار عند كاميرا القائمة حتى يظهر.
	local menuCamera = workspace:FindFirstChild("MenuCamera")
	if menuCamera and menuCamera:IsA("BasePart") then
		player:AddReplicationFocus(menuCamera)
		player.CharacterAdded:Once(function()
			player:RemoveReplicationFocus(menuCamera) -- من هذه اللحظة المحور هو الشخصية
		end)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do
	onPlayerAdded(player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	spawning[player] = nil
end)

لا ينقل PlayRequest أي قيم. تمرر Roblox اللاعب الذي أرسل الحدث كأول وسيط في OnServerEvent، وهذا كل ما يحتاج الخادم إلى معرفته.

من المسموح له بالظهور

معالج PlayRequest لا يُظهر اللاعب إلا إذا كان player.Character يساوي nil، وهذا حال اللاعب الذي ما زال في القائمة. اللاعب الميت يحتفظ بشخصيته حتى يعيد MenuService إظهاره، لذا لا يمكن تخطي الانتظار عبر هذا الـ remote.

جدول spawning يمنع الطلب الثاني من بدء ظهور ثانٍ بينما الأول ما زال يُحمَّل. ينتظر LoadCharacterAsync حتى تُحمَّل الشخصية، ولا ينصح مرجع Roblox باستدعائه مرة أخرى للاعب نفسه قبل أن ينطلق حدثه CharacterAppearanceLoaded. كل استدعاء يجري داخل pcall، لذا فالظهور الفاشل، كأن يخرج اللاعب أثناء التحميل، يطبع تحذيرًا باسم اللاعب لا خطأ. وإذا فشلت إعادة الظهور ينتظر MenuService مدة RespawnTime ويحاول مجددًا، فلا تترك إعادة الظهور الفاشلة لاعبًا ميتًا عالقًا. أما الظهور الأول الفاشل فلا يكرره الخادم: يكتب زر القائمة Try again، ويستطيع اللاعب الضغط عليه.

إعادة الظهور بعد الموت أو السقوط

مع تعطيل CharacterAutoLoads لا تعيد Roblox إظهار أحد. لا يعمل Players.RespawnTime (5 ثوانٍ افتراضيًا) وحده إلا مع تفعيل CharacterAutoLoads، لذا يقرأ MenuService هذه القيمة وينتظر بنفسه ثم يستدعي LoadCharacterAsync من جديد. تظهر الشخصية الجديدة على SpawnLocation كالمعتاد، ويدمّر السكربت الشخصية القديمة، وهذا يفصل اتصالاتها أيضًا.

السقوط من الخريطة يحتاج إلى فحص ثانٍ. تحذف Roblox القطع التي تسقط تحت Workspace.FallenPartsDestroyHeight، وتحذف النموذج حين تختفي آخر قطعة فيه، لذا قد تغادر الشخصية الساقطة Workspace، بينما لا ينطلق Humanoid.Died إلا ما دام Humanoid داخل Workspace. لذلك يعيد MenuService أيضًا إظهار الشخصية التي غادرت Workspace (AncestryChanged)، والعلامة respawning تضمن ألا تتسبب كل شخصية في أكثر من إعادة ظهور واحدة. بعد الانتظار لا يعيد السكربت إظهار اللاعب إلا إذا كان ما زال في اللعبة وكان player.Character ما زال هذه الشخصية أو nil، لذا فاللاعب الذي ظهر في هذه الأثناء بطريقة أخرى لا يظهر مرتين.

البث وكاميرا القائمة

مع بث الكائنات يتلقى كل عميل القطع المحيطة بمحور التكرار (replication focus) الخاص به، وهو افتراضيًا PrimaryPart لشخصيته. اللاعب في القائمة ليست لديه شخصية، وتحذّر صفحة Roblox عن تقنيات البث من أن العميل الذي لم تظهر شخصيته لا يملك محور تكرار، فقد لا تُحمَّل الخريطة إطلاقًا. والحل في تلك الصفحة هو Player:AddReplicationFocus()، الذي يستدعيه MenuService مع القطعة MenuCamera عند دخول اللاعب (وتقول Roblox إنه يُستدعى على الخادم فقط). وحين تظهر الشخصية أول مرة يستدعي MenuService الدالة RemoveReplicationFocus، فتعود الشخصية المحور الوحيد: كل محور إضافي يزيد عمل البث على الخادم. وفي الخطوة 5 اختبار لعب مع تفعيل البث للتأكد من أن الخريطة ظاهرة خلف القائمة.

ما الذي يقرره الخادم وما الذي يستطيعه الغشاش

يستطيع الغشاش تشغيل كوده على جهازه. يستطيع إرسال PlayRequest متى شاء وبأي قيم، وتغيير أي شيء على شاشته. وهذا ما يكسبه من ذلك.

ما قد يجرّبه الغشاش مع القائمة
الغشاشما يحدث
يرسل PlayRequest دون الضغط على Playيظهر، تمامًا كما لو ضغط Play. تخطي القائمة لا يعطيه شيئًا.
يرسل PlayRequest مئات المراتظهور واحد. أثناء التحميل تتجاهل العلامة spawning البقية؛ وبعده يملك اللاعب شخصية، ويُرفض كل طلب بفحص واحد. لذا لا يحتاج هذا الـ remote إلى حد للتكرار.
يرسل PlayRequest وهو ميت ليعود أسرعيُرفض. اللاعب الميت يحتفظ بشخصيته حتى يعيد MenuService إظهاره.
يرسل قيمًا زائدة مع PlayRequestتُتجاهل. المعالج لا يقرؤها أبدًا.
يحذف القائمة أو يحرّك كاميرتهلا يتغيّر إلا شاشته هو. ولا شخصية له على أي حال حتى يُظهره الخادم.

لنقلها بصراحة: القائمة شاشة لا قفل. هي تقرر متى يظهر اللاعب، ولا شيء غير ذلك. إذا كان زر في القائمة يمنح شيئًا، مثل مظهر أو باب VIP أو عملات، فيجب أن يتحقق منه Script على الخادم، تمامًا كما يتحقق دليل المتجر من كل عملية شراء. وفحص ما يتلقاه الـ remote مشروح في دليل RemoteEvent.

الخطوة 4: اجعل القائمة بأسلوب لعبتك

السكربتات ترسم عمدًا قائمة بسيطة كي يسهل فهم المنطق. كل ما يلي يغيّر جزء الواجهة في MainMenu فقط؛ اترك كود الكاميرا وPlay كما هو.

  • شعار بدلًا من نص العنوان. ارفع صورة الشعار في Studio أو Creator Hub، ثم استبدل TextLabel العنوان بـ ImageLabel تكون قيمة Image فيه rbxassetid:// متبوعًا برقم الأصل ID للصورة. اضبط فيه BackgroundTransparency على 1 وScaleType على Fit كي يحافظ على نسبه.
  • خلفية ضبابية. أنشئ BlurEffect في MainMenu وضعه داخل workspace.CurrentCamera. تنصح Roblox بذلك للقوائم: التأثير الموضوع تحت الكاميرا لا يراه إلا هذا اللاعب. قيمة Size فيه هي نصف قطر التمويه بالبكسل. دمّره في معالج Play، بجانب gui:Destroy().
  • اللون. أضف إلى الزر UIGradient، أو UIStroke لإطار حوله. وأبقِ TextScaled في النص كي يتسع على الشاشات الصغيرة.
  • أزرار أكثر. ضع الأزرار في Frame فيه UIListLayout مع Padding صغير، وأعطِ كل زر معالج Activated وUISizeConstraint خاصًا به. زر Settings أو Help يمكنه فتح لوحة على العميل فقط. وزر Shop يمكنه فتح النافذة من دليل المتجر، حيث تمر عمليات الشراء على الخادم في كل الأحوال.

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

  1. افتح نافذة Output (قائمة Window ثم Output) واضغط Play. تظهر الشاشة على عنوانك وزر Play فوق لقطة MenuCamera، وقائمة اللاعبين وحقيبة الأدوات مخفيتان. في Explorer لا يوجد في Workspace نموذج باسمك: ليست لديك شخصية بعد.
  2. اضغط زر Play. يظهر عليه "Loading..."، وتعتم الشاشة، ثم تظهر خلف شخصيتك بالكاميرا العادية، وتعود قائمة اللاعبين. وفي Players، ثم اسمك، ثم PlayerGui، لم يعد هناك MainMenu ولا MenuFade.
  3. أعد ضبط شخصيتك عبر قائمة اللعبة. تعود للظهور بعد نحو 5 ثوانٍ، ولا تعود القائمة.
  4. انزل أو اقفز من حافة الخريطة. حين تسقط الشخصية من العالم، تعود للظهور بعد نحو 5 ثوانٍ.
  5. اختبر شاشة الهاتف في Device Simulator في Studio (عند كتابة هذا الدليل هي نسخة تجريبية: فعّل New Device Simulator في File ثم Beta Features وأعد تشغيل Studio). على الهاتف الصغير يبقى زر Play بحجم لا يقل عن 160 في 56 بكسل، ويمكن إصابته بالإصبع.
  6. اختبر يد التحكم في Controller Emulator (Controller في تبويب Emulation) أثناء اختبار اللعب. اضغط أي زر في يد التحكم المحاكاة: يكون Play محددًا، والضغط على A يبدأ اللعبة. إذا لم يكن Play محددًا، فاضغط Select في يد التحكم، الذي يحدد الزر ما دام GuiService.AutoSelectGuiEnabled مفعّلًا، ثم A.
  7. مع تفعيل بث الكائنات، كما في الأماكن الجديدة، تحقق من أن الخريطة المحيطة بـ MenuCamera ظاهرة خلف القائمة، لا السماء وحدها.

يجب ألا تظهر في Output في أي لحظة أخطاء حمراء من MenuService أو MainMenu. وإذا لم يتطابق شيء، فراجع الأخطاء الشائعة.

القائمة مع الأنظمة الأخرى

تعطيل CharacterAutoLoads يغيّر سلوك بقية السكربتات في اللعبة. إذا اتبعت أدلة أخرى من هذا الموقع، فتحقق من هذه.

القائمة بجانب الأنظمة الأخرى
النظامما الذي يتغيّرماذا تفعل
نظام الجولاتاللاعبون في القائمة يُحسبون ضمن MIN_PLAYERS لأن الجولة تعدّ كل من في الخادم، لكنها لا تنقلهم أبدًا: لا يأخذ startRound إلا اللاعبين الذين لديهم شخصية حية. واللاعبون الخارجون يعيد إظهارهم MenuService لا Roblox.لا يلزم فعل شيء. وإذا منع اللاعبون في القائمة بدء الجولة ("Not enough players, starting over")، فاحسب في runIntermission فقط اللاعبين الذين ليست قيمة Character لديهم nil.
نقاط تفتيش obbyيعطّل ObbyCheckpoints أيضًا CharacterAutoLoads ويُظهر كل لاعب بمجرد تحميل مرحلته. مع السكربتين معًا يظهر اللاعبون على نقطة تفتيشهم خلف القائمة، ولا يفعل Play سوى إزالة القائمة.أبقِ سكربت إظهار واحدًا. احتفظ بـ ObbyCheckpoints واحذف MenuService. في ObbyCheckpoints احذف السطر spawnAtStage(player) في نهاية onPlayerAdded. ثم في المستوى الأعلى من السكربت، فوق Players.PlayerAdded:Connect(onPlayerAdded) مباشرة وليس داخل onPlayerAdded، انسخ من MenuService السطر الذي فيه ReplicatedStorage والأسطر التي تنشئ PlayRequest، واربط معالج OnServerEvent الخاص به. في المعالج استدعِ spawnAtStage(player) فقط حين يكون player.Character يساوي nil، وتكون stageValues[player] موجودة، ولا يجري ظهور لهذا اللاعب (جدول مثل spawning في MenuService). اللاعب الذي ضغط Play قبل تحميل مرحلته يرى Try again ويستطيع الضغط مرة أخرى. وتبقى إعادات الظهور فيه كما هي. وإذا كان البث مفعّلًا في المكان، فانسخ أيضًا أسطر MenuCamera من MenuService (AddReplicationFocus وRemoveReplicationFocus) إلى بداية onPlayerAdded.
سكربتات لوحة المتصدرين وDataStoreتعمل عند الدخول، بينما اللاعب في القائمة.لا شيء. تبدأ بيانات اللاعب بالتحميل بينما ينظر إلى القائمة.
واجهة المتجريبني ShopClient نافذته فور دخول اللاعب، لذا سيكون زر Shop الخاص به بجانب القائمة.في ShopClient أضف if not player.Character then player.CharacterAdded:Wait() end مباشرة قبل السطر gui.Parent = player:WaitForChild("PlayerGui")، كي يظهر المتجر بعد Play.
المشهد السينمائي الافتتاحييعرض CutsceneService المقدمة عند أول ظهور للاعب، ومع القائمة يكون هذا أول ظهور بعد Play. وتعيد القائمة تفعيل core GUI حين تظهر الشخصية، لذا قد تظهر قائمة اللاعبين أثناء المقدمة.لا يلزم فعل شيء. المشهد السينمائي يعيد تفعيل core GUI التي أخفاها هو فقط، لذا تبقى مفعّلة بعد المقدمة.
ScreenGui في StarterGuiلا تُنسخ إلى اللاعب إلا عند ظهور الشخصية.لا شيء. تظهر بعد Play، وهذا عادة ما تريده لواجهة HUD.

الفرق بين السكربتات في StarterPlayerScripts وفي StarterGui مشروح في دليل Script vs LocalScript vs ModuleScript.

لماذا تتعطل سكربتات القوائم المنسوخة

عرض زر على الشاشة أمر سهل. المشكلات تبدأ بعد Play. هذه هي الأنماط التي تسببها، وما يفعله هذا الدليل بدلًا منها.

أنماط القوائم الشائعة ومشكلاتها
النمطالمشكلةفي هذا الدليل
MouseButton1Click على زر Playتصفه Roblox لنقرة زر الفأرة الأيسر. أما Activated فهو الحدث الموصوف للنقر واللمس وزر يد التحكم.Activated، وPlay محدد ليد التحكم
ScreenGui القائمة في StarterGui مع تفعيل ResetOnSpawnتعطي Roblox اللاعب نسخة جديدة عند كل ظهور، لذا تعود القائمة بعد كل موتResetOnSpawn معطّل، والقائمة تُدمَّر بعد Play
الشخصية تظهر وتُجمَّد خلف القائمة، مثلًا بـ WalkSpeed يساوي 0الشخصية موجودة في العالم: يراها الآخرون ويدفعونها ويهاجمونهالا شخصية حتى Play
player:LoadCharacter()تشير Roblox إلى أن LoadCharacterAsync حلّ محلهLoadCharacterAsync داخل pcall
الكاميرا بقيت Scriptable بعد Playتعلق الكاميرا على لقطة القائمةفصل دالة الكاميرا، وضبط CameraType على Custom وCameraSubject على Humanoid
قراءة workspace.MenuPart فورًامع البث قد لا تكون القطعة وصلت إلى العميل بعد، فيتعطل السكربت بخطأمحور تكرار عند MenuCamera يُضاف على الخادم، وWaitForChild بمهلة 5 ثوانٍ ومنظر احتياطي
حلقات repeat wait() until للكاميراتصف Roblox wait() بأنه قديم، وقد حلّ محله task.wait()BindToRenderStep للكاميرا، وtask.wait في بقية المواضع
إعادة الظهور عبر Humanoid.Died فقطمع تعطيل CharacterAutoLoads قد لا يعود اللاعب الساقط من الخريطة للظهور أبدًا: السقوط قد يُخرج الشخصية من Workspace، وDied لا ينطلق إلا في Workspaceإعادة الإظهار أيضًا حين تغادر الشخصية Workspace
قائمة من نموذج مجانيتحذّر Roblox من أن نماذج Creator Store قد تحتوي على سكربتات أبواب خلفيةسكربتان قصيران يمكن قراءتهما سطرًا سطرًا

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

افتح نافذة Output (قائمة Window ثم Output) قبل الضغط على Play. معظم مشكلات القوائم تطبع هناك تحذيرًا أو خطأ مع اسم السكربت ورقم السطر.

الكاميرا تبقى على لقطة القائمة بعد Play

لم يصل MainMenu إلى الخطوة التي تعيد الكاميرا، أو غيّر سكربت آخر الكاميرا بعد ذلك. ابحث في Output عن خطأ أحمر من MainMenu. وإذا كان أحد سكربتاتك يضبط CameraType أيضًا، فتأكد أنه لا يضعه على Scriptable حين يكون اللاعب داخل اللعبة.

على الزر "Loading..." ثم "Try again"

عثر MainMenu على PlayRequest، أي أن MenuService يعمل، لكن الشخصية مع Humanoid لم تظهر خلال 15 ثانية. إذا أضفت PlayRequest بنفسك إلى ReplicatedStorage فاحذفه: ينشئ MenuService واحدًا خاصًا به، ومع وجود كائنين بالاسم نفسه قد يرسل الزر إلى أحدهما بينما يستمع الخادم إلى الآخر. ثم ابحث في Output عن MenuService: could not spawn والسبب المكتوب بعده. وإذا كنت تستخدم StarterCharacter خاصًا بك، فيجب أن يكون اسم Humanoid فيه Humanoid، لأن السكربتين ينتظران كائنًا فرعيًا بهذا الاسم. وإذا كان الظهور بطيئًا فحسب، فالضغط على Try again يكمله.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("PlayRequest")'

ينتظر MainMenu الـ RemoteEvent الذي ينشئه MenuService، أي أن MenuService لا يعمل: إما معطّل، أو في مكان خاطئ، أو أوقفه خطأ. هذا التحذير مشروح في دليل أخطاء السكربتات.

شخصيتي تظهر خلف القائمة

شيء آخر يُظهر اللاعبين. أزل علامة CharacterAutoLoads من خدمة Players وابحث عن سكربت آخر يستدعي LoadCharacterAsync عند الدخول، مثل سكربت نقاط تفتيش obby: راجع القائمة مع الأنظمة الأخرى.

لا يظهر في القائمة سوى السماء

الكاميرا تستخدم المنظر الاحتياطي، أو لم تُحمَّل الخريطة. تحقق من أن اسم القطعة MenuCamera تمامًا، وأنها مباشرة في Workspace (لا في مجلد أو نموذج)، ومثبّتة، ووجهها الأمامي نحو الخريطة.

لا أعود للظهور بعد الموت

الآن لا يعيد إظهار اللاعبين إلا MenuService، فابحث في Output عن خطأ منه. إعادة الظهور الفاشلة تطبع MenuService: could not spawn وتتكرر بعد RespawnTime. وإذا كانت لعبتك تعطّل حالة Dead في Humanoid، فإن Died لا ينطلق أبدًا، لذا أعد إظهار اللاعب من كود الموت الخاص بك.

واجهة HUD من StarterGui لا تظهر إلا بعد Play

هكذا يجب أن يكون. مع تعطيل CharacterAutoLoads لا تنسخ Roblox الـ StarterGui إلى PlayerGui الخاص باللاعب إلا عند ظهور الشخصية. وما يجب أن يظهر في القائمة ابنه من LocalScript في StarterPlayerScripts، كما يفعل MainMenu.

اصنعها مع RoCode

إذا لم ترغب في بناء كل هذا يدويًا، فيمكن لـ RoCode أن يفعله في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، وليس من Roblox: تصف الميزة في دردشة الويب، فتنشئ إضافته لـ Studio القطعة والسكربتات في Explorer لديك، فلا تحتاج إلى نسخ الكود من نافذة الدردشة.

ما تكتبه

أضف قائمة رئيسية: يجب ألا يظهر اللاعبون حتى يضغطوا Play. اعرض اسم لعبتي وزر Play فوق لقطة كاميرا بطيئة من القطعة MenuCamera، واجعل الشاشة تعتم، وأظهر اللاعب من الخادم وأعد الكاميرا العادية. يجب أن تعمل على الهواتف ومع يد التحكم.

ما يفعله RoCode
  • قد يفحص مكانك أولًا عبر Search Scripts، مثلًا بحثًا عن سكربت يعطّل CharacterAutoLoads أصلًا أو يعيد إظهار اللاعبين (كما يفعل سكربت نقاط تفتيش obby)، كي لا يتعارض سكربتان
  • ينشئ القطعة MenuCamera عبر Create Instance ويعطّل Players.CharacterAutoLoads عبر Set Property
  • يكتب MenuService وMainMenu عبر Create Script
  • تعليماته أن يفحص كل سكربت كتبه عبر Check Script، الذي يترجمه في Studio دون تشغيله، ويضع نقطة تراجع قبل كل دفعة تغييرات وبعدها

لا يستطيع RoCode رفع صورة الشعار أو موسيقى القائمة نيابة عنك: ارفعها في Studio أو Creator Hub وأعطِ RoCode أرقام الأصول ID. مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.15 أو أحدث تستطيع شخصية الاختبار الضغط على الأزرار في الشاشة، لكنه لا يفحص إلا ما قرر هو فحصه، لذا جرّب القائمة بنفسك بالنقر. وبأي ترتيب تبني لعبة كاملة، راجع دليل كيف تصنع لعبة في Roblox بالذكاء الاصطناعي، نظامًا بعد نظام. كيف يتصل RoCode بـ Studio.

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

كيف أجعل اللاعب لا يظهر حتى يضغط Play؟

أزل علامة CharacterAutoLoads من خدمة Players، ثم أظهر اللاعب من Script على الخادم عبر player:LoadCharacterAsync() حين يصل RemoteEvent من زر Play. وتحتاج إعادة الظهور بعد الموت عندها إلى الاستدعاء نفسه، ويتولاها MenuService.

لماذا تظهر القائمة الرئيسية مرة أخرى بعد كل موت؟

لأن ResetOnSpawn مفعّل في الـ ScreenGui الخاص بها، فتعطي Roblox اللاعب نسخة جديدة عند كل ظهور. عطّله وأزل القائمة بعد Play، كما يفعل MainMenu.

كيف أجعل الكاميرا تعرض الخريطة خلف القائمة؟

في LocalScript اضبط workspace.CurrentCamera.CameraType على Scriptable وأعطِ الكاميرا CFrame القطعة التي وضعتها. وبعد Play أعده إلى Custom واجعل Humanoid قيمة CameraSubject.

كيف أضيف شاشة تحميل قبل القائمة؟

يستخدم دليل Roblox لشاشات التحميل LocalScript في ReplicatedFirst، الذي يصل إلى اللاعب قبل أي شيء آخر. يبني ScreenGui، ويستدعي ReplicatedFirst:RemoveDefaultLoadingScreen()، وينتظر حتى game:IsLoaded()، ثم يزيل شاشته. أعطِ هذا الـ ScreenGui قيمة DisplayOrder أعلى من 11 كي يغطي هذه القائمة حتى يختفي. ودليل شاشة التحميل لدينا يبني شاشة كهذه بشريط تقدّم وزر Skip، وقيمة DisplayOrder فيها 100 تغطي القائمة أصلًا.

كيف أضيف موسيقى إلى القائمة الرئيسية؟

استخدم صوتًا تملك حقوقه، مثل مقطع مجاني من Creator Store أو صوت رفعته بنفسك. ضع Sound بهذا الـ ID في SoundService، وفعّل Looped، واستدعِ فيه :Play() من MainMenu حين تظهر القائمة، و:Stop() في معالج Play. الصوت الذي يبدأ من LocalScript لا يسمعه إلا هذا اللاعب ما دام SoundService.RespectFilteringEnabled مفعّلًا، وهو مفعّل افتراضيًا.

هل يمكنني أخذ قائمة رئيسية من نموذج مجاني؟

يمكنك، لكن اقرأ سكربتاتها أولًا. تحذّر Roblox من أن نماذج Creator Store قد تحتوي على سكربتات أبواب خلفية تمنح أصحابها وصولًا إلى لعبتك. والقائمة لا تحتاج إلا إلى السكربتين القصيرين في هذا الدليل.

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

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

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

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