ChatSentinel

# ChatSentinel **Production-ready chat protection for Spigot, Paper, Folia-aware Bukkit servers, BungeeCord, and Velocity networks.** 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. 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. **Bukkit / Spigot / Paper / Folia-aware backend** • **BungeeCord** • **Velocity** • **Regex filters** • **Discord webhooks** • **Redis alert sync** • **SocialSpy** --- ## What is ChatSentinel? ChatSentinel is a serious chat-filtering core for Minecraft servers and networks. 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. 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. --- ## Core Chat Protection - **Blacklist filtering** — block offensive language, advertisements, hacked-client spam, custom rules, and security payloads. - **Folder-based filter modules** — default rules are split into `security`, `advertisement`, `offense`, `client`, and `user` modules. - **Regex support** — advanced patterns are compiled from YAML filter files with compile reports and admin notifications. - **Whitelist support** — allow trusted expressions and proxy server names where filtering should not apply. - **Command checking** — selected commands such as `/msg`, `/reply`, `/tell`, `/broadcast`, and `/global` can be checked like normal chat. - **Syntax protection** — block namespaced command syntax such as `minecraft:me` unless whitelisted. - **Allowed-character filtering** — replace or block characters outside a configured regex. - **Player-name sanitization** — ignore online player names during moderation when configured. --- ## Anti-Spam and Message Quality - **Cooldown module** — control normal chat, command cooldown, repeated message cooldown, and global repeat delay. - **Flood module** — block or reduce repeated characters, oversized messages, and symbol spam. - **Similarity module** — detect repeated similar messages using normalized text comparison. - **Capitalization module** — correct excessive caps, optionally capitalize sentence starts, and ignore configured tokens such as `VIP` or `USA`. - **Auto-correction module** — correct common misspellings without turning moderation into punishment. - **No-move-chat module** — Bukkit backend protection that can require players to move before chatting. --- ## Blacklist System Built for Maintenance ChatSentinel does not force every rule into one giant config string. 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. Built-in rule groups include: - **Security** — Log4Shell/JNDI-style payload patterns. - **Advertisement** — domains, spaced domains, IPv4 addresses, and port-style spam. - **Offense** — English, Spanish, and Spanglish offensive-language patterns. - **Client** — hacked-client spam signatures. - **User** — your own custom rules. 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. --- ## Staff Visibility and Live Moderation - **Staff notifications** — alert online staff when a user triggers a module. - **Spy alerts** — optional staff spy channel with file, module, matched text, and message context. - **Discord webhooks** — send moderation events to Discord with configurable username, avatar, author, fields, colors, footer, and thumbnail. - **Redis alert bus** — optionally publish and receive alerts across multiple plugin instances. - **Self-test command** — verify command output, player messages, and warning delivery in-game. - **Compile reports** — invalid regex rules are reported instead of silently breaking protection. --- ## SocialSpy System ChatSentinel includes a configurable SocialSpy stack for staff oversight. Supported SocialSpy modules: - **Private messages** — `/msg`, `/tell`, `/w`, `/reply`, `/r`, `/dm`, and configurable patterns. - **Signs** — sign placement/edit content. - **Books** — book titles and content snippets. - **Anvils** — item rename changes. - **Commands** — general command visibility, w