لوحات المتصدرين

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

وجهات نظر لوحة المتصدرين

تقارن قائمة اللاعبين النقاط عبر هذه الوجهات:

استخدم leaderstats لملء هنا. استخدم متجر بيانات مرتب لملء الأصدقاء والعالمية.

إدارة لوحات المتصدرين للجلسة باستخدام leaderstats

تدفع مجلد leaderstats على كل لاعب عرض هنا. الخطوات التالية تقوم بإعداد هذا المجلد، إضافة الإحصائيات، تحديثها خلال الجلسة، التحكم في ترتيبها، وإخفاء قائمة اللاعبين.

إعداد leaderstats

لإعداد لوحة المتصدرين وإضافة اللاعبين عند دخولهم التجربة:

1. أنشئ Script جديدة داخل ServerScriptService وسمها Leaderboard.

   

2. في السكربت، قم بتوصيل دالة بحدث PlayerAdded.

   local Players = game:GetService("Players")
   
   local function leaderboardSetup(player)
   
   end
   
   Players.PlayerAdded:Connect(leaderboardSetup)

3. داخل الدالة المتصلة، أنشئ مثيل جديد من Folder، وسمه leaderstats، واجعله تابعًا للاعب.

   local Players = game:GetService("Players")
   
   local function leaderboardSetup(player)
   	local leaderstats = Instance.new("Folder")
   	leaderstats.Name = "leaderstats"
   	leaderstats.Parent = player
   end
   
   Players.PlayerAdded:Connect(leaderboardSetup)

   من الضروري أن يكون اسم المجلد leaderstats بحروف صغيرة. لا تضيف Roblox اللاعب إلى لوحة المتصدرين إذا سميته بأي طريقة أخرى.

إضافة الإحصائيات

تستخدم لوحات المتصدرين كائنات من نوع القيمة لتخزين وعرض إحصائيات اللاعبين. يظهر هذا السكربت ذهب اللاعب باستخدام IntValue، وهو عنصر نائب لعدد صحيح.

في دالة leaderboardSetup()، أضف الأسطر من 8 إلى 11:

local Players = game:GetService("Players")

local function leaderboardSetup(player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"
	leaderstats.Parent = player

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Value = 0
	gold.Parent = leaderstats
end

Players.PlayerAdded:Connect(leaderboardSetup)

تقوم هذه الأسطر بما يلي:

1. يتم إنشاء مثيل من IntValue.

2. يتم تعيين Name للمثيل إلى "Gold". هذه هي الطريقة التي ستظهر بها الإحصائية على لوحة المتصدرين.

   

3. يتم تعيين القيمة الأولية لـ Value للإحصائية إلى 0. يمكنك تعيين هذا إلى أي قيمة ترغب بها، بما في ذلك قيمة مخزنة في متجر بيانات إذا كنت تقوم بتنفيذ لوحات متصدرين دائمة.

   لاحظ أن قيمة الكائنات مثل IntValue، NumberValue، وStringValue يجب تعيينها من خلال خاصية Value الخاصة بها، كما في gold.Value في السطر 10.

4. يتم تعيين المثيل إلى مجلد leaderstats مما يضيفه إلى لوحة المتصدرين. عندما يدخل اللاعب التجربة، يظهر اسمه على اللوحة.

   

تحديث الإحصائيات

لتحديث إحصائية لوحة المتصدرين للاعب، قم بتغيير خاصية Value لتلك الإحصائية داخل مجلد leaderstats الخاص بهم. على سبيل المثال، يمكنك توصيل السكربت التالي بأي كائن جمع لزيادة إحصائية Gold للاعب الذي يجمعه.

local Players = game:GetService("Players")

local goldChunk = script.Parent

local function onPartTouch(otherPart)
	local partParent = otherPart.Parent
	local player = Players:GetPlayerFromCharacter(partParent)
	local leaderstats = player and player:FindFirstChild("leaderstats")
	local goldStat = leaderstats and leaderstats:FindFirstChild("Gold")

	if goldStat then
		-- تدمير العنصر الملتقط
		goldChunk:Destroy()

		-- تحديث إحصائية لوحة المتصدرين للاعب
		goldStat.Value += 10
	end
end

goldChunk.Touched:Connect(onPartTouch)

ترتيب الإحصائيات

هناك ثلاث طرق للتحكم في ترتيب الإحصائيات في لوحة المتصدرين:

• أضف الإحصائيات بالترتيب الذي تريد أن تظهر به.
• أضف قيمة فرعية BoolValue باسم IsPrimary إلى الإحصائية واضبط قيمتها على true لوضع الإحصائية أولاً في لوحة المتصدرين.
• أضف قيمة فرعية NumberValue باسم Priority إلى الإحصائية واضبط قيمتها على عدد صحيح. تظهر قيم الأولوية الأعلى في وقت أبكر في لوحة المتصدرين. الإحصائيات بدون أولوية لها أولوية افتراضية قدرها 0.

يظهر هذا المثال البرمجي كيفية إضافة قيمة IsPrimary إلى إحصائية:

local Players = game:GetService("Players")

local function leaderboardSetup(player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"
	leaderstats.Parent = player

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Value = 0
	gold.Parent = leaderstats

	local isPrimary = Instance.new("BoolValue")
	isPrimary.Name = "IsPrimary"
	isPrimary.Value = true
	isPrimary.Parent = gold
end

Players.PlayerAdded:Connect(leaderboardSetup)

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

لإخفاء لوحة المتصدرين، مثلًا على شاشة القائمة أو خلال مشهد، ضع LocalScript داخل StarterGui أو StarterPlayerScripts يحتوي على استدعاء لـ StarterGui.

local StarterGui = game:GetService("StarterGui")

StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false)

إدارة لوحات المتصدرين الدائمة باستخدام متجر بيانات مرتب

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

يدعم الإصدار التجريبي الأول لوحة متصدرين دائمة واحدة نشطة لكل تجربة. فقط لوحة المتصدرين المسجلة والنشطة تظهر في وجهات نظر الأصدقاء والعالمية.

متطلبات البيانات

قبل تسجيل لوحة المتصدرين، تأكد من أن بياناتها تلبي هذه المتطلبات:

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

إعداد البيانات المرتبة

اختر المسار الذي يتناسب مع كيفية تخزين تجربتك للنقاط حاليًا.

استخدام متجر بيانات مرتب موجود

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

لا تحتاج إلى إعادة بناء بيانات لوحة المتصدرين أو نسخها إلى خدمة ترتيب منفصلة.

إنشاء متجر بيانات مرتب

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

local DataStoreService = game:GetService("DataStoreService")
local playerScores = DataStoreService:GetOrderedDataStore("PlayerScores")

local function saveScore(player, score)
	local success, errorMessage = pcall(function()
		playerScores:SetAsync(tostring(player.UserId), score)
	end)

	if not success then
		warn(errorMessage)
	end
end

تحقق من وجود النقاط قبل تسجيل متجر البيانات في مركز المبدعين. لمزيد من المعلومات حول تخزين وترتيب القيم الدائمة، راجع متاجر البيانات المرتبة.

ترحيل النقاط من خلفية أخرى

إذا كان متجر بيانات قياسي، قاعدة بيانات خارجية، أو خلفية أخرى تخزن بيانات لوحة المتصدرين الخاصة بك، قم بترحيل النقاط التي تريد عرضها إلى متجر بيانات مرتب. احتفظ بنقطة عددية واحدة لكل لاعب واستخدم تنسيق مفتاح ثابت يحدد اللاعب.

بعد الترحيل، قم بتحديث تدفق تسجيل النقاط لديك حتى تستمر تغييرات النقاط الجديدة في الوصول إلى متجر البيانات المرتب.

تكوين لوحة المتصدرين في مركز المبدعين

قبل أن تبدأ، تأكد من أن تجربتك تكتب نقاطًا صالحة إلى متجر البيانات المرتب.

1. افتح مركز المبدعين.
2. اختر التجربة التي تمتلك متجر البيانات المرتب.
3. سجل متجر البيانات المرتب الذي يحتوي على نقاط لوحة المتصدرين الخاصة بك.
4. قم بتمكين لوحة المتصدرين للتجربة.
5. تأكد من أن لوحة المتصدرين نشطة.
6. اختبر لوحة المتصدرين داخل التجربة وتحقق من ظهور النقاط كما هو متوقع.

إلغاء تنشيط لوحة المتصدرين يخفيها عن اللاعبين ولكنه لا يحذف متجر البيانات المرتب أو النقاط الخاصة بها.

اختبار وجهات نظر الأصدقاء والعالمية

اختبر مع لاعبين لديهم إدخالات نقاط بالفعل.

1. انضم إلى التجربة كلاعب لديه نقطة محفوظة.
2. افتح لوحة المتصدرين داخل التجربة.
3. اختر الأصدقاء وتأكد من ظهور الأصدقاء المؤهلين مع النقاط المتوقعة.
4. اختر العالمية وتأكد من ظهور اللاعب مع الرتبة والنقطة المتوقعة.
5. قم بتحديث نقطة اللاعب من خلال تدفقك الحالي على الخادم.
6. تأكد من أن لوحة المتصدرين تعكس القيمة المحدثة.

إدارة النقاط

استمر في تحديث وتصحيح وتعديل النقاط من خلال تدفق متجر البيانات المرتب الخاص بك. يتحكم مركز المبدعين في أي لوحة متصدرين نشطة، لكنه لا يستبدل منطق كتابة النقاط أو الاعتدال لديك.

احمِ كتابة النقاط من خلال التحقق على الخادم، وراجع القيم المشبوهة أو المستحيلة قبل أن تؤثر على تصنيفات اللاعبين.

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