ChristianFilter
ChristianFilter is a powerful chat moderation plugin that keeps your server clean and family-friendly. It filters blocked words, advanced regex patterns, URLs, and IP addresses from player chat — with smart leet-speak normalization to catch bypass attempts before they slip through.
✨ Features
- 🔤 Word Filter — Block specific words with wildcard support and leet-speak normalization
- 🔍 Regex Filter — Advanced pattern matching with auto-generated regex from plain words
- 🔗 URL & IP Filter — Block links and raw IP addresses, with domain whitelisting
- ⚠️ Punishment System — Configurable warn → mute → kick → tempban escalation
- 📊 Stats Tracking — See the most triggered words, top offenders, and block history
- 🔔 Staff Alerts — Notify staff in-game whenever a filter is triggered
- 📝 Detailed Logging — Every blocked message is logged to a dedicated log file
📋 Commands
All commands use the /cf alias.
| Command | Description |
|---|---|
/cf reload |
Reload the config and all filter lists |
/cf info |
Show plugin info and loaded filter counts |
/cf stats [player] |
View top triggered words and block history |
/cf addword <word> |
Add a word to the filter at runtime |
/cf removeword <word> |
Remove a word from the filter at runtime |
/cf check <message> |
Test a message against all active filters |
/cf history <player> |
View a player's full offense history |
/cf pardon <player> |
Reset a player's offense count |
/cf unmute <player> |
Manually unmute a muted player |
🔐 Permissions
| Permission | Description | Default |
|---|---|---|
christianfilter.admin |
Access to all /cf commands |
op |
christianfilter.notify |
Receive in-game filter alerts | op |
christianfilter.bypass.words |
Bypass the word filter | false |
christianfilter.bypass.regex |
Bypass the regex filter | false |
christianfilter.bypass.links |
Bypass the URL & IP filter | false |
christianfilter.bypass.all |
Bypass all filters (includes all bypass nodes) | op |
🛠️ Configuration
ChristianFilter is fully configurable via config.yml. Control punishments, filter behavior,
messages, blocked words, regex patterns, and domain blacklists/whitelists — all in one place.
Run /cf reload to apply changes without restarting your server.
📦 Requirements
- Paper 1.21.1+
- Java 21+
Keep your server clean. Keep your community safe.
