Mod-Workflow

Typische Abläufe im Moderations-Alltag.

---

Regelverstoß — manuell

1. /mod warn @User <Grund>
   → User bekommt DM
   → Eintrag mit P-#-ID
   → mod-log aktualisiert

2. Wiederholt? → erneut /mod warn → automatische Eskalation
   (konfigurierbar in mod.yml > escalation):
     ab N aktiven Warns → timeout
     ab M aktiven Warns → kick
     ab X aktiven Warns → ban

---

Notiz ohne Strafe

/mod note @User <text>
→ kein Punishment, keine DM an den User
→ taucht in /mod history auf
→ nützlich für Staff-interne Beobachtungen

---

Softban (Cleanup ohne dauerhaften Ban)

/mod softban @User reason: "spam cleanup" delete-days: 1
→ User wird gebannt + entbannt + letzte 24h Nachrichten gelöscht
→ User kann sofort wieder joinen, aber sein Spam ist weg

---

Report bearbeiten

1. User meldet jemanden:  /report @User <Grund>
2. Report erscheint im mod-log-Channel
3. Mod prüft den Fall und führt manuell die passende Aktion aus
   (/mod warn / mute / kick / ban / softban)

---

Ticket bearbeiten

1. Neues Ticket → Category-Staff-Rollen werden gepingt
2. Claim-Button → Ticket übernehmen
3. Problem lösen
4. Close-Button (oder /ticket close <grund>)
   → Transcript geht an ticket-log
   → Owner bekommt Summary + Rating-Prompt

Falls weg müssen:
→ Unclaim-Button → anderer Supporter kann claimen

---

Ticket falsch geschlossen?

/tickets reopen <id>
→ Channel wird neu erstellt mit gleichem Owner, gleicher Kategorie
→ Form-Antworten werden übernommen
→ Notice geht in den Log-Channel

---

Inaktives Ticket

Bot macht das automatisch (autoClose):
- Pro Kategorie: autoCloseAfterHours (z.B. 48)
- Bot läuft alle checkIntervalMinutes durch (Default 30)
- Activity = jede non-bot-Nachricht im Ticket
- Auto-Close nutzt denselben Flow wie manueller Close

---

Ticket in andere Kategorie verschieben

/ticket transfer <category-id>
→ Channel wird re-parented
→ neue Kategorie-Staff bekommt Zugriff
→ alte Kategorie-Staff verliert Zugriff

---

Verwarnung korrigieren

Falsche Verwarnung?
→ /mod history @User → P-#-ID notieren
→ /mod unwarn <id> → markiert als inaktiv (zählt nicht mehr für Eskalation)
  Eintrag bleibt sichtbar, ist aber ⚫ statt 🟢

---

Ban aufheben

/mod ban hat keine /unban-Variante in 2.0 — Bans werden klassisch
über Discord-Audit-Log + Server-Einstellungen → Banns aufgehoben.

---

Server-Audit-Logger im Hintergrund

Egal welche Aktion: Channel-, Rollen-, Member-, Profil-, Invite-, Webhook-, Emoji- und Message-Events landen automatisch im mod-log-Channel mit Executor (Von:), Target und Details. Das hilft im Nachhinein zu rekonstruieren, wer was wann gemacht hat.

Hinweis: Voice-Channels die durch das Voice-Modul (/voice) erstellt und gelöscht werden, lösen die normalen CHANNEL_CREATE / CHANNEL_DELETE-Logs aus. Hilfreich um nachvollziehen zu können, wer wann einen Voice-Channel besessen hat — siehe GrumpyVoice.

---

Voice-Channel-Konflikt

User missbraucht seinen Channel (Spam, Stress, etc.)?
→ Owner bittet einen Mod, sich dazu zu setzen
→ Mod hat ManageChannels global → kann den Channel direkt umbenennen / löschen
   (oder mit /voice claim übernehmen, falls der Owner gerade weg ist)

---

Custom-Command erstellen

1. /cc add name: <name> type: <text|embed|role-toggle> response: "<inhalt>"
2. /cc info <name>  →  Verifizieren ob alles richtig ist
3. Bei Bedarf: /cc edit <name> response: "..." oder allowed-role: @Rolle

Wichtig: Role-Toggle-Commands für Rollen mit Manager-/Mod-Permissions werden abgelehnt. Das ist beabsichtigt — siehe GrumpyCommands.

---

Help-Hub neu deployen

Help-Embed im falschen Channel oder verschwunden?
→ channels.help in config.yml korrigieren
→ /help redeploy
   (oder Bot neu starten — Auto-Deploy läuft idempotent)

---

Tipps

• Immer einen Grund angeben — erscheint im mod-log + in der DM
• P-#-IDs notieren wenn Fälle dokumentiert werden müssen
• /mod note nutzen für Staff-interne Beobachtungen ohne dass der User informiert wird
• /botstatus liefert eine Schnellübersicht wenn was komisch ist (Module down? Memory hoch?)
• Rollen-Hierarchie beachten — Bot blockiert automatisch bei höherrangigen Usern