ChatGuardian

## **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 <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> View 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 – 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.