ChatGuard 🛡️
Fully configurable chat filtering that actually gets out of your way.
Tired of chat plugins that are either too rigid or need five other plugins to do what one should? ChatGuard handles profanity, spam, link/IP advertising, and personal info leaks — all in one lightweight plugin, all fully configurable, no bloat.
✨ Features
- Profanity filter — catches swears and basic leetspeak dodges (
@,0,1substitutions won't save them) - Spam protection — blocks message flooding, excessive CAPS, and symbol spam (
!!!!!!,??????) - Link/IP blocking — stop other servers getting advertised in your chat, with a whitelist for your own Discord/links
- Personal info detection — auto-catches phone numbers and emails before they hit public chat
- Pick your punishment — every category gets its own mode: block, censor, or warn-then-block. Mix and match however you want.
- LuckPerms-ready bypass system —
chatguard.bypassfor full bypass, or granular per-category bypasses (chatguard.bypass.links,.profanity,.spam,.personalinfo) so staff can post links without dodging the swear filter - Live reload —
/chatguard reloadapplies config changes with zero restart - Toggle categories on the fly —
/chatguard toggle <category>for quick moderation calls
⚙️ Fully Configurable
Every word, pattern, threshold, and message lives in config.yml — no code editing, no recompiling. Comes with solid defaults out of the box, but built to be tuned to your server's exact rules.
🔑 Permissions
| Permission | Description |
|---|---|
chatguard.admin |
Access to admin commands |
chatguard.bypass |
Bypass all filters |
chatguard.bypass.<category> |
Bypass one specific filter category |
📋 Requirements
- Paper 1.19+
- Java 17+
Found a bug or have a feature request? Send a notice to me at nope@voidhosting.vip — actively maintained.
