Singkatnya
Buat Script di ServerScriptService yang mendengarkan Players.PlayerAdded, membuat Folder bernama persis leaderstats (huruf kecil semua) dan menjadikan pemain sebagai parent-nya. Setiap IntValue, NumberValue atau StringValue di dalam folder itu menjadi kolom di daftar pemain.
- Buat dan ubah stat hanya di server. Perubahan yang dibuat LocalScript hanya dilihat oleh pemain itu dan tidak oleh orang lain.
- leaderstats tidak disimpan. Muat dan simpan nilainya dengan data store kalau nilainya harus bertahan ke sesi berikutnya.
- Untuk peringkat dari semua pemain, tulis setiap skor ke ordered data store dan tampilkan di papan di dunia game kamu, atau di tampilan Global daftar pemain.
Di halaman ini
Cara kerja leaderstats
Roblox menampilkan daftar pemain di setiap game. Kalau seorang pemain punya child Folder bernama leaderstats, daftar itu menambah kolom untuk setiap objek value di dalamnya dan menampilkan nilai pemain itu di barisnya. Judul kolomnya adalah Name objek value tersebut.
| Objek | Menyimpan | Cocok untuk |
|---|---|---|
IntValue | Bilangan bulat | Coin, kill, win, level |
NumberValue | Bilangan desimal | Waktu lap terbaik, jarak |
StringValue | Teks | Pangkat atau gelar tim |
Dua aturan menyebabkan hampir semua leaderboard yang rusak. Nama folder-nya harus persis leaderstats: Leaderstats atau leaderStats diabaikan. Dan folder-nya harus dibuat oleh Script server, karena server adalah satu-satunya tempat perubahan direplikasi ke setiap pemain. Kalau kamu belum yakin di mana kode berjalan, baca dulu Script vs LocalScript vs ModuleScript (dalam bahasa Inggris) atau panduan scripting untuk pemula.
Langkah 1: Buat script leaderstats
- Di Explorer, arahkan kursor ke ServerScriptService, klik tombol + dan sisipkan Script.
- Ganti namanya jadi
Leaderstatssupaya mudah ditemukan nanti. - Ganti isinya dengan kode di bawah dan tekan Play. Namamu muncul di daftar 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" -- harus persis nama ini, huruf kecil semua
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 -- atur parent terakhir, setelah value-nya ada di dalam
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Di Studio kamu bisa masuk sebelum script ini berjalan, jadi siapkan juga siapa pun yang sudah ada
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Loop di bagian akhir penting saat tes di Studio: pemain pertama kadang masuk sebelum PlayerAdded tersambung, dan pemain itu tidak akan dapat stat.
Langkah 2: Beri pemain poin dengan aman
Untuk mengubah stat, atur Value-nya dari script server. Coin pad ini membayar 10 coin saat pemain menyentuhnya. Touched berjalan berkali-kali per detik selama karakter berdiri di atas part, jadi script menyimpan cooldown singkat untuk 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 berjalan berkali-kali per langkah; ini mencegah 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") menemukan karakter bahkan saat part yang menyentuh ada di dalam accessory, yang terlewat oleh cek hit.Parent biasa.
Kalau poin datang dari sesuatu yang dilakukan pemain di layarnya sendiri, seperti mengklik tombol, LocalScript sebaiknya meminta ke server dengan RemoteEvent dan server yang memutuskan apakah akan membayar. Jangan pernah biarkan client mengirim jumlahnya. Panduan RemoteEvents menunjukkan polanya dengan validasi.
Empat contoh lengkap: panduan game pertama membayar 1 Coin untuk setiap coin yang disentuh pemain di lintasannya dan satu Win di finish pad setelah 3 coin, panduan clicker simulator membayar Coins untuk klik tombol dengan batas klik di server, panduan pedang menambah 1 ke stat Kills milik siapa pun yang memberi pukulan terakhir sebelum seorang pemain mati, dan panduan senjata api menunjukkan cara menghitung kill saat tembakan membuat Health target jadi 0 (tiga yang terakhir dalam bahasa Inggris).
Langkah 3: Simpan stat di antara sesi
leaderstats hanya hidup selama server hidup. Untuk menyimpan coin dan win, muat dari data store saat pemain masuk dan simpan saat mereka keluar. Versi ini menggantikan script Langkah 1. Script ini tidak pernah menyimpan pemain yang datanya gagal dimuat, kesalahan yang menghapus progres di kebanyakan script save hasil salinan.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Dipanggil di dalam setiap pcall di bawah, jadi place yang belum dipublikasikan
-- (tanpa akses data store) tetap mendapat leaderboard-nya
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Pemain yang stat tersimpannya berhasil dimuat. Siapa pun yang tidak ada di sini tidak pernah disimpan,
-- jadi load yang gagal tidak bisa menimpa progres sungguhan dengan nol.
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)
-- Saat server dimatikan, simpan semua orang sebelum server tutup
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)
Ini cukup untuk game kecil. Untuk retry, UpdateAsync, batas request dan perlindungan dari dua server yang menulis pemain yang sama, lanjutkan dengan tutorial DataStore.
Langkah 4: Top 10 global
leaderstats hanya membandingkan pemain di server yang sama. Peringkat global butuh ordered data store: data store yang menyimpan satu angka per key dan bisa mengembalikan key yang diurutkan menurut nilainya. Tulis skor setiap pemain ke situ dari server, lalu baca entri teratasnya kembali.
Ada dua cara menampilkannya. Daftar pemain Roblox punya tampilan Friends dan Global yang membaca dari ordered data store yang kamu daftarkan di Creator Hub (fitur beta saat panduan ini ditulis, satu leaderboard aktif per game). Atau kamu bisa menggambar peringkatnya sendiri di papan di dunia game kamu, yang berfungsi di setiap game dan bisa kamu atur tampilannya. Script di bawah melakukan cara kedua, dan skor yang ditulisnya memakai user ID pemain sebagai key, format yang juga diharapkan leaderboard Creator Hub.
- Tambahkan Part yang di-anchor ke Workspace, beri nama
WinsBoard, dan atur ukurannya seperti papan tanda (misalnya 12 kali 8 kali 1 stud), dengan sisi depan menghadap spawn kamu. - Sisipkan Script ke ServerScriptService bernama
GlobalWinsBoarddengan kode di bawah. - Main. Papan terisi setelah refresh pertama berjalan, dan diperbarui setiap menit.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Papannya: Part yang di-anchor bernama WinsBoard di Workspace. Script menambahkan
-- SurfaceGui dan baris-barisnya sendiri, jadi kamu cukup membuat Part-nya.
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) mengembalikan 10 nilai tertinggi lebih dulu. Ordered data store hanya menyimpan bilangan bulat, jadi simpan skor sebagai integer. Script menulis setiap pemain sekali semenit dan membaca top 10 sekali semenit, jauh di bawah batas default per server (30 + 5 per pemain per menit untuk penulisan ordered dan 5 + 2 per pemain untuk pembacaan terurut, sesuai dokumentasi per 30 September 2026).
Error umum dan cara memperbaikinya
Masalah di bawah ini menjadi penyebab sebagian besar keluhan "leaderboard-ku tidak jalan". Cek jendela Output dulu (buka dari menu Window di Studio atau tab Script): kalau ada script yang error, nomor barisnya ada di sana.
Leaderboard-nya sama sekali tidak tampil
Cek bahwa nama folder-nya leaderstats dengan huruf kecil, bahwa parent-nya adalah Player (bukan karakter), dan bahwa kodenya adalah Script di ServerScriptService, bukan LocalScript.
Pemain lain tidak melihat perubahan stat-ku
Nilainya diubah di client. Pindahkan perubahannya ke Script server, dan kalau dipicu oleh tombol atau tekanan keyboard, kirim RemoteEvent dan biarkan server yang mengubah nilainya.
attempt to index nil with 'Coins'
Kode mencoba membaca player.leaderstats.Coins sebelum folder-nya ada, atau namanya dieja berbeda. Di server pakai FindFirstChild dan cek hasilnya; di LocalScript pakai player:WaitForChild("leaderstats"). Panduan error script menjelaskan error ini secara detail.
Coin naik 10, 20 atau 50 dari satu sentuhan
Touched berjalan berulang kali selama part bertumpukan. Tambahkan cooldown per pemain seperti di Langkah 2, atau hapus pickup-nya saat diambil.
Stat reset setiap kali aku masuk lagi
leaderstats tidak disimpan oleh Roblox. Tambahkan script Langkah 3. Untuk mengetes penyimpanan di Studio, publikasikan place-nya dan nyalakan Studio Access to API Services di Experience Settings.
Buat dengan RoCode
Kalau kamu tidak mau menyambungkan ini secara manual, RoCode bisa membuatnya di dalam place yang sedang kamu buka. RoCode adalah agen AI yang bekerja lewat plugin Roblox Studio, jadi ia membuat script dan part di Explorer kamu, bukan memberimu kode untuk ditempel.
Tambahkan leaderboard dengan Coins dan Wins yang tersimpan di antara sesi, dan papan top 10 wins di sebuah part dekat spawn.
- Bisa mencari leaderstats atau kode DataStore yang sudah ada di place kamu dulu, supaya bisa memperluas yang kamu punya, bukan menambah leaderboard kedua
- Membuat script server di ServerScriptService dan part papan di Workspace
- Mengecek compile script yang ditulisnya di dalam Studio sebelum selesai
- Mengirim perubahannya per batch, dan setiap batch ditandai sebagai titik undo di riwayat Studio
Kamu tetap meninjau hasilnya dan mengetes stat dan penyimpanannya sendiri: dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru ia bisa mengendalikan karakter tes dan mengecek nilai seperti Coins dan Wins, tapi ia hanya mengecek yang dipilihnya untuk dites. Leaderstats biasanya sistem pertama dari banyak sistem di sebuah game: bangun sisa game kamu satu sistem per prompt dengan cara yang sama. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Apa itu leaderstats di Roblox?
Folder bernama persis leaderstats, huruf kecil semua, di dalam sebuah Player. Roblox menampilkan setiap IntValue, NumberValue atau StringValue di dalamnya sebagai kolom di daftar pemain. Buat dari Script server, seperti di Langkah 1.
Bagaimana cara membuat leaderboard global di Roblox?
Tulis skor setiap pemain ke ordered data store dari server, lalu baca entri teratasnya kembali dan tampilkan di papan di dunia game kamu. Langkah 4 berisi script lengkap untuk top 10.
Apakah Roblox menyimpan leaderstats secara otomatis?
Tidak. leaderstats hanya ada selama pemain berada di server. Simpan nilainya dengan data store saat pemain keluar dan muat saat mereka masuk, seperti di Langkah 3.
Bisakah aku menyembunyikan sebuah nilai dari leaderboard?
Bisa. Hanya nilai di dalam folder leaderstats yang ditampilkan. Simpan data pribadi di folder lain pada pemain, atau di table di script server.
Bagaimana cara menyembunyikan seluruh daftar pemain?
Dari LocalScript, panggil StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Berikan true untuk menampilkannya lagi.
Bolehkah aku memakai NumberValue untuk coin?
Boleh, tapi IntValue lebih cocok untuk mata uang bilangan bulat, dan ordered data store hanya menerima bilangan bulat kalau nanti kamu membuat peringkat berdasarkan nilai itu.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: Leaderboards (dalam bahasa Inggris). leaderstats, urutan stat, dan tampilan Friends dan Global yang permanen
- Roblox Creator Docs: Data stores (dalam bahasa Inggris). GetAsync, SetAsync, ordered data store dan batasnya
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.