← All templates

Server-verified scores, daily and all-time boards, cheaters flagged.

Spec — Leaderboards with anti-cheat

Status: draft · Created: 2026-11-10

1. Context and goal

Players compare scores on daily and all-time boards they can trust, because the server checks every score and flags players who cheat.

2. Functional requirements (EARS)

  • FR-1: WHEN a run ends, THE SYSTEM SHALL verify the submitted score on the server against a log of the run before ranking it, within 2 seconds.
  • FR-2: IF a score exceeds the highest score possible for the time played, THEN THE SYSTEM SHALL reject it and flag the player.
  • FR-3: THE SYSTEM SHALL keep a daily board that resets at 00:00 UTC and an all-time board.
  • FR-4: WHEN a player opens a board, THE SYSTEM SHALL show the top 100 scores and the player's own rank within 1 second.
  • FR-5: THE SYSTEM SHALL accept at most 10 score submissions per player per minute.
  • FR-6: WHEN a player is flagged, THE SYSTEM SHALL hide their scores from the boards and queue the case for a moderator.
  • FR-7: WHEN a moderator confirms or clears a flag, THE SYSTEM SHALL remove the scores or restore them within 1 minute and record the decision.

3. Out of scope

  • Friends-only boards.
  • Client-side cheat detection software.