リーダーボード | 文書 - Roblox クリエーターハブ

Robloxには、PlayerListに組み込まれたリーダーボードがあります。ここ、友達、およびグローバルは、その同じリストのビューです：ここは現在のサーバー内のプレイヤーのセッションランキングを表示し、友達とグローバルは、Creator Hubで登録した順序付きデータストアからの永続的なランキングを表示します。

リーダーボードビュー

PlayerListは、これらのビュー間でスコアを比較します：

ビュー	ランキング
ここ	現在のサーバー内のプレイヤーのセッションランキング、leaderstatsから。
友達	経験をプレイしたプレイヤーの友達間の永続的なランキング。
グローバル	経験内のプレイヤー間の永続的なランキング。

ここを埋めるにはleaderstatsを使用します。友達とグローバルを埋めるには順序付きデータストアを使用します。

リーダースタッツでセッションリーダーボードを管理する

各プレイヤーのleaderstatsフォルダーがここビューを駆動します。以下の手順でそのフォルダーを設定し、統計を追加し、セッション中に更新し、順序を制御し、PlayerListを隠します。

リーダースタッツを設定する

リーダーボードを設定し、プレイヤーが経験に入るときに追加するには：

ServerScriptService内に新しいScriptを作成し、名前をLeaderboardにします。

スクリプト内で、PlayerAddedイベントに関数を接続します。

local Players = game:GetService("Players")

local function leaderboardSetup(player)

end

Players.PlayerAdded:Connect(leaderboardSetup)

接続された関数内で、新しいFolderインスタンスを作成し、名前をleaderstatsにして、プレイヤーに親子関係を持たせます。
local Players = game:GetService("Players") local function leaderboardSetup(player) local leaderstats = Instance.new("Folder") leaderstats.Name = "leaderstats" leaderstats.Parent = player end Players.PlayerAdded:Connect(leaderboardSetup)
フォルダーの名前はすべて小文字のleaderstatsであることが重要です。別の名前を付けると、Robloxはプレイヤーをリーダーボードに追加しません。

統計を追加する

リーダーボードは、プレイヤーの統計を保存および表示するために値タイプオブジェクトを使用します。このスクリプトは、IntValueを使用してプレイヤーの金を表示します。これは整数のプレースホルダーです。

leaderboardSetup()関数内に、8行目から11行目を追加します：

local Players = game:GetService("Players")

local function leaderboardSetup(player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"
	leaderstats.Parent = player

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Value = 0
	gold.Parent = leaderstats
end

Players.PlayerAdded:Connect(leaderboardSetup)

これらの行は次のことを達成します：

IntValueインスタンスが作成されます。
インスタンスのNameが"Gold"に設定されます。これは、リーダーボードに表示される統計の名前です。
統計の初期Valueが0に設定されます。これは、データストアに保存されている値を含む任意の値に設定できます。永続的なリーダーボードを実装している場合。

IntValue、NumberValue、およびStringValueのようなオブジェクトの値は、Valueプロパティを介して設定する必要があります。これは、10行目のgold.Valueのようにです。
インスタンスはleaderstatsフォルダーに親子関係を持たせ、リーダーボードに追加されます。プレイヤーが経験に入ると、その名前がボードに表示されます。

統計を更新する

プレイヤーのリーダーボード統計を更新するには、その統計のleaderstatsフォルダー内のValueプロパティを変更します。たとえば、次のScriptを任意のピックアップオブジェクトに接続して、それを収集したプレイヤーのGold統計を増加させることができます。

local Players = game:GetService("Players")

local goldChunk = script.Parent

local function onPartTouch(otherPart)
	local partParent = otherPart.Parent
	local player = Players:GetPlayerFromCharacter(partParent)
	local leaderstats = player and player:FindFirstChild("leaderstats")
	local goldStat = leaderstats and leaderstats:FindFirstChild("Gold")

	if goldStat then
		-- ピックアップを破壊する
		goldChunk:Destroy()

		-- プレイヤーのリーダーボード統計を更新する
		goldStat.Value += 10
	end
end

goldChunk.Touched:Connect(onPartTouch)

統計の順序を制御する

リーダーボード内の統計の順序を制御する方法は3つあります：

表示したい順序で統計を追加します。
統計にIsPrimaryという名前の子BoolValueを追加し、その値をtrueに設定して、リーダーボードの最初にその統計を配置します。
統計にPriorityという名前の子NumberValueを追加し、その値を整数に設定します。優先度の高い値はリーダーボードの前に表示されます。優先度がない統計はデフォルトの優先度0を持ちます。

このコードサンプルは、統計にIsPrimary値を追加する方法を示しています：

local Players = game:GetService("Players")

local function leaderboardSetup(player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"
	leaderstats.Parent = player

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Value = 0
	gold.Parent = leaderstats

	local isPrimary = Instance.new("BoolValue")
	isPrimary.Name = "IsPrimary"
	isPrimary.Value = true
	isPrimary.Parent = gold
end

Players.PlayerAdded:Connect(leaderboardSetup)

IsPrimaryは、任意のPriority値よりも優先されます。複数の統計がIsPrimary値をtrueに設定されている場合、それらのPriority値がリーダーボードの順序を決定します。

リーダーボードを隠す

メニュー画面やカットシーン中にリーダーボードを隠すには、LocalScriptをStarterGuiまたはStarterPlayerScripts内に配置し、StarterGuiを呼び出します。

local StarterGui = game:GetService("StarterGui")

StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false)

順序付きデータストアで永続的なリーダーボードを管理する

この機能はベータ版です。機能や利用可能性は変更される可能性があります。

友達とグローバルは、Creator Hubで登録した順序付きデータストアからスコアを読み取ります。順序付きデータストアは真実のソースとして残り、RobloxはPlayerListに設定されたスコアを表示します。これにより、別のリーダーボードインターフェースやランキングサービスを構築することなく、永続的なソーシャルおよびグローバルランキングを追加できます。

初期ベータ版では、経験ごとに1つのアクティブな永続的リーダーボードをサポートしています。登録されたアクティブなリーダーボードのみが友達およびグローバルビューに表示されます。

データ要件

リーダーボードを登録する前に、そのデータが次の要件を満たしていることを確認してください：

リーダーボードを支える単一の順序付きデータストア。
各プレイヤーは、その順序付きデータストア内に1つの数値スコアを持っています。
各キーは、ユーザーIDによって1人のプレイヤーを識別します。直接またはユーザーIDを含む一貫した形式を通じて。
あなたの経験は、順序付きデータストアにスコアの更新を書き込みます。プラットフォームはスコアを読み取りますが、書き込みません。
スコア書き込みロジックはサーバー上で実行されます。

順序付きデータを準備する

あなたの経験が現在スコアを保存している方法に一致するパスを選択します。

既存の順序付きデータストアを使用する

あなたの経験がすでに互換性のある順序付きデータストアにリーダーボードスコアを保存している場合、そのデータストアを保持し、Creator Hubで登録します。各エントリが数値スコアを含み、そのキーが一貫して1人のプレイヤーを識別していることを確認してください。

リーダーボードデータを再構築したり、別のランキングサービスにコピーしたりする必要はありません。

順序付きデータストアを作成する

リーダーボードデータがまだない場合、順序付きデータストアを作成し、既存のサーバー側スコアリングフローに追加します。各プレイヤーに1つの数値スコアを書き込み、プレイヤーのユーザーIDをキーとして使用するか、一貫したキー形式にユーザーIDを含めます。

local DataStoreService = game:GetService("DataStoreService")
local playerScores = DataStoreService:GetOrderedDataStore("PlayerScores")

local function saveScore(player, score)
	local success, errorMessage = pcall(function()
		playerScores:SetAsync(tostring(player.UserId), score)
	end)

	if not success then
		warn(errorMessage)
	end
end