League Bot

The ETHR League Bot is a Discord bot for running a league entirely inside Discord.

It manages:

• Player and guild syncing
• Team creation, reforming, editing, and disbanding
• Rosters and captain transfers
• Leaderboards and ELO
• Match reporting and match voiding
• Team availability
• Weekly matchmaking schedule generation
• Guild-scoped configuration for roster limits and matchmaking rules

Access Model

The bot is now paywalled by guild activation.

• A server can invite the bot before activation.
• Commands are blocked until the guild is activated.
• Activation is currently manual.

How The Bot Is Structured

There are three main roles in a normal league setup:

• Organizer or server admin: configures the guild and runs organizer-only commands
• Captain: manages a single team
• Player: joins, leaves, and plays on teams

Most leagues use this flow:

1. Install the bot and activate the guild.
2. Run /sync-users.
3. Configure the guild with /config.
4. Create or reform teams.
5. Let captains manage rosters and availability.
6. Generate weekly schedules with /schedule generate or the automatic scheduler.
7. Report match results with /report-match or organizer tools.

Important Notes

• Most commands are designed for guild use only.
• Some owner-only DM commands exist for internal ETHR operations and are documented separately.
• Matchmaking is guild-specific. Every guild has its own matchmaking config namespace.