MythicPlusDiscordBot 💎

Launch Activity | Documentation | Report Bug

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

---

🚀 Launch App | 📖 Documentation | 🐞 Report Bug

---

✨ 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.
• Voice Integration: The bot joins voice channels to announce results and play sound effects.
• GitHub Integration: Report bugs and request features directly from Discord using /bug and /featurerequest.

📸 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

   # Using uv (recommended)
   uv pip install -r requirements-dev.txt
   
   # OR using standard pip
   pip install -r requirements-dev.txt

3. Run the Bot

   # Ensure you have your BOT_TOKEN set in your environment
   export BOT_TOKEN="your_token_here"
   python bot.py

🗺️ 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

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