TableTopTourney Documentation

Complete guide to features, rules, and mechanics

What is TableTopTourney?

TableTopTourney is a tabletop tournament tracker for board game groups. Create a tournament, invite your group, log plays, and watch rankings, stats, and achievements update automatically.

Tournaments can run for any duration — a single weekend, a monthly league, or a full year. Each tournament is configurable: choose which scoring modules to enable, set start and end dates, and define the rules that suit your group.

Beyond tournament play, TableTopTourney also serves as a board game collection manager. Track your games, build lists, filter by complexity or BGG metadata, and use the What to Play calculator to settle game night debates. Play history and game data can be imported directly from BoardGameGeek.

Tournament Setup & Configuration

When creating a tournament you set the name, duration, and which modules to include. Contestants are invited via a shareable link and can start logging plays immediately.

Duration

Tournaments can run for any period. Choose a preset (weekly, monthly, quarterly, yearly) or set custom start and end dates. The scoring and ranking system adapts automatically to the tournament length.

Modules

Modules can be toggled on or off per tournament:

  • Financial system — earnings, taxes, bonuses, and penalties (see Earnings and Taxes sections)
  • Game of the Month — monthly board game competition based on plays and complexity
  • Influence Tokens — invest points to boost specific games
  • Achievements — badge system for milestones and standout performances

Board Game Collection

Each tournament draws from the creator's board game collection. Games can be added manually, searched by name to pull data from BoardGameGeek, or imported in bulk via CSV or BGG username.

Contestants

Invite contestants by sharing the tournament invite link. Any contestant can log plays for the group. Contestants can be assigned nicknames and their BGG usernames can be saved for automatic play matching during imports.

Logging Plays

Plays are logged from the Plays tab. Each play records the game, date, number of players, winner, and runner-up. Any contestant in the tournament can log plays on behalf of the group.

After a play is logged, a stats overview shows the impact on tournament standings — points earned, bonuses applied, and any achievements unlocked. Plays can be edited or deleted at any time; affected gains and standings recalculate automatically.

Plays can also be imported in bulk from BoardGameGeek — see the Importing Data section.

Earnings & Bonuses

Each play awards points to the first and second place players. The winner receives the total points which consists of the sum of all bonuses for that play. The runner up receives half the total points in a 2 player game. When there are 3 or more players the second place pot scales with the number of players to compensate for the difficulty of scoring high in multiplayer games.

Bonuses

  • Daily Bonus: Increases by 1 point for each consecutive day played
  • Monthly Bonus: Increases by 2 points each 5th play in the same month
  • Player Count Bonus: Increases for each player over 2
  • First Play Bonus: Increases by the game's complexity the first time a game is played
  • Game of the Month Bonus: Adds 8 points to the pot when the game played is the current game of the month
  • Custom Bonus: Invest 10 points in a game to increase its play value by 5 points

Taxes & Penalties

Each quarter, contestants pay tax proportional to their earnings that quarter. The tax is based on the size of the board game collection for the tournament.

Total quarterly tax amount: 2 × (1 + 0.7)(Collection Size/10)

Each month there is a penalty or bonus depending on how many days were played and how many unique games have been played.

Board Games

Board games are tracked and awarded points when played, based on their complexity rating.

Complexity is a composite score made up of several factors. Online play uses a reduced complexity value since setup and rules overhead are handled by the platform.

The factors used to determine complexity are:

  • Weight from BoardGameGeek
  • Setup time
  • Playing time
  • Strategy depth
  • Rules complexity

Each month a winning board game is determined based on complexity and number of plays. At the end of the tournament the board game of the year is awarded.

Board Game Tournament Ranking

The board game ranking uses a balanced scoring system that rewards both strategic gameplay and consistent participation.

Base Score: Play Count & Complexity

Every game earns points based on how often it is played and its complexity rating:

  • More plays = more points: Playing a game multiple times increases its score
  • Game weight matters: Complex games earn more per play than simple games
  • Balanced approach: Diminishing returns on complexity prevent heavy games from dominating solely based on weight

Consistency Bonus: Multi-Month Play

Games played across multiple months receive a special bonus:

  • Each additional month earns extra points
  • This bonus scales with the game's complexity
  • Rewards consistent play of the same game throughout the tournament

Medal System: Monthly Performance

The top three games each month earn medal points:

  • Gold Medal (1st place): 2 points
  • Silver Medal (2nd place): 1 point
  • Bronze Medal (3rd place): 0.5 points

Final Score Calculation

Base Score + Multi-Month Bonus + Medal Points

Tournament Strategy

  • The Complexity Path: Play heavy games that score well in individual sessions
  • The Frequency Path: Play games more often to accumulate points through volume
  • The Consistency Path: Play the same games across multiple months to earn consistency bonuses
  • Monthly competition: Chase monthly medals for significant bonus points

Rules & Mechanics

A contestant's running total is the sum of all gains from plays.

The running expenditure is the sum of all bonus increases for specific board games a contestant has paid for.

Penalty/Bonus Calculation

Penalty or bonus is either net positive or negative depending on how many games have been played in a month. Contestants get the running total sum for the month divided by the total number of days in the month, multiplied by the difference between the number of games played in the month and the total number of days in the month. If fewer games were played than days in the month, the result is negative (penalty). If more games were played than days in the month, the result is positive (bonus).

Unplayed Games Penalty

There is a penalty for unplayed games based on the size of the board game collection. It starts small at the beginning of the tournament and ramps up each month. The logic counts the unique number of games played so far and subtracts the number of games in the collection. The result is divided by 2 times the current month number (increasing over time) and multiplied by the contestant's tax contribution percentage.

Winners & Rankings

Monthly Winner: The contestant with the highest earnings in the month.

Quarterly Winner: The contestant with the most monthly wins.

Yearly Winner:

  • Primary: Most quarterly wins
  • 1st tie breaker: Most monthly wins
  • 2nd tie breaker: Biggest yearly revenue
  • 3rd tie breaker: Total number of yearly wins

Live Tracker

The live tracker is a dynamic ticker displayed on the tournament home screen. It automatically surfaces insights from the current tournament data — no configuration needed.

Examples of insights surfaced by the live tracker:

  • Winning streaks and consecutive wins
  • Game-specific dominance — who is unbeaten at a particular title
  • Milestone achievements as they are unlocked
  • Emerging rivalries between contestants
  • Monthly and quarterly standings shifts

Insights rotate automatically and are weighted by recency and significance. The tracker updates every time a play is logged.

Achievements & Badges

Achievements are awarded automatically when a contestant reaches a milestone. They are tracked in real time and highlighted in the live tracker when unlocked.

Achievement categories include:

  • Winning streaks — consecutive wins across any games
  • Variety — playing a wide range of different games
  • Volume — reaching play count milestones
  • Game mastery — repeated wins at the same title
  • Social — playing with all contestants in the tournament

Achievements are visible on each contestant's profile page and in the tournament standings.

Collection Management

The Board Games section lets you manage your full board game collection independently of any tournament. Games added to your collection can be added to any tournament you create.

Adding Games

Games can be added manually or by searching BoardGameGeek by name. BGG search auto-fills the game image, weight rating, designer, publisher, and other metadata. Games can also be imported in bulk via CSV or BGG username.

Complexity Ratings

Each game has a complexity rating used to calculate points in tournament play. The rating can be set manually or derived from the BGG weight and other factors. A separate online complexity rating is used when a play is logged as online.

Filtering

Your collection can be filtered and sorted by:

  • Your own complexity ratings and play stats
  • BGG metadata — designer, publisher, game type
  • Play frequency and recency
  • Collection status (in collection, wishlist, etc.)

Board Game Lists

Lists let you organise games into ranked or tiered collections — a personal top 10, a want-to-play pile, a season shortlist, or any custom grouping that suits your group.

Lists can be kept private or shared. Shared lists generate a public link with a preview image.

What to Play Calculator

The What to Play calculator suggests games from your collection based on player count and complexity preferences. It factors in how recently each game has been played to surface games that are due another outing.

Sharing

Most key views in TableTopTourney have a share button that generates a public link with a dynamic preview image for social media.

Shareable views include:

  • Tournament standings
  • Individual play results
  • Contestant profiles and stats
  • Board game tournament history
  • Championship and season results
  • Board game lists

Shared links are public and do not require a TableTopTourney account to view.

Importing from BGG

Tournament organisers can import both games and play history directly from a BoardGameGeek account. Only public data is accessed — no BGG login is required.

Importing Games

Games from your BGG collection can be imported directly into your board game library. BGG data including weight, designer, publisher, and thumbnail is pulled automatically. Games already in your collection are matched and skipped.

Importing Plays

The play import flow has four steps:

  1. Enter a BGG username — fetches all public plays logged on BGG for the tournament period.
  2. Preview & map — plays are matched against games already in your tournament. Unrecognised games are flagged so you can add them or skip. Contestants are mapped by BGG username; any unmapped players can be linked to existing contestants or left unassigned. Winner and second place are auto-detected from scores or BGG win flags, and can be overridden per play.
  3. Import — selected plays are added to the tournament in bulk.
  4. Summary — a summary of imported, skipped, and failed plays is shown.

Imported plays behave exactly like manually logged plays — they can be edited or deleted from the tournament at any time.