Shufflem ist ein Discord-Bot für World of Warcraft Mythic+ Events. Der Bot organisiert Anmeldungen, bildet automatisch faire 5er-Gruppen und reshuffelt die Spieler über mehrere Runden hinweg.
Das Tool ist besonders für Gilden, Communities oder feste M+ Gruppen gedacht, die mehrere Dungeon-Runs parallel planen möchten, ohne Gruppen manuell zusammenstellen und Spieler auf der Bench im Blick behalten zu müssen.
Kurz gesagt: Shufflem ist ein WoW Mythic+ Discord Bot für Gilden, M+ Communities, Dungeon-Abende, Rollenverteilung, Bench-Rotation und automatische Gruppenbildung.
Dieses Projekt ist relevant für:
World of Warcraft, WoW, Mythic+, M+, Discord Bot, Discord.py, Python Bot, WoW Guild Bot, Mythic Plus Bot, Dungeon Group Finder, M+ Shuffle, WoW Event Bot, Discord Event Manager, Guild Event Tool
- 🗓️ Erstellt M+ Shuffle-Events per Discord Slash Command
- ✅ Verwaltet Anmeldungen direkt über Discord Buttons und Dropdowns
- 🛡️ Unterstützt Rollenwahl für Tank, Heiler, DD und Flex-Spieler
- 👥 Bildet automatisch vollständige M+ Gruppen aus 1 Tank, 1 Heiler und 3 DDs
- 🪑 Priorisiert Spieler von der Bench in der nächsten Runde
- 🔁 Führt bis zu 4 Runden pro Event aus
- 🔀 Reshuffelt Gruppen automatisch nach Ablauf der Rundendauer
- 🧰 Erlaubt Admins manuelle Eingriffe während eines Events
- 🔊 Erstellt optional Voice-Channels pro Gruppe in einer Discord-Kategorie
- 📊 Postet am Ende eine Statistik mit gespielten Runden und Bench-Runden
- ♻️ Unterstützt wiederkehrende Events, zum Beispiel täglich oder wöchentlich
Shufflem eignet sich für organisierte World of Warcraft Mythic+ Abende, bei denen viele Spieler teilnehmen und in mehreren Runden durchgemischt werden sollen. Der Bot hilft vor allem dann, wenn eine WoW-Gilde oder Discord-Community mehrere Mythic+ Gruppen gleichzeitig bauen und fair rotieren möchte.
Typische Einsatzzwecke:
- 🏰 Gildeninterne M+ Shuffle-Abende
- 🌐 Community-Events mit mehreren parallelen Gruppen
- ⚖️ Faire Rotation zwischen aktiven Gruppen und Bench
- ⚡ Spontane M+ Sessions mit automatischer Rollenverteilung
- 📆 Regelmäßige Events, die wiederholt im selben Discord-Channel stattfinden
- 🧑🤝🧑 WoW-Gilden, die einen einfachen Mythic+ Group Finder im Discord brauchen
- Ein Admin erstellt ein Event mit
/shuffle create. - Spieler melden sich über das Dropdown als Tank, Heiler, DD oder Flex-Spieler an.
- Zum geplanten Start baut der Bot automatisch die erste Runde.
- Nach jeder Rundendauer wird neu gemischt.
- Bench-Spieler werden bei der nächsten Gruppenzuteilung bevorzugt.
- Nach Runde 4 endet das Event.
- Der Bot postet eine Abschlussmeldung und eine Statistik.
- 🐍 Python 3.11 oder neuer
- 🔐 Ein Discord Bot Token
- 💬 Ein Discord Server, auf dem der Bot eingeladen ist
pip install -r requirements.txtKopiere .env.example zu .env und trage deinen Discord Token ein:
DISCORD_TOKEN=dein_token_hier
TIMEZONE=Europe/BerlinOptional kann die Discord-Kategorie für automatisch erstellte Voice-Channels gesetzt werden:
VOICE_CATEGORY_NAME=LobbyWenn die Variable nicht gesetzt ist, verwendet Shufflem standardmäßig die Kategorie Lobby.
python bot.pyBeim Start synchronisiert der Bot seine Slash Commands und stellt aktive Event-Views wieder her.
Beim Erstellen der OAuth2-Einladungs-URL sollten diese Scopes gesetzt werden:
botapplications.commands
Empfohlene Bot-Berechtigungen:
- Nachrichten senden
- Channels ansehen
- Nachrichtenverlauf lesen
- Embeds einbetten
- Channels verwalten, falls Voice-Channels automatisch erstellt und gelöscht werden sollen
/shuffle create datum:15.04.2026 uhrzeit:20:00 rundendauer:45
Mit Wiederholung:
/shuffle create datum:15.04.2026 uhrzeit:20:00 rundendauer:45 wiederholen:wöchentlich
Verfügbare Wiederholungen:
täglichwöchentlich2-wöchentlichmonatlich
/shuffle stop
Das aktuelle Event läuft weiter, aber es wird danach kein neues wiederkehrendes Event erstellt.
/shuffle add spieler:@Name rollen:Tank + DD
/shuffle remove spieler:@Name
Admins mit der Discord-Berechtigung Server verwalten können während eines laufenden Events:
- 🔄 Spieler tauschen
- ⏭️ Sofort einen Reshuffle auslösen
- ❌ Spieler entfernen
- ➕ Spieler hinzufügen
- ⏸️ Den Timer pausieren und fortsetzen
Diese Aktionen sind direkt über die Buttons an der Gruppen-Nachricht verfügbar.
Eine gültige Mythic+ Gruppe besteht aus:
| Rolle | Anzahl | Farbe im Discord-Kontext |
|---|---|---|
| 🛡️ Tank | 1 | Blau / Schutz |
| 💚 Heiler | 1 | Grün / Support |
| ⚔️ DD | 3 | Rot / Schaden |
Flex-Spieler können mehrere Rollen angeben. Shufflem weist sie nur einer Rolle pro Runde zu. Spieler, die in der letzten Runde auf der Bench waren, werden bei der nächsten Runde bevorzugt, damit die Rotation fairer bleibt.
Shufflem speichert Events, Anmeldungen, Gruppenzuweisungen, Voice-Channel-Referenzen und Statistiken lokal in einer SQLite-Datenbank:
shuffle.db
Die Datenbank wird beim Start automatisch erstellt, falls sie noch nicht existiert.
bot.py Discord Bot, Slash Commands und Scheduler
views.py Discord Embeds, Buttons, Dropdowns und Admin-Menüs
shuffle.py Gruppenbildung und Shuffle-Logik
database.py SQLite-Datenbankzugriff
ANLEITUNG.md Ausführliche Einrichtungsanleitung
requirements.txt
Damit das Repository auf GitHub und in Google besser gefunden wird, sollten in der GitHub-About-Box diese Topics gesetzt werden:
discord-bot
discord-py
python
world-of-warcraft
wow
mythic-plus
mythic-dungeons
guild-management
event-management
sqlite
shuffle-bot
mplus
Empfohlene Repository-Beschreibung:
World of Warcraft Mythic+ Discord Bot for guild events, automatic group shuffling, role signup, bench rotation and M+ event management.
Lege deinen Discord Token nur in einer lokalen .env Datei oder als Hosting-Variable ab. Der Token darf nicht in GitHub committed oder öffentlich geteilt werden.
Auch shuffle.db sollte normalerweise nicht committed werden, da die Datei Discord-IDs, Eventdaten und Gruppenzuweisungen enthalten kann.
Eine ausführlichere Schritt-für-Schritt-Anleitung findest du in ANLEITUNG.md.