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.