Mastering Chat Moderation with the ReplaceRegex Plugin for Minecraft Servers
Running a Minecraft server means building a community, and with that comes the need to keep chat clean and respectful. The ReplaceRegex plugin steps in as a lightweight yet powerful tool that scans every message, replaces forbidden words, and dishes out creative punishments—all without bogging down your server. Whether you manage a small survival world or a bustling minigame hub, this plugin gives you granular control over language, player behavior, and automated reporting.
What Is ReplaceRegex?
ReplaceRegex is a server-side chat moderation plugin that blocks specific words based on a fully configurable list. Instead of simply censoring with asterisks, it replaces offensive terms with harmless alternatives—for example, turning an expletive into “duck.” Beyond word filtering, the plugin can punish players who attempt to bypass the rules, using lightning strikes, direct damage, temporary kicks, or permanent bans. It also maintains separate log files for banned players and reported incidents, making it easy to review repeat offenders.
Key Features and Punishments
The plugin stands out by offering multiple punishment tiers that you can mix and match. Each punishment type is toggleable, so you can start with gentle reminders and escalate only when necessary.
- Word Replacement: Any blocked word gets swapped with a predefined substitute, keeping the conversation flowing while removing toxicity.
- Lightning Strike: When enabled, a bolt strikes the offending player’s location—a dramatic warning, though best used with fire-spread protection enabled.
- Damage Penalty: Inflicts a configurable amount of hearts (0–10) directly to the player’s health, serving as an immediate deterrent.
- Automatic Ban: Bans the player from the server with a custom reason message. Note that this uses its own ban list rather than the vanilla
/bancommand. - Instant Kick: Removes the player from the server and displays a customizable kick message.
- Report Logging: When enabled, the plugin writes the player’s name to a
reportlist.txtfile, creating a paper trail for staff review.
Configuration Made Easy
All behavior is controlled through a straightforward YAML configuration file. You define the list of bad words and their replacements right at the top, then toggle each punishment section on or off. For example, you can disable bans entirely and rely only on word replacement and a kick. Once you’ve downloaded the plugin, installing it on your server is straightforward—especially if you use a flexible launcher like foxygame.net, which lets you grab mods and plugins right from its interface and keep everything up to date without manual file shuffling.
Word Replacement and Filtering
Under the Words section, each entry follows the pattern badWord:replaceWord. This is case‑sensitive, so plan your list accordingly. You can add as many pairs as you like, and the plugin will scan every chat message for matches.
Lightning and Damage
Set Punishment.Lightning to true for a visual spectacle, but remember to protect your builds from fire spread. The Punishment.Damage block lets you enable health reduction and set the amount—2 hearts is a common starting point that warns without killing a full-health player.
Ban and Kick Options
The ban feature is intentionally separate from the server’s built-in ban system. If you enable Punishment.Ban, the player’s name gets added to banlist.txt, and the reason you configure appears when they try to reconnect. Interestingly, you can also use the plugin purely as a manual ban tool by adding names directly to that file and setting Punishment.Ban.Enabled to false—though the developer notes that dedicated ban plugins may be simpler for that specific task.
Reporting System
When Report to reportlist is active, any player who triggers a word filter gets logged in reportlist.txt. This file is separate from the ban list, giving moderators a quick way to spot patterns without issuing automatic punishments.
Permissions and Command Reference
ReplaceRegex uses a permission node system to let server owners exempt trusted players or staff from specific actions. The following permissions are available:
replaceregex.bypass.*– Bypass all punishments and word replacement (default false).replaceregex.bypass.replace– Bypass word replacement only.replaceregex.bypass.report– Bypass being added to the report list.replaceregex.bypass.lightning– Bypass lightning strikes.replaceregex.bypass.ban– Bypass automatic bans.replaceregex.bypass.kick– Bypass kicks.
The main command is /regex, which requires no permission by default. Subcommands include:
/regex reload– Reloads the configuration (permission:replaceregex.reload)./regex add– Adds a new blocked word on the fly (permission:replaceregex.add)./regex help– Displays command help.
Practical Use Cases
ReplaceRegex shines in family‑friendly servers where certain language simply isn’t welcome. It’s also useful for roleplay servers that want to maintain an immersive atmosphere by automatically swapping modern slang with lore‑friendly terms. Because punishments are optional, you can start with a soft touch—only replacing words and logging reports—and gradually introduce damage or kicks if the problem persists. The separate ban and report files make it easy to share incident logs with your moderation team without cluttering the main server console.
Conclusion
ReplaceRegex delivers a complete chat moderation package that goes beyond simple censorship. With word replacement, layered punishments, detailed permissions, and dual logging systems, it gives server administrators the tools to shape their community’s communication standards precisely. Whether you’re protecting young players, enforcing roleplay rules, or just keeping chat friendly, this plugin adapts to your needs with minimal configuration. Add it to your server toolkit and watch your chat become a cleaner, more welcoming space.