CapsBlock: Stop ALL CAPS Spam on Your Minecraft Server

Understanding the CapsBlock Plugin for Minecraft Servers Running a Minecraft server often means managing a diverse community, and one of the most persistent nuisances is the excessive use of capital letters in chat. Younger players especially tend to SHOUT EVERYTHING, turning the chat into a jarr...

Download CapsBlock

Original name: CapsBlock

FileVersionLoaderSize
CapsBlock-0.1.jar——4 КБDownload
CapsBlock-0.2.jar——5 КБDownload
CapsBlock-0.3.jar——5 КБDownload
CapsBlock-0.4.jar——5 КБDownload
CapsBlock-0.5.jar——5 КБDownload
CapsBlock.jar——5 КБDownload

Understanding the CapsBlock Plugin for Minecraft Servers

Running a Minecraft server often means managing a diverse community, and one of the most persistent nuisances is the excessive use of capital letters in chat. Younger players especially tend to SHOUT EVERYTHING, turning the chat into a jarring, hard-to-read stream. While a few caps for emphasis are fine, an entire message in uppercase can feel aggressive and disruptive. That is where CapsBlock steps in—a lightweight, server-side plugin that gives you full control over caps usage without punishing players unfairly.

What Exactly Does CapsBlock Do?

CapsBlock monitors every chat message sent on your server and calculates the percentage of uppercase letters. If that percentage exceeds a threshold you define—the default is 50%—the plugin can take action. You can choose to silently convert the message to lowercase, replace it with custom text, block it entirely, or even kick the offending player. This flexibility means you can tailor the response to your community’s tone, from gentle nudges to strict enforcement.

One of the smartest touches is that punctuation marks are not counted toward the total message length when calculating the caps percentage. This prevents a message like “HELLO!!!” from being unfairly penalized because of extra exclamation marks. The plugin also respects a minimum message length (configurable) so that short phrases like “OK” aren’t flagged unnecessarily.

Key Features That Make Server Moderation Smoother

CapsBlock isn’t just a blunt instrument—it offers layered control. Here are the standout capabilities:

  • Percentage-based filtering: Set a custom caps threshold (PercentCaps) to define what counts as excessive. A message with 60% caps? Blocked. 30%? Allowed.
  • Three handling modes: Convert to lowercase, replace with custom text, or cancel the message entirely. Each mode can include a notification so the player understands why their message was altered.
  • Kick option: For repeat offenders, you can enable KickOnCaps and define a custom kick message. This adds a layer of automated discipline.
  • Minimum message length: The MinMsgLength setting prevents filtering of very short messages, avoiding false positives on acronyms or quick replies.
  • Permission-based bypass: Grant the capsblock.ignore permission to trusted players or staff so their messages are never filtered, regardless of caps usage.

Installation and Basic Setup

Getting CapsBlock onto your server is straightforward. Download the .jar file and place it in your server’s plugins directory, then restart the server. Once loaded, a configuration file will be generated where you can tweak every aspect of the plugin. If you’re managing a modded server and want a seamless way to manage plugins, the foxygame.net launcher offers a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it easy to install CapsBlock alongside other essential tools.

After installation, you’ll find a well-organized config.yml file. The default settings are sensible, but customizing them lets you match the plugin to your server’s culture. For example, a family-friendly server might use a lower caps threshold and convert to lowercase, while a competitive PvP server might simply cancel the message and notify the player.

Diving Into Configuration Options

The configuration file is the heart of CapsBlock. Every option is clearly named and documented. Here’s a quick breakdown of what you can adjust:

  • ReplaceWithLowerCase: Set to true to automatically convert all caps in a message to lowercase before displaying it.
  • NotifyOnReplaceWithLowerCase: If true, the player receives a notification (defined in ReplaceWithLowerCaseMessage) that their message was modified.
  • ReplaceText: Instead of modifying the original, you can replace the entire message with your own text (e.g., “Please avoid excessive caps.”).
  • CancelText: Blocks the message from appearing at all, with an optional notification.
  • KickOnCaps: When true, any message exceeding the caps threshold will result in an immediate kick, using the message set in KickMessage.
  • PercentCaps: The magic number—set the percentage of uppercase characters that triggers action. Default is 50.
  • MinMsgLength: Messages shorter than this number of characters are ignored. Prevents filtering of single words or abbreviations.

All notification messages support color codes, so you can make them fit your server’s style. A quick /CapsBlock reload applies changes without restarting the server, which is a huge time-saver.

Commands and Permissions at a Glance

CapsBlock keeps things simple with just two commands and two permissions:

  • /CapsBlock – Opens an in-game menu displaying the current configuration and status.
  • /CapsBlock reload – Reloads the config file instantly. Requires the capsblock.reload permission.
  • capsblock.ignore – Players with this permission bypass all filtering.
  • capsblock.reload – Allows use of the reload command.

These permissions integrate seamlessly with any permissions plugin like LuckPerms, giving you granular control over who can ignore the rules and who can manage the plugin.

Why CapsBlock Matters for Your Community

Excessive caps aren’t just an aesthetic issue; they can set a hostile tone and discourage quieter players from participating. By automating moderation, CapsBlock removes the need for staff to constantly police chat. The ability to convert to lowercase rather than block messages outright means the conversation keeps flowing, just at a more readable volume. For servers with younger audiences, it’s an educational tool that gently reinforces proper chat etiquette without scolding.

The plugin’s evolution—from basic filtering to handling the /me command and improving thread safety—shows a developer who listens to feedback. With support for Minecraft 1.3 and beyond, it’s a stable choice even for older server versions.

Final Thoughts

CapsBlock fills a small but important niche in server administration. It’s not flashy, but it solves a real problem with precision and flexibility. Whether you run a survival world, a creative build server, or a minigame hub, keeping chat readable is part of creating a welcoming environment. The plugin’s configurable nature means you can start with a lenient policy and tighten it if needed, all without touching a single line of code. If you’ve ever wished you could dial down the shouting without muting players entirely, CapsBlock is the tool you’ve been looking for.