Tutorial · Data pemain

Cara buat leaderboard dalam Roblox Studio

Senarai pemain di penjuru kanan atas game Roblox dikawal oleh satu folder bernama leaderstats. Panduan ini membinanya dari awal: skrip pelayan, cara selamat untuk memberi mata, simpanan antara sesi dan 10 teratas global.

Dikemas kini 20 November 20267 minit bacaanDitulis oleh

Ringkasnya

Cipta Script dalam ServerScriptService yang mendengar Players.PlayerAdded, mencipta Folder yang dinamakan tepat leaderstats (semuanya huruf kecil) dan menjadikannya anak kepada pemain. Setiap IntValue, NumberValue atau StringValue di dalam folder itu menjadi lajur dalam senarai pemain.

  • Cipta dan ubah statistik hanya pada pelayan. Perubahan yang dibuat oleh LocalScript hanya dilihat oleh pemain itu sahaja, dan bukan orang lain.
  • leaderstats tidak disimpan. Muat dan simpan nilai melalui data store jika ia perlu kekal hingga sesi seterusnya.
  • Untuk kedudukan merentas semua pemain, tulis setiap skor ke dalam ordered data store dan paparkannya pada papan dalam dunia anda atau dalam mod Global senarai pemain.
Di halaman ini
  1. Cara leaderstats berfungsi
  2. 1. Cipta leaderstats
  3. 2. Beri mata
  4. 3. Simpan
  5. 4. 10 teratas global
  6. Common errors
  7. Dengan RoCode
  8. Soalan lazim
  9. Sumber dan bacaan lanjut

Cara leaderstats berfungsi

IlustrasiSkrip leaderstats dan pad syiling yang siap dalam game yang sedang berjalan.

Roblox memaparkan senarai pemain dalam setiap game. Apabila pemain ada anak Folder bernama leaderstats, senarai itu menambah satu lajur untuk setiap objek nilai di dalamnya dan memaparkan nilai pemain itu dalam barisnya. Tajuk lajur ialah Name objek nilai tersebut.

Objek nilai yang boleh dimasukkan ke dalam leaderstats
ObjekMenyimpanSesuai untuk
IntValueNombor bulatSyiling, bunuhan, kemenangan, tahap
NumberValueNombor perpuluhanMasa pusingan terbaik, jarak
StringValueTeksPangkat atau gelaran pasukan

Dua peraturan merosakkan hampir setiap leaderboard yang tidak berfungsi. Nama folder mesti tepat leaderstats: Leaderstats atau leaderStats diabaikan. Dan folder itu mesti dicipta oleh Script pelayan, kerana hanya perubahan pada pelayan direplikasi kepada semua pemain. Jika anda tidak pasti di mana kod berjalan, baca dahulu Script vs LocalScript vs ModuleScript (dalam bahasa Inggeris).

Langkah 1: cipta skrip leaderstats

  1. Dalam Explorer, halakan tetikus pada ServerScriptService, tekan butang + dan masukkan Script.
  2. Namakan semula kepada Leaderstats supaya mudah dicari kemudian.
  3. Gantikan kandungannya dengan kod di bawah dan tekan Play. Nama anda akan muncul dalam senarai pemain dengan Coins dan Wins bernilai 0.
Script dalam ServerScriptService bernama Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- nama mesti tepat begini, semuanya huruf kecil

	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 -- tetapkan induk paling akhir, selepas nilai sudah di dalam
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- Dalam Studio anda boleh masuk sebelum skrip ini berjalan, jadi kita sediakan juga sesiapa yang sudah ada
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

Gelung di hujung penting semasa ujian dalam Studio: pemain pertama kadang-kadang masuk sebelum PlayerAdded disambungkan, dan tanpa gelung itu dia tidak akan mendapat statistik.

Langkah 2: beri mata dengan selamat

Untuk mengubah statistik, tetapkan Value nya daripada skrip pelayan. Pad syiling ini memberi 10 syiling apabila pemain menyentuhnya. Touched dicetuskan berkali-kali sesaat selagi watak berdiri di atas part, jadi skrip menyimpan cooldown pendek bagi setiap pemain.

Script dalam part dalam Workspace bernama CoinPad
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 dicetuskan berkali-kali bagi setiap langkah; ini menghalang satu sentuhan membayar sepuluh kali
	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") menemui watak walaupun part yang menyentuh berada di dalam aksesori, manakala semakan ringkas hit.Parent terlepas kes itu.

Jika mata diberi untuk sesuatu yang pemain buat pada skrinnya sendiri, contohnya menekan butang, LocalScript perlu meminta pelayan melalui RemoteEvent, dan pelayan yang memutuskan sama ada untuk membayar. Jangan sekali-kali biarkan client menghantar jumlahnya. Panduan RemoteEvents menunjukkan corak ini dengan semakan.

Empat contoh siap: panduan game pertama memberi 1 Coin untuk setiap syiling yang disentuh pemain di laluan dan satu Win pada pad penamat selepas 3 syiling, panduan simulator klik memberi Coins untuk tekanan butang dengan had klik pada pelayan, panduan pedang menambah 1 pada Kills untuk sesiapa yang memberi pukulan terakhir sebelum pemain mati, dan panduan senjata api menunjukkan cara mengira bunuhan apabila tembakan menjadikan Health sasaran 0.

Langkah 3: simpan statistik antara sesi

leaderstats hanya wujud selagi pelayan wujud. Untuk menyimpan syiling dan kemenangan, muatkannya daripada data store apabila pemain masuk dan simpan apabila dia keluar. Versi ini menggantikan skrip daripada langkah 1. Ia tidak pernah menyimpan pemain yang datanya gagal dimuatkan: kesilapan inilah yang memadam kemajuan dalam kebanyakan skrip simpanan yang disalin.

Script dalam ServerScriptService bernama Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- Dipanggil di dalam setiap pcall di bawah, jadi place yang belum diterbitkan
-- (tanpa akses data store) tetap mendapat leaderboard
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- Pemain yang statistik simpanannya berjaya dimuatkan. Mereka yang tiada di sini tidak pernah disimpan,
-- jadi muatan yang gagal tidak akan menulis ganti kemajuan sebenar dengan sifar.
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)

-- Apabila pelayan ditutup, simpan semua orang sebelum ia tertutup
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)

Untuk game kecil, ini sudah memadai. Tentang cubaan semula, UpdateAsync, had permintaan dan perlindungan daripada dua pelayan yang menulis pemain yang sama, baca seterusnya dalam tutorial DataStore.

Langkah 4: 10 teratas global

leaderstats hanya membandingkan pemain dalam satu pelayan. Untuk kedudukan global, anda perlukan ordered data store: data store yang menyimpan satu nombor bagi setiap kunci dan boleh memulangkan kunci yang disusun mengikut nilai. Tulis skor setiap pemain ke dalamnya daripada pelayan, kemudian baca semula rekod teratas.

Ada dua cara untuk memaparkannya. Senarai pemain Roblox ada mod Friends dan Global yang membaca ordered data store yang didaftarkan dalam Creator Hub (semasa penulisan, ini ciri beta, satu leaderboard aktif bagi setiap game). Atau anda boleh melukis kedudukan sendiri pada papan dalam dunia anda: ini berfungsi dalam mana-mana game dan membolehkan anda mereka bentuknya sesuka hati. Skrip di bawah membuat cara kedua, dan ia menulis skor dengan user ID pemain sebagai kunci, iaitu format yang sama yang dijangka oleh leaderboard dalam Creator Hub.

  1. Tambah Part Anchored dalam Workspace, namakannya WinsBoard dan jadikannya sebesar papan tanda (contohnya 12 kali 8 kali 1 stud), dengan muka hadapan menghadap spawn.
  2. Masukkan Script ke dalam ServerScriptService bernama GlobalWinsBoard dengan kod di bawah.
  3. Tekan Play. Papan akan terisi selepas kemas kini pertama dan dikemas kini setiap minit.
Script dalam ServerScriptService bernama GlobalWinsBoard
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")

local TOP_N = 10
local REFRESH_SECONDS = 60

-- Papan: Part Anchored bernama WinsBoard dalam Workspace. Skrip sendiri menambah
-- SurfaceGui dan baris, jadi anda hanya perlu membina 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) memulangkan 10 nilai terbesar dahulu. Ordered data store hanya menyimpan nombor bulat, jadi simpan skor sebagai nombor bulat. Skrip menulis setiap pemain sekali seminit dan membaca 10 teratas sekali seminit, jauh di dalam had standard bagi setiap pelayan (30 + 5 bagi setiap pemain seminit untuk penulisan ke ordered data store dan 5 + 2 bagi setiap pemain untuk bacaan tersusun, menurut dokumentasi pada 30 September 2026).

Ralat biasa dan cara membaikinya

Masalah di bawah merangkumi kebanyakan aduan "leaderboard saya tidak berfungsi". Semak tetingkap Output dahulu (buka dari menu Window dalam Studio atau tab Script): jika skrip gagal dengan ralat, nombor baris ada di situ.

Leaderboard langsung tidak muncul

Pastikan folder dinamakan leaderstats dengan huruf kecil, induknya ialah Player (bukan watak) dan kod itu ialah Script dalam ServerScriptService, bukan LocalScript.

Pemain lain tidak nampak perubahan statistik saya

Nilai diubah pada client. Pindahkan perubahan ke Script pelayan, dan jika ia dicetuskan oleh butang atau kekunci, hantar RemoteEvent dan biarkan pelayan yang mengubah nilai.

attempt to index nil with 'Coins'

Kod cuba membaca player.leaderstats.Coins sebelum folder itu wujud, atau namanya dieja berbeza. Pada pelayan, gunakan FindFirstChild dan semak hasilnya; dalam LocalScript, gunakan player:WaitForChild("leaderstats"). Panduan ralat skrip menerangkan ralat ini dengan terperinci.

Syiling bertambah 10, 20 atau 50 daripada satu sentuhan

Touched dicetuskan berulang kali selagi part bertindih. Tambah cooldown bagi setiap pemain seperti dalam langkah 2, atau padam item selepas ia dikutip.

Statistik ditetapkan semula setiap kali masuk semula

Roblox tidak menyimpan leaderstats. Tambah skrip daripada langkah 3. Untuk menguji simpanan dalam Studio, terbitkan place dan hidupkan Studio Access to API Services dalam Experience Settings.

Buat dengan RoCode

Jika anda tidak mahu membina ini sendiri, RoCode boleh membina semuanya di dalam place yang sedang anda buka. Ia ialah ejen AI yang berfungsi melalui plugin Roblox Studio, jadi ia mencipta skrip dan part dalam Explorer anda, bukan memberi kod untuk ditampal.

Anda tulis

Tambah leaderboard dengan Coins dan Wins yang disimpan antara sesi, dan papan 10 teratas mengikut kemenangan pada part berhampiran spawn.

RoCode buat
  • Boleh mencari dahulu kod leaderstats atau DataStore sedia ada dalam place, supaya ia melengkapkan apa yang ada dan tidak menambah leaderboard kedua
  • Mencipta skrip pelayan dalam ServerScriptService dan part untuk papan dalam Workspace
  • Menyemak kompilasi skrip yang ditulis di dalam Studio sebelum selesai
  • Menghantar perubahan secara berkumpulan, dan setiap kumpulan ditanda sebagai titik undo dalam sejarah Studio

Anda tetap menyemak hasilnya dan menguji statistik serta simpanan dalam game sendiri: dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.11 atau lebih baharu ia boleh mengawal watak ujian dan menyemak nilai seperti Coins dan Wins, tetapi ia hanya menyemak apa yang dipilihnya untuk diuji. Leaderstats biasanya sistem pertama daripada banyak sistem dalam game: bina selebihnya game satu sistem bagi setiap permintaan dengan cara yang sama. Cara RoCode bersambung ke Studio.

Soalan lazim

Apa itu leaderstats dalam Roblox?

Folder yang dinamakan tepat leaderstats, semuanya huruf kecil, di dalam Player. Roblox memaparkan setiap IntValue, NumberValue atau StringValue di dalamnya sebagai lajur dalam senarai pemain. Cipta ia daripada Script pelayan, seperti dalam langkah 1.

Bagaimana buat leaderboard global dalam Roblox?

Tulis skor setiap pemain ke dalam ordered data store daripada pelayan, kemudian baca semula rekod teratas dan paparkannya pada papan dalam dunia anda. Langkah 4 ada skrip penuh untuk 10 teratas.

Adakah Roblox menyimpan leaderstats secara automatik?

Tidak. leaderstats hanya wujud selagi pemain berada dalam pelayan. Simpan nilai melalui data store apabila pemain keluar, dan muatkannya apabila dia masuk, seperti dalam langkah 3.

Bolehkah saya sembunyikan nilai daripada leaderboard?

Boleh. Hanya nilai di dalam folder leaderstats yang dipaparkan. Simpan data peribadi dalam folder lain pada pemain atau dalam jadual dalam skrip pelayan.

Bagaimana sembunyikan seluruh senarai pemain?

Daripada LocalScript, panggil StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Hantar true untuk memaparkannya semula.

Bolehkah saya guna NumberValue untuk syiling?

Boleh, tetapi untuk mata wang nombor bulat, IntValue lebih sesuai, dan ordered data store hanya menerima nombor bulat jika kemudian anda mahu membina kedudukan berdasarkannya.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.