The "Front Door" for your guild's Mythic+ groups. Organize and spin balanced Mythic+ groups together in a Discord Activity.
Get up and running in less than 5 minutes.
-
Clone the repo
git clone https://github.com/TytaniumDev/MythicPlusDiscordBot.git cd MythicPlusDiscordBot -
Install Dependencies This project uses
npmworkspaces.npm ci
-
Run the activity The demo runs in any browser with no setup:
npm -w activity run dev
Open the printed URL and click Start Demo. Real lobbies only open inside the Discord activity.
-
Verify your changes
./scripts/verify-ts.sh
- 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, launched from a Discord voice channel.
- GitHub Integration: Report bugs and request features from the Activity, or with
/bugand/featurerequestin a server or a DM with Wheelson.
- 🏗️ Architecture: Architecture Documentation - Understanding the core logic and services.
- 🚀 Deployment: Deployment Guide - The deploy workflow, its secrets, and Discord setup.
- 🎮 Activity Setup: Activity Configuration - Configuring the Discord Activity and Frontend.
- 🔥 Firebase Setup: Firebase Configuration - Database and Auth configuration.
- 👨💻 Contributing: Development Standards - Development standards and guidelines.
- 🛡️ CI Standards: CI & Security Standards - CI and security standards.
- 🤖 AI Agents: Agent Instructions - Instructions for AI coding agents (also loaded via
CLAUDE.md). - 📜 Terms of Service: Terms of Service - Rules for using Wheelson.
- 🔒 Privacy Policy: Privacy Policy - What data the app collects and how it is used.
We welcome contributions! Please check the Contributing Guidelines for development standards, guidelines, and verification instructions.
Maintained by TytaniumDev