Papan peringkat dalam permainan

Roblox memiliki sistem papan peringkat bawaan yang memungkinkan Anda menampilkan informasi pengguna seperti skor, mata uang, atau waktu tercepat dalam sebuah balapan.

Atur papan peringkat

Untuk mengatur papan peringkat dan menambahkan pemain saat mereka memasuki permainan:

1. Buat Script baru di dalam ServerScriptService dan beri nama Leaderboard.

   

2. Dalam skrip, hubungkan sebuah fungsi ke acara PlayerAdded.

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

3. Di dalam fungsi yang terhubung, buat instance baru Folder, beri nama leaderstats, dan jadikan sebagai parent untuk pemain.

   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)

   Penting bahwa folder diberi nama leaderstats dengan huruf kecil semua. Roblox tidak akan menambahkan pemain ke papan peringkat jika Anda menamakannya dengan cara lain.

Tambahkan statistik

Papan peringkat menggunakan objek tipe nilai untuk menyimpan dan menampilkan statistik pemain. Skrip ini akan menunjukkan emas pemain menggunakan IntValue, sebuah placeholder untuk integer.

Dalam fungsi leaderboardSetup(), tambahkan baris 8 hingga 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)

Baris-barus ini melakukan hal berikut:

1. Sebuah instance IntValue dibuat.

2. Name instance diatur menjadi "Gold". Ini adalah cara tepat statistik akan muncul di papan peringkat.

   

3. Value awal statistik diatur menjadi 0. Ini dapat diatur ke nilai berapa pun yang Anda inginkan, termasuk nilai yang disimpan dalam data store jika Anda menerapkan papan peringkat yang persisten.

   Perhatikan bahwa nilai objek seperti IntValue, NumberValue, dan StringValue harus diatur melalui propertinya Value, seperti gold.Value di baris 10.

4. Instance tersebut dijadikan parent ke folder leaderstats yang menambahkannya ke papan peringkat. Ketika seorang pemain memasuki permainan, nama mereka muncul di papan.

   

Perbarui statistik

Untuk memperbarui statistik papan peringkat seorang pemain, ubah properti Value dari statistik tersebut di dalam folder leaderstats mereka. Misalnya, Anda dapat melampirkan Script berikut ke objek pickup mana pun untuk meningkatkan statistik Gold pemain yang mengumpulkannya.

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
		-- Hancurkan pickup
		goldChunk:Destroy()

		-- Perbarui statistik papan peringkat pemain
		goldStat.Value += 10
	end
end

goldChunk.Touched:Connect(onPartTouch)

Urutkan statistik

Ada tiga cara untuk mengontrol urutan statistik dalam papan peringkat:

• Tambahkan statistik sesuai urutan yang Anda inginkan untuk mereka muncul.
• Tambahkan anak BoolValue bernama IsPrimary ke statistik dan atur nilainya menjadi true untuk menempatkan statistik tersebut pertama di papan peringkat.
• Tambahkan anak NumberValue bernama Priority ke statistik dan atur nilainya menjadi integer. Nilai prioritas yang lebih tinggi muncul lebih awal di papan peringkat. Statistik tanpa prioritas memiliki prioritas default 0.

Contoh kode ini menunjukkan bagaimana menambahkan nilai IsPrimary ke statistik:

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)

Sembunyikan papan peringkat

Untuk menyembunyikan papan peringkat, seperti di layar menu atau selama pemutaran cutscene, tempatkan LocalScript di dalam StarterGui atau StarterPlayerScripts yang berisi panggilan ke StarterGui.

local StarterGui = game:GetService("StarterGui")

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