ChatGuardian – Powerful Minecraft Chat Moderation
ChatGuardian is a modern, robust, and network-ready Minecraft chat moderation plugin designed for both single servers and large multi-server networks. Whether you're running a small community or an expansive network, ChatGuardian helps keep your chat clean, fair, and safe.
✨ Key Features
Advanced Leetspeak & Fuzzy Word Detection Detects even obfuscated or disguised violations using smart text-matching algorithms.
Global Violation Tracking via MySQL Synchronize warnings, kicks, and bans across your entire network using a shared database.
Flexible & Configurable Punishment System Customize thresholds for warnings, kicks, tempbans, and permanent bans to suit your community.
Real-Time Discord Webhook Integration Receive alerts directly in your Discord server for immediate moderator action.
Live Blacklist Management Add or remove forbidden words on the fly without restarting your server.
Fully Customizable Messages & Multi-language Support Personalize every player-facing message for a seamless and localized experience.
Installation & Setup
Drop the plugin JAR file into your server's /plugins folder.
Start the server once to generate configuration files.
Edit config.yml to enable MySQL and adjust plugin behavior.
(Optional) Edit messages.yml and blacklist.yml for custom wording and blacklisted terms.
Restart your server to apply changes.
️ MySQL Setup (Global Violation Tracking)
Enable and configure MySQL in config.yml:
mysql:
enabled: true
host: localhost
port: 3306
database: chatguardian
username: youruser
password: yourpass
All violations and bans will be tracked and shared across all servers using this database.
Blacklist & Word Filtering
Add blacklisted words in blacklist.yml under the words: list.
Smart leetspeak and fuzzy matching ensure maximum protection against disguised language.
⚖️ Punishment Configuration
Customize punishment limits and durations in config.yml:
punishments:
enabled: true
warn-limit: 1
kick-limit: 2
tempban-limit: 3
tempban-time: 1h
Discord Integration
Set your Discord webhook URLs in config.yml to receive violation alerts in real time.
You can also set a support Discord invite link, which will be shown in ban/kick messages.
Commands
/cg addword Add a word to the blacklist
/cg delword Remove a word from the blacklist
/cg listwords List all blacklisted words
/cg reload Reload the plugin configuration
/cg violations View a player's violations (MySQL only)
/cg clearviolations Clear a player's violations (MySQL only)
/cg bans List all active bans (MySQL only)
/cg unban Unban a player (MySQL only)
️ Permissions
chatguardian.admin – Grants access to all admin commands
chatguardian.bypass – Exempts a user from chat checks
Customization
Modify messages.yml to change all plugin messages.
Manage your blacklist in blacklist.yml.
Set your Discord invite in config.yml under support-discord.
ChatGuardian is the ultimate tool to maintain respectful and safe communication in your
Minecraft server or network—no matter how large your player base grows.
