排行榜

Roblox 在 PlayerList 中内置了排行榜。这里、好友和全球是同一列表的视图：这里显示当前服务器中玩家的会话排名，而好友和全球显示您在 Creator Hub 注册的有序数据存储中的持久排名。

排行榜视图

PlayerList 在这些视图中比较分数：

视图	排名
这里	当前服务器中玩家的会话排名，来自 leaderstats。
好友	在玩过该体验的玩家好友中的持久排名。
全球	在该体验中玩家的持久排名。

使用 leaderstats 来填充这里。使用有序数据存储来填充好友和全球。

使用 leaderstats 管理会话排行榜

每个玩家的 leaderstats 文件夹驱动这里视图。以下步骤设置该文件夹，添加统计信息，在会话期间更新它们，控制它们的顺序，并隐藏 PlayerList。

设置 leaderstats

要设置排行榜并在玩家进入体验时添加玩家：

在 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)

排序统计信息

有三种方法可以控制排行榜中统计信息的顺序：

按您希望它们出现的顺序添加统计信息。
向统计信息添加一个名为 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 值决定排行榜的顺序。

隐藏排行榜

要隐藏排行榜，例如在菜单屏幕或过场动画期间，从客户端脚本调用 SetCoreGuiEnabled()。

local StarterGui = game:GetService("StarterGui")

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

使用有序数据存储管理持久排行榜

此功能处于测试版。功能和可用性可能会发生变化。

好友和全球从您在 Creator Hub 注册的有序数据存储中读取分数。有序数据存储保持真实来源，Roblox 在 PlayerList 中显示配置的分数。这使您可以添加持久的社交和全球排名，而无需构建单独的排行榜界面或排名服务。

初始测试版支持每个体验一个活动的持久排行榜。只有注册的活动排行榜会出现在好友和全球视图中。

数据要求

在注册排行榜之前，请确认其数据满足以下要求：

一个有序数据存储支持排行榜。
每个玩家在该有序数据存储中有一个数字分数。
每个键通过用户 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