What is ChatGuardian?
ChatGuardian is a modern, network-ready chat moderation plugin for Minecraft servers. It offers global violation tracking, advanced leetspeak detection, flexible punishments, Discord integration, and easy configuration—perfect for any server or network!
Features:
- Global violation tracking via MySQL
- Leetspeak and fuzzy word detection
- Configurable punishments: warn, kick, tempban, ban
- Discord webhook support for alerts
- Blacklist management (add/remove words live)
- Customizable messages and multi-language support
Installation:
- Place the plugin JAR in your /plugins folder.
- Start your server once to generate config files.
- Edit config.yml to enable MySQL and adjust settings.
- (Optional) Edit messages.yml and blacklist.yml for custom messages and forbidden words.
MySQL Setup (for global tracking):
Enable MySQL in config.yml:
mysql:
enabled: true
host: localhost
port: 3306
database: chatguardian
username: youruser
password: yourpass
All violations and bans will be tracked globally across all servers using the same database.
Blacklist:
Add forbidden words in blacklist.yml under the words: list.
Leetspeak and fuzzy matching are supported for maximum protection.
Punishments:
Configure thresholds and durations in config.yml:
punishments:
enabled: true
warn-limit: 1
kick-limit: 2
tempban-limit: 3
tempban-time: 1h
Discord Webhooks:
Set your Discord webhook URLs in config.yml to receive alerts for violations.
Commands:
- /cg addword <word> - Add a word to the blacklist
- /cg delword <word> - Remove a word from the blacklist
- /cg listwords - List all blacklisted words
- /cg reload - Reload the plugin configuration
- /cg violations <player> - Show a player's violations (MySQL only)
- /cg clearviolations <player> - Clear a player's violations (MySQL only)
- /cg bans - List all active bans (MySQL only)
- /cg unban <player> - Unban a player (MySQL only)
Permissions:
- chatguardian.admin - Access all admin commands
- chatguardian.bypass - Bypass all chat checks
Customization:
- Edit messages.yml for all player messages.
- Add forbidden words in blacklist.yml.
- Set your Discord invite in config.yml under support-discord.
Support:
Set your Discord invite link in config.yml under support-discord. Violators will see this link in their ban/kick messages.
Keep your Minecraft chat clean, fair, and safe—across all your servers!