Rankings that
ship with your
game.
Add real-time global leaderboards to any game in minutes. REST API, webhooks, seasons, teams, and analytics — everything you need, nothing you don't.
Whether you're a solo dev
or a full studio, we've got you.
Built for game developers,
not enterprise teams
From a casual Godot jam game to a published title — LightLeaderboard scales with you without the complexity.
A real leaderboard,
inside a real game.
Words per minute, high score, personal bests — all stored and ranked in real time. Built with LightLeaderboard and a single REST call per score.
KeyKeeper — a Kaboom.js platformer
powered by the npm SDK
A complete, open-source game showing how to wire LightLeaderboard into a real Kaboom.js game using Node.js and Express on the backend.
How it's built
- Kaboom.js frontend (Vite dev server)
- Express.js backend with the
lightleaderboardnpm SDK - Scores submitted with metadata (
keysCollected) - Live top-5 leaderboard rendered on the title screen
- Server-side API key — credentials never touch the client
From zero to live leaderboard
in three steps
Two SDKs.
One API.
First-class SDKs for JavaScript and Godot 4 — same REST API underneath, tailored for each environment. Submit a score and get rank, personal-best flag, and total player count back in a single call.
TypeScript-first. Works with Node.js, browsers, Bun, Deno, and Cloudflare Workers. Zero dependencies.
GDScript addon for Godot 4 with full async await API. HMAC score signing built in. One-click install from the official Asset Library.
// npm install lightleaderboard
import { LightLeaderboard } from 'lightleaderboard';
const lb = new LightLeaderboard({
apiKey: process.env.LLB_API_KEY,
gameId: 'my_game',
});
// Submit score — rank returned immediately
const result = await lb.submitScore({
score: 42000,
playerRefId: 'player_001',
playerName: 'Alice',
submissionId: crypto.randomUUID(),
metadata: { level: 5, combo: 12 },
});
// → { rank: 3, isPersonalBest: true, totalPlayers: 1024 }
// Fetch top 10 this week — best score per player
const { entries } = await lb.getLeaderboard({
limit: 10, period: 'weekly',
});SDK walkthrough —
from install to live leaderboard
A step-by-step video showing how to add a leaderboard to your game
using the lightleaderboard SDK.
One request.
Player ranked.
Submit a score with a single HTTP POST. Retrieve a full ranked leaderboard with a GET. Works from any language, any engine, any platform.
npm SDK · Godot plugin · raw REST. Your choice.
// npm install lightleaderboard
import { LightLeaderboard } from 'lightleaderboard';
const lb = new LightLeaderboard({
apiKey: 'YOUR_API_KEY',
gameId: 'my_game',
});
// Submit score and get rank back in one call
const { rank, isPersonalBest, totalPlayers } = await lb.submitScore({
score: 42000,
playerRefId: 'player_001',
playerName: 'Alice',
submissionId: crypto.randomUUID(),
});
// Show "Rank #3 of 1024!" — no extra API call needed
console.log(`Rank #${rank} of ${totalPlayers}!`);{ "id": 1847, "rank": 3, "isPersonalBest": true, "totalPlayers": 1024 }Start free. Scale when
you're ready.
No credit card required to start. Upgrade to Pro when you need more games.
- ✓ 1 game forever
- ✓ Up to 100 unique players
- ✓ Full REST API access
- ✓ Global + period leaderboards
- ✓ Season & team filtering
- ✓ Analytics dashboard
- ✓ Webhook events
- ✓ Score signature security
- ✓ Unlimited games
- ✓ Unlimited players
- ✓ Everything in Free
- ✓ Full data export (JSON)
- ✓ Priority support
- ✓ 7-day data grace on cancel
Both plans include all features. Upgrade or cancel anytime from the developer portal.
Start building your leaderboard
in minutes
Free plan. No credit card. All features included from day one.