MessageFilter — Clean Chat for Your Minecraft Server

MessageFilter: Full Chat Control for Your Minecraft Server

Every Minecraft server administrator knows the struggle: chat quickly becomes a chaotic mess. Between economy alerts, protection plugin warnings, and minigame announcements, players are bombarded with messages they simply do not need. Some want to silence those repetitive login notifications, others dream of translating English-only plugin messages into their native language, and many just need a way to throttle how often the same phrase can appear. This is exactly where MessageFilter steps in, offering a lightweight Bukkit plugin that transforms chat chaos into a streamlined, orderly system.

Why Your Server Needs This Chat Overhaul

Picture this scenario: you have a plugin that broadcasts economy status updates every five seconds. Or perhaps another mod spams "You can't build here!" every time a player tries to break a block in a protected region. The result is frustration and a chat feed that looks like a digital landfill. MessageFilter tackles these issues through three core mechanisms: message suppression, text replacement, and cooldown configuration. Instead of editing configuration files across dozens of plugins, all your rules live in one central location, making management a breeze.

The Core Toolkit: What MessageFilter Brings to the Table

The plugin is packed with features designed to give you total control: - **Message Hiding**: Permanently remove unwanted lines from chat, effectively silencing spam from any source. - **Text Replacement**: Act as a universal translator for plugins lacking built-in localization, converting messages to another language or rewording them entirely. - **Cooldown Management**: Limit how frequently a specific message can appear. For instance, an annoying warning can be set to show only once every 30 seconds. - **Flexible Comparison Methods**: Choose from exact match, substring search, string start/end checks, and full regular expressions (RegEx) for complex patterns. All rules are stored in YAML files within the `MessageFilter/rules` folder. You can edit them manually or manage everything through in-game commands, allowing the plugin to adapt to your preferred administrative style.

How MessageFilter Rules Actually Work

Each rule is built on several parameters: the comparison type, the incoming message mask, the replacement text, and the cooldown duration. The plugin intercepts every message before it reaches the chat, checks it against your active rules, and modifies the output accordingly. Players only ever see the processed, final text. There are five distinct comparison types available: - **EQUAL**: Case-insensitive matching. "Aaaa Bbbb" and "aaaa bbbb" are treated as identical. - **CONTAINS**: Checks if the message includes a specified substring. - **START**: The message must begin with a given pattern. - **END**: The message must conclude with a specified string. - **REGEX**: Harness the power of regular expressions for intricate patterns. When crafting replacement masks, you can use placeholders like `%word1%`, `%word2%`, and so on. These automatically pull the corresponding words from the original message, which is incredibly useful for translations where you need to preserve parts of the source text.

Building Rules: Commands and Manual Configuration

The primary command is `/msgfilter`, with aliases `/mfilter` and `/filter`. This lets you add, modify, and delete rules directly in-game. For example: - `/msgfilter add newrule` creates a rule with the identifier `newrule`. - `/msgfilter set newrule type EQUAL` assigns the comparison type. - `/msgfilter set newrule input &3[RP] &cThis place is protected!` defines the incoming mask, complete with color codes. - `/msgfilter set newrule output &6Здесь нельзя ломать и строить!` sets the Russian replacement text. For bulk message collection, the `/msgfilter save` command is invaluable. It logs incoming strings to a file, perfect for analyzing chat logs or rapidly building rules based on real-world spam patterns. Manual YAML editing offers complete control. Here is a sample structure: roadprotector: type: EQUAL message-mask: '&3[RP] &cThis place is protected!' replace-to: '&6Здесь нельзя ломать и строить!' 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 RoadProtector plugin message, the second completely hides player join notifications, and the third limits a building restriction warning to once every five seconds.

Installation, Dependencies, and Testing

MessageFilter requires ProtocolLib, a popular library for packet manipulation. Without it, the plugin cannot intercept messages. To verify everything is working, use the `/msgfilter test` command. If you see "MessageFilter test failed!", you likely need to update or install ProtocolLib. The plugin also features an automatic update checker that contacts dev.bukkit.org every hour. You can disable this by setting `version-check: false` in your `config.yml`. Regarding compatibility, this tool is designed for Bukkit-based servers, supporting a wide range of Minecraft versions. The plugin is lightweight and works seamlessly alongside other server-side modifications.

Permissions and Access Control

- `messagefilter.config` grants access to rule management commands. - `messagefilter.test` allows players to run the test on login.

Final Thoughts: A Cleaner Chat Awaits

MessageFilter is an essential tool for administrators who value order and want to provide players with a clear, understandable communication interface. With flexible rules, RegEx support, cooldowns, and translation capabilities, it is a universal solution to chat management. Setup requires no deep programming knowledge: a few commands or a quick YAML edit, and your server will communicate exactly how you want it to. If you are ready to experience a spam-free chat environment, you can download MessageFilter: Full Chat Control for Your Minecraft Server and see the difference immediately. For those seeking guidance, a quick search on how to install will reveal straightforward steps to get this powerful tool running on your server. MessageFilter: Full Chat Control for Your Minecraft Server for Minecraft is the definitive answer to chat clutter, and once you try it, you will wonder how you ever managed without it.