Skip to main content

Bracket Advancement

intermediateLast updated: 1/15/2024

How teams advance through brackets automatically when matches complete

Bracket Advancement

Understand how teams automatically advance through brackets when matches complete.

Advancement Overview

Bracket advancement automatically:

  • Moves Winners: Advances winning teams to next round
  • Creates Matches: Creates next round matches when ready
  • Updates Bracket: Updates bracket visualization
  • Tracks Progress: Tracks tournament progression

How Advancement Works

Automatic Advancement

When Match Completes:

  1. Match Finishes: Match is marked as completed
  2. Winner Determined: System determines winning team
  3. Bracket Updated: Winner advanced to next round
  4. Next Match Created: Next match created if both teams ready
  5. Bracket Visualized: Bracket display updates

Advancement Process

Step-by-Step:

  1. Match Completion: Match completes with winner
  2. Find Bracket Node: System finds bracket node for match
  3. Update Node: Node updated with winner
  4. Find Next Node: System finds next bracket node
  5. Advance Winner: Winner placed in next round
  6. Create Match: Match created if both teams ready
  7. Update Display: Bracket visualization updates

Single Elimination Advancement

Advancement Flow

How Teams Advance:

  • Round 1: Winners advance to Round 2
  • Round 2: Winners advance to Round 3
  • Continues: Until final round
  • Champion: Final winner is champion

Example Progression

8-Team Bracket:

  1. Round 1: 4 matches → 4 winners advance
  2. Round 2: 2 matches (4 teams) → 2 winners advance
  3. Round 3: 1 match (2 teams) → 1 champion

Match Creation

Automatic Match Creation:

  • Matches created when both teams are known
  • First round matches created during generation
  • Subsequent rounds created as teams advance
  • Final match created when semifinals complete

Double Elimination Advancement

Upper Bracket Advancement

Winners Bracket:

  • Win: Team stays in upper bracket
  • Lose: Team drops to lower bracket
  • Advance: Winner advances to next upper round
  • Continue: Until upper bracket final

Lower Bracket Advancement

Losers Bracket:

  • Win: Team continues in lower bracket
  • Lose: Team is eliminated
  • Advance: Winner advances to next lower round
  • Continue: Until lower bracket final

Grand Finals

Championship Match:

  • Upper Winner: Upper bracket winner
  • Lower Winner: Lower bracket winner
  • Advantage: Upper winner may have advantage
  • Champion: Winner of grand finals

Advancement Timing

When Advancement Happens

Automatic Advancement:

  • After Match Completion: When match is completed
  • After Game Import: When games are imported
  • Real-Time: Updates as matches finish
  • Immediate: Happens automatically

Manual Advancement

If Needed:

  • Manual Update: Can manually advance if needed
  • Correction: Correct advancement if wrong
  • Override: Override automatic advancement
  • Rare: Usually automatic is sufficient

Advancement Rules

Winner Determination

How Winner is Determined:

  • Best of 1: Winner of single game
  • Best of 3: First to 2 wins
  • Best of 5: First to 3 wins
  • Best of 7: First to 4 wins

Position Logic

Team Placement:

  • Even Positions: Winners go to team1 slot
  • Odd Positions: Winners go to team2 slot
  • Next Round: Position = floor(current_position / 2)
  • Automatic: System calculates automatically

Bracket Node Updates

Node States

Bracket Node States:

  • Pending: No teams assigned yet
  • Ready: Both teams assigned, match can be created
  • Completed: Match completed, winner advanced
  • Bye: Team has bye, advances automatically

Node Updates

When Match Completes:

  1. Current Node: Marked as completed
  2. Winner Recorded: Winner stored in node
  3. Next Node: Next node updated with winner
  4. Match Created: Match created if both teams ready

Best Practices

Monitoring Advancement

  • Watch Progress: Monitor bracket progression
  • Verify Advancement: Check teams advance correctly
  • Review Matches: Ensure matches created correctly
  • Track Completion: Track round completion

Handling Issues

  • Verify Results: Ensure match results are correct
  • Check Advancement: Verify teams advance correctly
  • Correct Errors: Fix advancement errors promptly
  • Document Issues: Keep notes on any problems

Common Scenarios

Normal Advancement

Scenario: Match completes normally

What Happens:

  1. Match marked completed
  2. Winner determined
  3. Winner advanced to next round
  4. Next match created (if ready)
  5. Bracket updated

Bye Advancement

Scenario: Team has bye (no opponent)

What Happens:

  1. Bye node marked completed
  2. Team advanced automatically
  3. No match needed
  4. Team placed in next round

Final Match

Scenario: Championship match

What Happens:

  1. Semifinals complete
  2. Final match created
  3. Final match scheduled
  4. Winner is champion

Troubleshooting

"Team not advancing"

Problem: Winner not advancing to next round

Solutions:

  • Verify match is marked as completed
  • Check match result is correct
  • Verify bracket node exists
  • Check advancement logic
  • Manually advance if needed

"Next match not created"

Problem: Next round match not created

Solutions:

  • Verify both teams are known
  • Check bracket structure
  • Ensure previous matches completed
  • Verify advancement occurred
  • Create match manually if needed

"Wrong team advanced"

Problem: Incorrect team advanced

Solutions:

  • Verify match result is correct
  • Check winner determination
  • Review bracket logic
  • Correct advancement manually
  • Re-advance if needed
Tags:bracket-managementadvancementprogressionelimination

Was this article helpful?