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:
- Match Finishes: Match is marked as completed
- Winner Determined: System determines winning team
- Bracket Updated: Winner advanced to next round
- Next Match Created: Next match created if both teams ready
- Bracket Visualized: Bracket display updates
Advancement Process
Step-by-Step:
- Match Completion: Match completes with winner
- Find Bracket Node: System finds bracket node for match
- Update Node: Node updated with winner
- Find Next Node: System finds next bracket node
- Advance Winner: Winner placed in next round
- Create Match: Match created if both teams ready
- 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:
- Round 1: 4 matches → 4 winners advance
- Round 2: 2 matches (4 teams) → 2 winners advance
- 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:
- Current Node: Marked as completed
- Winner Recorded: Winner stored in node
- Next Node: Next node updated with winner
- 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:
- Match marked completed
- Winner determined
- Winner advanced to next round
- Next match created (if ready)
- Bracket updated
Bye Advancement
Scenario: Team has bye (no opponent)
What Happens:
- Bye node marked completed
- Team advanced automatically
- No match needed
- Team placed in next round
Final Match
Scenario: Championship match
What Happens:
- Semifinals complete
- Final match created
- Final match scheduled
- 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
Related Articles
Tags:bracket-managementadvancementprogressionelimination