BlockSwear: The Ultimate Chat Filter Plugin for Minecraft Servers
Running a Minecraft server is a rewarding experience, but maintaining a friendly and clean chat environment can be a constant challenge. Trolls, spammers, and players who ignore the rules often disrupt the community with offensive language, repeated messages, or unwanted advertisements. That's where BlockSwear comes in — an advanced chat filter plugin designed to automatically detect and block swear words, spam, and other unwanted content in real time. Whether you run a small private server or a large public network, BlockSwear gives you the tools to enforce your chat rules effortlessly.
Key Features of BlockSwear
BlockSwear isn't just a simple word blacklist. It offers a comprehensive set of moderation tools that go beyond basic filtering. Here's what makes it stand out:
- Swear Blocking: Splits sentences, strips special characters like #!#, and checks each word against a customizable list. Any match is instantly blocked.
- Spam Prevention: Detects both repeated messages and character spam (like "aaaaaa"), keeping the chat readable.
- Advertisement Detection: Automatically catches and blocks common ad patterns, protecting your server from unwanted promotions.
- Warning System: Players accumulate warnings for each violation. When they hit the maximum (configurable), the plugin can kick them or run a custom command, such as a temporary ban.
- Sign Scanning: The filter also checks text on signs, preventing inappropriate messages from appearing in the world.
- OP Notifications: Only operators receive alerts when a player violates the rules, so your staff can stay informed without spamming regular users.
- Bypass Permissions: You can whitelist specific players (by UUID) or server owners so they never get filtered, perfect for trusted moderators.
- Easy Word Management: Add or remove blocked words directly from the swearwords.txt file, or use in-game commands to update the list on the fly.
- Automatic Updates: The plugin can check for and install new versions automatically, keeping your filter up to date without manual effort.
While BlockSwear focuses on server-side chat moderation, many server owners also enjoy enhancing their personal gameplay with client-side mods. If you're exploring that side of Minecraft, you can easily install mods via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. It's a great companion tool for any player who wants a customized experience without the hassle of manual installation.
Configuring BlockSwear for Your Server
BlockSwear is highly customizable, allowing you to tailor every message and rule to fit your server's tone. The configuration is split into two files: config.yml and swearwords.txt.
config.yml Settings
The main configuration file lets you adjust the plugin's behavior and messages. You can change the color-coded notifications using standard Minecraft color codes (like &6 for gold). Key settings include:
- onIllegal: The message shown when a blocked word is detected. The placeholder %word% shows the offending term.
- onRepeat: Warns players when their message is too similar to a previous one.
- onAdvertisement: Displays when an ad is blocked.
- onWarning: Informs the player how many warnings they've accumulated (e.g., %warnings%/5).
- onKick: The kick message sent when the warning limit is reached.
- onSpam: Alerts when character or repeat spam is detected.
- onMaxWarnings: A command to execute when a player hits the maximum warnings. For example,
tempban %player% 5m Tempbanned for saying too many illegal words/characters. - maxSwearWarnings: How many warnings before the action is triggered (default 3).
- bypass: A list of player UUIDs who are exempt from all filtering.
- CheckForUpdates and AutoUpdating: Enable or disable automatic updates.
Managing the Swear Word List
The swearwords.txt file is where you list every term you want blocked. Simply add one word or phrase per line. Because the plugin strips special characters before checking, you don't need to worry about players using symbols to bypass the filter. After editing the file, the plugin automatically reloads the configuration — no need to restart the server.
Installation and Compatibility
BlockSwear is designed for Bukkit, Spigot, and Paper servers. It requires Java 6 or higher and works on Linux, Mac, and Windows. To install, download the plugin JAR from your preferred source (always use trusted sites) and place it in your server's plugins folder. Restart the server, and BlockSwear will generate the default configuration files. From there, you can tweak the settings to your liking.
Plugin Metrics and Privacy
BlockSwear uses Plugin Metrics to collect anonymous usage data. This includes your plugin version, Java version, operating system, server country, system cores, architecture, server software (Spigot, Bukkit, etc.), and whether online mode is enabled. No personal information is ever transmitted. The data helps the developer improve performance and understand how the plugin is used. If you prefer to opt out, simply set useMetrics to false in the config. You can view the aggregated statistics on the public metrics page.
Why BlockSwear Is a Must-Have for Server Admins
A clean chat is essential for a positive player experience. With BlockSwear, you can automate moderation, reduce staff workload, and create a welcoming environment without constant manual intervention. The combination of swear filtering, spam detection, and sign scanning covers all the common pain points of public servers. The flexible warning system and custom commands let you escalate punishments smoothly, while the bypass feature ensures your staff never gets caught in the filter.
Whether you're running a survival world, a minigame hub, or a roleplay server, BlockSwear adapts to your needs. Its lightweight design and automatic updates mean you can set it and forget it, trusting that your chat stays under control. Give your community the safe space they deserve — install BlockSwear today and take the first step toward hassle-free chat moderation.