要点
ServerScriptService に Script を作り、Players.PlayerAdded を受け取って、名前がちょうど leaderstats(すべて小文字)の Folder を作成し、そのプレイヤーの子にします。このフォルダの中にある IntValue、NumberValue、StringValue がそれぞれプレイヤーリストの列になります。
- ステータスの作成と変更はサーバーだけで行ってください。LocalScript で行った変更は、そのプレイヤー本人にしか見えません。
- leaderstats は保存されません。次のセッションまで値を残したいなら、data store で読み込みと保存を行ってください。
- 全プレイヤーのランキングを作るには、各スコアを ordered data store に書き込み、ワールド内の掲示板か、プレイヤーリストの Global モードで表示します。
このページの内容
leaderstats の仕組み
Roblox はどのゲームでもプレイヤーリストを表示します。プレイヤーが leaderstats という名前の子 Folder を持っていると、リストはその中の値オブジェクトごとに列を追加し、そのプレイヤーの行に値を表示します。列の見出しは値オブジェクトの Name です。
| オブジェクト | 保持するもの | 向いている用途 |
|---|---|---|
IntValue | 整数 | コイン、キル数、勝利数、レベル |
NumberValue | 小数 | ベストラップタイム、距離 |
StringValue | テキスト | ランクやチームの称号 |
動かないリーダーボードのほとんどは、2つのルールのどちらかで壊れています。フォルダ名はちょうど leaderstats でなければならず、Leaderstats や leaderStats は無視されます。そして、フォルダはサーバーの Script が作る必要があります。全プレイヤーに複製されるのはサーバーでの変更だけだからです。コードがどこで動くか自信がなければ、先に Script vs LocalScript vs ModuleScript(英語)を読んでください。
ステップ1: leaderstats のスクリプトを作る
- Explorer で ServerScriptService にカーソルを合わせ、+ ボタンを押して Script を挿入します。
- あとで見つけやすいように、名前を
Leaderstatsに変えます。 - 中身を下のコードに置き換えて Play を押します。プレイヤーリストにあなたの名前が、Coins と Wins が0の状態で表示されます。
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- 名前はこのとおり、すべて小文字にする
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 -- 値を入れ終えてから、最後に親を設定する
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Studio ではこのスクリプトが動く前に参加できてしまうので、すでにいるプレイヤーも設定する
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
最後のループは Studio でのテストで重要です。最初のプレイヤーは PlayerAdded が接続される前に参加することがあり、ループがないとステータスなしのままになります。
ステップ2: ポイントを安全に配る
ステータスを変えるには、サーバースクリプトからその Value を設定します。このコインパッドは、プレイヤーが触れると10コインを渡します。キャラクターがパーツの上に立っている間 Touched は1秒に何度も発火するので、スクリプトはプレイヤーごとに短いクールダウンを持たせています。
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 は1歩で何度も発火する。これで1回の接触で10回払うのを防ぐ
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") は、触れたパーツがアクセサリーの中にあってもキャラクターを見つけます。単純な hit.Parent のチェックではこれを見逃します。
ボタンを押すなど、プレイヤーが自分の画面で行うことでポイントを渡す場合は、LocalScript が RemoteEvent でサーバーに頼み、払うかどうかはサーバーが決める必要があります。クライアントに金額を送らせてはいけません。RemoteEvent のガイドで、チェック付きのこのパターンを紹介しています。
完成した例が4つあります。初めてのゲームのガイドでは、コースで触れたコイン1枚ごとに 1 Coin、3枚集めたあとゴールのパッドで Win を渡します。クリッカーシミュレーターのガイドでは、ボタンのクリックで Coins を渡し、クリック数の上限をサーバーで管理します。剣のガイドでは、プレイヤーが倒れる直前に最後の一撃を入れた人の Kills に1を足します。銃のガイド(英語)では、射撃で相手の Health が0になったときにキルを数える方法を紹介しています。
ステップ3: セッションをまたいでステータスを保存する
leaderstats はサーバーが動いている間しか存在しません。コインと勝利数を残すには、プレイヤーが参加したときに data store から読み込み、退出したときに保存します。このバージョンはステップ1のスクリプトを置き換えます。データの読み込みに失敗したプレイヤーは決して保存しません。コピーされた保存スクリプトの多くで進行状況が消えるのは、まさにこのミスが原因です。
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- 下の各 pcall の中で呼ぶので、まだ公開していないプレイス
-- (data store にアクセスできない)でもリーダーボードは作られる
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- 保存済みステータスの読み込みに成功したプレイヤー。ここにいないプレイヤーは保存しないので、
-- 読み込みに失敗しても本物の進行状況がゼロで上書きされない。
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)
-- サーバーが停止するときは、閉じる前に全員を保存する
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)
小さなゲームならこれで十分です。リトライ、UpdateAsync、リクエストの上限、2つのサーバーが同じプレイヤーを書き込む問題への対策は、DataStore のチュートリアルで続きを読んでください。
ステップ4: グローバルなトップ10
leaderstats が比べるのは同じサーバーのプレイヤーだけです。グローバルなランキングには ordered data store が必要です。これはキーごとに1つの数値を保持し、値の順に並べたキーを返せる data store です。サーバーから各プレイヤーのスコアを書き込み、上位のエントリを読み出します。
表示する方法は2つあります。Roblox のプレイヤーリストには Friends と Global のモードがあり、Creator Hub で登録した ordered data store を読み込みます(執筆時点ではベータ機能で、1つのゲームにつき有効なリーダーボードは1つです)。もう1つは、ワールド内の掲示板に自分でランキングを描く方法で、どのゲームでも動き、見た目も自由にできます。下のスクリプトは後者を行い、スコアはプレイヤーの user ID をキーにして書き込みます。これは Creator Hub のリーダーボードが求める形式と同じです。
- Workspace に固定(Anchored)した Part を追加して
WinsBoardと名付け、看板くらいの大きさ(例えば 12 x 8 x 1 スタッド)にして、前面をスポーン地点に向けます。 - ServerScriptService に
GlobalWinsBoardという名前の Script を挿入し、下のコードを入れます。 - Play を押します。掲示板は最初の更新で埋まり、その後は1分ごとに更新されます。
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- 掲示板: Workspace にある WinsBoard という名前の固定された Part。SurfaceGui と行は
-- スクリプトが自分で追加するので、作るのは 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) は大きい値から順に10件を返します。ordered data store は整数しか保持しないので、スコアは整数で保存してください。このスクリプトは1分に1回各プレイヤーを書き込み、1分に1回トップ10を読み込みます。これはサーバーごとの標準の上限に対して十分な余裕があります(2026年9月30日時点のドキュメントでは、ordered data store への書き込みが1分あたり 30 + プレイヤー1人につき 5、並べ替えた読み込みが 5 + プレイヤー1人につき 2)。
よくあるエラーと対処法
下の問題で、「リーダーボードが動かない」という相談のほとんどをカバーできます。まず Output ウィンドウを確認してください(Studio の Window メニューか Script タブから開けます)。スクリプトがエラーで止まっていれば、そこに行番号が出ています。
リーダーボードがまったく表示されない
フォルダ名が小文字の leaderstats になっているか、その親が(キャラクターではなく)Player か、コードが LocalScript ではなく ServerScriptService の Script かを確認してください。
自分のステータスの変化がほかのプレイヤーに見えない
値をクライアントで変えています。変更をサーバーの Script に移してください。ボタンやキーで発生させる場合は、RemoteEvent を送って、サーバーに値を変えさせます。
attempt to index nil with 'Coins'
フォルダができる前に player.leaderstats.Coins を読もうとしたか、名前の書き方が違います。サーバーでは FindFirstChild を使って結果を確認し、LocalScript では player:WaitForChild("leaderstats") を使ってください。スクリプトエラーのガイドで、このエラーを詳しく解説しています。
1回触れただけでコインが10、20、50と増える
パーツが重なっている間、Touched は何度も発火します。ステップ2のようにプレイヤーごとのクールダウンを入れるか、拾ったらアイテムを削除してください。
参加し直すたびにステータスがリセットされる
Roblox は leaderstats を保存しません。ステップ3のスクリプトを追加してください。Studio で保存を確認するには、プレイスを公開し、Experience Settings で Studio Access to API Services をオンにします。
RoCode で作る
手作業で組み立てたくなければ、RoCode が開いているプレイスの中にすべて作れます。RoCode は Roblox Studio のプラグインを通じて動く AI エージェントなので、貼り付け用のコードを出すのではなく、あなたの Explorer にスクリプトとパーツを作ります。
セッションをまたいで保存される Coins と Wins のリーダーボードと、スポーン地点の近くのパーツに勝利数トップ10の掲示板を追加して。
- 最初にプレイスの中で既存の leaderstats や DataStore のコードを探し、2つ目のリーダーボードを足すのではなく、今あるものを拡張することがあります
- ServerScriptService にサーバースクリプトを、Workspace に掲示板用のパーツを作成します
- 書いたスクリプトがコンパイルできるかを、完了前に Studio の中でチェックします
- 変更をまとまりごとに送り、各まとまりは Studio の履歴に取り消しポイントとして記録されます
結果の確認と、ステータスや保存のゲーム内テストはあなた自身で行ってください。プラグイン 3.9 以降なら RoCode は短いプレイテストを実行してエラーを読めます。プラグイン 3.9.11 以降ならテスト用キャラクターを操作して Coins や Wins などの値を確認できますが、確認するのは自分でテスト対象に選んだものだけです。leaderstats はたいてい、ゲームの多くのシステムの最初の1つです。残りのゲームも、1回のリクエストにつき1システムずつ同じ方法で作れます。RoCode が Studio に接続する仕組み。
よくある質問
Roblox の leaderstats とは何ですか?
Player の中にある、名前がちょうど leaderstats(すべて小文字)の Folder です。Roblox はその中の IntValue、NumberValue、StringValue をそれぞれプレイヤーリストの列として表示します。ステップ1のように、サーバーの Script から作成してください。
Roblox でグローバルなリーダーボードを作るには?
サーバーから各プレイヤーのスコアを ordered data store に書き込み、上位のエントリを読み出してワールド内の掲示板に表示します。ステップ4にトップ10の完全なスクリプトがあります。
Roblox は leaderstats を自動で保存しますか?
いいえ。leaderstats はプレイヤーがサーバーにいる間しか存在しません。ステップ3のように、退出時に data store で値を保存し、参加時に読み込んでください。
リーダーボードから値を隠せますか?
はい。表示されるのは leaderstats フォルダの中の値だけです。非公開のデータは、プレイヤーの別のフォルダか、サーバースクリプトのテーブルに置いてください。
プレイヤーリスト全体を隠すには?
LocalScript から StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false) を呼びます。もう一度表示するには true を渡します。
コインに NumberValue を使ってもいいですか?
使えますが、整数の通貨には IntValue のほうが向いています。また、あとでランキングを作りたくなった場合、ordered data store は整数しか受け付けません。
参考資料
- Roblox Creator Docs: Leaderboards(英語). leaderstats、ステータスの順番、常設の Friends と Global モード
- Roblox Creator Docs: Data stores(英語). GetAsync、SetAsync、ordered data store と上限
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。