ChatSentinel
github.com
- Self-hosted
What ChatSentinel is
ChatSentinel is a free, open-source moderation plugin for Minecraft Paper servers. It checks messages through a local trie filter, with optional moderation API and LLM review layers that are disabled by default. The local filter can load word lists for 28 languages and normalize leet-speak or expand abbreviations. Moderation can cover chat, private messages, signs, books, and anvil renames. Flagged content can be blocked or masked, with configurable warnings, mutes, and staff alerts. Layer 1 uses an OpenAI-compatible moderation endpoint; Layer 2 supports compatible chat-completions providers including Ollama, LM Studio, vLLM, Azure OpenAI, Together, and Groq. The local setup works without API keys. SQLite is the default database, with MySQL and PostgreSQL also supported. An optional PlaceholderAPI integration exposes moderation information as placeholders. The README lists Java 21 or later and a Paper server as requirements. It describes a fail-open pipeline: if APIs are unreachable, local filtering stays active, with a configurable timeout before messages pass through.
Who it suits
ChatSentinel suits Minecraft Paper server operators who need configurable chat and content moderation. Its local filter can run without API keys, while optional API layers are available for operators who want them.
Good to know, and what to watch
- Local filter supports word lists for 28 languages
- Moderates signs, books, and anvil renames
- Flagged messages can be blocked or masked
- Optional moderation layers work with several providers
- Supports SQLite, MySQL, and PostgreSQL
- Requires Java 21 or later and a Paper server
- No staff web panel is listed
The verdict
ChatSentinel offers local filtering with optional API-based review and moderation controls across several Minecraft message types. Server operators should check the listed Java and Paper requirements before using it.
What the maker publishes
- API compatibility
- Layer 1 uses the OpenAI Moderation API by default, while Layer 2 supports OpenAI-compatible chat-completions endpoints including Ollama, LM Studio, vLLM, Azure OpenAI, Together, and Groq. source
- API providers
- Layer 1 uses an OpenAI-compatible moderation endpoint; Layer 2 supports OpenAI-compatible chat-completions providers including Ollama, LM Studio, vLLM, Azure OpenAI, Together, and Groq. source
- Database options
- SQLite is the default storage backend, with MySQL and PostgreSQL also supported. source
- Data retention
- Recent messages used for LLM context are held in memory and discarded when the server restarts; moderation logs can be purged by retention window. source
- Enforcement
- Flagged messages can be blocked or masked, and configurable escalation can warn, mute, or alert staff. source
- Enforcement
- Flagged messages can be blocked or masked, and configurable escalation can warn players, mute them, or alert staff. source
- Failure behavior
- The README describes a fail-open pipeline where the local filter remains active if moderation APIs are unreachable, with a configurable timeout before messages are allowed through. source
- Failure behavior
- The documented default is a 3000 ms timeout with fail-open enabled, leaving the local filter active if moderation APIs are unreachable. source
- Integration
- If PlaceholderAPI is installed, ChatSentinel registers placeholders for player moderation scores, mute status, remaining mute time, offense count, and time since last offense. source
- Integrations
- PlaceholderAPI is an optional integration that exposes player moderation scores, mute status, and offense information as placeholders. source
- Language filtering
- The local filter loads word lists for 28 languages and supports leet-speak normalization and abbreviation expansion. source
- Language filtering
- The local filter loads word lists for 28 LDNOOBW languages and normalizes leet-speak before scanning. source
- Local operation
- Layers 1 and 2 are disabled by default, so the plugin starts with its local filter and does not require API keys for that setup. source
- Moderated content
- It can moderate chat, whispers, signs, books, and anvil renames. source
- Moderation pipeline
- Messages pass through a local trie filter, an optional moderation API, and optional LLM review. source
- Moderation pipeline
- It checks messages with a local trie filter, a moderation API, and an LLM review layer. source
- Optional APIs
- Layers 1 and 2 are disabled by default, and the local filter works without API keys. source
- Other content
- The plugin can moderate signs, books, anvil renames, and private messages in addition to chat. source
- Purpose
- ChatSentinel is a multi-layer chat moderation plugin for Minecraft Paper servers. source
- Purpose
- ChatSentinel is a multi-layered chat moderation plugin for Minecraft Paper servers. source
- Requirements
- The README lists Java 21 or later and a Paper server as requirements, and identifies Paper API 1.21.11 in its build dependencies. source
- Storage
- SQLite is the default database, with optional MySQL and PostgreSQL backends. source
- Support
- The README directs users to report issues through the repository’s GitHub Issues page and asks them to include reproduction steps, version details, and relevant redacted logs. source
- Telemetry
- The README says bStats sends anonymous aggregate usage metrics and does not transmit player data, messages, or API keys; its global setting is controlled through bStats configuration. source
Checked against the maker's pages on 4 Oct 2026.