ChristianFilter

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

- 🔤 Detailed Logging — Block specific words with wildcard support and leet-speak normalization - 🔍 Detailed Logging — Advanced pattern matching with auto-generated regex from plain words - 🔗 Detailed Logging — Block links and raw IP addresses, with domain whitelisting - ⚠️ Detailed Logging — Configurable warn → mute → kick → tempban escalation - 📊 Detailed Logging — See the most triggered words, top offenders, and block history - 🔔 Detailed Logging — 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.*