Lyhyesti
Luo Script ServerScriptServiceen, joka kuuntelee Players.PlayerAdded-tapahtumaa, luo Folder-kansion, jonka nimi on täsmälleen leaderstats (kaikki pienillä kirjaimilla), ja tekee siitä pelaajan lapsen. Jokaisesta tämän kansion sisällä olevasta IntValue-, NumberValue- tai StringValue-objektista tulee sarake pelaajalistaan.
- Luo ja muuta tilastoja vain palvelimella. LocalScriptin tekemän muutoksen näkee vain kyseinen pelaaja eikä kukaan muu.
- leaderstats ei tallennu. Lataa ja tallenna arvot data storen avulla, jos niiden pitää säilyä seuraavaan istuntoon.
- Kaikkien pelaajien rankingia varten kirjoita jokainen tulos ordered data storeen ja näytä se taululla omassa maailmassasi tai pelaajalistan Global-tilassa.
Tällä sivulla
Miten leaderstats toimii
Roblox näyttää pelaajalistan jokaisessa pelissä. Kun pelaajalla on lapsena Folder nimeltä leaderstats, lista lisää sarakkeen jokaiselle sen sisällä olevalle arvo-objektille ja näyttää pelaajan arvon tämän rivillä. Sarakkeen otsikko on arvo-objektin Name.
| Objekti | Tallentaa | Sopii |
|---|---|---|
IntValue | Kokonaisluvut | Kolikot, tapot, voitot, taso |
NumberValue | Desimaaliluvut | Paras kierrosaika, matka |
StringValue | Teksti | Joukkueen arvo tai titteli |
Kaksi sääntöä rikkoo lähes jokaisen toimimattoman tulostaulukon. Kansion nimen on oltava täsmälleen leaderstats: Leaderstats tai leaderStats ohitetaan. Ja kansion on luotava palvelimen Script, koska vain palvelimella tehdyt muutokset replikoituvat kaikille pelaajille. Jos et ole varma, missä koodi suoritetaan, lue ensin Script vs LocalScript vs ModuleScript (englanniksi).
Vaihe 1: luo leaderstats-skripti
- Vie Explorerissa osoitin ServerScriptServicen päälle, paina +-painiketta ja lisää Script.
- Nimeä se uudelleen nimellä
Leaderstats, jotta se on myöhemmin helppo löytää. - Korvaa sen sisältö alla olevalla koodilla ja paina Play. Nimesi ilmestyy pelaajalistaan, ja Coins ja Wins ovat 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- nimen on oltava täsmälleen tämä, kaikki pienillä kirjaimilla
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 -- vanhempi asetetaan viimeisenä, kun arvot ovat jo sisällä
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Studiossa voi liittyä ennen kuin tämä skripti käynnistyy, joten asetetaan myös jo paikalla olevat
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Lopun silmukka on tärkeä Studiossa testatessa: ensimmäinen pelaaja liittyy joskus ennen kuin PlayerAdded on yhdistetty, ja ilman silmukkaa hän jäisi ilman tilastoja.
Vaihe 2: jaa pisteitä turvallisesti
Muuttaaksesi tilastoa aseta sen Value palvelinskriptistä. Tämä kolikkoalusta antaa 10 kolikkoa, kun pelaaja koskettaa sitä. Touched laukeaa monta kertaa sekunnissa, kun hahmo seisoo partin päällä, joten skripti pitää jokaiselle pelaajalle lyhyen jäähdytysajan.
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 laukeaa monta kertaa askeleen aikana; tämä estää yhtä kosketusta maksamasta kymmentä kertaa
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") löytää hahmon silloinkin, kun koskettanut part on asusteen sisällä, kun taas yksinkertainen hit.Parent-tarkistus ohittaa sen.
Jos pisteitä annetaan siitä, mitä pelaaja tekee omalla näytöllään, esimerkiksi painikkeen painamisesta, LocalScriptin on pyydettävä palvelinta RemoteEventin kautta, ja palvelimen on päätettävä, maksetaanko. Älä koskaan anna asiakkaan lähettää summaa. RemoteEvent-opas näyttää tämän mallin tarkistuksineen.
Neljä valmista esimerkkiä: ensimmäisen pelin opas antaa 1 Coinin jokaisesta kolikosta, jota pelaaja koskettaa radalla, ja Winin maalialustalla 3 kolikon jälkeen, klikkerisimulaattorin opas antaa Coinseja painikkeen painalluksista palvelimen klikkausrajalla, miekkaopas lisää 1 Killsiin sille, joka löi viimeisen iskun ennen pelaajan kuolemaa, ja aseopas näyttää, miten tappo lasketaan, kun laukaus pudottaa kohteen Healthin 0:aan.
Vaihe 3: tallenna tilastot istuntojen välillä
leaderstats elää vain niin kauan kuin palvelin. Tallentaaksesi kolikot ja voitot lataa ne data storesta, kun pelaaja liittyy, ja tallenna, kun hän poistuu. Tämä versio korvaa vaiheen 1 skriptin. Se ei koskaan tallenna pelaajaa, jonka tiedot eivät latautuneet: juuri tämä virhe pyyhkii edistymisen useimmissa kopioiduissa tallennusskripteissä.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Kutsutaan jokaisen alla olevan pcallin sisällä, joten vielä julkaisematon paikka
-- (ilman pääsyä data storeen) saa silti tulostaulukon
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Pelaajat, joiden tallennetut tilastot latautuivat. Niitä, joita tässä ei ole, ei koskaan tallenneta,
-- joten epäonnistunut lataus ei korvaa oikeaa edistymistä nollilla.
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)
-- Kun palvelin sammuu, tallennetaan kaikki ennen sulkemista
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)
Pienelle pelille tämä riittää. Uusintayrityksistä, UpdateAsync-kutsusta, pyyntörajoista ja suojasta kahta samaa pelaajaa kirjoittavaa palvelinta vastaan voit lukea lisää DataStore-tutoriaalista.
Vaihe 4: globaali top 10
leaderstats vertaa vain saman palvelimen pelaajia. Globaaliin rankingiin tarvitaan ordered data store: data store, joka tallentaa yhden luvun avainta kohden ja osaa palauttaa avaimet arvon mukaan järjestettyinä. Kirjoita siihen jokaisen pelaajan tulos palvelimelta ja lue sitten kärkimerkinnät takaisin.
Sen voi näyttää kahdella tavalla. Robloxin pelaajalistassa on tilat Friends ja Global, jotka lukevat Creator Hubissa rekisteröityä ordered data storea (kirjoitushetkellä beetaominaisuus, yksi aktiivinen tulostaulukko peliä kohden). Tai voit piirtää rankingin itse taululle omaan maailmaasi: se toimii missä tahansa pelissä, ja sen voi muotoilla miten haluaa. Alla oleva skripti tekee jälkimmäisen, ja se kirjoittaa tulokset pelaajan user ID:llä avaimena, mikä on sama muoto, jota Creator Hubin tulostaulukko odottaa.
- Lisää Workspaceen ankkuroitu Part, nimeä se
WinsBoardja tee siitä kyltin kokoinen (esimerkiksi 12 x 8 x 1 studia) etupinta spawnia kohti. - Lisää ServerScriptServiceen Script nimeltä
GlobalWinsBoardja alla oleva koodi. - Paina Play. Taulu täyttyy ensimmäisen päivityksen jälkeen ja päivittyy joka minuutti.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Taulu: ankkuroitu Part nimeltä WinsBoard Workspacessa. Skripti lisää itse
-- SurfaceGuin ja rivit, joten rakentaa tarvitsee vain Partin.
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) palauttaa 10 suurinta arvoa ensin. Ordered data store tallentaa vain kokonaislukuja, joten tallenna tulokset kokonaislukuina. Skripti kirjoittaa jokaisen pelaajan kerran minuutissa ja lukee top 10:n kerran minuutissa, reilusti palvelinkohtaisten oletusrajojen sisällä (30 + 5 pelaajaa kohden minuutissa ordered data storen kirjoituksille ja 5 + 2 pelaajaa kohden järjestetyille luvuille, dokumentaation mukaan 30. syyskuuta 2026).
Yleiset virheet ja ratkaisut
Alla olevat ongelmat kattavat useimmat "tulostaulukkoni ei toimi" -valitukset. Tarkista ensin Output-ikkuna (avaa se Studion Window-valikosta tai Script-välilehdeltä): jos skripti kaatui virheeseen, siellä on rivinumero.
Tulostaulukko ei näy lainkaan
Tarkista, että kansion nimi on leaderstats pienillä kirjaimilla, että sen vanhempi on Player (eikä hahmo) ja että koodi on Script ServerScriptServicessä eikä LocalScript.
Muut pelaajat eivät näe tilastoni muutoksia
Arvo muutettiin asiakkaalla. Siirrä muutos palvelimen Scriptiin, ja jos sen käynnistää painike tai näppäin, lähetä RemoteEvent ja anna palvelimen muuttaa arvo.
attempt to index nil with 'Coins'
Koodi yritti lukea player.leaderstats.Coins ennen kuin kansio ilmestyi, tai nimi on kirjoitettu eri tavalla. Käytä palvelimella FindFirstChild-kutsua ja tarkista tulos; käytä LocalScriptissä player:WaitForChild("leaderstats"). Skriptivirheiden opas käy tämän virheen läpi yksityiskohtaisesti.
Kolikoita tulee 10, 20 tai 50 yhdestä kosketuksesta
Touched laukeaa yhä uudelleen niin kauan kuin partit leikkaavat toisiaan. Lisää jokaiselle pelaajalle jäähdytysaika kuten vaiheessa 2, tai poista esine poiminnan jälkeen.
Tilastot nollautuvat joka kerta, kun liityn uudelleen
Roblox ei tallenna leaderstatsia. Lisää vaiheen 3 skripti. Testataksesi tallennusta Studiossa julkaise paikka ja ota Studio Access to API Services käyttöön Experience Settingsissä.
Tee RoCodella
Jos et halua koota tätä käsin, RoCode voi rakentaa kaiken paikkaan, joka sinulla on auki. Se on tekoälyagentti, joka toimii Roblox Studio -lisäosan kautta, joten se luo skriptit ja partit Exploreriisi sen sijaan, että antaisi liitettävää koodia.
Lisää tulostaulukko, jossa on Coins ja Wins ja joka tallentuu istuntojen välillä, sekä voittojen top 10 -taulu partille spawnin lähelle.
- Voi ensin etsiä paikasta olemassa olevaa leaderstats- tai DataStore-koodia täydentääkseen sitä, mitä on, eikä lisätä toista tulostaulukkoa
- Luo palvelinskriptin ServerScriptServiceen ja taulun partin Workspaceen
- Tarkistaa kirjoittamiensa skriptien kääntymisen Studiossa ennen lopettamista
- Lähettää muutokset erinä, ja jokainen erä merkitään kumouspisteeksi Studion historiaan
Tuloksen tarkistat silti sinä, ja testaat itse pelissä tilastot ja tallennuksen: lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.11 tai uudemmalla ohjata testihahmoa ja tarkistaa arvoja kuten Coins ja Wins, mutta se tarkistaa vain sen, mitä se itse valitsi testattavaksi. Leaderstats on yleensä ensimmäinen pelin monista järjestelmistä: rakenna loppu peli järjestelmä kerrallaan, yksi pyyntö kutakin kohden samalla tavalla. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Mikä on leaderstats Robloxissa?
Folder, jonka nimi on täsmälleen leaderstats, kaikki pienillä kirjaimilla, Playerin sisällä. Roblox näyttää jokaisen sen sisällä olevan IntValue-, NumberValue- tai StringValue-objektin sarakkeena pelaajalistassa. Luo se palvelimen Scriptistä kuten vaiheessa 1.
Miten Robloxiin tehdään globaali tulostaulukko?
Kirjoita jokaisen pelaajan tulos ordered data storeen palvelimelta, lue sitten kärkimerkinnät takaisin ja näytä ne taululla omassa maailmassasi. Vaiheessa 4 on koko skripti top 10:lle.
Tallentaako Roblox leaderstatsin automaattisesti?
Ei. leaderstats on olemassa vain niin kauan kuin pelaaja on palvelimella. Tallenna arvot data storen avulla, kun pelaaja poistuu, ja lataa ne, kun hän liittyy, kuten vaiheessa 3.
Voiko arvon piilottaa tulostaulukosta?
Kyllä. Vain leaderstats-kansion sisällä olevat arvot näytetään. Säilytä yksityiset tiedot toisessa kansiossa pelaajan alla tai taulukossa palvelinskriptissä.
Miten koko pelaajalista piilotetaan?
Kutsu LocalScriptistä StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Anna true näyttääksesi sen taas.
Voiko kolikoihin käyttää NumberValueta?
Voi, mutta kokonaislukuvaluutalle IntValue sopii paremmin, ja ordered data store hyväksyy vain kokonaislukuja, jos haluat myöhemmin tehdä niistä rankingin.
Lähteet ja lisälukemista
- Roblox Creator Docs: Leaderboards (englanniksi). leaderstats, tilastojen järjestys sekä pysyvät Friends- ja Global-tilat
- Roblox Creator Docs: Data stores (englanniksi). GetAsync, SetAsync, ordered data storet ja rajat
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.