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.