Tournaments

Tournaments are multi-round competitive events that chain multiple contests together with bracket progression. Winners advance through rounds until a champion is crowned.

Tournament Formats

Single Elimination

Standard bracket — one loss and you’re out.

Minimum: 4 players, Maximum: 32
Seeding: Random or score-based
Byes: Auto-advance for odd brackets

Double Elimination

Players must lose twice to be eliminated. Features both a winners bracket and a losers bracket.

Minimum: 6 players, Maximum: 32
Grand Finals: Losers bracket winner must beat the winners bracket winner twice (if resetGrandFinals = true)

Round Robin

Every player faces every other player. Final standings based on total points.

Minimum: 3 players, Maximum: 12
Win: 3 points, Draw: 1 point

Swiss

Players are matched against opponents with similar records. Efficient for large groups.

Minimum: 4 players, Maximum: 64
Rounds: Determined by maxRounds setting
Pairing: Score-based matching

Running a Tournament

Creating (Admin)

/tournament gui                                              # Open creation GUI
/tournament create <name> <hall_id> <type>                  # Create (3 rounds, 15 min registration)
/tournament create <name> <hall_id> <type> <rounds>         # Custom round count (1-10)
/tournament create <name> <hall_id> <type> <rounds> <reg_minutes>  # Full control (1-120 min)

Player Commands

/tournament list                    # List active tournaments
/tournament info <id>              # View tournament details
/tournament join <id>              # Register for a tournament
/tournament leave                   # Leave current tournament
/tournament leaderboard            # View current standings
/tournament leaderboard <id>       # View specific tournament

Admin Management

/tournament start <id>             # Force start (skip registration window)
/tournament cancel <id>            # Cancel a tournament
/tournament kick <id> <player>     # Remove a player
/tournament nextround <id>         # Force advance to next round

Tournament Flow

Registration — Players join during the registration window
Bracket Generation — Matchups are created based on format and seeding
Round N — Matched players compete in contests at the designated hall
Advancement — Winners advance, losers are eliminated (or sent to losers bracket)
Repeat until champion is determined
Prizes distributed based on final placement

Rating System

Tournaments use an ELO-style rating system:

Starting rating: 1200
Rating adjusts after each match based on win/loss and opponent’s rating
Ratings persist across tournaments within a season
Displayed on leaderboards

Rewards

Rewards are configured per tournament or in the global tournament config at config/reverie/tournament.conf:

rewards {
  first {
    items = ["minecraft:netherite_ingot 2", "minecraft:experience_bottle 20"]
    ribbon = "master"
  }
  second {
    items = ["minecraft:diamond 5", "minecraft:experience_bottle 15"]
    ribbon = "hyper"
  }
  third {
    items = ["minecraft:gold_ingot 10", "minecraft:experience_bottle 10"]
    ribbon = "super"
  }
  participation {
    items = ["minecraft:iron_ingot 3", "minecraft:experience_bottle 5"]
  }
}

Tournament IDs

Tournament IDs can be referenced by:

First 8 characters of the UUID
Tournament name (with underscores replacing spaces)

Both formats work in commands and are available as tab completions.

Next Steps

Seasons — Seasonal leaderboards that track tournament results
Tournament Config — Format and bracket settings
Economy — Entry fees and currency rewards