🏆 Tournament Manager User Guide
Quick Start
Tournament Manager is a comprehensive tournament management system integrated with the Playtopia Dev Lab authentication system. Access the platform at https://tournaments.playtopia.com.au
Getting Started
- Authentication: Login using your Playtopia account through Authelia
- User Roles: Your permissions are automatically assigned based on your account group
- Admin: Full system access and user management
- Family Group: Tournament Organizer privileges (can create tournaments)
- Users: Participant access (can join tournaments)
🏆 Creating Tournaments
Basic Tournament Setup
As a Tournament Organizer or Admin, you can create tournaments using the following process:
- Name: Descriptive tournament name
- Description: Optional detailed description
- Tournament Type: Choose from available formats
- Maximum Participants: Set capacity limits
- Public/Private: Control tournament visibility
Single Elimination
- Traditional knockout bracket
- Participants are eliminated after one loss
- Bracket size automatically optimized to next power of 2
- Bye rounds handled automatically for odd participant counts
Double Elimination
- Main bracket with losers bracket
- Participants get a second chance after one loss
- Grand finals between winners and losers bracket champions
- More comprehensive tournament experience
Round Robin
- Every participant plays every other participant
- Best for smaller tournaments (typically 8-12 participants)
- Final ranking based on wins/losses record
- Ensures everyone gets multiple matches
Swiss System
- Pairing-based system for larger tournaments
- Participants paired against others with similar records
- Multiple rounds without elimination
- Ideal for skill-based ranking
Step 3: Registration Settings
- Registration Deadline: Optional cutoff for participant registration
- Start Date: Scheduled tournament commencement
- Auto-Registration: Allow participants to join directly
- Manual Entry: Add participants who don’t have accounts
👥 Participant Management
Registration Process
For Participants:
- Browse available tournaments
- Click “Register” on desired tournament
- Automatic enrollment if space available
- View tournament details and schedule
For Organizers:
- Participant List: View all registered participants
- Manual Addition: Add participants without accounts
- Seeding Options:
- Random seeding
- Registration order
- Manual seeding with custom order
- Capacity Management: Monitor and control participant limits
Seeding System
Seeding Options:
├── Random: Shuffle participants randomly
├── Registration Order: First-come, first-served
└── Manual: Custom seed assignment
🎮 Match Management
Match Results
For Participants:
- View Matches: See your scheduled matches and opponents
- Report Results: Submit match results (if permitted)
- Match History: Track your performance across tournaments
For Organizers:
- Result Entry: Input match results and scores
- Result Validation: Confirm submitted results
- Bracket Progression: Automatic advancement to next rounds
- Schedule Management: View and modify match scheduling
Real-time Updates
Tournament Manager provides live updates through:
- Bracket Updates: Automatic bracket progression as matches complete
- Result Notifications: Immediate result broadcasting to participants
- Tournament Status: Live tournament state updates
- Match Scheduling: Dynamic match generation for subsequent rounds
📋 Tournament Rules
Rule Management
Organizers can create comprehensive tournament rules:
Rule Categories:
- GENERAL: Overall tournament guidelines
- SCORING: Point systems and victory conditions
- TIME_LIMITS: Match duration and deadline policies
- CONDUCT: Participant behavior expectations
- PRIZES: Tournament rewards and recognition
- FORMAT: Specific format rules and variations
Rule Features:
- Priority System: Important rules highlighted first
- Active/Inactive: Enable/disable rules as needed
- Batch Creation: Add multiple rules simultaneously
- Custom Data: Additional rule-specific information
Example Rule Set
Tournament Rules - Summer Championship
GENERAL (Priority: 100)
├── All matches must be played within 7 days of scheduling
├── Participants must confirm availability before tournament start
└── No substitutions allowed after bracket generation
SCORING (Priority: 90)
├── Best of 3 format for all matches
├── Winner determined by first to 2 game victories
└── Games cannot end in draws - play until decisive outcome
CONDUCT (Priority: 80)
├── Respectful behavior required at all times
├── No external assistance during matches
└── Report technical issues immediately to organizers
📊 User Profiles & Statistics
Personal Dashboard
Access your tournament history and performance metrics:
Profile Information:
- Basic Details: Name, username, contact information
- Tournament History: List of participated and organized tournaments
- Performance Stats: Win/loss records, match statistics
- Achievement Tracking: Tournament victories and milestones
Statistics Overview
Participation Metrics:
- Tournaments Joined: Total tournament participation count
- Tournaments Completed: Finished tournament statistics
- Tournaments Created: Organized tournament count (for organizers)
Match Performance:
- Total Matches: Complete match participation
- Matches Won: Victory count across all tournaments
- Win Rate: Success percentage calculation
- Recent Activity: Latest tournament participation
🛠️ Advanced Features
Tournament Templates
For Regular Organizers:
- Save Configurations: Store frequently used tournament settings
- Quick Setup: Rapid tournament creation using saved templates
- Rule Templates: Reusable rule sets for consistent tournaments
- Format Preferences: Saved tournament format configurations
Export & Reporting
Available Exports:
- Tournament Brackets: Visual bracket representations
- Results Summary: Complete tournament outcome reports
- Participant Lists: Tournament registration data
- Statistics Reports: Performance and participation analytics
Mobile Optimization
Tournament Manager is fully optimized for mobile use:
- Responsive Design: Adapts to all screen sizes
- Touch Interface: Mobile-friendly interaction patterns
- Offline Capability: Basic functionality during network interruptions
- Progressive Web App: Install on mobile devices for app-like experience
🔧 Troubleshooting
Common Issues
Authentication Problems:
- Ensure you’re logged into the Playtopia authentication system
- Clear browser cache if authentication seems stuck
- Check that your account has appropriate permissions for desired actions
Tournament Access:
- Can’t Create Tournaments: Verify your account is in the ‘family’ group for organizer privileges
- Can’t Join Tournament: Check if tournament is public and has available capacity
- Missing Tournament: Confirm tournament hasn’t been cancelled or is in draft status
Match Results:
- Can’t Submit Results: Verify you’re a participant in the match or have organizer permissions
- Results Not Updating: Check internet connection and refresh the page
- Bracket Not Advancing: Ensure all matches in the current round are completed
Getting Help
Support Channels:
- System Status: Check Traefik dashboard for service status
- Authentication Issues: Verify Authelia authentication system status
- Database Problems: Contact system administrator for data-related issues
- Feature Requests: Submit enhancement requests through development channels
🚀 API Access
For developers and advanced users, Tournament Manager provides a comprehensive REST API:
Authentication
All API requests require valid Authelia authentication headers:
curl -H "Remote-User: your-username" \
-H "Remote-Email: your-email@example.com" \
-H "Remote-Groups: family,users" \
https://tournaments.playtopia.com.au/api/tournaments
Key Endpoints
Tournament Management:
# List tournaments
GET /api/tournaments
# Create tournament
POST /api/tournaments
# Get tournament details
GET /api/tournaments/{id}
# Register for tournament
POST /api/tournaments/{id}/register
Match Operations:
# Get tournament matches
GET /api/matches/{tournamentId}
# Update match result
PUT /api/matches/{matchId}/result
# Generate tournament bracket
POST /api/matches/{tournamentId}/generate
User Information:
# Get user profile
GET /api/users/profile
# Get user statistics
GET /api/users/{userId}/stats
# Get user tournament history
GET /api/users/{userId}/tournaments
📈 Best Practices
Tournament Organization
Planning Phase:
- Participant Capacity: Plan for 16, 32, or 64 participants for elimination brackets
- Schedule Buffer: Allow extra time for match completion
- Rule Clarity: Create comprehensive, clear tournament rules before start
- Communication: Establish clear channels for participant communication
Execution Phase:
- Regular Monitoring: Check tournament progress and resolve issues promptly
- Result Verification: Confirm match results before bracket progression
- Participant Support: Be available for questions and technical assistance
- Documentation: Keep records of tournament decisions and results
Post-Tournament:
- Results Publishing: Share final results and bracket outcomes
- Feedback Collection: Gather participant feedback for future improvements
- Performance Analysis: Review tournament statistics for insights
- Archive Management: Preserve tournament data for historical reference
Optimization Tips:
- Browser Updates: Keep browser updated for best performance
- Connection Stability: Ensure reliable internet connection for real-time updates
- Resource Management: Close unnecessary browser tabs during tournament management
- Regular Refresh: Periodically refresh browser if issues arise
Tournament Manager provides a comprehensive platform for organizing and participating in competitive tournaments with professional-grade features and seamless integration with the Playtopia Dev Lab ecosystem.