Eğitim · Oyuncu verisi

Roblox Studio'da liderlik tablosu nasıl yapılır

Bir Roblox oyununun sağ üst köşesindeki oyuncu listesi, leaderstats adlı tek bir klasöre bağlıdır. Bu rehber onu sıfırdan kuruyor: sunucu scripti, puan vermenin güvenli bir yolu, oturumlar arasında kaydetme ve global bir top 10.

Güncellendi: 20 Kasım 20266 dk okumaYazan:

Kısaca

ServerScriptService içinde bir Script oluştur; bu script Players.PlayerAdded'ı dinlesin, adı tam olarak leaderstats (hepsi küçük harf) olan bir Folder oluştursun ve onu oyuncunun child'ı yapsın. O klasörün içindeki her IntValue, NumberValue ya da StringValue oyuncu listesinde bir sütun olur.

  • İstatistikleri sadece sunucuda oluştur ve değiştir. Bir LocalScript'in yaptığı değişikliği sadece o oyuncu görür, başka kimse görmez.
  • leaderstats kaydedilmez. Değerlerin bir sonraki oturumda da kalması gerekiyorsa onları bir data store ile yükle ve kaydet.
  • Tüm oyuncular arasında bir sıralama için her skoru bir ordered data store'a yaz ve dünyandaki bir tabelada ya da oyuncu listesinin Global görünümünde göster.
Bu sayfada
  1. leaderstats nasıl çalışır
  2. 1. leaderstats oluştur
  3. 2. Puan ver
  4. 3. İstatistikleri kaydet
  5. 4. Global top 10
  6. Common errors
  7. RoCode ile
  8. Sık sorulan sorular
  9. Kaynaklar ve ek okumalar

leaderstats nasıl çalışır

ÇizimBitmiş leaderstats ve coin platformu scriptleri çalışan bir oyunda.

Roblox her oyunda bir oyuncu listesi gösterir. Bir oyuncunun leaderstats adlı bir Folder child'ı olduğunda liste, içindeki her değer nesnesi için bir sütun ekler ve o oyuncunun değerini onun satırında gösterir. Sütun başlığı değer nesnesinin Name'idir.

leaderstats içine koyabileceğin değer nesneleri
NesneNe tutarNe için
IntValueTam sayılarCoin, kill, galibiyet, seviye
NumberValueOndalıklı sayılarEn iyi tur süresi, mesafe
StringValueMetinRütbe ya da takım unvanı

Bozuk liderlik tablolarının neredeyse hepsini iki kural açıklar. Klasörün adı tam olarak leaderstats olmalı: Leaderstats ya da leaderStats yok sayılır. Ve klasörü bir sunucu Script'i oluşturmalı, çünkü sadece sunucudaki değişiklikler tüm oyunculara replike edilir. Kodun nerede çalıştığından emin değilsen önce Script vs LocalScript vs ModuleScript rehberini oku (İngilizce).

1. adım: leaderstats scriptini oluştur

  1. Explorer'da fareyle ServerScriptService üzerine gel, + butonuna tıkla ve bir Script ekle.
  2. Sonra kolayca bulmak için adını Leaderstats yap.
  3. İçeriğini aşağıdaki kodla değiştir ve Play'e bas. Adın oyuncu listesinde Coins ve Wins 0 olarak görünür.
Script konum: ServerScriptService adı: Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- adı tam olarak bu olmalı, hepsi küçük harf

	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 -- parent'ı en son, değerler zaten içerideyken ata
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- Studio'da bu script çalışmadan önce girebilirsin, o yüzden zaten burada olanları da hazırla
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

Sondaki döngü Studio'da test ederken önemli: bazen ilk oyuncu PlayerAdded bağlanmadan önce girer ve o oyuncu istatistiksiz kalırdı.

2. adım: oyunculara güvenli şekilde puan ver

Bir istatistiği değiştirmek için Value'sunu bir sunucu scriptinden ayarla. Bu coin platformu bir oyuncu ona dokunduğunda 10 coin öder. Bir karakter bir parçanın üstündeyken Touched saniyede birçok kez tetiklenir, bu yüzden script her oyuncu için kısa bir bekleme süresi tutar.

Script konum: Workspace'teki bir part adı: 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 her adımda birçok kez tetiklenir; bu, tek dokunuşun on kez ödeme yapmasını engeller
	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"), dokunan parça bir aksesuarın içinde olsa bile karakteri bulur; basit bir hit.Parent kontrolü bunu kaçırır.

Puanlar oyuncunun kendi ekranında yaptığı bir şeyden geliyorsa, örneğin bir butona basmaktan, LocalScript bunu bir RemoteEvent ile sunucudan istemeli ve ödeme yapılıp yapılmayacağına sunucu karar vermeli. Miktarı asla istemcinin göndermesine izin verme. RemoteEvents rehberi bu kalıbı doğrulamayla gösteriyor.

Dört hazır örnek: ilk oyun rehberi oyuncunun parkurda dokunduğu her coin için 1 Coin ve 3 coin'den sonra bitiş platformunda bir Win verir, clicker simülatör rehberi sunucuda tıklama sınırıyla buton tıklamaları için Coins verir, kılıç rehberi bir oyuncu ölmeden önce son vuruşu yapan kişinin Kills değerine 1 ekler, silah rehberi de bir atış hedefin Health'ini 0'a indirdiğinde bir kill'in nasıl sayılacağını gösterir.

3. adım: istatistikleri oturumlar arasında kaydet

leaderstats sadece sunucu var olduğu sürece var olur. Coin'leri ve galibiyetleri korumak için oyuncu girdiğinde onları bir data store'dan yükle ve çıktığında kaydet. Bu sürüm 1. adımdaki scriptin yerine geçer. Verisi yüklenemeyen bir oyuncuyu asla kaydetmez; kopyalanan kaydetme scriptlerinin çoğunda ilerlemeyi silen hata budur.

Script konum: ServerScriptService adı: Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- Aşağıdaki her pcall içinde çağrılır, böylece henüz yayınlanmamış bir place
-- (data store erişimi yok) yine de liderlik tablosuna sahip olur
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- Kayıtlı istatistikleri yüklenen oyuncular. Burada olmayan kimse asla kaydedilmez,
-- böylece başarısız bir yükleme gerçek ilerlemeyi sıfırlarla ezemez.
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)

-- Sunucu kapanırken kapanmadan önce herkesi kaydet
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)

Küçük bir oyun için bu yeterli. Yeniden denemeler, UpdateAsync, istek sınırları ve aynı oyuncuyu yazan iki sunucuya karşı koruma için DataStore eğitimiyle devam et.

4. adım: global bir top 10

leaderstats sadece aynı sunucudaki oyuncuları karşılaştırır. Global bir sıralama bir ordered data store ister: her anahtar için bir sayı tutan ve anahtarları değere göre sıralı döndürebilen bir data store. Her oyuncunun skorunu sunucudan ona yaz, sonra ilk kayıtları oku.

Bunu göstermenin iki yolu var. Roblox'un oyuncu listesinde, Creator Hub'da kaydettiğin bir ordered data store'dan okuyan Friends ve Global görünümleri var (bu yazı yazılırken beta bir özellik, oyun başına bir aktif liderlik tablosuyla). Ya da sıralamayı dünyandaki bir tabelaya kendin çizebilirsin; bu her oyunda çalışır ve ona stil vermeni sağlar. Aşağıdaki script ikincisini yapıyor ve yazdığı skorlar anahtar olarak oyuncunun kullanıcı ID'sini kullanıyor; Creator Hub liderlik tablosunun beklediği biçim de bu.

  1. Workspace'e anchored bir Part ekle, adını WinsBoard koy ve ona tabela boyutu ver (örneğin 12 x 8 x 1 stud), ön yüzü spawn noktana baksın.
  2. ServerScriptService'e aşağıdaki kodla GlobalWinsBoard adlı bir Script ekle.
  3. Oyna. Tabela ilk güncelleme bitince dolar ve her dakika yenilenir.
Script konum: ServerScriptService adı: 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

-- Tabela: Workspace'te WinsBoard adlı anchored bir Part. Script SurfaceGui'yi ve satırları
-- kendisi ekler, yani kurman gereken tek şey 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) en yüksek 10 değeri önce döndürür. Ordered data store'lar sadece tam sayı tutar, bu yüzden skorları tam sayı olarak sakla. Script her oyuncuyu dakikada bir yazar ve top 10'u dakikada bir okur; bu, varsayılan sunucu başı sınırların çok altında (30 Eylül 2026 tarihli dokümantasyona göre sıralı yazmalar için dakikada 30 + oyuncu başına 5, sıralı okumalar için 5 + oyuncu başına 2).

Sık yapılan hatalar ve çözümleri

Aşağıdaki sorunlar "liderlik tablom çalışmıyor" şikayetlerinin çoğunu açıklar. Önce Output penceresine bak (Studio'nun Window menüsünden ya da Script sekmesinden aç): bir script hata verdiyse satır numarası orada.

Liderlik tablosu hiç görünmüyor

Klasörün adının küçük harflerle leaderstats olduğunu, parent'ının Player olduğunu (karakter değil) ve kodun bir LocalScript değil, ServerScriptService içinde bir Script olduğunu kontrol et.

Diğer oyuncular istatistiğimdeki değişikliği görmüyor

Değer istemcide değiştirildi. Değişikliği bir sunucu Script'ine taşı; onu bir buton ya da tuş tetikliyorsa bir RemoteEvent gönder ve değeri sunucu değiştirsin.

attempt to index nil with 'Coins'

Kod, klasör oluşmadan önce player.leaderstats.Coins'u okumaya çalıştı ya da ad farklı yazılmış. Sunucuda FindFirstChild kullan ve sonucu kontrol et; LocalScript'te player:WaitForChild("leaderstats") kullan. Script hataları rehberi bu hatayı ayrıntılı anlatıyor.

Tek dokunuşta coin'ler 10, 20 ya da 50 artıyor

Touched parçalar üst üste olduğu sürece tekrar tekrar tetiklenir. 2. adımdaki gibi oyuncu başına bir bekleme süresi ekle ya da toplandığında nesneyi kaldır.

Her tekrar girişimde istatistikler sıfırlanıyor

Roblox leaderstats'ı kaydetmez. 3. adımdaki scripti ekle. Kaydetmeyi Studio'da test etmek için place'i yayınla ve Experience Settings'te Studio Access to API Services'ı aç.

RoCode ile yap

Hepsini elle bağlamak istemiyorsan RoCode bunu açık olan place'inin içinde kurabilir. Roblox Studio plugin'i aracılığıyla çalışan bir yapay zeka ajanı, yani sana yapıştıracağın kod vermek yerine scriptleri ve parçaları Explorer'ında oluşturur.

Sen yazarsın

Oturumlar arasında kaydedilen Coins ve Wins içeren bir liderlik tablosu ve spawn yakınındaki bir parçada galibiyetlere göre top 10 tabelası ekle.

RoCode yapar
  • Önce place'inde var olan leaderstats ya da DataStore kodunu arayabilir, böylece ikinci bir liderlik tablosu eklemek yerine elindekini genişletir
  • Sunucu scriptini ServerScriptService'te, tabela parçasını Workspace'te oluşturur
  • Bitirmeden önce yazdığı scriptlerin derlendiğini Studio içinde kontrol eder
  • Değişikliklerini gruplar halinde gönderir ve her grup Studio geçmişinde bir geri alma noktası olarak işaretlenir

Sonucu kontrol etmek, istatistikleri ve kaydetmeyi oyunda kendin test etmek yine sana kalıyor: plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.11 ya da üstüyle de bir test karakterini yönetip Coins ve Wins gibi değerleri kontrol edebilir, ama sadece test etmeye karar verdiği şeyi kontrol eder. Leaderstats genelde bir oyunun birçok sisteminden ilkidir: oyununun geri kalanını da aynı şekilde, her prompt'ta bir sistem olarak kur. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox'ta leaderstats nedir?

Bir Player'ın içinde, adı tam olarak leaderstats olan, hepsi küçük harf bir Folder. Roblox içindeki her IntValue, NumberValue ya da StringValue'yu oyuncu listesinde bir sütun olarak gösterir. Onu 1. adımdaki gibi bir sunucu Script'inden oluştur.

Roblox'ta global liderlik tablosu nasıl yapılır?

Her oyuncunun skorunu sunucudan bir ordered data store'a yaz, sonra ilk kayıtları geri oku ve dünyandaki bir tabelada göster. 4. adımda top 10 için tam script var.

Roblox leaderstats'ı otomatik kaydeder mi?

Hayır. leaderstats sadece oyuncu sunucudayken var olur. Değerleri 3. adımdaki gibi oyuncu çıkarken bir data store ile kaydet ve girerken yükle.

Bir değeri liderlik tablosundan gizleyebilir miyim?

Evet. Sadece leaderstats klasörünün içindeki değerler gösterilir. Özel verileri oyuncunun başka bir klasöründe ya da bir sunucu scriptindeki bir tabloda tut.

Bütün oyuncu listesini nasıl gizlerim?

Bir LocalScript'ten StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false)'u çağır. Tekrar göstermek için true ver.

Coin'ler için NumberValue kullanabilir miyim?

Kullanabilirsin, ama tam sayılı bir para birimine IntValue daha iyi uyar ve sonra onunla bir sıralama yaparsan ordered data store'lar sadece tam sayı kabul eder.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.