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
Jak działa leaderstats
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.
| Obiekt | Przechowuje | Nadaje się do |
|---|---|---|
IntValue | Liczby całkowite | Monety, zabójstwa, wygrane, poziom |
NumberValue | Liczby ułamkowe | Najlepszy czas okrążenia, dystans |
StringValue | Tekst | Ranga 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
- W Explorerze najedź kursorem na ServerScriptService, kliknij przycisk + i wstaw Script.
- Zmień jego nazwę na
Leaderstats, żeby potem łatwo go znaleźć. - 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.
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.
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.
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.
- Dodaj do Workspace zakotwiczony Part, nazwij go
WinsBoardi zrób go wielkości szyldu (na przykład 12 na 8 na 1 stud), przednią ścianą w stronę spawnu. - Wstaw do ServerScriptService Script o nazwie
GlobalWinsBoardz kodem poniżej. - Kliknij Play. Tablica zapełni się po pierwszym odświeżeniu i będzie się odświeżać co minutę.
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.
Dodaj leaderboard z Coins i Wins, który zapisuje się między sesjami, i tablicę top 10 według wygranych na parcie obok spawnu.
- 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
- Roblox Creator Docs: Leaderboards (po angielsku). leaderstats, kolejność statystyk i stałe tryby Friends i Global
- Roblox Creator Docs: Data stores (po angielsku). GetAsync, SetAsync, ordered data stores i limity
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ą.