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

1. Drop the plugin JAR file into your server’s /plugins folder.
   
   
2. Start the server once to generate configuration files.
   
   
3. Edit config.yml to enable MySQL and adjust plugin behavior.
   
   
4. (Optional) Edit messages.yml and blacklist.yml for custom wording and blacklisted terms.
   
   
5. 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

Command Description
/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.