Moderation
Verwarnungen, Bans, Kicks, Timeouts und Kanal-Sperren — inklusive Auto-Ban bei zu vielen Verwarnungen.
Das Moderations-Modul bündelt die Werkzeuge, mit denen du auf deinem Server durchgreifst. Verwarnungen werden gespeichert und pro Mitglied gezählt; ab einer einstellbaren Schwelle kann der Bot ein Mitglied automatisch bannen. Jeder Befehl lässt sich einzeln abschalten, und eine eigene Moderator-Rolle steuert, wer die Befehle benutzen darf. (moderation)
Bild folgt
Das Dashboard mit geöffnetem Tab „Moderation“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.
Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.
public/docs-assets/modules/moderation.png · 1600x900 · dunkles Design
Warnungen und Eskalation
Der Befehl warn legt zu jedem Mitglied eine Verwarnung mit Grund, Moderator und Zeitpunkt ab. Die Verwarnungen bleiben dauerhaft gespeichert und lassen sich einzeln oder gesammelt auflisten.
- Mit Ban-Schwelle legst du fest, ab wie vielen aktiven Verwarnungen der Bot handelt.
- Mit Auto-Ban entscheidest du, ob bei Erreichen der Schwelle sofort gebannt wird. Ist Auto-Ban aus, passiert trotz erreichter Schwelle nichts.
- Ein entfernter Warn zählt nicht mehr – die Schwelle wird über die tatsächlich gespeicherten Verwarnungen berechnet.
Wer darf moderieren
Jeder Moderationsbefehl verlangt ein Discord-Recht (z. B. Mitglieder bannen für ban). Zusätzlich kannst du eine Moderator-Rolle eintragen – sie ist für die Moderation gedacht, ersetzt aber die Discord-Rechte nicht.
Was im Mod-Log landet
Ist ein Mod-Log-Kanal eingetragen, schreibt jeder Moderationsvorgang dort eine Meldung: wer gehandelt hat, wen es traf und warum. Ohne Log-Kanal bleiben die Aktionen für das Team unsichtbar.
Befehle
/warncreate? list? info? edit? remove? clear?Mitglieder im TimeoutVerwarnungen verwalten
/banuser reason? duration?Mitglieder bannenBannt einen Benutzer vom Server
/kickuser reason?Mitglieder kickenKickt einen Benutzer vom Server
/timeoutuser duration reason?Mitglieder im TimeoutSetzt einen User in Timeout
/clearanzahl? typ? benutzer?Nachrichten verwaltenLöscht Nachrichten aus dem Kanal (Anzahl, Typ und/oder Benutzer wählbar)
/lockchannel? reason?Kanaele verwaltenSperrt einen Kanal
/unlockchannel? reason?Kanaele verwaltenEntsperrt einen Kanal
/softbanuser reason? tage?Mitglieder bannenBannt einen User und hebt den Ban sofort auf – löscht seine Nachrichten
/unbanuserid reason?Mitglieder bannenEntbannt einen Benutzer
Einstellungen im Dashboard
| Einstellung | Typ | Bedeutung |
|---|---|---|
Modul Moderation aktivmoderationEnabled | Schalter | Schaltet das Modul ein oder aus. Beim Ausschalten sperrt der Bot die zugehörigen Befehle (siehe FAQ „Befehl gesperrt“). |
Moderator-RollemodRole | Rolle | Rolle, die Moderationsbefehle ausführen darf. Wird zusätzlich zu Discords eigenen Berechtigungen geprüft — beide müssen erfüllt sein. |
Mod-Log-KanalmodLogChannel | Kanal | Kanal, in den Moderationsaktionen (Verwarnungen, Bans, Kicks, Timeouts) protokolliert werden. |
Auto-Ban bei Warn-SchwelleautoBan | Schalter | Bannt ein Mitglied automatisch, sobald es die Ban-Schwelle an Verwarnungen erreicht. |
Ban-Schwelle (Anzahl Warns)banThreshold | Zahl | Anzahl an Verwarnungen, ab der Auto-Ban greift. Wirkt nur zusammen mit eingeschaltetem Auto-Ban. |
Befehl /warn aktivmodWarnEnabled | Schalter | Erlaubt das Verwalten von Verwarnungen über den Befehl warn. |
Befehl /ban aktivmodBanEnabled | Schalter | Erlaubt den Befehl ban. |
Befehl /kick aktivmodKickEnabled | Schalter | Erlaubt den Befehl kick. |
Befehl /timeout aktivmodTimeoutEnabled | Schalter | Erlaubt den Befehl timeout. |
Befehl /purge aktivmodPurgeEnabled | Schalter | Schaltet den Eintrag für /purge in der Oberfläche. Hinweis: In der aktuellen Befehlsliste existiert kein eigener purge-Befehl — zum Löschen von Nachrichten dient clear. |
Befehl /clear aktivmodClearEnabled | Schalter | Erlaubt den Befehl clear (Nachrichten löschen). |
Befehle /lock & /unlock aktivmodLockEnabled | Schalter | Erlaubt die Befehle lock und unlock. |
Befehl /softban aktivmodSoftbanEnabled | Schalter | Erlaubt den Befehl softban (bannen und sofort entbannen, um Nachrichten zu löschen). |
Befehl /unban aktivmodUnbanEnabled | Schalter | Erlaubt den Befehl unban. |
Stolperfallen
- Auto-Ban greift nur, wenn Auto-Ban aktiv und eine Ban-Schwelle gesetzt ist. Die Schwelle allein bewirkt nichts.
- Die Moderator-Rolle ersetzt Discords Berechtigungen nicht. Fehlt dem Bot selbst ein Recht (z. B. „Mitglieder bannen“), schlägt der Befehl trotz richtiger Rolle fehl.
- Verwarnungen werden dauerhaft gespeichert. Ein entfernter Warn zählt nicht mehr zur Schwelle.
Siehe auch