Moderation

Das Moderations-Modul stellt Slash-Commands für alle häufigen Moderationsmaßnahmen bereit. Jede Aktion wird in einem dedizierten Mod-Log-Channel dokumentiert und optional per DM an den betroffenen User gemeldet. Moderatoren müssen eine konfigurierte Moderator-Rolle besitzen, um die Commands nutzen zu dürfen.

Einrichten

1. Moderation im Dashboard aktivieren
2. Moderator-Rollen auswählen (Rollen, die alle Mod-Commands nutzen dürfen)
3. Immune Rollen auswählen (z. B. Admins — diese können nicht gebannt oder gemuted werden)
4. Mod-Log-Channel auswählen (empfohlen: privaten Channel nur für Mods)
5. DM-bei-Bestrafung aktivieren oder deaktivieren (Standard: AN)
6. Speichern

Slash-Commands

Alle Commands benötigen eine Moderator-Rolle. Der Ziel-User muss auf dem Server sein (außer bei /unban).

/ban

/ban <@User> [Dauer] [Grund]

Bannt den User vom Server. Ohne Dauer: permanenter Ban. Mit Dauer: temporärer Ban, der nach Ablauf automatisch aufgehoben wird.

/kick

/kick <@User> [Grund]

Kickt den User aus dem Server. Kein automatisches Entsperren — der User kann sofort wieder beitreten.

/mute

/mute <@User> [Dauer] [Grund]

Schaltet den User per Discord-Timeout stumm. Ohne Dauer: 10 Minuten (Discord-Minimum). Der User kann keine Nachrichten senden und keine Voice-Channels betreten.

/unmute

/unmute <@User> [Grund]

Hebt einen aktiven Timeout sofort auf.

/warn

/warn <@User> <Grund>

Gibt eine Verwarnung. Wird im Mod-Log und in der Aktions-History gespeichert. Hat keine direkte Discord-Konsequenz — du kannst aber manuell eskalieren, wenn jemand zu viele Verwarnungen hat.

/unban

/unban <User-ID> [Grund]

Hebt einen aktiven Ban auf. Da der User nicht mehr auf dem Server ist, wird die ID statt einer Erwähnung verwendet.

/history

/history <@User>

Zeigt die komplette chronologische Aktions-History eines Users: alle Verwarnungen, Mutes, Kicks und Bans mit Datum, Dauer, Grund und verantwortlichem Moderator.

Dauer-Syntax

Für /ban und /mute werden Zeiten im Format <Zahl><Einheit> angegeben:

Beispiel: /ban @Spammer 7d Spam im #general

Mod-Log

Jede Moderationsaktion erzeugt einen Embed-Post im konfigurierten Mod-Log-Channel. Der Embed enthält: Aktionstyp, betroffener User (Avatar + Name + ID), Moderator, Grund, Dauer und Zeitstempel.

DM an betroffene User

Wenn DM-bei-Bestrafung aktiviert ist (Standard), versucht der Bot, dem User vor der Aktion eine Direktnachricht zu schicken. Die DM enthält Aktionstyp, Dauer, Grund und einen Hinweis auf den Servernam. Wenn der User DMs deaktiviert hat, wird die Aktion trotzdem durchgeführt — der Bot zeigt nur einen stillen Hinweis im Command-Response.

Fehlersuche

Command erscheint nicht in Discord

Slash-Commands müssen nach der Aktivierung bis zu 1 Stunde brauchen, bis Discord sie registriert. Bei Custom-Bot: bis zu 1 Stunde nach Bot-Neustart.

"Fehlende Berechtigungen" beim /ban

Prüfe die Rollenhierarchie: TeraOne muss in der Hierarchie über dem Ziel-User stehen. Außerdem muss der Bot die Berechtigung "Mitglieder bannen" haben.

Mod-Log-Post erscheint nicht

Prüfe, ob der Bot Schreibrechte und Einbettungsrechte im Mod-Log-Channel hat.

Häufige Fragen

Kann ich Moderatoren auf bestimmte Aktionen einschränken (z. B. nur Verwarnungen, keine Bans)?

Aktuell ist die Berechtigung binär: Moderator-Rolle = Zugriff auf alle Mod-Commands. Granulare Berechtigungen pro Command sind in Planung.

Was passiert mit einem temporären Ban, wenn der Bot offline geht?

Der Ablaufzeitpunkt wird in der Datenbank gespeichert. Wenn der Bot wieder online geht, werden alle abgelaufenen Bans nachträglich aufgehoben.

Kann man die Verwarnung-History löschen?

Nein, Mod-Aktionen sind unveränderlich gespeichert — das ist bewusst so, um einen vollständigen Audit-Trail zu gewährleisten.