Chat Guardian
Chat Guardian is an automatic chat moderation plugin. It catches shouting, spam, links, and banned words as players type, warns them, and escalates repeat offenders through mutes and kicks on its own. Staff get a live alert on every catch and a control panel to manage filters, mutes, and offender records without touching config files.
Built for: Survival, SMP, Skyblock, Factions, and any server that wants clean chat without a staff member watching it around the clock.
Four chat filters
Caps blocks messages that are mostly shouting. Spam blocks players sending too many messages too fast and blocks repeated duplicate messages. Links blocks web addresses and bare IP addresses, with a domain whitelist for the ones you want to allow. Words blocks any message containing a banned word from your own list. Each filter can block the message, award violation points, and be turned on or off independently.
Automatic escalation
Every catch adds violation points, and points slowly decay over time so a bad five minutes does not follow a player forever. When live points reach a tier, its action fires automatically: a short mute, a longer mute, or a kick. Tiers and their point thresholds are fully configurable, so you decide exactly how strict or lenient the ladder is.
Staff control panel
/chatguardian gui opens an inventory menu with one icon per filter. Click an icon to toggle that filter on or off instantly, no config editing or reload needed. A stats book in the same menu shows total messages caught, players caught, and active mutes at a glance.
Features
Commands
Permissions
Configuration
Every filter has its own settings: thresholds, points, and whether it blocks the message. The link filter has a domain whitelist and a list of blocked TLDs. The word filter takes your own banned word list. The escalation ladder's decay time, tiers, point thresholds, and actions are all editable, and so is how often offender data saves to disk. Run /chatguardian reload to apply changes with no restart.
Requirements
Installation
Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.
Chat Guardian is an automatic chat moderation plugin. It catches shouting, spam, links, and banned words as players type, warns them, and escalates repeat offenders through mutes and kicks on its own. Staff get a live alert on every catch and a control panel to manage filters, mutes, and offender records without touching config files.
Built for: Survival, SMP, Skyblock, Factions, and any server that wants clean chat without a staff member watching it around the clock.
Four chat filters
Caps blocks messages that are mostly shouting. Spam blocks players sending too many messages too fast and blocks repeated duplicate messages. Links blocks web addresses and bare IP addresses, with a domain whitelist for the ones you want to allow. Words blocks any message containing a banned word from your own list. Each filter can block the message, award violation points, and be turned on or off independently.
Automatic escalation
Every catch adds violation points, and points slowly decay over time so a bad five minutes does not follow a player forever. When live points reach a tier, its action fires automatically: a short mute, a longer mute, or a kick. Tiers and their point thresholds are fully configurable, so you decide exactly how strict or lenient the ladder is.
Staff control panel
/chatguardian gui opens an inventory menu with one icon per filter. Click an icon to toggle that filter on or off instantly, no config editing or reload needed. A stats book in the same menu shows total messages caught, players caught, and active mutes at a glance.
Features
- Four independent filters: caps, spam and duplicates, links and IPs, banned words.
- Per filter points, message blocking, and on/off toggle, all configurable.
- Decaying violation points so old catches stop counting after a while.
- Configurable escalation ladder with mute and kick tiers.
- Live staff chat alert on every catch, showing the filter, the player, the points, and the message.
- Admin GUI to toggle filters and view moderation totals with no commands.
- Per player record: live points, lifetime catches, and mute status.
- Manual mute, unmute, and clear commands for staff.
- Link filter domain whitelist for sites you want allowed.
- Persistent offender data and mutes that survive a server restart.
- Every option lives in config.yml with inline comments, and /chatguardian reload applies changes with no restart.
Commands
- /chatguardian (aliases /cg, /chatg) opens the control panel for staff.
- /chatguardian help lists every option.
- /chatguardian gui opens the control panel.
- /chatguardian check <player> shows a player's live points, lifetime catches, and mute status.
- /chatguardian clear <player> resets a player's points and lifts their mute.
- /chatguardian mute <player> [seconds] mutes a player. Leave the duration off for a permanent mute.
- /chatguardian unmute <player> lifts a mute.
- /chatguardian filter <name> <on|off> toggles a filter.
- /chatguardian stats shows moderation totals for staff, or your own record for regular players.
- /chatguardian reload reloads config.yml and messages.yml live.
Permissions
- chatguardian.use check your own record with /chatguardian stats. Default: everyone.
- chatguardian.admin open the panel and run mute, clear, filter, and reload commands. Default: operators.
- chatguardian.notify receive the staff alert on every catch. Default: operators.
- chatguardian.bypass skip every chat filter. Give this to trusted staff only. Default: nobody.
Configuration
Every filter has its own settings: thresholds, points, and whether it blocks the message. The link filter has a domain whitelist and a list of blocked TLDs. The word filter takes your own banned word list. The escalation ladder's decay time, tiers, point thresholds, and actions are all editable, and so is how often offender data saves to disk. Run /chatguardian reload to apply changes with no restart.
Requirements
- Minecraft 1.21 to 26.1.2.
- Paper, Spigot, or Bukkit.
- Java 21.
Installation
- Put ChatGuardian-1.0.0.jar in your plugins folder.
- Start the server once to create config.yml and messages.yml.
- Add your own banned words and adjust the escalation ladder in config.yml if you want.
- Run /chatguardian reload, or just restart.
Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.
