Moderation

Das Moderationsmodul bietet einen vollständigen Satz an Werkzeugen zur Benutzerverwaltung: Bannen, Kicken, Stummschalten, Verwarnungen, Nachrichten löschen, Spitznamen ändern und Rollenverwaltung.

Modul aktivieren

1. Dashboard → Ihr Server → Toggle Moderation
2. Klicken Sie auf Edit und fügen Sie Moderationsrollen hinzu
3. Speichern Sie die Änderungen

Wichtig

Ohne konfigurierte moderation_roles funktioniert kein Moderationsbefehl — dies gilt für alle Benutzer, einschließlich Discord-Administratoren. Mindestens eine Rolle muss zur Liste hinzugefügt werden, und der Benutzer muss eine dieser Rollen besitzen, damit die Befehle funktionieren.

Konfiguration

Option	Typ	Standard	Beschreibung
moderation_roles	Rollen-ID-Liste	[]	Rollen mit Zugang zu Moderationsbefehlen
warning_threshold	Zahl (1–10)	3	Verwarnungsschwelle — bei Erreichen wird eine Benachrichtigung an die Logs gesendet
dm_on_action	boolean	true	Ob dem Benutzer eine DM über die Moderationsaktion gesendet wird
auto_delete_warnings_days	Zahl	0	Auto-Löschung alter Verwarnungen (0 = deaktiviert)

Konfiguration im Dashboard

Das Bearbeitungspanel des Moderation-Moduls enthält:

• Moderation Roles — Multi-Select mit Serverrollen
• Warning Threshold — Schieberegler 1–10
• DM on Action — Checkbox
• Auto-delete Warnings — Zahlenfeld (Tage, 0 = aus)

Befehle

/ban

Bannt einen Benutzer vom Server.

Parameter	Erforderlich	Beschreibung
target	✅	Zu bannender Benutzer
reason	❌	Grund (max 512 Zeichen)

/kick

Entfernt einen Benutzer vom Server.

Parameter	Erforderlich	Beschreibung
target	✅	Zu kickender Benutzer
reason	❌	Grund (max 512 Zeichen)

/mute

Stellt einen Benutzer stumm (Discord-Timeout).

Parameter	Erforderlich	Beschreibung
target	✅	Stummzuschaltender Benutzer
duration	❌	Zeit in Minuten (1–40320, Standard 10)
reason	❌	Grund (max 512 Zeichen)

info

40320 Minuten = 28 Tage (maximales Discord-Timeout-Limit).

/unmute

Hebt die Stummschaltung (Timeout) eines Benutzers auf.

Parameter	Erforderlich	Beschreibung
target	✅	Benutzer, dessen Stummschaltung aufgehoben werden soll
reason	❌	Grund (max 512 Zeichen)

/warn

Verwarnt einen Benutzer (wird in der Datenbank gespeichert).

Parameter	Erforderlich	Beschreibung
target	✅	Zu verwarnender Benutzer
reason	❌	Grund (max 512 Zeichen)

Nach der Verwarnung:

• Die Verwarnung wird in der Tabelle warnings gespeichert
• Der Benutzer erhält eine DM (wenn dm_on_action aktiviert ist)
• Der Bot prüft, ob die warning_threshold erreicht wurde
• Falls ja — sendet eine Benachrichtigung an den Moderationslog-Kanal

/warnings

Zeigt die Verwarnungshistorie eines Benutzers an (letzte 10).

Parameter	Erforderlich	Beschreibung
target	✅	Zu prüfender Benutzer

/clear

Löscht Nachrichten aus dem aktuellen Kanal.

Parameter	Erforderlich	Beschreibung
amount	✅	Anzahl der Nachrichten (1–100)

/setnick

Ändert den Spitznamen eines Benutzers.

Parameter	Erforderlich	Beschreibung
target	✅	Benutzer
nickname	❌	Neuer Spitzname (leer = Zurücksetzen auf Benutzernamen)

info

Discord beschränkt Spitznamen auf 1–32 Zeichen.

/role add

Weist einem Benutzer eine Rolle zu.

Parameter	Erforderlich	Beschreibung
target	✅	Benutzer
role	✅	Zuzuweisende Rolle

/role remove

Entzieht einem Benutzer eine Rolle.

Parameter	Erforderlich	Beschreibung
target	✅	Benutzer
role	✅	Zu entziehende Rolle

Rollenhierarchie

Alle Befehle respektieren die Discord-Rollenhierarchie:

• Ein Moderator kann keine Aktionen bei Benutzern mit höherer Rolle ausführen
• Der Bot kann keine Rollen verwalten, die höher als seine eigene sind

Wenn die Hierarchie eine Aktion nicht erlaubt, gibt der Bot den Fehler "hierarchy_error" zurück.

DM an den Benutzer

Wenn dm_on_action aktiviert ist, sendet der Bot ein Embed an den Benutzer vor der Ausführung:

• Information über den Aktionstyp (banned from / kicked from / muted in / warned in)
• Servername
• Dauer (bei Mute)
• Grund (falls angegeben)

tipp

Die DM wird nach dem "Best Effort"-Prinzip gesendet — wenn der Benutzer DMs deaktiviert oder den Bot blockiert hat, wird die Aktion trotzdem ausgeführt.

Auto-Löschung von Verwarnungen

Wenn auto_delete_warnings_days > 0 ist, löscht der Bot automatisch alle 6 Stunden Verwarnungen, die älter als die angegebene Anzahl von Tagen sind. Nützlich zur Pflege einer aktuellen Historie und zum automatischen "Verblassen" alter Verwarnungen.

Protokollierung

Jede Moderationsaktion wird durch das Modul Logs unter der Kategorie moderation protokolliert. Die Logs enthalten:

• Aktionstyp (ban, kick, mute, warn, clear, setnick, role_add, role_remove)
• Ziel (betroffener Benutzer)
• Moderator (wer die Aktion ausgeführt hat)
• Grund

Tipps

Best Practices

• Setzen Sie warning_threshold auf 3–5, um Benachrichtigungen über problematische Benutzer zu erhalten
• Aktivieren Sie dm_on_action, damit Benutzer wissen, warum sie bestraft wurden
• Verwenden Sie /warnings bevor Sie schwerwiegendere Aktionen (Ban/Kick) ergreifen
• Konfigurieren Sie Moderationslogs für einen vollständigen Audit-Trail