Your players are nobody
on a world leaderboard.

Why this exists

A leaderboard is worthless.
A title is not.

The difference between the two is not technology, it is credibility — and credibility has four parts. None of them is solved by the usual backends, all four are too expensive for a small team, and each one gets better the more apps take part.

Not only games

One field decides what you are building.

A high-score game, a running app and a habit tracker differ by exactly one property on a discipline. Everything else — identity, regions, qualification, titles, challenges, badges — stays the same.

Integration

Three lines, then you are on the board.

Only the public key ever touches a client. Anything carrying authority — creating disciplines, reporting duels, granting collectibles — needs the secret key, and therefore a server.

import { connect } from '@moinsen/challenges'

const api = await connect({ base, appKey: 'pk_live_...' })

await api.submit('score-attack', 12500)
const board = await api.leaderboard('score-attack', { region: api.regionId })

board.entries[0].handle  //  'kirsten'
board.title_eligible     //  true — this district can crown someone

var api := ChallengesAPI.new()
add_child(api)
await api.connect_anonymous("pk_live_...")

await api.submit("score-attack", score)
var board := await api.leaderboard("score-attack", api.region_id)

for row in board.entries:
    print("%d. %s — %d" % [row.rank, row.handle, row.value])

final api = await Challenges.connect(
  base: base,
  appKey: 'pk_live_...',
);

await api.submit('daily-practice', 1);
final me = await api.status('daily-practice');

me.streakDays;  // 61
me.rank.region; // (rank: 2, of: 19)

The JavaScript client ships today. Godot and Dart packages are phase 2 — see the roadmap, which says plainly what exists and what does not.

What you stop rebuilding

Sixteen things, once, for every app you make.

This list is the actual pitch. Every item is something a small team writes again in each new project, gets slightly wrong, and then maintains forever.

• Anonymous accounts and sessions
• A leaderboard that survives a restart
• Per-region and per-friend standings
• Streak counting across time zones
• A challenge between two players
• Elo or Glicko, done wrong the first time
• Badges, and the rules behind them
• Collections and set completion
• Daily seeds everyone shares
• Handle changes without breaking history
• Blocking, reporting, moderating
• Invite codes and closed betas
• Waitlists for a region or a launch
• Idempotency for a flaky mobile network
• Cheat plausibility limits
• GDPR export and deletion