SwearFilter: Automatic Chat Moderation for Minecraft

Keeping Your Minecraft Server Chat Clean with SwearFilter

Managing a bustling Minecraft server is no small feat. You have to balance player creativity, community growth, and the ever-present challenge of maintaining a welcoming atmosphere. Profanity and toxic language can quickly sour the experience for everyone, driving away newcomers and creating extra work for your staff team. That is where a robust chat moderation tool becomes essential. SwearFilter is a powerful plugin designed to automate the entire process, letting you define exactly what language is unacceptable and how offenders should be handled.

What Makes SwearFilter Stand Out

Unlike basic chat filters that simply delete a message, SwearFilter offers a layered approach. It listens to both chat messages and commands, catching attempts to bypass the filter through creative spelling or command tricks. The plugin relies on uuidAPI to function correctly, ensuring player identities are tracked accurately even if they change their username. Once set up, the system works silently in the background, reducing the burden on moderators while keeping your server’s tone exactly how you want it.

Core Features That Simplify Moderation

SwearFilter packs a comprehensive set of features that go far beyond a simple word blocklist. Here is what you can configure right out of the box:

• Customizable blocked words list – add or remove any term you consider inappropriate, directly from in-game commands or the configuration file.
• Automatic punishment escalation – after a configurable number of cuss attempts, the plugin can issue an automatic ban, removing repeat offenders without any staff intervention.
• Temporary ban system – instead of permanent bans, you can opt for temporary suspensions that scale with the offense count.
• Word replacement with asterisks – rather than blocking the entire message, you can replace the offending word with '*' characters, preserving the rest of the sentence and reducing frustration.
• Optional language file – all in-game messages are fully customizable, so you can translate warnings and notifications into your server’s primary language.
• Player-controlled toggle – the /togglecuss command lets individual players decide whether they want to see filtered words replaced or messages blocked entirely, giving them a degree of personal control.

One of the most convenient aspects of modern server administration is how easily tools like this can be integrated into your setup. For those who prefer a streamlined experience, the plugin can be effortlessly installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it simple to keep your server’s moderation suite up to date without digging through multiple websites.

Commands and How to Use Them

SwearFilter comes with a straightforward command structure that allows both admins and players to interact with the filter. All commands are built around the /swearfilter base, with several subcommands for different tasks.

Administrative Commands

• /swearfilter info [player] – displays the current cuss attempt count for a specific player, helping you track repeat offenders.
• /swearfilter reset [player] – resets a player’s cuss count back to zero, useful for giving second chances.
• /swearfilter add [word] – adds a new word to the blocked list without needing to reload the server or edit files manually.
• /swearfilter remove [word] – removes a previously blocked word from the list.
• /swearfilter list – lists all currently blocked words, making it easy to audit your filter settings on the fly.

Player-Facing Command

• /togglecuss – allows any player with the appropriate permission to toggle whether they see filtered messages with asterisks or have them hidden entirely. This respects individual comfort levels without affecting the enforcement of the rules.

Granular Permission Control

Every action in SwearFilter is tied to a specific permission node, giving you fine-grained control over who can manage the filter and who can bypass it. This is critical for larger servers with multiple staff ranks.

• swearfilter.chatfilter – grants access to the main chat filtering functionality (usually given to all players by default).
• swearfilter.info – allows viewing player cuss counts.
• swearfilter.reset – permits resetting cuss counts.
• swearfilter.add – enables adding words to the blocklist in-game.
• swearfilter.remove – enables removing words from the blocklist.
• swearfilter.list – allows listing all blocked words.
• swearfilter.bypass – lets a player bypass the chat filter entirely, ideal for trusted staff or special roles.
• swearfilter.notify – sends a notification to staff when a player is stopped from cussing or is banned for exceeding the attempt limit.
• swearfilter.togglecuss – grants access to the /togglecuss command for personal chat viewing preferences.

These permissions can be assigned through any standard permissions plugin, ensuring that only the right people can alter the filter’s behavior or see sensitive notifications.

Ban Integration and Compatibility

SwearFilter uses the server’s default ban system to enforce automatic punishments. This means any ban issued by the plugin will be recorded just like a manual ban, compatible with your existing ban management tools. For those who want even deeper integration, SwearFilter currently supports QuickTools, allowing you to tie the plugin’s actions into a broader administrative suite. The system is designed to be fully automated, so once you set the cuss attempt threshold, you can step back and let the plugin handle the rest.

Seeing SwearFilter in Action

If you want to test how the plugin behaves before installing it on your own server, you can join the demonstration server at minecraft.thetaco.us. There you can experience the filter firsthand, see how warnings appear, and understand the ban escalation process without any risk to your own community. It is a great way to evaluate whether the default settings match your server’s moderation style.

Why Automated Chat Filtering Matters

Manually monitoring chat is exhausting and prone to inconsistency. Different moderators may have different tolerance levels, and players can slip through when staff are offline. SwearFilter eliminates that variability. It applies your rules uniformly, 24/7, and only escalates to a ban when a player has clearly demonstrated a pattern of ignoring warnings. This approach not only keeps the chat cleaner but also reduces drama, because the punishment is automatic and based on objective criteria rather than personal judgment.

The optional temporary-ban system adds another layer of fairness. Instead of permanently losing a player who might have just had a bad day, you can issue a short suspension that scales with the number of offenses. Combined with the ability to replace words with asterisks, the plugin maintains a friendly atmosphere without feeling overly oppressive.

Final Thoughts

SwearFilter is more than just a word blocker; it is a complete chat moderation assistant that grows with your server. From its configurable word lists and automatic ban thresholds to its detailed permissions and player toggle command, every aspect is designed to give you control while keeping the community experience smooth. Whether you run a small private server or a large public network, automating profanity management frees up your time to focus on what really matters — building incredible worlds and fostering a positive player community.