Free-game leaderboards
Try it first
Choose a supported score backend#
You need Your game’s ranking rules and the target Hub environment.
- Read the live managed-results capabilities and the registered adapter limits below.
- Compare your ranking and replay needs with the supported contract.
- Use your existing trusted backend for custom ranks or replay storage; keep the exact build and run identity with each result.
Check your result You know which backend validates and stores each score, without assuming a paid contest or premium Live service is required.
What is available today?#
Hosted free-game results are available on the Hub for registered simulations, not as a general-purpose score database. Read /api/games/v1/capabilities on the target Hub: enabled:true, protocol:1, results:server-replay and leaderboards:verified-practice describe the deployed service. The current registered adapters are speed-run-v1 and tower-v1. A game must also have its exact build and simulation bound by the Hub; capability discovery alone does not register a new game. Premium Live and paid entry are not required for this practice service.
Can I choose the ranking?#
Custom ranking is not supported by this service today. The server calculates the adapter score, keeps one personal best per player and build, and returns the top ten ordered by score descending, then completedAt ascending, then playerId ascending. An equal score does not replace that player's saved best. There is no custom sort key or configurable finish-time tie-breaker. Mo's Courts' adjusted ticks, real finish time and submission-order ranking therefore need the game's own trusted backend for V1; do not force that ranking into the existing adapter score.
Can I attach a replay?#
Replays are server-recorded bounded input tuples [x,z,jump], associated with the exact build and registered adapter. Published eligible results may return those recordings in the top-ten board. There is no arbitrary replay-blob upload, replay-URL field or generic replay-storage service. Private preview runs return a private result receipt but cannot write public bests or award account achievements.
What should my game use?#
Keep the game's existing backend and replay storage for custom boards. Authenticate the player, bind the run to the game/build/rules version, validate gameplay on the server, compute the rank and tie-breakers there, and grant once per accepted run. Store bounded replay data privately and return an access-controlled replay reference. Browser scores and analytics events are not score verification. Selecting Playmos leaderboard services or importing an SDK does not provision a custom verifier.
What comes next?#
No delivery date is published for a general custom-ranking/replay service. Check the live capabilities and /api/games/v1/openapi.json rather than waiting for an assumed rollout. See /docs/leaderboards for the supported path and limits. Paid competitions, payouts and Anti-Cheat human verification remain separate integrations.
Live capabilities · Managed results API contract · Game hosting
If it did not work#
An unsupported adapter cannot submit managed results. Keep local practice and your own backend instead of inventing a verification receipt.
Try one variation
Continue with the next guide →