باختصار
أنشئ Script في ServerScriptService يستمع إلى Players.PlayerAdded، وينشئ Folder باسم leaderstats تمامًا (كله بأحرف صغيرة) ويجعله ابنًا للاعب. كل IntValue أو NumberValue أو StringValue داخل هذا المجلد يصبح عمودًا في قائمة اللاعبين.
- أنشئ الإحصائيات وغيّرها على الخادم فقط. التغيير الذي يجريه LocalScript يراه هذا اللاعب وحده، ولا يراه أحد غيره.
- leaderstats لا يُحفظ. حمّل القيم واحفظها عبر data store إذا كان يجب أن تبقى حتى الجلسة التالية.
- لترتيب يشمل كل اللاعبين، اكتب كل نتيجة في ordered data store واعرضها على لوحة داخل عالمك أو في وضع Global لقائمة اللاعبين.
في هذه الصفحة
كيف يعمل leaderstats
يعرض Roblox قائمة اللاعبين في كل لعبة. عندما يكون لدى اللاعب Folder ابن باسم leaderstats، تضيف القائمة عمودًا لكل كائن قيمة بداخله وتعرض قيمة هذا اللاعب في صفه. عنوان العمود هو Name الخاص بكائن القيمة.
| الكائن | يحفظ | مناسب لـ |
|---|---|---|
IntValue | أعداد صحيحة | العملات، والقتلات، والانتصارات، والمستوى |
NumberValue | أعداد عشرية | أفضل زمن للفة، والمسافة |
StringValue | نص | الرتبة أو لقب الفريق |
قاعدتان تفسدان تقريبًا كل لوحة متصدرين لا تعمل. يجب أن يكون اسم المجلد leaderstats تمامًا: Leaderstats أو leaderStats يتم تجاهلهما. ويجب أن ينشئ المجلد Script على الخادم، لأن التغييرات على الخادم وحدها تُنسخ إلى كل اللاعبين. إذا لم تكن متأكدًا أين يعمل الكود، فاقرأ أولًا Script vs LocalScript vs ModuleScript (بالإنجليزية).
الخطوة 1: أنشئ سكربت leaderstats
- في Explorer مرّر المؤشر فوق ServerScriptService، واضغط الزر + وأدرج Script.
- أعد تسميته إلى
Leaderstatsلتجده بسهولة لاحقًا. - استبدل محتواه بالكود أدناه واضغط Play. سيظهر اسمك في قائمة اللاعبين مع Coins وWins تساويان 0.
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 ينطلق مرات كثيرة في الثانية ما دامت الشخصية واقفة على القطعة، لذلك يحتفظ السكربت بفترة تهدئة قصيرة لكل لاعب.
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. وهي لا تحفظ أبدًا لاعبًا لم تُحمَّل بياناته: هذا الخطأ تحديدًا هو ما يمسح التقدم في معظم سكربتات الحفظ المنسوخة.
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.
- أضف إلى Workspace قطعة Part مثبّتة، وسمّها
WinsBoardواجعلها بحجم لافتة (مثلًا 12 في 8 في 1 ستد)، ووجهها الأمامي نحو نقطة الظهور. - أدرج في ServerScriptService سكربت Script باسم
GlobalWinsBoardمع الكود أدناه. - اضغط Play. ستمتلئ اللوحة بعد أول تحديث، وستتحدّث كل دقيقة.
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 في الانتصارات على قطعة بجانب نقطة الظهور.
- يمكنه أولًا البحث في المكان عن كود 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 يقبل الأعداد الصحيحة فقط، إذا أردت لاحقًا بناء ترتيب عليها.
المصادر والقراءات
- Roblox Creator Docs: Leaderboards (بالإنجليزية). leaderstats، وترتيب الإحصائيات، والوضعان الدائمان Friends وGlobal
- Roblox Creator Docs: Data stores (بالإنجليزية). GetAsync وSetAsync وordered data stores والحدود
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.