Tutorial · Data pemain

Cara membuat leaderboard di Roblox Studio

Daftar pemain di kanan atas game Roblox dijalankan oleh satu folder bernama leaderstats. Panduan ini membuatnya dari nol: script server-nya, cara aman memberi poin, menyimpan di antara sesi, dan top 10 global.

Diperbarui 12 November 20267 menit bacaDitulis oleh

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
  1. Cara kerja leaderstats
  2. 1. Buat leaderstats
  3. 2. Beri poin
  4. 3. Simpan stat
  5. 4. Top 10 global
  6. Error umum
  7. Dengan RoCode
  8. Pertanyaan umum
  9. Sumber dan bacaan lanjutan

Cara kerja leaderstats

IlustrasiScript leaderstats dan coin pad yang sudah jadi di game yang sedang berjalan.

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 value yang bisa kamu taruh di leaderstats
ObjekMenyimpanCocok untuk
IntValueBilangan bulatCoin, kill, win, level
NumberValueBilangan desimalWaktu lap terbaik, jarak
StringValueTeksPangkat 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

  1. Di Explorer, arahkan kursor ke ServerScriptService, klik tombol + dan sisipkan Script.
  2. Ganti namanya jadi Leaderstats supaya mudah ditemukan nanti.
  3. Ganti isinya dengan kode di bawah dan tekan Play. Namamu muncul di daftar pemain dengan Coins dan Wins bernilai 0.
Script di ServerScriptService bernama Leaderstats
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.

Script di Part di 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 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.

Script di ServerScriptService bernama Leaderstats
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.

  1. 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.
  2. Sisipkan Script ke ServerScriptService bernama GlobalWinsBoard dengan kode di bawah.
  3. Main. Papan terisi setelah refresh pertama berjalan, dan diperbarui setiap menit.
Script di 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

-- 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.

Kamu ketik

Tambahkan leaderboard dengan Coins dan Wins yang tersimpan di antara sesi, dan papan top 10 wins di sebuah part dekat spawn.

RoCode mengerjakan
  • 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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.