Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

ChatSentinel

github.com

  • Self-hosted
6.0 Club score Visit github.com

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.