Documentation

Recording Matches

Matches are the core data in Foosball Leaderboard. Every match you record updates player ratings and the leaderboard in real time.

How to record a match

  1. From the Leaderboard or Matches page, click Record Match
  2. Select the players for each team (one player per team in 1v1, two in 2v2)
  3. Enter the score for each team
  4. Optionally choose a team colour for each side
  5. Click Submit

Ratings update immediately and the leaderboard reflects the new rankings.

Game modes

Your organisation's game mode (set at creation) determines how teams work:

  • 1v1 — Each team is a single player. Head-to-head competition.
  • 2v2 — Each team has two players. Both teammates share the win or loss.

Team colours

You can assign a colour (red or blue) to each team when recording a match. This is optional, but it's used in live match tracking and goal analytics to associate each goal with the correct side of the table.

Scores

Enter the final score for each team. There's no enforced maximum — record whatever your group plays to (typically 10, sometimes more).

Rating changes

After submitting, each player's rating changes based on:

  • The expected outcome (based on both teams' current ratings)
  • The actual result (upset wins earn more rating gain; expected wins earn less)
  • The margin of victory
  • Contribution within 2v2 matches (how much each player contributed)

See Rating System for the full breakdown.

Editing and deleting matches

Admins can delete a match from the Matches page. Deleting a match recalculates all subsequent ratings — use this sparingly.

Match history

The Matches page shows a chronological list of all recorded matches with scores, players, rating changes per player, and timestamps. You can filter by player to see a specific person's history.