Sa madaling salita
Gumawa ng Script sa ServerScriptService na nakikinig sa Players.PlayerAdded, gumagawa ng Folder na ang pangalan ay eksaktong leaderstats (lahat lowercase) at ginagawa itong child ng player. Bawat IntValue, NumberValue o StringValue sa loob ng folder na iyon ay nagiging column sa player list.
- Sa server lang gumawa at magbago ng stats. Ang pagbabagong ginawa ng LocalScript ay nakikita lang ng player na iyon, at wala nang iba.
- Hindi nase-save ang leaderstats. I-load at i-save ang mga value gamit ang data store kung kailangan nilang umabot sa susunod na session.
- Para sa ranking ng lahat ng player, isulat ang bawat score sa ordered data store at ipakita ito sa board sa loob ng mundo mo o sa Global mode ng player list.
Sa page na ito
Paano gumagana ang leaderstats
Ipinapakita ng Roblox ang player list sa bawat game. Kapag may child na Folder ang player na may pangalang leaderstats, nagdadagdag ang list ng column para sa bawat value object sa loob at ipinapakita ang value ng player na iyon sa row niya. Ang header ng column ay ang Name ng value object.
| Object | Ini-store | Bagay para sa |
|---|---|---|
IntValue | Buong numero | Coins, kills, wins, level |
NumberValue | Numerong may decimal | Pinakamabilis na lap time, distansya |
StringValue | Text | Rank o titulo ng team |
Dalawang rule ang sumisira sa halos bawat leaderboard na hindi gumagana. Dapat eksaktong leaderstats ang pangalan ng folder: binabalewala ang Leaderstats o leaderStats. At dapat server Script ang gumawa ng folder, dahil ang mga pagbabago lang sa server ang nare-replicate sa lahat ng player. Kung hindi ka sigurado kung saan tumatakbo ang code, basahin muna ang Script vs LocalScript vs ModuleScript (sa English).
Hakbang 1: gumawa ng leaderstats script
- Sa Explorer, i-hover ang ServerScriptService, i-click ang + button at mag-insert ng Script.
- I-rename ito na
Leaderstatspara madaling mahanap mamaya. - Palitan ang laman nito ng code sa ibaba at pindutin ang Play. Lalabas ang pangalan mo sa player list na may Coins at Wins na 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- dapat eksakto ang pangalan, lahat lowercase
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 -- huling itinatakda ang parent, kapag nasa loob na ang mga value
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Sa Studio, puwede kang pumasok bago tumakbo ang script na ito, kaya sine-setup din ang mga nandito na
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Mahalaga ang loop sa dulo kapag nagte-test sa Studio: minsan pumapasok ang unang player bago maikonekta ang PlayerAdded, at kung walang loop ay maiiwan siyang walang stats.
Hakbang 2: magbigay ng points nang ligtas
Para baguhin ang isang stat, itakda ang Value nito mula sa server script. Ang coin pad na ito ay nagbibigay ng 10 coins kapag hinawakan ito ng player. Ang Touched ay nagfa-fire nang maraming beses kada segundo habang nakatayo ang character sa part, kaya may maikling cooldown ang script para sa bawat player.
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 -- maraming beses nagfa-fire ang Touched sa isang hakbang; pinipigilan nito na magbayad nang sampung beses ang isang hawak
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)
Nahahanap ng FindFirstAncestorOfClass("Model") ang character kahit nasa loob ng accessory ang part na humawak, habang nalalampasan ito ng simpleng check ng hit.Parent.
Kung binibigay ang points para sa ginagawa ng player sa screen niya, halimbawa sa pagpindot ng button, dapat humingi ang LocalScript sa server gamit ang RemoteEvent, at ang server ang magpapasya kung magbabayad. Huwag kailanman hayaang ang client ang magpadala ng halaga. Ipinapakita ng guide sa RemoteEvents ang pattern na ito na may check.
Apat na ready na halimbawa: ang guide sa unang game ay nagbibigay ng 1 Coin para sa bawat coin na hinawakan ng player sa course, at Win sa finish pad pagkatapos ng 3 coins, ang guide sa clicker simulator ay nagbibigay ng Coins sa pagpindot ng button na may click limit sa server, ang guide sa espada ay nagdadagdag ng 1 sa Kills ng gumawa ng huling tama bago mamatay ang player, at ipinapakita ng guide sa baril kung paano bilangin ang kill kapag ang tama ay nagdala sa Health ng target sa 0.
Hakbang 3: i-save ang stats sa pagitan ng mga session
Buhay lang ang leaderstats habang buhay ang server. Para i-save ang coins at wins, i-load sila mula sa data store kapag pumasok ang player, at i-save kapag umalis siya. Pinapalitan ng bersyong ito ang script mula sa hakbang 1. Hindi nito kailanman sine-save ang player na hindi na-load ang data: ito mismo ang bug na bumubura ng progress sa karamihan ng kinopyang save script.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Tinatawag sa loob ng bawat pcall sa ibaba, kaya ang place na hindi pa naka-publish
-- (walang access sa data store) ay may leaderboard pa rin
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Mga player na na-load ang naka-save na stats. Ang wala rito ay hindi kailanman sine-save,
-- kaya hindi papatungan ng sero ng palpak na load ang totoong progress.
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)
-- Kapag nagsasara ang server, sine-save ang lahat bago ito tuluyang magsara
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)
Sapat na ito para sa maliit na game. Tungkol sa retries, UpdateAsync, request limits at proteksyon laban sa dalawang server na sabay nagsusulat sa iisang player, basahin pa ang DataStore tutorial.
Hakbang 4: global top 10
Ang leaderstats ay naghahambing lang ng mga player sa iisang server. Para sa global ranking, kailangan mo ng ordered data store: data store na nag-i-store ng isang numero kada key at kayang ibalik ang mga key na naka-sort ayon sa value. Isulat dito ang score ng bawat player mula sa server, tapos basahin pabalik ang mga nangungunang entry.
Dalawa ang paraan para ipakita ito. Ang player list ng Roblox ay may Friends at Global mode na nagbabasa ng ordered data store na naka-register sa Creator Hub (sa panahon ng pagsulat, beta feature ito, isang active na leaderboard kada game). O puwede mong iguhit mismo ang ranking sa board sa loob ng mundo mo: gumagana ito sa kahit anong game at hinahayaan kang i-design ito kahit paano. Ang pangalawa ang ginagawa ng script sa ibaba, at isinusulat nito ang mga score gamit ang user ID ng player bilang key, na siya ring format na hinihintay ng leaderboard sa Creator Hub.
- Magdagdag ng anchored na Part sa Workspace, pangalanan itong
WinsBoardat gawin itong kasinlaki ng karatula (halimbawa, 12 by 8 by 1 stud), nakaharap ang front face sa spawn. - Mag-insert sa ServerScriptService ng Script na may pangalang
GlobalWinsBoardat ang code sa ibaba. - Pindutin ang Play. Mapupuno ang board pagkatapos ng unang refresh at mag-a-update kada minuto.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Ang board: anchored na Part na may pangalang WinsBoard sa Workspace. Ang script mismo ang nagdadagdag
-- ng SurfaceGui at mga row, kaya ang Part lang ang kailangan mong i-build.
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
Ibinabalik ng GetSortedAsync(false, 10) ang 10 pinakamalaking value nang una. Buong numero lang ang ini-store ng ordered data store, kaya i-store ang mga score bilang buong numero. Isinusulat ng script ang bawat player minsan kada minuto at binabasa ang top 10 minsan kada minuto, malayong pasok sa standard na limit kada server (30 + 5 kada player bawat minuto para sa pagsulat sa ordered data store at 5 + 2 kada player para sa sorted na pagbasa, ayon sa documentation noong 30 Setyembre 2026).
Mga karaniwang error at solusyon
Sakop ng mga problema sa ibaba ang karamihan ng reklamong "hindi gumagana ang leaderboard ko". Tingnan muna ang Output window (buksan ito mula sa Window menu sa Studio o sa Script tab): kung nag-crash ang script sa error, nandoon ang line number.
Hindi talaga lumalabas ang leaderboard
Siguraduhing leaderstats ang pangalan ng folder sa lowercase, na ang parent nito ay ang Player (hindi ang character), at na ang code ay Script sa ServerScriptService, hindi LocalScript.
Hindi nakikita ng ibang player ang pagbabago sa stat ko
Binago ang value sa client. Ilipat ang pagbabago sa server Script, at kung button o key ang nagti-trigger nito, magpadala ng RemoteEvent at hayaang ang server ang magbago ng value.
attempt to index nil with 'Coins'
Sinubukan ng code na basahin ang player.leaderstats.Coins bago lumitaw ang folder, o iba ang pagkakasulat ng pangalan. Sa server, gamitin ang FindFirstChild at i-check ang resulta; sa LocalScript, gamitin ang player:WaitForChild("leaderstats"). Detalyadong ipinapaliwanag ng guide sa mga error sa script ang error na ito.
Nadadagdagan ang coins ng 10, 20 o 50 sa isang hawak lang
Paulit-ulit na nagfa-fire ang Touched habang nagsasalubong ang mga part. Magdagdag ng cooldown para sa bawat player, gaya sa hakbang 2, o i-delete ang item pagkatapos itong makuha.
Nare-reset ang stats tuwing papasok ulit
Hindi sine-save ng Roblox ang leaderstats. Idagdag ang script mula sa hakbang 3. Para i-test ang pag-save sa Studio, i-publish ang place at i-on ang Studio Access to API Services sa Experience Settings.
Gawin gamit ang RoCode
Kung ayaw mong buuin ito nang mano-mano, kayang i-build ng RoCode ang lahat sa loob ng place na bukas mo. Isa itong AI agent na gumagana sa pamamagitan ng Roblox Studio plugin, kaya gumagawa ito ng mga script at part sa Explorer mo, hindi nagbibigay ng code na ipe-paste mo.
Magdagdag ng leaderboard na may Coins at Wins na nase-save sa pagitan ng mga session, at top 10 board ng wins sa isang part malapit sa spawn.
- Puwedeng hanapin muna sa place ang kasalukuyang leaderstats o DataStore code, para dagdagan ang meron na at hindi magdagdag ng pangalawang leaderboard
- Gumagawa ng server script sa ServerScriptService at part para sa board sa Workspace
- Sinusuri ang compile ng mga isinulat na script sa loob ng Studio bago matapos
- Ipinapadala ang mga pagbabago nang paisa-isang batch, at bawat batch ay minamarkahan bilang undo point sa history ng Studio
Ikaw pa rin ang susuri sa resulta at magte-test mismo sa game ng stats at pag-save: sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.11 o mas bago ay kontrolin ang test character at suriin ang mga value gaya ng Coins at Wins, pero sinusuri lang nito ang pinili nitong i-test. Karaniwang ang leaderstats ang una sa maraming system ng isang game: buuin ang natitirang bahagi ng game nang isang system kada request sa parehong paraan. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Ano ang leaderstats sa Roblox?
Isang Folder na ang pangalan ay eksaktong leaderstats, lahat lowercase, sa loob ng Player. Ipinapakita ng Roblox ang bawat IntValue, NumberValue o StringValue sa loob nito bilang column sa player list. Gawin ito mula sa server Script, gaya sa hakbang 1.
Paano gumawa ng global leaderboard sa Roblox?
Isulat ang score ng bawat player sa ordered data store mula sa server, tapos basahin pabalik ang mga nangungunang entry at ipakita sila sa board sa loob ng mundo mo. Nasa hakbang 4 ang buong script para sa top 10.
Awtomatikong sine-save ba ng Roblox ang leaderstats?
Hindi. Umiiral lang ang leaderstats habang nasa server ang player. I-save ang mga value gamit ang data store kapag umalis ang player, at i-load kapag pumasok siya, gaya sa hakbang 3.
Puwede bang itago ang isang value sa leaderboard?
Oo. Ang mga value lang sa loob ng leaderstats folder ang ipinapakita. I-store ang private na data sa ibang folder sa player o sa table sa server script.
Paano itago ang buong player list?
Mula sa LocalScript, tawagin ang StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Ipasa ang true para ipakita ulit ito.
Puwede bang gumamit ng NumberValue para sa coins?
Puwede, pero mas bagay ang IntValue para sa currency na buong numero, at buong numero lang ang tinatanggap ng ordered data store kung gusto mong gumawa ng ranking mula rito mamaya.
Mga source at dagdag na babasahin
- Roblox Creator Docs: Leaderboards (sa English). leaderstats, pagkakasunod ng mga stat at ang permanenteng Friends at Global mode
- Roblox Creator Docs: Data stores (sa English). GetAsync, SetAsync, ordered data stores at mga limit
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.