- Home
- Minecraft Moderation Plugins
- ChatSentinel
ChatSentinel
What it is
ChatSentinel is a self-hosted moderation plugin for Minecraft Paper servers. Its local trie filter can load word lists for 28 languages and normalize leet-speak or expand abbreviations. The plugin can also review whispers, signs, books, and anvil renames, not just chat. Flagged messages can be blocked or masked, with configurable warnings, mutes, or staff alerts. Optional moderation API and LLM review layers are disabled by default, so the local filter can run without API keys. Layer 1 uses an OpenAI-compatible moderation endpoint; Layer 2 supports compatible chat-completions providers such as Ollama, LM Studio, vLLM, Azure OpenAI, Together, and Groq. SQLite is the default database, with MySQL and PostgreSQL alternatives. An optional PlaceholderAPI integration exposes moderation scores and related player status as placeholders. The README describes fail-open behavior: the local filter remains active when APIs are unreachable, with a configurable timeout before messages pass through. Recent messages for LLM context are held in memory and discarded on server restart; moderation logs can be purged by retention window. The README lists Java 21 or later and a Paper server as requirements.
For and against
For
- Local filter supports word lists for 28 languages.
- Can moderate signs, books, and private messages.
- Flagged content can be blocked or masked.
- SQLite, MySQL, and PostgreSQL storage options.
- Optional API layers are disabled by default.
Against
- Requires Java 21 or later.
- Requires a Paper server.
- No staff web panel.
The verdict
ChatSentinel offers local filtering with optional API and LLM review, plus configurable moderation actions. Administrators should account for its Paper and Java requirements and its fail-open behavior when APIs are unavailable.
Who it suits
ChatSentinel suits Minecraft Paper server administrators who want configurable moderation across chat and other player-submitted text. Its local filtering option fits setups that do not want to configure API keys.
On the record
- 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.github.com · read 4 Oct 2026
- 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.github.com · read 3 Oct 2026
- Database options
- SQLite is the default storage backend, with MySQL and PostgreSQL also supported.github.com · read 4 Oct 2026
- 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.github.com · read 3 Oct 2026
- Enforcement
- Flagged messages can be blocked or masked, and configurable escalation can warn players, mute them, or alert staff.github.com · read 4 Oct 2026
- Failure behavior
- The documented default is a 3000 ms timeout with fail-open enabled, leaving the local filter active if moderation APIs are unreachable.github.com · read 4 Oct 2026
- Integration
- If PlaceholderAPI is installed, ChatSentinel registers placeholders for player moderation scores, mute status, remaining mute time, offense count, and time since last offense.github.com · read 4 Oct 2026
- Integrations
- PlaceholderAPI is an optional integration that exposes player moderation scores, mute status, and offense information as placeholders.github.com · read 3 Oct 2026
- Language filtering
- The local filter loads word lists for 28 LDNOOBW languages and normalizes leet-speak before scanning.github.com · read 4 Oct 2026
- 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.github.com · read 4 Oct 2026
- Moderated content
- It can moderate chat, whispers, signs, books, and anvil renames.github.com · read 4 Oct 2026
- Moderation pipeline
- It checks messages with a local trie filter, a moderation API, and an LLM review layer.github.com · read 4 Oct 2026
- Optional APIs
- Layers 1 and 2 are disabled by default, and the local filter works without API keys.github.com · read 3 Oct 2026
- Other content
- The plugin can moderate signs, books, anvil renames, and private messages in addition to chat.github.com · read 3 Oct 2026
- Purpose
- ChatSentinel is a multi-layered chat moderation plugin for Minecraft Paper servers.github.com · read 4 Oct 2026
- 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.github.com · read 4 Oct 2026
- Storage
- SQLite is the default database, with optional MySQL and PostgreSQL backends.github.com · read 3 Oct 2026
- 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.github.com · read 4 Oct 2026
