Tutorial · Data ng player

Paano gumawa ng leaderboard sa Roblox Studio

Ang player list sa kanang itaas ng isang Roblox game ay kontrolado ng isang folder na may pangalang leaderstats. Binubuo ito ng guide na ito mula sa simula: server script, ligtas na paraan ng pagbigay ng points, pag-save sa pagitan ng mga session, at global top 10.

In-update Nobyembre 20, 20268 minutong basaIsinulat ni

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
  1. Paano gumagana ang leaderstats
  2. 1. Gumawa ng leaderstats
  3. 2. Pagbigay ng points
  4. 3. Pag-save
  5. 4. Global top 10
  6. Common errors
  7. Gamit ang RoCode
  8. Mga madalas itanong
  9. Mga source at dagdag na babasahin

Paano gumagana ang leaderstats

IlustrasyonAng tapos na leaderstats script at coin pad sa tumatakbong game.

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.

Mga value object na puwedeng ilagay sa leaderstats
ObjectIni-storeBagay para sa
IntValueBuong numeroCoins, kills, wins, level
NumberValueNumerong may decimalPinakamabilis na lap time, distansya
StringValueTextRank 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

  1. Sa Explorer, i-hover ang ServerScriptService, i-click ang + button at mag-insert ng Script.
  2. I-rename ito na Leaderstats para madaling mahanap mamaya.
  3. 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.
Script sa ServerScriptService na pinangalanang Leaderstats
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.

Script sa part sa Workspace na pinangalanang 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 -- 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.

Script sa ServerScriptService na pinangalanang Leaderstats
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.

  1. Magdagdag ng anchored na Part sa Workspace, pangalanan itong WinsBoard at gawin itong kasinlaki ng karatula (halimbawa, 12 by 8 by 1 stud), nakaharap ang front face sa spawn.
  2. Mag-insert sa ServerScriptService ng Script na may pangalang GlobalWinsBoard at ang code sa ibaba.
  3. Pindutin ang Play. Mapupuno ang board pagkatapos ng unang refresh at mag-a-update kada minuto.
Script sa ServerScriptService na pinangalanang 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

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

Ang tina-type 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.

Ang ginagawa ng RoCode
  • 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

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.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.