MessageFilter: Full Chat Control for Your Minecraft Server
Running a Minecraft server means juggling dozens of plugins, each with its own chat output. Economy alerts, protection warnings, minigame announcements — they all pile up into an unreadable mess. Players miss important messages because they are buried under spam, and administrators waste time editing individual plugin configs to tone things down. MessageFilter: Full Chat Control for Your Minecraft Server solves this by acting as a central filtering layer for everything that appears in chat.
This lightweight Bukkit plugin intercepts messages before they reach players, applies your custom rules, and then displays the cleaned result. Instead of hunting through ten different configuration files, you define all your filtering logic in one place. Whether you want to remove a message entirely, rephrase it, or limit how often it appears, MessageFilter handles it with minimal overhead.
Core Capabilities of the Plugin
MessageFilter provides three primary functions that cover the vast majority of chat management needs on any server:
- Message hiding — Permanently suppress unwanted lines from any plugin. If a protection mod spams "You cannot build here" every time a player tries to place a block in a claimed region, you can make that message disappear completely.
- Text replacement — Rewrite messages into a different language or change their wording entirely. This effectively turns MessageFilter into a localization layer for plugins that lack built-in translation support.
- Cooldown enforcement — Limit how frequently a specific message can appear. An annoying economy status update that fires every five seconds can be throttled to once per minute, keeping the chat readable without losing the information entirely.
Beyond these three actions, the plugin offers flexible matching methods. You can filter based on exact equality, substring containment, prefix or suffix matching, or full regular expressions. This flexibility means you can target precise messages from specific plugins without accidentally catching similar text from other sources.
Understanding the Rule System
Every rule in MessageFilter consists of several parameters: the comparison type, the incoming message mask, the replacement text, and an optional cooldown duration. When a message is generated by any plugin, the filter checks it against all active rules and modifies the output accordingly. Players only ever see the final processed text.
The plugin supports five distinct comparison types:
- EQUAL — Case-insensitive exact match. "Hello World" and "hello world" are treated as identical.
- CONTAINS — Checks whether the message includes a specified substring anywhere within it.
- START — Requires the message to begin with the given pattern.
- END — Requires the message to end with the specified string.
- REGEX — Uses Java regular expressions for complex pattern matching, ideal for messages that vary in player names or numbers.
For replacement rules, you can use placeholders like %word1%, %word2%, and so on. These automatically capture the corresponding words from the original message and insert them into the replacement text. This is particularly useful when translating messages while preserving dynamic parts like player names or item names.
Configuration and Commands
All rules are stored in YAML files inside the MessageFilter/rules folder. You have two ways to manage them: edit the files manually or use in-game commands. The manual approach gives you full control and is ideal for bulk changes, while commands allow quick adjustments without restarting or reloading.
The primary command is /msgfilter with aliases /mfilter and /filter. Here is how a typical rule creation flow looks:
/msgfilter add newrule— Creates a rule with the identifier "newrule"./msgfilter set newrule type EQUAL— Sets the comparison type./msgfilter set newrule input &3[RP] &cThis place is protected!— Defines the incoming message mask, including color codes./msgfilter set newrule output &6This area is off-limits!— Sets the replacement text.
There is also a useful /msgfilter save command that captures incoming messages and writes them to a file. This is invaluable when you want to analyze what plugins are actually sending to chat or when building rules based on real spam patterns rather than guesses.
Manual YAML editing follows a straightforward structure. Here is an example that combines translation, removal, and cooldown rules:
roadprotector: type: EQUAL message-mask: '&3[RP] &cThis place is protected!' replace-to: '&6This area is off-limits!' cooldown-time: '' use-formating: true removejoin: type: REGEX message-mask: '\w+ joined the server\.' replace-to: '' cooldown-time: '' use-formating: false annoying: type: EQUAL message-mask: 'You can\'t build here!' replace-to: '' cooldown-time: '5s' use-formating: false
In this example, the first rule translates a protection plugin message, the second hides all join notifications using a regular expression, and the third suppresses a building restriction warning but allows it to appear once every five seconds.
Installation and Dependencies
MessageFilter requires ProtocolLib, a well-known library that handles packet manipulation. Without it, the plugin cannot intercept chat messages. After installing both, you can verify everything works with the /msgfilter test command. If the test fails, the usual culprit is a missing or outdated ProtocolLib version.
The plugin also includes an automatic update checker that contacts dev.bukkit.org once per hour. If you prefer to disable this, set version-check: false in the config.yml file.
For players who want to experiment with client-side chat modifications or interface tweaks, many useful mods can be installed through modern launchers that offer one-click mod installation. This complements server-side filtering by letting individual players customize their own experience further.
Permissions
Two permission nodes control access to the plugin's features:
messagefilter.config— Grants access to all rule management commands.messagefilter.test— Allows running the test command when a player joins.
Assign these to your staff members so they can manage chat filtering without granting full server console access.
Supported Versions and Loaders
MessageFilter is built for Bukkit-based servers and works across a range of Minecraft versions. The plugin is lightweight and does not interfere with other plugins, making it suitable for both small community servers and larger networks. As with any server plugin, check the specific version compatibility before installing to ensure smooth operation with your server software.
Practical Use Cases
The plugin shines in several common scenarios. On a survival server with grief protection, you can translate all protection plugin messages into the server's primary language, eliminating confusion for non-English-speaking players. On a minigame server, you can suppress the constant score updates that flood chat during matches. On a large public server, you can throttle repeated warning messages so they do not become background noise that players ignore.
To get started, download MessageFilter: Full Chat Control for Your Minecraft Server from a trusted source, place the JAR file into your plugins folder, and restart the server. Then use the commands or edit the YAML files to define your rules. The setup process takes minutes, and the result is a significantly cleaner chat experience for everyone.
MessageFilter: Full Chat Control for Your Minecraft Server for Minecraft is an essential tool for any administrator who values order and readability. Its combination of message hiding, text replacement, and cooldown enforcement covers all the common chat problems without requiring deep programming knowledge. Whether you manage a small private server or a large public network, this plugin gives you the control you need to keep communication clear and enjoyable.
By centralizing all chat filtering logic, reducing the need to edit multiple plugin configs, and offering both command-based and file-based configuration, MessageFilter is a practical and powerful addition to any server setup. The learning curve is minimal, the impact is immediate, and the benefits compound as you add more plugins over time.