# ChatSentinel<\/p>\n
**Production-ready chat protection for Spigot, Paper, Folia-aware Bukkit servers, BungeeCord, and Velocity networks.**<\/p>\n
ChatSentinel is a free, open-source Minecraft chat moderation plugin built for server owners who need practical chat protection without outdated filters, heavy regex mistakes, or fragile proxy behavior.<\/p>\n
It protects public chat and supported command messages against spam, flood, repeated messages, excessive caps, advertising, offensive language, syntax abuse, unsafe patterns, and custom blacklist rules. Staff get live alerts, Discord webhooks, SocialSpy modules, chat clear\/delete tools, module toggles, runtime regex additions, server mute, and multilingual messages.<\/p>\n
**Bukkit \/ Spigot \/ Paper \/ Folia-aware backend** \u2022 **BungeeCord** \u2022 **Velocity** \u2022 **Regex filters** \u2022 **Discord webhooks** \u2022 **Redis alert sync** \u2022 **SocialSpy**<\/p>\n
—<\/p>\n
## What is ChatSentinel?<\/p>\n
ChatSentinel is a serious chat-filtering core for Minecraft servers and networks.<\/p>\n
Most old chat filter plugins only check a few words, break on bypasses, or stop being maintained. ChatSentinel is built around configurable modules, source-aware regex filter files, per-module actions, staff visibility, proxy support, and safe defaults for real production communities.<\/p>\n
Use it for SMP servers, practice servers, PvP networks, survival networks, proxy networks, and any server where chat needs to stay readable, safe, and controllable.<\/p>\n
—<\/p>\n
## Core Chat Protection<\/p>\n
– **Blacklist filtering** \u2014 block offensive language, advertisements, hacked-client spam, custom rules, and security payloads.
\n– **Folder-based filter modules** \u2014 default rules are split into `security`, `advertisement`, `offense`, `client`, and `user` modules.
\n– **Regex support** \u2014 advanced patterns are compiled from YAML filter files with compile reports and admin notifications.
\n– **Whitelist support** \u2014 allow trusted expressions and proxy server names where filtering should not apply.
\n– **Command checking** \u2014 selected commands such as `\/msg`, `\/reply`, `\/tell`, `\/broadcast`, and `\/global` can be checked like normal chat.
\n– **Syntax protection** \u2014 block namespaced command syntax such as `minecraft:me` unless whitelisted.
\n– **Allowed-character filtering** \u2014 replace or block characters outside a configured regex.
\n– **Player-name sanitization** \u2014 ignore online player names during moderation when configured.<\/p>\n
—<\/p>\n
## Anti-Spam and Message Quality<\/p>\n
– **Cooldown module** \u2014 control normal chat, command cooldown, repeated message cooldown, and global repeat delay.
\n– **Flood module** \u2014 block or reduce repeated characters, oversized messages, and symbol spam.
\n– **Similarity module** \u2014 detect repeated similar messages using normalized text comparison.
\n– **Capitalization module** \u2014 correct excessive caps, optionally capitalize sentence starts, and ignore configured tokens such as `VIP` or `USA`.
\n– **Auto-correction module** \u2014 correct common misspellings without turning moderation into punishment.
\n– **No-move-chat module** \u2014 Bukkit backend protection that can require players to move before chatting.<\/p>\n
—<\/p>\n
## Blacklist System Built for Maintenance<\/p>\n
ChatSentinel does not force every rule into one giant config string.<\/p>\n
Default and custom rules live in structured YAML files under blacklist folders. Each file compiles into a source-aware filter, so staff alerts can include the source file, module, matched text, and original message.<\/p>\n
Built-in rule groups include:<\/p>\n
– **Security** \u2014 Log4Shell\/JNDI-style payload patterns.
\n– **Advertisement** \u2014 domains, spaced domains, IPv4 addresses, and port-style spam.
\n– **Offense** \u2014 English, Spanish, and Spanglish offensive-language patterns.
\n– **Client** \u2014 hacked-client spam signatures.
\n– **User** \u2014 your own custom rules.<\/p>\n
Each blacklist module can have its own enabled state, display name, warning behavior, webhook behavior, censorship behavior, fake-message mode, raw block mode, and punishment commands.<\/p>\n
—<\/p>\n
## Staff Visibility and Live Moderation<\/p>\n
– **Staff notifications** \u2014 alert online staff when a user triggers a module.
\n– **Spy alerts** \u2014 optional staff spy channel with file, module, matched text, and message context.
\n– **Discord webhooks** \u2014 send moderation events to Discord with configurable username, avatar, author, fields, colors, footer, and thumbnail.
\n– **Redis alert bus** \u2014 optionally publish and receive alerts across multiple plugin instances.
\n– **Self-test command** \u2014 verify command output, player messages, and warning delivery in-game.
\n– **Compile reports** \u2014 invalid regex rules are reported instead of silently breaking protection.<\/p>\n
—<\/p>\n
## SocialSpy System<\/p>\n
ChatSentinel includes a configurable SocialSpy stack for staff oversight.<\/p>\n
Supported SocialSpy modules:<\/p>\n
– **Private messages** \u2014 `\/msg`, `\/tell`, `\/w`, `\/reply`, `\/r`, `\/dm`, and configurable patterns.
\n– **Signs** \u2014 sign placement\/edit content.
\n– **Books** \u2014 book titles and content snippets.
\n– **Anvils** \u2014 item rename changes.
\n– **Commands** \u2014 general command visibility, with sensitive authentication commands ignored by default.<\/p>\n
SocialSpy supports per-module permissions, default-enabled states, content trimming, ignored command roots, self-include control, and a Bukkit `\/socialspy menu` interface.<\/p>\n
—<\/p>\n
## Chat Snapshot, Clear, and Delete Tools<\/p>\n
ChatSentinel keeps a recent visible-chat snapshot so staff can clean chat without relying only on blank-line spam.<\/p>\n
– **Clear chat** \u2014 send a clear payload to non-bypass players.
\n– **Bypass-aware clear** \u2014 staff with bypass permission keep visibility.
\n– **Recent chat list** \u2014 inspect recent tracked messages.
\n– **Delete chat entry** \u2014 mark a message deleted and replay visible chat.
\n– **Live delete click** \u2014 on Bukkit, staff can receive a clickable delete prefix beside live chat lines.<\/p>\n
This gives staff faster moderation during raids, advertisement spam, or public chat incidents.<\/p>\n
—<\/p>\n
## Server Mute<\/p>\n
Server-wide mute is built in.<\/p>\n
– Toggle server mute from command.
\n– Define bypass permission.
\n– Persist mute state in config.
\n– Broadcast configurable mute\/unmute messages.
\n– Use aliases such as `\/servermute`, `\/muteall`, and `\/muteserver` where supported.<\/p>\n
—<\/p>\n
## Network and Platform Support<\/p>\n
ChatSentinel supports multiple deployment styles:<\/p>\n
– **Bukkit-family backend mode** for Spigot, Paper, Purpur, and Folia-aware servers.
\n– **BungeeCord proxy mode** for network-wide chat moderation.
\n– **Velocity proxy mode** with configurable signed-chat behavior.
\n– **Redis alert sync** for multi-instance staff notifications.
\n– **Java 8 target** for broad hosting compatibility.<\/p>\n
Velocity signed-chat behavior is configurable. `legacy-deny` can block or modify chat, while `warn-only` keeps notifications, webhooks, and spy alerts without mutating signed-chat messages.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
Main command:<\/p>\n
– `\/chatsentinel help` \u2014 show available commands. Common aliases:<\/p>\n – `\/autocorrect`, `\/correction` Some aliases are platform-specific depending on Bukkit, BungeeCord, or Velocity command registration.<\/p>\n —<\/p>\n ## Permissions<\/p>\n Staff permissions:<\/p>\n – `chatsentinel.admin` \u2014 access to all staff commands. Bypass permissions:<\/p>\n – `chatsentinel.bypass` \u2014 global moderation bypass except excluded UX modules. SocialSpy permissions:<\/p>\n – `chatsentinel.socialspy` \u2014 use SocialSpy. —<\/p>\n ## Configuration Philosophy<\/p>\n Everything important is configurable.<\/p>\n – Module enable\/disable state. —<\/p>\n ## Why Choose ChatSentinel?<\/p>\n – **Not just a swear filter** \u2014 handles spam, flood, caps, similarity, syntax, ads, unsafe payloads, and command messages. —<\/p>\n ## Installation<\/p>\n 1. Stop your server or proxy. For proxy networks, install ChatSentinel where you want chat moderation to run. Use backend Bukkit mode when you need Bukkit-only features such as no-move-chat, sign\/book\/anvil listeners, or clickable live delete chat.<\/p>\n —<\/p>\n ## FAQ<\/p>\n **What kind of server is this for?**<\/p>\n SMP, survival, PvP, practice, factions-lite, proxy networks, and community servers that need configurable chat moderation.<\/p>\n **Does it support proxy networks?**<\/p>\n Yes. ChatSentinel includes BungeeCord and Velocity support.<\/p>\n **Does it support Bukkit backend servers?**<\/p>\n Yes. ChatSentinel includes Bukkit-family backend support and declares Folia support for Folia-aware runtime behavior.<\/p>\n **Can I add my own words or regex rules?**<\/p>\n Yes. Add rules in blacklist YAML files or use `\/chatsentinel regex add` for runtime additions.<\/p>\n **Can staff see what triggered a filter?**<\/p>\n Yes. Alerts can include source file, module, matched text, message, player, and server context.<\/p>\n **Can punishments be customized?**<\/p>\n Yes. Configure commands per module. This works with external punishment plugins such as LiteBans or AdvancedBan-style command systems.<\/p>\n **Does it require Discord or Redis?**<\/p>\n No. Discord webhooks and Redis alert sync are optional.<\/p>\n **Can users disable auto-correction?**<\/p>\n Yes. Players can use `\/autocorrect off` when the module is enabled.<\/p>\n —<\/p>\n ## Links<\/p>\n – **Discord:** https:\/\/discord.gg\/gF36AT3 —<\/p>\n **Run cleaner chat with a moderation core staff can actually control.**<\/p>\n SEO keywords: ChatSentinel, Minecraft chat filter, chat moderation plugin, Spigot chat filter, Paper chat filter, Bukkit chat filter, Folia chat plugin, BungeeCord chat filter, Velocity chat filter, Minecraft anti-spam, Minecraft swear filter, Minecraft advertisement blocker, Minecraft flood protection, Minecraft caps filter, SocialSpy plugin, Discord webhook moderation, Redis Minecraft plugin, regex chat filter, Minecraft server mute, chat clear plugin, Minecraft chat snapshot.<\/p>\n","protected":false},"excerpt":{"rendered":" Advanced AntiSwear\/AntiSpam System using Regular Expression for high customization.<\/p>\n","protected":false},"featured_media":38926,"template":"","meta":{"_minecraft_slug":"chatsentinel","_minecraft_project_id":"d1aRSTsI","_minecraft_author":"LinsaFTW","_minecraft_license":"MIT","_minecraft_downloads":765,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chatsentinel.zip","_minecraft_size_bytes":1688010,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T09:23:38.399333Z","_minecraft_date_created":"2025-08-31T21:35:58.237416Z","_minecraft_date_modified":"2026-05-11T01:17:28.156350Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chatsentinel","_minecraft_icon_attachment_id":38926,"_minecraft_imported_at":"2026-06-01T20:19:45+00:00","_minecraft_import_hash":"7c2a2043ae1c96c5325d4cdd9d796eeb","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,90,127,128,867,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-38925","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/chatsentinel status` \u2014 show module and filter status.
\n– `\/chatsentinel selftest` \u2014 test message and warning delivery.
\n– `\/chatsentinel reload` \u2014 reload config, messages, filters, and online-player cache.
\n– `\/chatsentinel clear [reason]` \u2014 clear visible chat for non-bypass players.
\n– `\/chatsentinel notify` \u2014 toggle moderation notifications.
\n– `\/chatsentinel spy` \u2014 toggle ChatSentinel spy alerts.
\n– `\/chatsentinel delete
\n– `\/chatsentinel module list|enable|disable|toggle
\n– `\/chatsentinel regex add
\n– `\/chatsentinel regex add
\n– `\/chatsentinel mutechat [on|off|toggle] [reason]` \u2014 mute or unmute server chat.
\n– `\/chatsentinel socialspy [module|status]` \u2014 toggle or inspect SocialSpy modules.
\n– `\/chatsentinel autocorrect [on|off|toggle]` \u2014 toggle personal auto-correction.<\/p>\n
\n– `\/servermute`, `\/muteall`, `\/muteserver`
\n– `\/socialspy`, `\/sspy`
\n– `\/deletechat
\n– `\/recentchats [limit]`<\/p>\n
\n– `chatsentinel.help` \u2014 use help\/status command surfaces.
\n– `chatsentinel.reload` \u2014 reload ChatSentinel.
\n– `chatsentinel.clear` \u2014 clear chat.
\n– `chatsentinel.notify` \u2014 toggle and receive moderation notifications.
\n– `chatsentinel.spy` \u2014 toggle ChatSentinel spy alerts.
\n– `chatsentinel.delete` \u2014 use chat snapshot delete\/list tools.
\n– `chatsentinel.module` \u2014 toggle modules live.
\n– `chatsentinel.regex.add` \u2014 add user regex rules.
\n– `chatsentinel.mute` \u2014 use server mute controls.<\/p>\n
\n– `chatsentinel.bypass.capitalization` \u2014 bypass capitalization correction.
\n– `chatsentinel.bypass.correction` \u2014 bypass auto-correction.
\n– `chatsentinel.clear.bypass` \u2014 bypass visual chat clear\/delete refresh.
\n– `chatsentinel.mute.bypass` \u2014 chat while server mute is active.<\/p>\n
\n– `chatsentinel.socialspy.messages` \u2014 receive private-message spy alerts.
\n– `chatsentinel.socialspy.signs` \u2014 receive sign spy alerts.
\n– `chatsentinel.socialspy.books` \u2014 receive book spy alerts.
\n– `chatsentinel.socialspy.anvils` \u2014 receive anvil rename spy alerts.
\n– `chatsentinel.socialspy.commands` \u2014 receive command spy alerts.<\/p>\n
\n– Filter folders and regex files.
\n– Per-module display names.
\n– Warnings and warning thresholds.
\n– Punishment commands.
\n– Censorship, fake-message, hide, and raw-block behavior.
\n– Cooldown timings.
\n– Flood regex.
\n– Similarity normalization rules.
\n– Capitalization behavior and whitelisted tokens.
\n– Auto-correction replacements and ignored words.
\n– Server mute state and bypass.
\n– No-move-chat distance.
\n– SocialSpy modules, formats, permissions, trimming, and ignored commands.
\n– Chat snapshot history, clear lines, live delete prefix, hover, and command.
\n– Discord webhook payload style.
\n– Redis channel, URI, instance ID, publish, and receive behavior.
\n– Multilingual messages.<\/p>\n
\n– **Built for staff visibility** \u2014 notifications, spy alerts, Discord webhooks, SocialSpy, and chat snapshot tools.
\n– **Built for real networks** \u2014 Bukkit backend mode, BungeeCord mode, Velocity mode, and optional Redis alert sync.
\n– **Built for maintainability** \u2014 source-aware YAML filter files instead of one unmanageable blacklist.
\n– **Built for control** \u2014 per-module actions, runtime toggles, regex additions, bypasses, permissions, and reload workflow.
\n– **Built for production use** \u2014 compile reports, safe defaults, Folia-aware backend scheduling, and signed-chat policy controls for Velocity.<\/p>\n
\n2. Download the ChatSentinel `.jar`.
\n3. Place it in the correct `plugins` folder.
\n4. Start the server or proxy once to generate files.
\n5. Edit `config.yml`, `messages.yml`, `whitelist.yml`, and blacklist filter files.
\n6. Run `\/chatsentinel reload` after configuration changes.<\/p>\n
\n– **Donate:** https:\/\/paypal.me\/LinsaFTW<\/p>\n