Discord Bot einrichten

Der SC-OrgaBase Discord Bot ist Teil der kostenlosen Community-Plattform. Er ist optional – SC-OrgaBase funktioniert vollständig auch ohne ihn. Eine Übersicht findest du auf der öffentlichen Seite /discord-bot.

Login, Integration und Bot – der Unterschied

• Discord Login: Du meldest dich mit Discord an bzw. verknüpfst dein Konto (betrifft nur dich).
• Discord Integration: Deine Organisation verbindet ihren Server (Guild-ID, Rollenmapping, Kanal).
• Discord Bot: Führt Aktionen aus – Rollensync, Nachrichten, Slash-Befehle.

Bot einladen

1. Auf /discord-bot den Button „Bot zu Discord hinzufügen" nutzen (Scopes: bot, applications.commands).
2. Server auswählen und die angefragten Rechte bestätigen.
3. In SC-OrgaBase die Discord-Integration im Org-Dashboard aktivieren und Guild-ID, Rollenmapping und Benachrichtigungskanal setzen.

Benötigte Rechte

• Server/Kanäle anzeigen
• Nachrichten senden
• Slash-Befehle verwenden
• Rollen verwalten (für den Rollensync)

Slash-Befehle

Verfügbar sind u.a. /help, /link, /profile, /org, /alliance, /applications, /event, /fleet, /blueprint, /crafting, /production, /resource, /gallery, /docs, /ticket, /sync, /status, /admin. Befehle werden serverseitig per RBAC geprüft – Discord-Rollen allein entscheiden nie.

Fehlerbehebung

• Bot erscheint offline: Der Gateway-Dienst läuft als eigener Service; REST-Funktionen (Rollensync, Benachrichtigungen) arbeiten auch dann, wenn der Bot in Discord offline wirkt.
• Bot kann Rollen nicht vergeben: Bot-Rolle steht zu niedrig oder es fehlt das Recht „Rollen verwalten".
• Bot sieht keine Kanäle / sendet keine Nachrichten: Kanalrechte prüfen (Anzeigen, Nachrichten senden).
• Guild-ID falsch oder Rollenmapping fehlt: In der Discord-Integration korrigieren.
• Discord-Login geht, Bot nicht: Login (OAuth) und Bot/Integration sind getrennt – Integration separat einrichten.
• Bot eingeladen, aber SC-OrgaBase nicht verknüpft: Integration im Org-Dashboard aktivieren und Guild-ID setzen.