ChatManager

Overview

ChatManager is a lightweight Paper 1.21.x chat moderation plugin designed to keep your server chat clean and rule-friendly. It blocks inappropriate messages, tracks player violations with a strike system, and automatically applies punishments when players repeatedly break the rules.

Main Features

Blocked Words Filter
Detects words from a configurable blacklist in config.yml
Suppresses messages containing blocked words (the message will not appear in chat)
Optional player notification message when a message is blocked
Fully configurable word list (add/remove words anytime)

Strike System (Violations)

Adds a strike when a player triggers the blocked-words filter (configurable)
Configurable maximum strikes (e.g. 3 strikes)
Configurable strike reset timer (strikes reset after a period without violations)
Optional warning messages per strike level (e.g. 1/3, 2/3)
Automatic Punishments (Auto Mute)
When a player reaches the maximum strikes, ChatManager can automatically punish them
Default punishment: Auto-mute for a configurable duration
While muted, all chat messages from that player are completely blocked

Logging & Storage

Strikes are logged to plugins/ChatManager/strikes.yml with useful data:
player (player name)
id (unique strike ID)
words (the message that caused the strike)
punish-duration (mute duration when punished)
Mutes are stored in plugins/ChatManager/mutes.yml
Configuration
Everything is customizable in plugins/ChatManager/config.yml, including:

Blocked word list

Strike amount / reset time
Mute duration
Player messages (blocked message, strike message, muted message)
Compatibility
Server Software: Paper
Minecraft Version: 1.21.x
Java: Recommended Java 21

Installation

Download the plugin .jar
Place it into your server’s plugins/ folder
Start/restart the server
Edit plugins/ChatManager/config.yml to your needs