Poradnik · Dane gracza

Jak zrobić leaderboard w Roblox Studio

Lista graczy w prawym górnym rogu gry Roblox jest sterowana jednym folderem o nazwie leaderstats. Ten poradnik buduje ją od zera: skrypt serwerowy, bezpieczny sposób dawania punktów, zapis między sesjami i globalne top 10.

Zaktualizowano 20 listopada 20267 min czytaniaAutor:

W skrócie

Utwórz Script w ServerScriptService, który nasłuchuje Players.PlayerAdded, tworzy Folder o nazwie dokładnie leaderstats (wszystko małymi literami) i robi go dzieckiem gracza. Każdy IntValue, NumberValue albo StringValue w tym folderze staje się kolumną na liście graczy.

  • Twórz i zmieniaj statystyki tylko na serwerze. Zmianę zrobioną przez LocalScript widzi tylko ten gracz i nikt więcej.
  • leaderstats się nie zapisuje. Wczytuj i zapisuj wartości przez data store, jeśli mają przetrwać do następnej sesji.
  • Do rankingu wszystkich graczy zapisuj każdy wynik w ordered data store i pokazuj go na tablicy w swoim świecie albo w trybie Global listy graczy.
Na tej stronie
  1. Jak działa leaderstats
  2. 1. Utwórz leaderstats
  3. 2. Dawanie punktów
  4. 3. Zapis
  5. 4. Globalne top 10
  6. Common errors
  7. Z RoCode
  8. Najczęstsze pytania
  9. Źródła i dalsza lektura

Jak działa leaderstats

IlustracjaGotowe skrypty leaderstats i platformy z monetami w uruchomionej grze.

Roblox pokazuje listę graczy w każdej grze. Gdy gracz ma dziecko Folder o nazwie leaderstats, lista dodaje kolumnę dla każdego obiektu wartości w środku i pokazuje wartość tego gracza w jego wierszu. Nagłówek kolumny to Name obiektu wartości.

Obiekty wartości, które można wkładać do leaderstats
ObiektPrzechowujeNadaje się do
IntValueLiczby całkowiteMonety, zabójstwa, wygrane, poziom
NumberValueLiczby ułamkoweNajlepszy czas okrążenia, dystans
StringValueTekstRanga albo nazwa drużyny

Dwie zasady psują prawie każdy niedziałający leaderboard. Nazwa folderu musi być dokładnie leaderstats: Leaderstats albo leaderStats są ignorowane. A folder musi tworzyć serwerowy Script, bo tylko zmiany na serwerze replikują się do wszystkich graczy. Jeśli nie masz pewności, gdzie wykonuje się kod, najpierw przeczytaj Script vs LocalScript vs ModuleScript (po angielsku).

Krok 1: utwórz skrypt leaderstats

  1. W Explorerze najedź kursorem na ServerScriptService, kliknij przycisk + i wstaw Script.
  2. Zmień jego nazwę na Leaderstats, żeby potem łatwo go znaleźć.
  3. Zastąp jego zawartość kodem poniżej i kliknij Play. Twoja nazwa pojawi się na liście graczy z Coins i Wins równymi 0.
Script w ServerScriptService o nazwie Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- nazwa musi być dokładnie taka, wszystko małymi literami

	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 -- rodzica ustawiamy na końcu, gdy wartości są już w środku
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- W Studio możesz wejść, zanim uruchomi się ten skrypt, więc ustawiamy tych, którzy już tu są
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

Pętla na końcu jest ważna przy testach w Studio: pierwszy gracz czasem wchodzi, zanim podłączy się PlayerAdded, i bez pętli zostałby bez statystyk.

Krok 2: bezpiecznie dawaj punkty

Żeby zmienić statystykę, ustaw jej Value z serwerowego skryptu. Ta platforma z monetami daje 10 monet, gdy gracz jej dotknie. Touched odpala się wiele razy na sekundę, gdy postać stoi na parcie, więc skrypt trzyma krótki cooldown dla każdego gracza.

Script w Part w Workspace o nazwie 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 odpala się wiele razy na krok; to nie pozwala jednemu dotknięciu zapłacić dziesięć razy
	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") znajduje postać nawet wtedy, gdy dotykający part jest wewnątrz akcesorium, a proste sprawdzenie hit.Parent to pomija.

Jeśli punkty są za coś, co gracz robi na swoim ekranie, na przykład za kliknięcie przycisku, LocalScript musi poprosić serwer przez RemoteEvent, a serwer musi zdecydować, czy zapłacić. Nigdy nie pozwalaj klientowi przysyłać kwoty. Poradnik o RemoteEvents pokazuje ten wzorzec ze sprawdzaniem.

Cztery gotowe przykłady: poradnik o pierwszej grze daje 1 Coin za każdą monetę, której gracz dotknie na trasie, i Win na platformie mety po 3 monetach, poradnik o symulatorze klikania daje Coins za kliknięcia przycisku z limitem kliknięć na serwerze, poradnik o mieczu dodaje 1 do Kills temu, kto zadał ostatni cios przed śmiercią gracza, a poradnik o broni pokazuje, jak zaliczyć zabójstwo, gdy strzał doprowadza Health celu do 0.

Krok 3: zapisuj statystyki między sesjami

leaderstats żyje tylko tak długo, jak serwer. Żeby zapisać monety i wygrane, wczytuj je z data store, gdy gracz wchodzi, i zapisuj, gdy wychodzi. Ta wersja zastępuje skrypt z kroku 1. Nigdy nie zapisuje gracza, którego dane się nie wczytały: to właśnie ten błąd kasuje postęp w większości skopiowanych skryptów zapisu.

Script w ServerScriptService o nazwie Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- Wywoływane wewnątrz każdego pcall poniżej, więc jeszcze nieopublikowana gra
-- (bez dostępu do data store) i tak dostaje leaderboard
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- Gracze, których zapisane statystyki się wczytały. Tych, których tu nie ma, nigdy nie zapisujemy,
-- więc nieudane wczytanie nie nadpisze prawdziwego postępu zerami.
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)

-- Gdy serwer się wyłącza, zapisujemy wszystkich przed zamknięciem
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)

Dla małej gry to wystarczy. O ponownych próbach, UpdateAsync, limitach zapytań i ochronie przed dwoma serwerami zapisującymi tego samego gracza czytaj dalej w poradniku o DataStore.

Krok 4: globalne top 10

leaderstats porównuje tylko graczy na jednym serwerze. Do globalnego rankingu potrzebny jest ordered data store: data store, który przechowuje jedną liczbę na klucz i umie zwracać klucze posortowane według wartości. Zapisuj w nim wynik każdego gracza z serwera, potem czytaj z powrotem najwyższe wpisy.

Pokazać go można na dwa sposoby. Lista graczy Roblox ma tryby Friends i Global, które czytają ordered data store zarejestrowany w Creator Hub (w chwili pisania to funkcja beta, jeden aktywny leaderboard na grę). Albo możesz sam narysować ranking na tablicy w swoim świecie: działa to w każdej grze i pozwala go ostylować, jak chcesz. Skrypt poniżej robi to drugie, a wyniki zapisuje z user ID gracza jako kluczem, czyli w tym samym formacie, którego oczekuje leaderboard w Creator Hub.

  1. Dodaj do Workspace zakotwiczony Part, nazwij go WinsBoard i zrób go wielkości szyldu (na przykład 12 na 8 na 1 stud), przednią ścianą w stronę spawnu.
  2. Wstaw do ServerScriptService Script o nazwie GlobalWinsBoard z kodem poniżej.
  3. Kliknij Play. Tablica zapełni się po pierwszym odświeżeniu i będzie się odświeżać co minutę.
Script w ServerScriptService o nazwie 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

-- Tablica: zakotwiczony Part o nazwie WinsBoard w Workspace. Skrypt sam dodaje
-- SurfaceGui i wiersze, więc zbudować trzeba tylko 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) zwraca 10 największych wartości jako pierwsze. Ordered data store przechowuje tylko liczby całkowite, więc trzymaj wyniki jako całkowite. Skrypt zapisuje każdego gracza raz na minutę i czyta top 10 raz na minutę, z dużym zapasem w standardowych limitach na serwer (30 + 5 na gracza na minutę dla zapisów w ordered data store i 5 + 2 na gracza dla posortowanych odczytów, według dokumentacji z 30 września 2026).

Częste błędy i rozwiązania

Problemy poniżej obejmują większość skarg „mój leaderboard nie działa”. Najpierw sprawdź okno Output (otwórz je z menu Window w Studio albo na karcie Script): jeśli skrypt wywalił się z błędem, będzie tam numer linii.

Leaderboard w ogóle się nie pokazuje

Sprawdź, czy folder nazywa się leaderstats małymi literami, czy jego rodzicem jest Player (a nie postać) i czy kod to Script w ServerScriptService, a nie LocalScript.

Inni gracze nie widzą zmian mojej statystyki

Wartość zmieniono na kliencie. Przenieś zmianę do serwerowego Script, a jeśli uruchamia ją przycisk albo klawisz, wyślij RemoteEvent i niech wartość zmienia serwer.

attempt to index nil with 'Coins'

Kod próbował przeczytać player.leaderstats.Coins, zanim folder się pojawił, albo nazwa jest napisana inaczej. Na serwerze używaj FindFirstChild i sprawdzaj wynik; w LocalScript używaj player:WaitForChild("leaderstats"). Poradnik o błędach skryptów szczegółowo omawia ten błąd.

Monety rosną o 10, 20 albo 50 od jednego dotknięcia

Touched odpala się raz za razem, dopóki party się przecinają. Dodaj cooldown dla każdego gracza, jak w kroku 2, albo usuwaj przedmiot po podniesieniu.

Statystyki resetują się przy każdym ponownym wejściu

Roblox nie zapisuje leaderstats. Dodaj skrypt z kroku 3. Żeby sprawdzić zapis w Studio, opublikuj grę i włącz Studio Access to API Services w Experience Settings.

Zrób to z RoCode

Jeśli nie chce ci się składać tego ręcznie, RoCode może zbudować wszystko w grze, którą masz otwartą. To agent AI, który działa przez plugin Roblox Studio, więc tworzy skrypty i party w twoim Explorerze, a nie daje kodu do wklejenia.

Ty piszesz

Dodaj leaderboard z Coins i Wins, który zapisuje się między sesjami, i tablicę top 10 według wygranych na parcie obok spawnu.

RoCode robi
  • Może najpierw poszukać w grze istniejącego kodu leaderstats albo DataStore, żeby uzupełnić to, co jest, zamiast dodawać drugi leaderboard
  • Tworzy skrypt serwerowy w ServerScriptService i part na tablicę w Workspace
  • Sprawdza kompilację napisanych skryptów wewnątrz Studio przed zakończeniem
  • Wysyła zmiany paczkami, a każda paczka jest oznaczana jako punkt cofania w historii Studio

Wynik i tak sprawdzasz ty i sam testujesz w grze statystyki i zapis: z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.11 lub nowszym sterować testową postacią i sprawdzać wartości takie jak Coins i Wins, ale sprawdza tylko to, co sam wybrał do testu. Leaderstats to zwykle pierwszy z wielu systemów gry: zbuduj resztę gry po jednym systemie na zapytanie w ten sam sposób. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Czym jest leaderstats w Roblox?

Folder o nazwie dokładnie leaderstats, wszystko małymi literami, wewnątrz Player. Roblox pokazuje każdy IntValue, NumberValue albo StringValue w nim jako kolumnę na liście graczy. Twórz go z serwerowego Script, jak w kroku 1.

Jak zrobić globalny leaderboard w Roblox?

Zapisuj wynik każdego gracza w ordered data store z serwera, potem czytaj z powrotem najwyższe wpisy i pokazuj je na tablicy w swoim świecie. W kroku 4 jest pełny skrypt na top 10.

Czy Roblox zapisuje leaderstats automatycznie?

Nie. leaderstats istnieje tylko, dopóki gracz jest na serwerze. Zapisuj wartości przez data store, gdy gracz wychodzi, i wczytuj, gdy wchodzi, jak w kroku 3.

Czy można ukryć wartość z leaderboardu?

Tak. Pokazują się tylko wartości wewnątrz folderu leaderstats. Prywatne dane trzymaj w innym folderze u gracza albo w tabeli w serwerowym skrypcie.

Jak ukryć całą listę graczy?

Z LocalScript wywołaj StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Przekaż true, żeby znowu ją pokazać.

Czy mogę użyć NumberValue na monety?

Możesz, ale do waluty z liczb całkowitych lepiej pasuje IntValue, a ordered data store przyjmuje tylko liczby całkowite, jeśli potem zechcesz robić z nich ranking.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.