体验排行榜

Roblox 有一个内置的 排行榜系统 ，可以让您显示用户信息，例如得分、货币或最快时间在比赛中。

设置排行榜

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

1. 在 Script 中创建一个新的 ServerScriptService 并命名它为 排行榜。

   

2. 在脚本中，连接一个函数到 PlayerAdded 事件。

   local Players = game:GetService("Players")
   
   local function leaderboardSetup(player)
   
   end
   
   -- 连接 "leaderboardSetup()" 函数到 "PlayerAdded" 事件
   Players.PlayerAdded:Connect(leaderboardSetup)

3. 在连接的函数内，创建一个新的 Folder 实例，命名它 leaderstats，并将其作为父级给玩家。

   local Players = game:GetService("Players")
   
   local function leaderboardSetup(player)
   	local leaderstats = Instance.new("Folder")
   	leaderstats.Name = "leaderstats"
   	leaderstats.Parent = player
   end
   
   -- 连接 "leaderboardSetup()" 函数到 "PlayerAdded" 事件
   Players.PlayerAdded:Connect(leaderboardSetup)

   文件夹名称必须为 leaderstats ，使用所有大小写字母。Roblox 不会将玩家添加到排行榜上，如果你用任何其他方式命名它。

添加统计

排行榜使用 value type objects 来存储和显示玩家统计。此脚本将显示一个玩家的金币使用一个 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

-- 连接 "leaderboardSetup()" 函数到 "PlayerAdded" 事件
Players.PlayerAdded:Connect(leaderboardSetup)

这些线完成以关注中/正在关注任务：

1. 一个 IntValue 实例创建。

2. 实例的 Name 设置为 "Gold" 。这正是统计数据会在排行榜上显示的方式。

   

3. 统计的初始值 Value 设置为 0 。这可以设置为您所选择的任何值，包括存储在 数据存储 中的值，如果您实现了持久排行榜。

   注意，如果 IntValue 、 NumberValue 和 StringValue 的值通过其 1> Value1> 属性设置， 4> gold.Value4> 在第 10 行中， 7> Class.StringValue7> 在第 11 行中， 0> Class.StringValue0> 在第 12 行

4. 实例是父级 leaderstats 文件，它将其添加到排行榜。当玩家进入体验时，他们的名字会出现在板上。

   

更新统计信息

要更新玩家的排行榜统计，请在其 Value 文件夹内的 leaderstats 属性改变该属性的 Script 以增加玩家收集到的 2> 金币2> 属性。例如，您可以将以下 5>Class.Script5> 附加到任何 8>p

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)

订购统计

有三种方法来控制排行榜上的统计数据的顺序：

• 将统计数据添加在您想要显示它们的顺序。
• 添加一个名为 BoolValue 的子 IsPrimary 到统计，将其值设置为 true 以将统计第一次放置在排行榜上。
• 在统计中添加一个名为 NumberValue 的子 ，其中 Priority 为子 ，设置其值为整数。更高的优先级值在排行榜上的前几个位置显示。没有优先级的统计值的统计值为 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)

隐藏排行榜

要隐藏排行榜，例如在菜单屏幕上或在切换场景中，请将 LocalScript 放置在 StarterGui 或 StarterPlayerScripts 中，其中包含调用 2>Class.StarterGui:SetCoreGuiEnabled()|StarterGui2> 。

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false)