Skip to content

Chat Moderation

Jack edited this page Apr 5, 2026 · 1 revision

Chat Moderation

Allium now has a modular chat moderation system under plugins/Allium/chat/.

Current Active Modules

  • word-phrase-filter
  • spam-blocker

Word / Phrase Filter

Configured in:

  • chat/modules/word-phrase-filter.yml

Supports:

  • tokens
  • phrases
  • substrings
  • regex

Strengths:

  • exact
  • normal
  • loose

The matcher is built to reduce false positives by working with token-aware normalization instead of naive whole-message substring logic.

Spam Blocker

Configured in:

  • chat/modules/spam-blocker.yml

Supports:

  • singular spam detection
  • repeated-message similarity
  • phrase whitelist
  • repeat-collapse handling
  • temporary mute behavior

In-Game Management

/core filter supports dry-run and editing flows for the word/phrase filter:

  • test
  • check
  • add
  • remove
  • set

Planned/Scaffolded Modules

The module folder also includes scaffold files for future systems like:

  • link/ad blocking
  • chat cooldown
  • unicode filtering
  • anti-parrot
  • command spy
  • auto grammar

Clone this wiki locally