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