Install the LightLeaderboard plugin from the Godot Asset Library, add one AutoLoad, and your game has live global rankings. No server. No backend code. Scores persist forever.
Add the plugin, enable the AutoLoad, call two functions — done.
In Godot, open AssetLib, search "LightLeaderboard", click Install. Or clone from GitHub and copy addons/lightleaderboard/ into your project.
In Project → Project Settings → Plugins, enable LightLeaderboard. It registers itself as the LightLeaderboard global singleton automatically.
# In any script after adding LightLeaderboard as an AutoLoad
func _ready() -> void:
LightLeaderboard.configure("YOUR_API_KEY", "my_game")# Submit a score — returns rank immediately
var result = await LightLeaderboard.submit_score(
42000, # score
"player_001", # player_ref_id
"Alice", # player_name
)
print("Rank: #", result.rank) # → Rank: #3
# Fetch global top 10
var lb = await LightLeaderboard.get_leaderboard(10)
for entry in lb.entries:
print("#%d %s %d" % [entry.rank, entry.player_name, entry.score])The API returns the player's global rank in the same response as the submit call. No second request.
Filter by daily, weekly, monthly, or all-time. Great for seasonal or weekly events.
Fetch the rows around a specific player — show where they rank among their neighbours, not just the top 10.
Built-in HMAC-SHA256 request signing prevents score tampering. Enable it with one flag.
Windows, macOS, Linux, Android, iOS — Godot 4's built-in TLS handles HTTPS on every export target.
The free tier covers your game through early access and beyond. Upgrade when you actually need the capacity.
Create a free account, grab your API key, and follow the 10-minute integration guide.