Konzeption der Discord-Integration
Diese Seite erklärt, wie die Discord-Integration in dzbot funktioniert und was zu prüfen ist, wenn Discord-Funktionen fehlen.
Was die Discord-Integration ermöglicht
Je nach Konfiguration und Berechtigungen kann dzbot:
- Spieler mit Discord-Konten verknüpfen
- Spitznamen mit Spielernamen im Spiel synchronisieren
- Rollen zuweisen oder entfernen
- Direktnachrichten senden
- dedizierte Ticket-Channel erstellen
- An Unterstützungs- oder Alarmkanäle posten
- Einen Online-Spielerlisten-Kanal pflegen
Grundlagen der Bot-Installation
Die Installationsaufforderung für den Bot wird als Admin-Warnung angezeigt, wenn beide folgenden Bedingungen erfüllt sind:
- ein Discord-Server aus dem verbundenen Discord-Konto des Administrators ist in den Einstellungen ausgewählt, und
- dzbot erkennt, dass der Bot auf diesem Server nicht installiert ist.
Die Warnung enthält einen Discord-OAuth-Link, um den Bot hinzuzufügen, sowie einen erneuten Überprüfungslink, sobald er installiert ist. Sie erscheint nicht für Spieler oder auf der Shop-Frontend.
Den vollständigen Setup-Ablauf findest du unter Erste Schritte: Discord-Integration verbinden.
Eine Guild für mehrere Gameserver
Mehrere dzbot-Server können denselben Discord-Server auswählen — eine Community kann so zwei Gameserver über einen Discord betreiben. Eingehende Ereignisse (KI-Companion-Erwähnungen, über Discord eröffnete Tickets) werden dann über die Kategorie des Channels per Einstellung Zugeordnete Discord-Kategorien zugeordnet. Das erfordert bewusste Konfiguration — siehe Mehrere Gameserver in einer Discord-Guild für Einrichtung und Stolperfallen.
Anforderungen an die Rollenhierarchie
Discord erlaubt es einem Bot nur, Rollen zu verwalten, die unterhalb der Bot-Rolle liegen. Wenn die Rollensynchronisierung nicht funktioniert, verschiebe die Bot-Rolle über die Rollen, die sie verwalten muss. Um sicherzustellen, dass der Bot alles tun kann, was er muss, stelle sicher, dass er die höchste Rolle im System hat.
Referenzen: https://docs.discord.com/developers/topics/permissions https://support.discord.com/hc/de/articles/214836687-Discord-Rollen-und-Berechtigungen
Berechtigungen für Spitznamen
Um seinen eigenen Spitznamen zu aktualisieren, benötigt ein Bot Spitznamen ändern. Um Spitznamen anderer Mitglieder zu aktualisieren, benötigt er Spitznamen verwalten.
Referenzen: https://support.discord.com/hc/de/articles/219070107-Server-Spitznamen https://docs.discord.com/developers/topics/permissions
Opt-in- und Opt-out-Verhalten
Wenn ein Benutzer sich abmeldet, werden Discord-basierte Benachrichtigungen für dieses Konto gestoppt. Es gibt zwei Möglichkeiten, wie Spieler den Erhalt von Discord-Nachrichten deaktivieren können:
Automatische Abmeldung bei Bot-Blockierung
Wenn der Spieler den Bot in Discord blockiert, wird er automatisch abgemeldet.
Explizite Abmeldung
Wir stellen einen expliziten Abmeldeendpunkt bereit, der in allen Nachrichten verlinkt ist, die der Bot direkt an Spieler sendet (per DM, nicht in Kanälen). Dies ermöglicht es Spielern, den Erhalt von Discord-Benachrichtigungen bei Bedarf einfach zu beenden.
Fehlerbehebung bei Abmeldungen
Oftmals erfolgen Abmeldungen ohne Kenntnis der Konsequenzen (oder unbewusst durch Bot-Blockierungen). Wenn Spieler sich über fehlende Benachrichtigungen (wie Basisalarme) beschweren, überprüfe stets den Abmeldestatus des betreffenden Spielers, indem du die Impersonationsfunktion verwendest. Abgemeldete Spieler erhalten auf allen Shop-Seiten eine deutliche Warnung, sich erneut anzumelden.
Allgemeine Überprüfungen bei fehlenden Discord-Funktionen
- Discord-Server ist in Server-Admin → Einstellungen aus dem verbundenen Discord-Konto des Administrators ausgewählt
- die Channel-/Kategorie-Dropdowns wurden nach dem Wechsel des Discord-Servers aktualisiert
- Bot ist auf der richtigen Gilde installiert
- Bot-Rolle steht über den von ihr verwalteten Rollen
- Erforderliche Berechtigungen sind erteilt
- Spieler ist nicht abgemeldet