league custom game helper Discord Bot

League Helper Bot helps Discord servers organize balanced League of Legends custom 5v5 games. It uses an MMR system to create fair teams and track player performance.
🎮 Core Features:
Account Management
Connect your Discord account to your League account using /connect. Enter your Riot ID (username and tag) and select your ranked tier and division (e.g., Gold III, Diamond I). The bot calculates your initial MMR from your tier and rank, with fixed values for Master (800), Grandmaster (900), and Challenger (1000).
Intelligent Team Balancing
When you have 10 players ready, use /generate-teams to create balanced teams. The bot:
Evaluates all 252 possible team combinations
Selects the top 20 most balanced options
Randomly picks one for variety
Minimizes MMR differences between teams
You can manually select 10 players or use /generate-teams-voice to automatically pull players from your current voice channel.
Match Tracking & MMR System
After each game, use interactive buttons to record the match result. The bot uses an Elo-based system to update MMR:
Winners gain MMR based on the expected outcome
Losers lose MMR accordingly
Close matches result in smaller changes
Mismatched teams result in larger swings
Player Management
Use /인원췤 (attendance check) to see who’s ready to play. Players click buttons to mark availability, making it easy to gather 10 players.
Statistics & Leaderboards
/mmr-history - View your MMR progression over time with a visual graph
/leaderboard - See top players ranked by MMR (customizable limit)
/me - Check your current MMR and account information
🔧 Technical Features:
Guild-specific MMR tracking (separate ratings per server)
Persistent data storage using Supabase
Fast team generation algorithm
Interactive Discord UI with buttons and embeds
Comprehensive error handling and logging
💡 Perfect For:
Discord communities organizing custom games
Friend groups wanting balanced matches
Gaming communities tracking player skill progression
Anyone tired of manually balancing teams
🚀 Getting Started:
Invite the bot to your server
Use /connect to link your League account
Gather 10 players and use /generate-teams
Play your match and record the result
Watch your MMR evolve over time!
The bot makes organizing custom games easier and more competitive by ensuring balanced teams and tracking performance. No more one-sided matches—just fair, competitive games.