الشارات

A badge is a special award you can gift players when they meet a goal within your game, such as completing a difficult objective or playing for a certain amount of time. As soon as a player receives a badge, it displays within the Badges category of their inventory.

إنشاء الشارات

يمكنك إنشاء ما يصل إلى 5 شارات مجانًا في فترة 24 ساعة (بتوقيت غرينتش) لكل لعبة تمتلكها. إذا كنت ترغب في إنشاء المزيد خلال فترة الـ 24 ساعة، فإن كل شارة إضافية تكلف 100 روبوكس.

لإنشاء شارة:

1. انتقل إلى لوحة التحكم الخاصة بالمنشئين.

2. مرر فوق صورة مصغرة للعبة، انقر على زر ⋯، واختر إنشاء شارة.

   

3. في صفحة الإنشاء، انقر على زر تحميل الصورة ثم اختر/أكد الصورة التي تريد استخدامها كأيقونة للشارة. عند إنشاء صورة لاستخدامها لشارة، ضع في اعتبارك ما يلي:

   • استخدم قالب بحجم 512×512 بكسل.

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

     

     

4. أكمل الحقول التالية:

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

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

   

إعادة ترتيب الشارات

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

لإعادة ترتيب الشارات:

1. انتقل إلى اللعبة المعنية.

2. في اللوحة الجانبية تحت عنوان المشاركة، انتقل إلى صفحة الشارات.

3. اختر إعادة الترتيب للانتقال إلى صفحة إعادة الترتيب.

   

4. في صفحة إعادة الترتيب، اسحب وأفلت الشارات في الترتيب المفضل لديك.

   

5. اختر حفظ لحفظ هذا الترتيب. يجب أن يظهر الترتيب المحدد الآن في صفحة تفاصيل اللعبة.

سكربت الشارات

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

تحديد معرفات الشارات

معرف الشارة هو معرفها الفريد. ستحتاج إلى هذا المعرف عند تنفيذ سير العمل مثل منح الشارة للاعب.

1. على لوحة التحكم الخاصة بالمنشئين، انتقل إلى قسم الشارات للعبة المعنية تحت المشاركة.

2. مرر فوق صورة مصغرة لشارة، انقر على زر ⋯، واختر نسخ معرف الأصل من قائمة السياق.

   

منح الشارات

يمكنك منح الشارات للاعبين في جميع أنحاء لعبتك عن طريق استدعاء الطريقة BadgeService:AwardBadgeAsync() في سكربت من جانب الخادم Script. تعيد BadgeService:GetBadgeInfoAsync() خصائص الشارة، بما في ذلك IsEnabled التي تؤكد ما إذا كانت الشارة يمكن منحها للاعب أم لا. يمكنك تفعيل أو تعطيل الشارة من نموذج تكوين الشارة على لوحة التحكم الخاصة بالمنشئين.

فيما يلي مثال على دالة آمنة لمنح الشارات للاعبين.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Fetch badge information
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Confirm that badge can be awarded
		if badgeInfo.IsEnabled then
			-- Award badge
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("خطأ أثناء منح الشارة:", errorMessage)
			end
		end
	else
		warn("خطأ أثناء جلب معلومات الشارة: " .. badgeInfo)
	end
end

التحقق من الشارات المكتسبة

السكربت التالي يتحقق عند دخول أي لاعب إلى اللعبة، ثم يستخدم الطريقة BadgeService:UserHasBadgeAsync() للتحقق مما إذا كان ذلك اللاعب يمتلك الشارة ذات المعرف المطابق المحدد في المتغير BADGE_ID. يمكنك أيضًا التحقق من ملكية الشارة في دفعات باستخدام الطريقة BadgeService:GetUserBadgesAsync().

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

local BADGE_ID = 00000000  -- غير هذا إلى معرف الشارة الخاص بك

local function onPlayerAdded(player)
  -- Check if the player has the badge
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- If there's an error, issue a warning and exit the function
	if not success then
		warn("خطأ أثناء التحقق مما إذا كان اللاعب يمتلك الشارة")
		return
	end

	if hasBadge then
		-- Handle player's badge ownership as needed
	end
end

-- Connect "PlayerAdded" events to the "onPlayerAdded()" function
Players.PlayerAdded:Connect(onPlayerAdded)

الحصول على معلومات الشارة

للحصول على معلومات حول شارة، مثل وصفها أو معرف الأصل الخاص بها، استدعِ الطريقة BadgeService:GetBadgeInfoAsync() مع معرف الشارة. على سبيل المثال:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- غير هذا إلى معرف الشارة الخاص بك

-- Fetch badge information
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Output the information
if success then
	print("شارة:", result.Name)
	print("مفعلة:", result.IsEnabled)
	print("الوصف:", result.Description)
	print("الأيقونة:", "rbxassetid://" .. result.IconImageId)
else
	warn("خطأ أثناء جلب معلومات الشارة:", result)
end