How to make a Roblox leaderboard (with AI)

Files Picoo ships for this prompt

2 files · 186 lines · one recipe call

Sample output: ServerScriptService/GlobalLeaderboardServer.lua

--!strict
-- Generated by Picoo recipe: global_leaderboard
-- Cross-server top-10 board backed by OrderedDataStore.

local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local RunService = game:GetService("RunService")

-- GetOrderedDataStore itself errors in a place that was never published, and
-- can in Studio without API access. Called bare up here, that one error stopped
-- this whole script before the board was ever drawn. A failure now leaves
-- BOARD nil: the board ranks the players in this server instead (see
-- useServerBoard below), and nothing is written.
local boardOk, boardResult = pcall(function()
	return DataStoreService:GetOrderedDataStore("Leaderboard_v1")
end)
local BOARD: OrderedDataStore? = if boardOk then boardResult else nil
local STAT_NAME = "Coins"
local TOP_N = 10
local REFRESH_INTERVAL = 60

-- (excerpt) publishing a score, and the refresh loop:

local function publish(player: Player)
	local store = BOARD
	if not store then return end -- no DataStore: nothing to publish to
	local value = currentValue(player)
	if value == nil then return end

	-- OrderedDataStore accepts INTEGERS ONLY. A float is rejected outright, so
	-- a stat that ever holds 10.5 silently stops appearing on the board.
	local whole = math.floor(value)
	if whole < 0 then return end            -- negative scores are not ranked here
	if published[player.UserId] == whole then return end

	local _, err = safe(function()
		return store:SetAsync(tostring(player.UserId), whole)
	end)
	if err and RunService:IsStudio() then
		useServerBoard(err)
	elseif err then
		warn("[Leaderboard] publish failed for " .. player.Name .. ": " .. err)
	else
		published[player.UserId] = whole
	end
end

task.spawn(function()
	while true do
		-- Publish everyone first so the board reflects the current server too,
		-- then read the global top N.
		for _, player in Players:GetPlayers() do
			publish(player)
		end
		refresh()
		task.wait(REFRESH_INTERVAL)
	end
end)