Moderation
Moderationsbefehle zur Verwaltung von Serverbenutzern. Alle erfordern eine Rolle aus der Liste Moderation Roles (konfiguriert im Dashboard).
Alle Moderationsbefehle (außer /clear und /warnings) prüfen die Rollenhierarchie — Sie können keinen Benutzer moderieren, dessen höchste Rolle über Ihrer liegt.
Befehle
/ban
Bannt einen Benutzer vom Server. Vor dem Ban wird eine DM mit Information gesendet (wenn dm_on_action aktiviert ist).
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Zu bannender Benutzer |
| reason | string | Nein | Ban-Grund (max 512 Zeichen) |
Berechtigungen: Moderation Roles
Beispiel: /ban target:@ToxicUser reason:Spam und beleidigende Sprache
Erfolg: Ephemerale Bestätigung + Log im Modul "moderation"
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle als Moderator
- Bot hat keine
ban_members-Berechtigung
/kick
Entfernt einen Benutzer vom Server. Vor dem Kick wird eine DM gesendet.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Zu kickender Benutzer |
| reason | string | Nein | Kick-Grund (max 512 Zeichen) |
Berechtigungen: Moderation Roles
Beispiel: /kick target:@Troublemaker reason:Mehrfache Verwarnungen
Erfolg: Ephemerale Bestätigung + Log
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Bot hat keine
kick_members-Berechtigung
/mute
Stellt einen Benutzer stumm (Discord-Timeout). Der Benutzer kann für die angegebene Zeit weder schreiben noch sprechen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Stummzuschaltender Benutzer |
| duration | integer | Nein | Zeit in Minuten (1–40320, Standard 10) |
| reason | string | Nein | Grund der Stummschaltung (max 512 Zeichen) |
Berechtigungen: Moderation Roles
Beispiel: /mute target:@Spammer duration:60 reason:Spam im Kanal
Erfolg: Ephemerale Bestätigung + DM an Benutzer + Log
Fehler:
- Keine Moderationsberechtigungen
- Ungültige Zeit (außerhalb 1–40320)
- Ziel hat höhere Rolle
- Bot hat keine
moderate_members-Berechtigung
40320 Minuten = 28 Tage — das ist das maximale Timeout-Limit der Discord-API.
/unmute
Hebt die Stummschaltung (Timeout) eines Benutzers auf.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Benutzer, dessen Stummschaltung aufgehoben werden soll |
| reason | string | Nein | Grund (max 512 Zeichen) |
Berechtigungen: Moderation Roles
Beispiel: /unmute target:@User reason:Strafzeit abgelaufen
Erfolg: Ephemerale Bestätigung + Log
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Bot hat keine
moderate_members-Berechtigung
/warn
Verwarnt einen Benutzer. Die Verwarnung wird in der Datenbank gespeichert und eine DM gesendet.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Zu verwarnender Benutzer |
| reason | string | Nein | Verwarnungsgrund (max 512 Zeichen) |
Berechtigungen: Moderation Roles
Beispiel: /warn target:@User reason:Unangemessene Sprache
Erfolg: Ephemerale Bestätigung + DM + Log + Prüfung der Verwarnungsschwelle
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Datenbankfehler
Wenn ein Benutzer die konfigurierte Verwarnungsschwelle (warning_threshold, Standard 3) erreicht, sendet der Bot eine Benachrichtigung an den Moderationslog-Kanal. Die Benachrichtigung wird genau einmal gesendet — im Moment der Schwellenerreichung.
/warnings
Zeigt die Verwarnungshistorie eines Benutzers (bis zu 10 neueste).
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Zu prüfender Benutzer |
Berechtigungen: Moderation Roles
Beispiel: /warnings target:@User
Erfolg: Liste der Verwarnungen mit ID, Moderator, Datum und Grund
Fehler:
- Keine Moderationsberechtigungen
- Keine Verwarnungen (Information)
- Datenbankfehler
/clear
Löscht eine bestimmte Anzahl von Nachrichten aus dem aktuellen Kanal.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| amount | integer | Ja | Anzahl zu löschender Nachrichten (1–100) |
Berechtigungen: Moderation Roles
Beispiel: /clear amount:50
Erfolg: Ephemerale Bestätigung mit Anzahl gelöschter Nachrichten + Log
Fehler:
- Keine Moderationsberechtigungen
- Ungültige Anzahl (außerhalb 1–100)
- Bot hat keine
manage_messages-Berechtigung
Discord erlaubt das Massenlöschen von Nachrichten, die älter als 14 Tage sind, nicht (Bulk Delete). Nachrichten älter als 14 Tage werden nicht gelöscht.
/setnick
Ändert den Spitznamen (Nickname) eines Benutzers auf dem Server.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Benutzer, dessen Nick geändert werden soll |
| nickname | string | Nein | Neuer Spitzname (leer = Zurücksetzen auf Benutzernamen) |
Berechtigungen: Moderation Roles
Beispiel: /setnick target:@User nickname:Neuer Nick
Erfolg: Ephemerale Bestätigung mit altem → neuem Nick + Log
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Nickname zu lang/kurz (1–32 Zeichen)
- Bot hat keine
manage_nicknames-Berechtigung
/role add
Weist einem Benutzer eine Rolle zu.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Benutzer, dem die Rolle zugewiesen werden soll |
| role | Role | Ja | Zuzuweisende Rolle |
Berechtigungen: Moderation Roles
Beispiel: /role add target:@User role:@VIP
Erfolg: Ephemerale Bestätigung + Log
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Rolle ist über der höchsten Bot-Rolle (Bot-Hierarchie-Fehler)
- Benutzer hat die Rolle bereits
- Bot hat keine
manage_roles-Berechtigung
/role remove
Entfernt eine Rolle von einem Benutzer.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| target | Member | Ja | Benutzer, von dem die Rolle entfernt werden soll |
| role | Role | Ja | Zu entfernende Rolle |
Berechtigungen: Moderation Roles
Beispiel: /role remove target:@User role:@Muted
Erfolg: Ephemerale Bestätigung + Log
Fehler:
- Keine Moderationsberechtigungen
- Ziel hat höhere Rolle
- Rolle ist über der höchsten Bot-Rolle
- Benutzer hat die Rolle nicht
- Bot hat keine
manage_roles-Berechtigung
Konfiguration
Moderationseinstellungen werden im Dashboard konfiguriert (Cog "Moderation"):
| Option | Beschreibung | Standardwert |
|---|---|---|
moderation_roles | Liste der Rollen mit Moderationsberechtigungen | keine (Befehle nicht verfügbar) |
warning_threshold | Verwarnungsschwelle für Benachrichtigung | 3 |
dm_on_action | DM an den moderierten Benutzer senden | true |
auto_delete_warnings_days | Auto-Löschung alter Verwarnungen (0 = deaktiviert) | 0 |
Wenn Sie keine moderation_roles konfigurieren, kann kein Benutzer Moderationsbefehle verwenden (auch keine Server-Administratoren). Fügen Sie mindestens eine Rolle im Dashboard hinzu.