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
Cara leaderstats berfungsi
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 | Menyimpan | Sesuai untuk |
|---|---|---|
IntValue | Nombor bulat | Syiling, bunuhan, kemenangan, tahap |
NumberValue | Nombor perpuluhan | Masa pusingan terbaik, jarak |
StringValue | Teks | Pangkat 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
- Dalam Explorer, halakan tetikus pada ServerScriptService, tekan butang + dan masukkan Script.
- Namakan semula kepada
Leaderstatssupaya mudah dicari kemudian. - Gantikan kandungannya dengan kod di bawah dan tekan Play. Nama anda akan muncul dalam senarai pemain dengan Coins dan Wins bernilai 0.
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.
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.
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.
- Tambah Part Anchored dalam Workspace, namakannya
WinsBoarddan jadikannya sebesar papan tanda (contohnya 12 kali 8 kali 1 stud), dengan muka hadapan menghadap spawn. - Masukkan Script ke dalam ServerScriptService bernama
GlobalWinsBoarddengan kod di bawah. - Tekan Play. Papan akan terisi selepas kemas kini pertama dan dikemas kini setiap minit.
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.
Tambah leaderboard dengan Coins dan Wins yang disimpan antara sesi, dan papan 10 teratas mengikut kemenangan pada part berhampiran spawn.
- 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
- Roblox Creator Docs: Leaderboards (dalam bahasa Inggeris). leaderstats, susunan statistik dan mod kekal Friends dan Global
- Roblox Creator Docs: Data stores (dalam bahasa Inggeris). GetAsync, SetAsync, ordered data store dan had
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.