เข็มกลัด

A เข็มกลัด คือรางวัลพิเศษที่คุณสามารถมอบให้กับผู้เล่นเมื่อพวกเขาบรรลุเป้าหมายภายในเกมของคุณ เช่น การทำภารกิจที่ยากหรือการเล่นเป็นระยะเวลาหนึ่ง เมื่อผู้เล่นได้รับเข็มกลัดแล้ว มันจะแสดงอยู่ในหมวด เข็มกลัด ของสินค้าคงคลังของพวกเขา

การสร้างเข็มกลัด

คุณสามารถสร้างเข็มกลัดได้สูงสุด 5 ชิ้นฟรีในช่วงระยะเวลา 24 ชั่วโมง (GMT) สำหรับแต่ละเกมที่คุณเป็นเจ้าของ หากคุณต้องการสร้างมากกว่าในช่วงระยะเวลา 24 ชั่วโมง จะมีค่าใช้จ่ายเพิ่มเติมสำหรับเข็มกลัดแต่ละชิ้นอยู่ที่ 100 Robux

ในการสร้างเข็มกลัด:

1. ไปที่ แดชบอร์ดนักสร้าง.

2. ชี้เมาส์ไปที่ภาพขนาดย่อของเกม คลิกที่ปุ่ม ⋯ และเลือก สร้างเข็มกลัด.

   

3. ในหน้าสร้าง คลิกที่ปุ่ม อัปโหลดภาพ และจากนั้นเลือก/ยืนยันภาพที่คุณต้องการใช้เป็นไอคอนของเข็มกลัด เมื่อสร้างภาพที่จะใช้สำหรับเข็มกลัด โปรดพิจารณาสิ่งต่อไปนี้:

   • ใช้แม่แบบขนาด 512×512 พิกเซล.

   • กระบวนการอัปโหลดจะตัดและครอบภาพเข็มกลัดให้เป็นไอคอนกลม ดังนั้นให้หลีกเลี่ยงการใส่รายละเอียดที่สำคัญนอกเหนือจากขอบเขตกลม

     

     

4. เติมข้อมูลในฟิลด์ต่อไปนี้:

   • ชื่อ — ชื่อสำหรับเข็มกลัด.
   • คำอธิบาย — คำอธิบายเกี่ยวกับสิ่งที่ผู้เล่นสามารถทำเพื่อรับเข็มกลัด.
   • เข็มกลัดเปิดใช้งาน — ว่าเข็มกลัดจะถูกเปิดใช้งานเมื่อสร้างหรือไม่ เข็มกลัดที่ปิดใช้งานจะไม่แสดงในส่วน เข็มกลัด ของหน้าหลักของเกมและไม่สามารถได้รับโดยผู้เล่น

5. คลิกที่ปุ่ม สร้างเข็มกลัด เข็มกลัดใหม่จะแสดงในส่วน การมีส่วนร่วม ⟩ เข็มกลัด บน แดชบอร์ดนักสร้าง. หากเข็มกลัดใหม่เปิดใช้งาน มันจะถูกแสดงในส่วน เข็มกลัด ของหน้าหลักของเกม

   

การเปลี่ยนลำดับเข็มกลัด

เมื่อเข็มกลัดถูกสร้างขึ้นครั้งแรก มันจะถูกวางไว้ที่ท้ายสุดของรายการเข็มกลัด คุณสามารถจัดลำดับได้สูงสุด 50 เข็มกลัดในครั้งเดียวโดยใช้การลากและปล่อย

ในการเปลี่ยนลำดับเข็มกลัด:

1. ไปที่เกมที่เกี่ยวข้อง

2. ในแผงด้านข้างภายใต้หัวข้อ การมีส่วนร่วม ให้ไปที่หน้า เข็มกลัด

3. เลือก เปลี่ยนลำดับ เพื่อไปยังหน้าการจัดลำดับ

   

4. ในหน้าการจัดลำดับ ลากและวางเข็มกลัดไปยังลำดับที่ต้องการ

   

5. เลือก บันทึก เพื่อบันทึกลำดับนี้ ลำดับที่ระบุควรปรากฏบนหน้ารายละเอียดเกม

การเขียนสคริปต์เข็มกลัด

กระบวนการเขียนสคริปต์เข็มกลัดทั่วไปประกอบด้วย การมอบเข็มกลัด, การตรวจสอบว่าผู้เล่นได้รับ เข็มกลัด ก่อนหน้านี้ในเกมของคุณหรือไม่, และ การรับข้อมูลเข็มกลัด.

ระบุ ID เข็มกลัด

ID ของเข็มกลัดคือหมายเลขประจำตัวเฉพาะของมัน คุณจะต้องใช้ ID นี้เมื่อดำเนินการวิธีการต่าง ๆ เช่นการ มอบเข็มกลัด ให้กับผู้เล่น

1. ใน แดชบอร์ดนักสร้าง ให้ไปที่ส่วน เข็มกลัด ของเกมที่เกี่ยวข้องภายใต้ การมีส่วนร่วม

2. ชี้เมาส์ไปที่ภาพขนาดย่อของเข็มกลัด คลิกที่ปุ่ม ⋯ และเลือก คัดลอก Asset ID จากเมนูบริบท

   

มอบเข็มกลัด

คุณสามารถมอบเข็มกลัดให้กับผู้เล่นตลอดเกมของคุณโดยการเรียกใช้เมธอด BadgeService:AwardBadgeAsync() ในสคริปต์ฝั่งเซิร์ฟเวอร์ Script. BadgeService:GetBadgeInfoAsync() คืนค่าคุณสมบัติของเข็มกลัดรวมทั้ง IsEnabled ซึ่งยืนยันว่าเข็มกลัดสามารถมอบให้กับผู้เล่นได้หรือไม่ คุณสามารถเปิดหรือปิดเข็มกลัดจากแบบฟอร์ม กำหนดค่าผู้เขียน บน แดชบอร์ดนักสร้าง.

ต่อไปนี้คือตัวอย่างของฟังก์ชันที่ปลอดภัยในการมอบเข็มกลัดให้กับผู้เล่น

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- รับข้อมูลเข็มกลัด
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- ยืนยันว่าเข็มกลัดสามารถมอบได้
		if badgeInfo.IsEnabled then
			-- มอบเข็มกลัด
			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() เพื่อยืนยันว่าผู้เล่นนั้นมีเข็มกลัดที่มี ID ที่ตรงกัน ที่ตั้งไว้ในตัวแปร BADGE_ID คุณสามารถตรวจสอบความเป็นเจ้าของเข็มกลัดเป็นกลุ่มได้ด้วยการใช้เมธอด BadgeService:CheckUserBadgesAsync().

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

local BADGE_ID = 00000000  -- เปลี่ยนเป็น ID ของเข็มกลัดของคุณ

local function onPlayerAdded(player)
  -- ตรวจสอบว่าผู้เล่นมีเข็มกลัดหรือไม่
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- หากมีข้อผิดพลาด ให้แสดงคำเตือนและออกจากฟังก์ชัน
	if not success then
		warn("พบข้อผิดพลาดขณะตรวจสอบว่าผู้เล่นมีเข็มกลัด")
		return
	end

	if hasBadge then
		-- จัดการความเป็นเจ้าของเข็มกลัดของผู้เล่นตามต้องการ
	end
end

-- เชื่อมต่อเหตุการณ์ "PlayerAdded" ไปยังฟังก์ชัน "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

รับข้อมูลเข็มกลัด

ในการรับข้อมูลเกี่ยวกับเข็มกลัด เช่น คำอธิบายหรือ ID ของสินทรัพย์ไอคอน ให้เรียกเมธอด BadgeService:GetBadgeInfoAsync() พร้อมกับ ID เข็มกลัด. ตัวอย่างเช่น:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- เปลี่ยนเป็น ID ของเข็มกลัดของคุณ

-- รับข้อมูลเข็มกลัด
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- แสดงข้อมูล
if success then
	print("เข็มกลัด:", result.Name)
	print("เปิดใช้งาน:", result.IsEnabled)
	print("คำอธิบาย:", result.Description)
	print("ไอคอน:", "rbxassetid://" .. result.IconImageId)
else
	warn("พบข้อผิดพลาดขณะรับข้อมูลเข็มกลัด:", result)
end