Wortfilter: Einstellungen, Treffer-Logik und Grenzen

Der Wortfilter löscht Nachrichten, die einen der von dir hinterlegten Begriffe enthalten. Er arbeitet automatisch, ohne Befehle, und kann zusätzlich im Moderations-Protokoll festhalten, wer wann einen Begriff getroffen hat.

Diese Seite ist die Referenz: Einstellungen, genaue Treffer-Logik, Ausnahmen, Grenzen und Fehlerursachen. Eine Anleitung, wie du eine sinnvolle Wortliste aufbaust, findest du im Ratgeber Wortfilter einrichten.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Kage braucht in den überwachten Kanälen das Recht Nachrichten verwalten, um Nachrichten zu löschen. Es ist in den Rechten der Standard-Einladung enthalten. Fehlt es, kann Kage nichts löschen.
• Optional ein Protokollkanal: Das Protokoll des Wortfilters läuft über das Modul Moderation (siehe unten).

So prüft der Wortfilter eine Nachricht

1. Kage prüft jede neue Nachricht auf einem Server. Nachrichten von Bots und Direktnachrichten ignoriert Kage.
2. Wer das Recht Nachrichten verwalten hat, wird nie gefiltert. Das gilt für Admins und Moderatoren.
3. Ist der Wortfilter ausgeschaltet oder die Liste leer, passiert nichts.
4. Kage vergleicht den Nachrichtentext mit jedem Begriff der Liste, ohne auf Groß- und Kleinschreibung zu achten. Ein Begriff trifft, sobald er irgendwo im Text vorkommt, auch mitten in einem Wort: „spam“ trifft auch „Spammer“.
5. Bei einem Treffer löscht Kage die Nachricht und schreibt im Kanal einen kurzen Hinweis an den Verfasser. Der Hinweis verschwindet nach 5 Sekunden wieder.
6. Ist das Modul Moderation eingeschaltet und dort ein Protokollkanal gewählt, postet Kage dort „🚫 Wortfilter ausgelöst“ mit Mitglied und Begriff. Der Begriff steht als Spoiler, damit er nicht mitgelesen wird.
7. Im Reiter Logs und Statistik des Moduls erscheint jeder Treffer.

Der Filter gilt auch für nachträglich bearbeitete Nachrichten, sofern sich der Text geändert hat. Reine Änderungen an der Link-Vorschau löst er nicht aus.

Einstellungen im Überblick

Du findest sie im Dashboard unter Wortfilter.

Beim Speichern entfernt das Dashboard leere Zeilen, überflüssige Leerzeichen am Rand und doppelte Einträge.

Es gibt keine Slash-Befehle für den Wortfilter, und es gibt keine Kanal- oder Rollenausnahmen außer dem Recht Nachrichten verwalten.

Limit der Wortliste je Tarif

Die Zahl der Begriffe ist begrenzt: 150 in Basic, 1000 in Premium und 5000 in Enterprise. Überschreitest du das Limit, lehnt das Dashboard das Speichern mit „Tarif-Limit erreicht: maximal N in deinem aktuellen Tarif. Ein Upgrade hebt das Limit an.“ ab. Neben der Liste zeigt das Dashboard den Verbrauch an („N / Limit im Tarif“).

Was der Wortfilter nicht tut

• Er erkennt keine Umgehungen wie Leerzeichen zwischen den Buchstaben, Sonderzeichen oder Ersetzungen („sp@m“). Nimm gängige Schreibweisen als eigene Begriffe auf.
• Er vergleicht Teilstücke, keine ganzen Wörter. Ein kurzer Begriff kann deshalb harmlose Wörter treffen (Scunthorpe-Problem). Prüfe deine Liste auf unerwünschte Treffer.
• Er löscht nur und verwarnt oder bestraft nicht. Eine Verwarnung oder ein Timeout lösen andere Module aus.
• Er prüft nur den Text einer Nachricht, keine Bilder, Dateinamen oder Profilnamen.

Ergebnis überprüfen

1. Test mit einem Konto ohne Rechte: Schreibe mit einem normalen Mitgliedskonto einen Begriff aus der Liste. Die Nachricht sollte verschwinden und ein kurzer Hinweis erscheinen.
2. Test mit deinem eigenen Konto: Als Admin oder Moderator wirst du nicht gefiltert. Das ist Absicht. Teste deshalb mit einem zweiten Konto.
3. Protokoll: Prüfe den Reiter Logs im Modul und, falls eingerichtet, den Protokollkanal des Moduls Moderation.

Fehlerbehebung

Eine Nachricht mit einem Begriff aus der Liste bleibt stehen

Prüfe, ob „Wortfilter aktiv“ an ist und gespeichert wurde. Prüfe, ob die Person das Recht Nachrichten verwalten hat (auch über eine Rolle). Prüfe außerdem, ob der Begriff genau so in der Nachricht vorkommt, wie du ihn eingetragen hast.

Es wird nichts gelöscht, obwohl der Hinweis erscheint

Der Hinweis erscheint nur, wenn Kage die Nachricht löschen konnte. Fehlt das Recht Nachrichten verwalten im Kanal, wird weder gelöscht noch ein Hinweis gepostet. Der Fehler steht nur im Betriebslog. Gib Kage das Recht im Kanal.

Harmlose Nachrichten werden gelöscht

Ein Begriff der Liste kommt als Teilstück in einem anderen Wort vor. Entferne den Begriff oder ersetze ihn durch eine längere Form.

Im Protokollkanal erscheint nichts

Der Eintrag erscheint nur, wenn das Modul Moderation eingeschaltet ist und dort ein Protokollkanal gewählt wurde. Kage braucht dort Nachrichten senden. Das Modul Wortfilter hat keinen eigenen Protokollkanal.

Das Speichern wird abgelehnt

Die Liste ist länger als das Limit deines Tarifs. Kürze sie oder wechsle den Tarif.

Weiterführend

Für Verwarnungen und Strafen nach einem Verstoß hilft das Verwarnsystem. Wie der Wortfilter mit weiteren Schutzfunktionen zusammenspielt, steht auf der Funktionsseite zur Moderation.