Erste Schritte

Rechte & Zugriff

Wer das Dashboard öffnen darf und welches Discord-Recht jede Cloudy-Funktion zur Laufzeit tatsächlich braucht.

Es gibt zwei getrennte Rechtefragen, und sie zu verwechseln verursacht die meisten „Warum geht das nicht?"-Fälle:

  1. Wer das Dashboard öffnen darf — eine Prüfung deiner eigenen Discord-Rechte.
  2. Was der Bot darf — eine Prüfung der Rechte der Bot-Rolle.

Wer einen Server konfigurieren darf

Ein Server erscheint in deinem Dashboard, wenn mindestens eines zutrifft:

  • du bist Server-Inhaber, oder
  • deine Rollen geben Administrator, oder
  • deine Rollen geben Server verwalten.

Mehr nicht — es gibt keine separate Cloudy-Rolle und keine Einladungsliste. Die Prüfung läuft bei jedem API-Aufruf, nicht nur beim Seitenaufbau: Eine URL mit fremder Server-ID bekommt ein 403 statt einer gerenderten Seite.

Rechteänderungen in Discord erreichen das Dashboard binnen etwa zwei Minuten — die Serverliste wird kurz zwischengespeichert. Der Aktualisieren-Button in der Serverauswahl erzwingt es sofort.

Was der Bot braucht

Cloudy fragt beim Einladen ein Rechtepaket an, aber jedes Plugin nutzt nur einen Teil davon. Wenn eine Funktion nichts tut und das Dashboard keinen Fehler zeigt, ist diese Tabelle die erste Adresse.

Discord-RechtWird gebraucht von
Kanäle ansehen / Nachrichten sendenAllem, was postet: Willkommen, Level-ups, Geburtstage, Alerts, Panels
Links einbettenJedem Embed — Panels, Level-ups, Giveaways, Stream-Alerts
Nachrichtenverlauf lesenSticky Messages, AutoMod, Custom Commands
Nachrichten verwaltenAutoMod-Löschungen, Sticky-Repost, /del-msg, Umfragen-Aufräumen, Löschen dessen, was in einem Honeypot gepostet wird
Rollen verwaltenReaction Roles, Verifizierung, Auto-Rollen, Geburtstagsrolle, Rollen-Aktionen in Automationen, /channel lock, /lockdown, /ticket add und /ticket remove
Kanäle verwaltenTemp Voice, Ticket-Kanäle, Counter- und Honeypot-Kanäle, /channel lock, /lockdown, /slowmode
Mitglieder verschiebenTemp Voice (den Ersteller in seinen neuen Kanal ziehen)
Mitglieder bannen/ban, /unban, /massban, AutoMod-Eskalation bis Bann, ein Honeypot mit Strafe Bann
Server verwalten/massban (Discords Massen-Bann verlangt es zusätzlich zu Mitglieder bannen), Raid-Modus beim Anheben der Verifizierungsstufe
Mitglieder kicken/kick, AutoMod-Eskalation bis Kick, ein Honeypot mit Strafe Kick
Mitglieder moderieren/timeout, AutoMod-Timeout-Aktionen, ein Honeypot mit Strafe Timeout
Reaktionen hinzufügenReaction-Role-Panels (Vorbelegen der Reaktionen)
Audit-Log ansehenDie Dashboard-Seite Audit-Log und die Mod-Log-Kategorie Nickname- & Rollenänderungen

Die Rollenhierarchie-Falle

Rechte allein reichen nicht. Ein Bot kann nur Rollen vergeben, die unter seiner eigenen höchsten Rolle stehen, und nur Mitglieder moderieren, deren höchste Rolle unter seiner liegt.

Das ist mit Abstand die häufigste Ursache für „die Rolle wird nicht vergeben":

Wenn dein Reaction-Role-Panel @Member vergibt, Cloudys Rolle in Servereinstellungen → Rollen aber unter@Member steht, passiert nichts — und Discord liefert einen generischen Fehler, den der Bot nicht besser erklären kann. Zieh Cloudys Rolle über jede Rolle, die sie verwalten soll.

Für Moderation gilt dasselbe: Cloudy kann niemanden bannen, kicken oder stummschalten, dessen höchste Rolle über der eigenen liegt — egal welche Rechte gesetzt sind.

Privilegierte Intents

Zwei von Discords privileged gateway intents sind nötig, damit Cloudy überhaupt etwas jenseits von Slash-Befehlen sieht:

IntentOhne ihn
Server MembersBeitritte und Austritte sind unsichtbar → kein Willkommen/Abschied, keine Auto-Rollen, keine Verifizierung, keine Geburtstagsrolle
Message ContentNachrichtentext ist unsichtbar → kein AutoMod, kein Leveling, keine Custom Commands, keine Sticky Messages

Beim gehosteten Cloudy-Bot sind sie bereits aktiv — du musst nichts tun. Deine Aufgabe werden sie erst, wenn du einen Custom Bot unter deiner eigenen Discord-Anwendung betreibst; diese Seite führt durch das Einschalten.

Welche Daten das Dashboard liest

Der Transparenz halber — das Dashboard liest in deinem Namen genau das:

  • dein Profil (ID, Name, Avatar) und deine Serverliste über OAuth,
  • Kanäle, Rollen und Basis-Metadaten des Zielservers über den Bot,
  • das Audit-Log des Servers, wenn du die Seite öffnest und der Bot Audit-Log ansehen hat.

Das Einzige, was es in deinem Namen schreibt, ist der einmalige Beitritt zum Cloudy-Community-Server bei deiner ersten Anmeldung (Scope guilds.join); schlägt der fehl, blockiert das die Anmeldung nie.

Nachrichteninhalte liest es über deine Anmeldung nie, und das Token eines Custom Bots wird verschlüsselt gespeichert und an keinen Client zurückgegeben.