درس · بيانات اللاعب

كيف تصنع لوحة متصدرين في Roblox Studio

قائمة اللاعبين في الزاوية العلوية اليمنى من لعبة Roblox يتحكم فيها مجلد واحد باسم leaderstats. هذا الدليل يبنيها من الصفر: سكربت على الخادم، وطريقة آمنة لمنح النقاط، والحفظ بين الجلسات، وأفضل 10 على مستوى العالم.

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

باختصار

أنشئ Script في ServerScriptService يستمع إلى Players.PlayerAdded، وينشئ Folder باسم leaderstats تمامًا (كله بأحرف صغيرة) ويجعله ابنًا للاعب. كل IntValue أو NumberValue أو StringValue داخل هذا المجلد يصبح عمودًا في قائمة اللاعبين.

  • أنشئ الإحصائيات وغيّرها على الخادم فقط. التغيير الذي يجريه LocalScript يراه هذا اللاعب وحده، ولا يراه أحد غيره.
  • leaderstats لا يُحفظ. حمّل القيم واحفظها عبر data store إذا كان يجب أن تبقى حتى الجلسة التالية.
  • لترتيب يشمل كل اللاعبين، اكتب كل نتيجة في ordered data store واعرضها على لوحة داخل عالمك أو في وضع Global لقائمة اللاعبين.
في هذه الصفحة
  1. كيف يعمل leaderstats
  2. 1. إنشاء leaderstats
  3. 2. منح النقاط
  4. 3. الحفظ
  5. 4. أفضل 10 عالميًا
  6. Common errors
  7. مع RoCode
  8. الأسئلة الشائعة
  9. المصادر والقراءات

كيف يعمل leaderstats

توضيحسكربتا leaderstats ومنصة العملات جاهزان داخل لعبة قيد التشغيل.

يعرض Roblox قائمة اللاعبين في كل لعبة. عندما يكون لدى اللاعب Folder ابن باسم leaderstats، تضيف القائمة عمودًا لكل كائن قيمة بداخله وتعرض قيمة هذا اللاعب في صفه. عنوان العمود هو Name الخاص بكائن القيمة.

كائنات القيم التي يمكن وضعها في leaderstats
الكائنيحفظمناسب لـ
IntValueأعداد صحيحةالعملات، والقتلات، والانتصارات، والمستوى
NumberValueأعداد عشريةأفضل زمن للفة، والمسافة
StringValueنصالرتبة أو لقب الفريق

قاعدتان تفسدان تقريبًا كل لوحة متصدرين لا تعمل. يجب أن يكون اسم المجلد leaderstats تمامًا: Leaderstats أو leaderStats يتم تجاهلهما. ويجب أن ينشئ المجلد Script على الخادم، لأن التغييرات على الخادم وحدها تُنسخ إلى كل اللاعبين. إذا لم تكن متأكدًا أين يعمل الكود، فاقرأ أولًا Script vs LocalScript vs ModuleScript (بالإنجليزية).

الخطوة 1: أنشئ سكربت leaderstats

  1. في Explorer مرّر المؤشر فوق ServerScriptService، واضغط الزر + وأدرج Script.
  2. أعد تسميته إلى Leaderstats لتجده بسهولة لاحقًا.
  3. استبدل محتواه بالكود أدناه واضغط Play. سيظهر اسمك في قائمة اللاعبين مع Coins وWins تساويان 0.
Script في ServerScriptService باسم Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- يجب أن يكون الاسم هكذا تمامًا، كله بأحرف صغيرة

	local coins = Instance.new("IntValue")
	coins.Name = "Coins"
	coins.Value = 0
	coins.Parent = leaderstats

	local wins = Instance.new("IntValue")
	wins.Name = "Wins"
	wins.Value = 0
	wins.Parent = leaderstats

	leaderstats.Parent = player -- نحدد الأب أخيرًا، بعد أن تصبح القيم بداخله
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- في Studio قد تدخل قبل أن يبدأ هذا السكربت، لذلك نجهّز من هم هنا بالفعل
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

الحلقة في النهاية مهمة عند الاختبار في Studio: أحيانًا يدخل اللاعب الأول قبل ربط PlayerAdded، وبدون الحلقة سيبقى بلا إحصائيات.

الخطوة 2: امنح النقاط بأمان

لتغيير إحصائية، اضبط Value الخاصة بها من سكربت على الخادم. منصة العملات هذه تعطي 10 عملات عندما يلمسها اللاعب. Touched ينطلق مرات كثيرة في الثانية ما دامت الشخصية واقفة على القطعة، لذلك يحتفظ السكربت بفترة تهدئة قصيرة لكل لاعب.

Script في قطعة في Workspace باسم CoinPad
local Players = game:GetService("Players")

local part = script.Parent :: BasePart
local REWARD = 10
local COOLDOWN_SECONDS = 1

local lastReward: { [Player]: number } = {}

part.Touched:Connect(function(hit: BasePart)
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return
	end

	local now = os.clock()
	local last = lastReward[player]
	if last and now - last < COOLDOWN_SECONDS then
		return -- Touched ينطلق مرات كثيرة في الخطوة الواحدة؛ هذا يمنع لمسة واحدة من الدفع عشر مرات
	end
	lastReward[player] = now

	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if coins and coins:IsA("IntValue") then
		coins.Value += REWARD
	end
end)

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

FindFirstAncestorOfClass("Model") يجد الشخصية حتى عندما تكون القطعة التي لمست داخل إكسسوار، أما التحقق البسيط من hit.Parent فيفوّت ذلك.

إذا كانت النقاط تُمنح مقابل شيء يفعله اللاعب على شاشته، كالضغط على زر مثلًا، فيجب أن يطلب LocalScript ذلك من الخادم عبر RemoteEvent، وأن يقرر الخادم هل يدفع. لا تسمح أبدًا للعميل بإرسال المبلغ. دليل RemoteEvents يعرض هذا النمط مع التحقق.

أربعة أمثلة جاهزة: دليل اللعبة الأولى يعطي 1 Coin مقابل كل عملة يلمسها اللاعب في المسار، وWin على منصة النهاية بعد 3 عملات، ودليل محاكي النقر يعطي Coins مقابل الضغط على زر مع حد للنقرات على الخادم، ودليل السيف يضيف 1 إلى Kills لمن وجّه الضربة الأخيرة قبل موت اللاعب، ودليل السلاح يبيّن كيف تحتسب القتلة عندما تُنزل الطلقة Health الهدف إلى 0.

الخطوة 3: احفظ الإحصائيات بين الجلسات

يعيش leaderstats فقط ما دام الخادم يعمل. لحفظ العملات والانتصارات، حمّلها من data store عند دخول اللاعب، واحفظها عند خروجه. هذه النسخة تحل محل سكربت الخطوة 1. وهي لا تحفظ أبدًا لاعبًا لم تُحمَّل بياناته: هذا الخطأ تحديدًا هو ما يمسح التقدم في معظم سكربتات الحفظ المنسوخة.

Script في ServerScriptService باسم Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- يُستدعى داخل كل pcall أدناه، لذلك المكان غير المنشور بعد
-- (دون وصول إلى data store) يحصل على لوحة المتصدرين على أي حال
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- اللاعبون الذين تم تحميل إحصائياتهم المحفوظة. من ليس هنا لا نحفظه أبدًا،
-- لذلك لن يستبدل التحميل الفاشل التقدم الحقيقي بأصفار.
local loaded: { [Player]: boolean } = {}

local function keyFor(player: Player): string
	return "player_" .. player.UserId
end

local function onPlayerAdded(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"

	local coins = Instance.new("IntValue")
	coins.Name = "Coins"
	coins.Parent = leaderstats

	local wins = Instance.new("IntValue")
	wins.Name = "Wins"
	wins.Parent = leaderstats

	local ok, data = pcall(function()
		return statsStore():GetAsync(keyFor(player))
	end)
	if ok then
		if type(data) == "table" then
			coins.Value = tonumber(data.Coins) or 0
			wins.Value = tonumber(data.Wins) or 0
		end
		loaded[player] = true
	else
		warn(`Could not load stats for {player.Name}: {data}`)
	end

	leaderstats.Parent = player
end

local function save(player: Player)
	if not loaded[player] then
		return
	end
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	if not (coins and coins:IsA("IntValue") and wins and wins:IsA("IntValue")) then
		return
	end
	local ok, err = pcall(function()
		statsStore():SetAsync(keyFor(player), { Coins = coins.Value, Wins = wins.Value })
	end)
	if not ok then
		warn(`Could not save stats for {player.Name}: {err}`)
	end
end

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

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

-- عندما يتوقف الخادم، نحفظ الجميع قبل الإغلاق
game:BindToClose(function()
	local pending = 0
	for _, player in Players:GetPlayers() do
		pending += 1
		task.spawn(function()
			save(player)
			pending -= 1
		end)
	end
	while pending > 0 do
		task.wait()
	end
end)

هذا يكفي للعبة صغيرة. عن إعادة المحاولة، وUpdateAsync، وحدود الطلبات، والحماية من خادمين يكتبان بيانات اللاعب نفسه، تابع القراءة في درس DataStore.

الخطوة 4: أفضل 10 عالميًا

يقارن leaderstats فقط بين اللاعبين على خادم واحد. للترتيب العالمي تحتاج إلى ordered data store: وهو data store يحفظ رقمًا واحدًا لكل مفتاح ويستطيع إعادة المفاتيح مرتبة حسب القيمة. اكتب فيه نتيجة كل لاعب من الخادم، ثم اقرأ الإدخالات الأعلى منه.

يمكن عرضه بطريقتين. في قائمة اللاعبين في Roblox يوجد وضعا Friends وGlobal اللذان يقرآن ordered data store مسجّلًا في Creator Hub (عند كتابة هذا الدليل هي ميزة تجريبية، بلوحة متصدرين نشطة واحدة لكل لعبة). أو يمكنك رسم الترتيب بنفسك على لوحة داخل عالمك: هذا يعمل في أي لعبة ويتيح لك تنسيقه كما تشاء. السكربت أدناه يفعل الطريقة الثانية، ويكتب النتائج بالـ user ID الخاص باللاعب كمفتاح، وهي الصيغة نفسها التي تنتظرها لوحة المتصدرين في Creator Hub.

  1. أضف إلى Workspace قطعة Part مثبّتة، وسمّها WinsBoard واجعلها بحجم لافتة (مثلًا 12 في 8 في 1 ستد)، ووجهها الأمامي نحو نقطة الظهور.
  2. أدرج في ServerScriptService سكربت Script باسم GlobalWinsBoard مع الكود أدناه.
  3. اضغط Play. ستمتلئ اللوحة بعد أول تحديث، وستتحدّث كل دقيقة.
Script في ServerScriptService باسم GlobalWinsBoard
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")

local TOP_N = 10
local REFRESH_SECONDS = 60

-- اللوحة: Part مثبّتة باسم WinsBoard في Workspace. السكربت نفسه يضيف
-- SurfaceGui والأسطر، لذلك لا تحتاج إلى بناء سوى الـ Part.
local boardPart = workspace:WaitForChild("WinsBoard") :: BasePart

local gui = Instance.new("SurfaceGui")
gui.Face = Enum.NormalId.Front
gui.SizingMode = Enum.SurfaceGuiSizingMode.PixelsPerStud
gui.PixelsPerStud = 50
gui.Parent = boardPart

local list = Instance.new("Frame")
list.Size = UDim2.fromScale(1, 1)
list.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
list.Parent = gui

local layout = Instance.new("UIListLayout")
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = list

local nameCache: { [number]: string } = {}

local function nameFor(userId: number): string
	local cached = nameCache[userId]
	if cached then
		return cached
	end
	local ok, name = pcall(function()
		return Players:GetNameFromUserIdAsync(userId)
	end)
	local result = if ok then name else "Unknown player"
	nameCache[userId] = result
	return result
end

local function recordWins(player: Player)
	local leaderstats = player:FindFirstChild("leaderstats")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	if wins and wins:IsA("IntValue") then
		local ok, err = pcall(function()
			winsBoard:SetAsync(tostring(player.UserId), wins.Value)
		end)
		if not ok then
			warn(`Could not record wins for {player.Name}: {err}`)
		end
	end
end

local function refresh()
	local ok, pages = pcall(function()
		return winsBoard:GetSortedAsync(false, TOP_N)
	end)
	if not ok then
		warn(`Could not read the wins board: {pages}`)
		return
	end

	for _, child in list:GetChildren() do
		if child:IsA("TextLabel") then
			child:Destroy()
		end
	end

	for rank, entry in pages:GetCurrentPage() do
		local label = Instance.new("TextLabel")
		label.Size = UDim2.new(1, 0, 1 / TOP_N, 0)
		label.BackgroundTransparency = 1
		label.TextColor3 = Color3.new(1, 1, 1)
		label.TextScaled = true
		label.Text = `{rank}. {nameFor(tonumber(entry.key) or 0)}   {entry.value}`
		label.LayoutOrder = rank
		label.Parent = list
	end
end

while true do
	for _, player in Players:GetPlayers() do
		recordWins(player)
	end
	refresh()
	task.wait(REFRESH_SECONDS)
end

GetSortedAsync(false, 10) يعيد أكبر 10 قيم أولًا. ordered data store يحفظ الأعداد الصحيحة فقط، لذلك احفظ النتائج كأعداد صحيحة. السكربت يكتب كل لاعب مرة في الدقيقة ويقرأ أفضل 10 مرة في الدقيقة، بهامش كبير ضمن الحدود القياسية لكل خادم (30 + 5 لكل لاعب في الدقيقة لعمليات الكتابة في ordered data store، و5 + 2 لكل لاعب للقراءات المرتبة، حسب التوثيق في 30 سبتمبر 2026).

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

المشكلات أدناه تغطي معظم الشكاوى من نوع «لوحة المتصدرين عندي لا تعمل». افحص أولًا نافذة Output (افتحها من قائمة Window في Studio أو من تبويب Script): إذا توقف السكربت بخطأ، فستجد هناك رقم السطر.

لوحة المتصدرين لا تظهر إطلاقًا

تأكّد أن المجلد اسمه leaderstats بأحرف صغيرة، وأن أباه هو Player (وليس الشخصية)، وأن الكود Script في ServerScriptService وليس LocalScript.

اللاعبون الآخرون لا يرون تغييرات إحصائيتي

تم تغيير القيمة على العميل. انقل التغيير إلى Script على الخادم، وإذا كان يُطلَق بزر أو مفتاح، فأرسل RemoteEvent ودع الخادم يغيّر القيمة.

attempt to index nil with 'Coins'

حاول الكود قراءة player.leaderstats.Coins قبل ظهور المجلد، أو أن الاسم مكتوب بشكل مختلف. على الخادم استخدم FindFirstChild وتحقّق من النتيجة؛ وفي LocalScript استخدم player:WaitForChild("leaderstats"). دليل أخطاء السكربتات يشرح هذا الخطأ بالتفصيل.

العملات تزيد 10 أو 20 أو 50 من لمسة واحدة

Touched ينطلق مرارًا ما دامت القطع متداخلة. أضف فترة تهدئة لكل لاعب كما في الخطوة 2، أو احذف العنصر بعد التقاطه.

الإحصائيات تُعاد إلى الصفر عند كل عودة للعبة

لا يحفظ Roblox الـ leaderstats. أضف سكربت الخطوة 3. لتختبر الحفظ في Studio، انشر المكان وفعّل Studio Access to API Services في Experience Settings.

اصنعه مع RoCode

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

ما تكتبه

أضف لوحة متصدرين فيها Coins وWins تُحفظ بين الجلسات، ولوحة لأفضل 10 في الانتصارات على قطعة بجانب نقطة الظهور.

ما يفعله RoCode
  • يمكنه أولًا البحث في المكان عن كود leaderstats أو DataStore موجود، ليكمل ما هو موجود بدل إضافة لوحة متصدرين ثانية
  • ينشئ سكربتًا على الخادم في ServerScriptService وقطعة للوحة في Workspace
  • يتحقق من تجميع السكربتات التي كتبها داخل Studio قبل أن ينهي
  • يرسل التغييرات على دفعات، وكل دفعة تُعلَّم كنقطة تراجع في سجل Studio

تبقى أنت من يراجع النتيجة ويختبر الإحصائيات والحفظ في اللعبة بنفسه: مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم في شخصية اختبار والتحقق من قيم مثل Coins وWins، لكنه يفحص فقط ما اختار اختباره بنفسه. عادةً يكون leaderstats أول أنظمة كثيرة في اللعبة: ابنِ بقية اللعبة بنظام واحد في كل طلب بالطريقة نفسها. كيف يتصل RoCode بـ Studio.

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

ما هو leaderstats في Roblox؟

هو Folder باسم leaderstats تمامًا، كله بأحرف صغيرة، داخل Player. يعرض Roblox كل IntValue أو NumberValue أو StringValue فيه كعمود في قائمة اللاعبين. أنشئه من Script على الخادم، كما في الخطوة 1.

كيف أصنع لوحة متصدرين عالمية في Roblox؟

اكتب نتيجة كل لاعب في ordered data store من الخادم، ثم اقرأ الإدخالات الأعلى منه واعرضها على لوحة داخل عالمك. في الخطوة 4 سكربت كامل لأفضل 10.

هل يحفظ Roblox الـ leaderstats تلقائيًا؟

لا. leaderstats موجود فقط ما دام اللاعب على الخادم. احفظ القيم عبر data store عند خروج اللاعب، وحمّلها عند دخوله، كما في الخطوة 3.

هل يمكن إخفاء قيمة من لوحة المتصدرين؟

نعم. تُعرض فقط القيم الموجودة داخل مجلد leaderstats. احفظ البيانات الخاصة في مجلد آخر لدى اللاعب أو في جدول داخل سكربت على الخادم.

كيف أخفي قائمة اللاعبين كلها؟

من LocalScript استدعِ StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). مرّر true لتظهرها من جديد.

هل يمكن استخدام NumberValue للعملات؟

يمكن، لكن IntValue أنسب لعملة من أعداد صحيحة، كما أن ordered data store يقبل الأعداد الصحيحة فقط، إذا أردت لاحقًا بناء ترتيب عليها.

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

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

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

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