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 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.