チュートリアル · プレイヤーデータ

Roblox Studio でリーダーボードを作る方法

Roblox のゲームの右上にあるプレイヤーリストは、leaderstats という名前のフォルダ1つで管理されています。このガイドでは、サーバースクリプト、ポイントを安全に配る方法、セッションをまたいだ保存、グローバルなトップ10まで、ゼロから作っていきます。

更新日 2026年11月20日読了時間 約3分執筆

要点

ServerScriptService に Script を作り、Players.PlayerAdded を受け取って、名前がちょうど leaderstats(すべて小文字)の Folder を作成し、そのプレイヤーの子にします。このフォルダの中にある IntValue、NumberValue、StringValue がそれぞれプレイヤーリストの列になります。

  • ステータスの作成と変更はサーバーだけで行ってください。LocalScript で行った変更は、そのプレイヤー本人にしか見えません。
  • leaderstats は保存されません。次のセッションまで値を残したいなら、data store で読み込みと保存を行ってください。
  • 全プレイヤーのランキングを作るには、各スコアを ordered data store に書き込み、ワールド内の掲示板か、プレイヤーリストの Global モードで表示します。
このページの内容
  1. leaderstats の仕組み
  2. 1. leaderstats を作る
  3. 2. ポイントを配る
  4. 3. 保存
  5. 4. グローバルなトップ10
  6. Common errors
  7. RoCode で作る
  8. よくある質問
  9. 参考資料

leaderstats の仕組み

イメージ完成した leaderstats とコインパッドのスクリプトを、実行中のゲームで動かした様子です。

Roblox はどのゲームでもプレイヤーリストを表示します。プレイヤーが leaderstats という名前の子 Folder を持っていると、リストはその中の値オブジェクトごとに列を追加し、そのプレイヤーの行に値を表示します。列の見出しは値オブジェクトの Name です。

leaderstats に入れられる値オブジェクト
オブジェクト保持するもの向いている用途
IntValue整数コイン、キル数、勝利数、レベル
NumberValue小数ベストラップタイム、距離
StringValueテキストランクやチームの称号

動かないリーダーボードのほとんどは、2つのルールのどちらかで壊れています。フォルダ名はちょうど leaderstats でなければならず、Leaderstats や leaderStats は無視されます。そして、フォルダはサーバーの Script が作る必要があります。全プレイヤーに複製されるのはサーバーでの変更だけだからです。コードがどこで動くか自信がなければ、先に Script vs LocalScript vs ModuleScript(英語)を読んでください。

ステップ1: leaderstats のスクリプトを作る

  1. Explorer で ServerScriptService にカーソルを合わせ、+ ボタンを押して Script を挿入します。
  2. あとで見つけやすいように、名前を Leaderstats に変えます。
  3. 中身を下のコードに置き換えて Play を押します。プレイヤーリストにあなたの名前が、Coins と Wins が0の状態で表示されます。
Script 場所: ServerScriptService 名前: Leaderstats
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秒に何度も発火するので、スクリプトはプレイヤーごとに短いクールダウンを持たせています。

Script 場所: Workspace のパーツ 名前: 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 は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のスクリプトを置き換えます。データの読み込みに失敗したプレイヤーは決して保存しません。コピーされた保存スクリプトの多くで進行状況が消えるのは、まさにこのミスが原因です。

Script 場所: ServerScriptService 名前: Leaderstats
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 のリーダーボードが求める形式と同じです。

  1. Workspace に固定(Anchored)した Part を追加して WinsBoard と名付け、看板くらいの大きさ(例えば 12 x 8 x 1 スタッド)にして、前面をスポーン地点に向けます。
  2. ServerScriptService に GlobalWinsBoard という名前の Script を挿入し、下のコードを入れます。
  3. Play を押します。掲示板は最初の更新で埋まり、その後は1分ごとに更新されます。
Script 場所: ServerScriptService 名前: 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

-- 掲示板: 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の掲示板を追加して。

RoCode の作業
  • 最初にプレイスの中で既存の 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 API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。

RoCode を自分のゲームで試してみましょう。

毎日無料のクレジット付き、カード不要です。プラグインを入れて、作りたい機能を説明し、Studio に反映された内容を確認してください。