MythicPlusDiscordBot 💎

🚀 Launch App | 📖 Documentation | 🐞 Report Bug

The "Front Door" for your guild's Mythic+ groups. Seamlessly organize, calculate, and announce Mythic+ groups directly in Discord with interactive activities.

---

📸 Preview

⚡ Quick Start (Local Development)

Get up and running in less than 5 minutes.

1. Clone the repo

   git clone https://github.com/TytaniumDev/MythicPlusDiscordBot.git
   cd MythicPlusDiscordBot

2. Install Dependencies We recommend using uv for fast, reliable dependency management.

   uv sync

3. Configure Environment Create a .env file in the root directory:

   echo "BOT_TOKEN=your_token_here" > .env

4. Run the Bot

   uv run python bot.py

✨ Key Features

• Group Organization: Automatically calculate balanced Mythic+ groups based on player roles and key levels.
• Discord Activity: Interactive "Wheel of Fate" for selecting keys or players, integrated directly into Discord voice channels.
• GitHub Integration: Report bugs and request features directly from Discord using /bug and /featurerequest.

🗺️ Documentation Map

• 🏗️ Architecture: Read ARCHITECTURE.md - Understanding the core logic and services.
• 🚀 Deployment: Read DEPLOYMENT.md - Docker, Raspberry Pi, and GitHub Actions setup.
• 🎮 Activity Setup: Read ACTIVITY_SETUP.md - Configuring the Discord Activity and Frontend.
• 🔥 Firebase Setup: Read FIREBASE_SETUP.md - Database and Auth configuration.
• 👨‍💻 Contributing: Read AGENTS.md - Development standards and guidelines.

🤝 Contributing

We welcome contributions! Please check AGENTS.md for development standards and guidelines.

1. Install Pre-commit Hooks

   pre-commit install

2. Verify Changes

   ./scripts/verify.sh

---

Maintained by TytaniumDev