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 einer Minute — 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
Rollen verwaltenReaction Roles, Verifizierung, Auto-Rollen, Geburtstagsrolle, Rollen-Aktionen in Automationen
Kanäle verwaltenTemp Voice, Ticket-Kanäle, /channel-lock, /slowmode
Mitglieder verschiebenTemp Voice (den Ersteller in seinen neuen Kanal ziehen)
Mitglieder bannen/ban, /unban, AutoMod-Eskalation bis Bann
Mitglieder kicken/kick, AutoMod-Eskalation bis Kick
Mitglieder moderieren/timeout, AutoMod-Timeout-Aktionen
Reaktionen hinzufügenReaction-Role-Panels (Vorbelegen der Reaktionen)
Audit-Log ansehenDie Dashboard-Seite Audit-Log

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.

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