What Is SpamHammer and Why Your Server Needs It
Every Minecraft server administrator knows the headache of chat spam. Whether it’s a player flooding the chat with repeated messages or someone firing off dozens of lines in seconds, spam ruins the experience for everyone. That’s where SpamHammer steps in. Originally created by dumptruckman and later rewritten to be leaner and meaner, SpamHammer is a lightweight plugin that automatically detects and punishes chat spammers. It works quietly in the background, handing out mutes, kicks, and bans in a sensible order, while leaving your staff and trusted players untouched.
Key Features of SpamHammer
SpamHammer isn’t just a simple spam filter. It’s a smart moderation tool that adapts to your server’s needs. Here’s what makes it stand out:
- Progressive punishment: The plugin escalates from mute to kick to ban, giving offenders a chance to correct their behavior before harsher measures apply.
- Repeat message detection: It can catch players who copy-paste the same line over and over, not just those typing rapidly.
- Permission-based immunity: Server operators and anyone with the right permission nodes are completely bypassed, so staff never get caught in the crossfire.
- Clean command structure: Simple slash commands let you unmute, reset a player’s history, or reload the configuration on the fly.
- Lightweight footprint: The rewritten version shed over 70KB of unnecessary code, making it faster and less resource-hungry.
How the Progressive Punishment System Works
When SpamHammer detects that a player is sending too many messages in a short time window, it doesn’t jump straight to a ban. First, the player gets muted — they can still play, but their chat messages are hidden from everyone else. If they continue spamming after the mute expires (or if they trigger the limit again), the plugin escalates to a kick. Persistent offenders finally receive a temporary or permanent ban. This graduated approach keeps the chat clean without being overly harsh on someone who might just be excited or made a mistake.
Repeat Message Detection
Beyond simple rate limiting, SpamHammer can optionally flag identical messages. If a player pastes the same advertisement or insult multiple times, the plugin treats it as spam even if the messages aren’t sent at lightning speed. You can tweak both the time window and the repeat threshold in the config.yml file to match your community’s tolerance.
Commands and Permissions at a Glance
SpamHammer gives you full control through a handful of intuitive commands. No complex syntax, no endless sub-arguments.
Commands
- /spam unmute
– Lifts a mute imposed by SpamHammer. Requires spamhammer.cmd.unmute. - /spam reset
– Wipes the player’s spam history, as if they never triggered the plugin. Requires spamhammer.cmd.reset. - /spam reload – Reloads the configuration from disk without restarting the server. Requires spamhammer.cmd.reload.
Permission Nodes
Granular permissions let you decide exactly who can manage SpamHammer and who gets a free pass. The main nodes include:
- spamhammer.* – Full access (default: op).
- spamhammer.bypass.* – Grants immunity to all punishments, including repeat detection.
- spamhammer.bypass.punish.mute – Bypasses mute only.
- spamhammer.bypass.punish.kick – Bypasses kick only.
- spamhammer.bypass.punish.ban – Bypasses ban only.
- spamhammer.bypass.repeat – Ignores the repeat message limit.
- spamhammer.cmd.* – Allows use of all SpamHammer commands (default: false for non-ops).
This fine-grained system means you can let moderators unmute players without giving them full operator status, or protect VIPs from ever being kicked while still allowing mutes.
Installation and Configuration
Getting SpamHammer onto your server is straightforward. Drop the JAR file into your server’s plugins folder and restart. The default configuration works out of the box, but you’ll probably want to tweak the thresholds to suit your player base. Open plugins/SpamHammer/config.yml and adjust values like the message limit, time window, and punishment durations. If you’re running a network of servers and want to keep everything consistent, you can manage the plugin easily through a modern launcher. For instance, you can install SpamHammer directly via the foxygame.net launcher, a convenient and flexible tool where you can download mods and plugins right from its menu, saving you the hassle of manual file transfers.
Privacy and the Phoning Home Feature
SpamHammer includes a lightweight analytics call that helps the developer understand how many servers use the plugin and which versions are active. When enabled, the plugin sends only the plugin name, version, server IP, and port to a remote database. The IP and port are never displayed publicly; they merely differentiate one server from another. If you prefer not to share this data, simply open the config.yml and set settings.callhome to false. The plugin will function perfectly without it, and no other information ever leaves your server.
Why SpamHammer Remains a Top Choice
In a sea of chat moderation plugins, SpamHammer distinguishes itself with simplicity and reliability. The rewrite by the current maintainer stripped away bloat, shrinking the file size from over 100KB to around 30KB without losing any core functionality. The codebase is clean, the commands are logical, and the permission tree is thorough. Whether you run a small survival world or a bustling minigame network, SpamHammer keeps your chat readable and your players happy without adding noticeable server lag. It’s a set-and-forget solution that respects both your staff hierarchy and your community’s need for a spam-free environment.
Conclusion
SpamHammer delivers exactly what it promises: intelligent, tiered spam detection that protects your server’s chat without punishing innocent players. The combination of rate limiting, repeat message detection, and progressive escalation makes it a robust tool for any administrator. With easy configuration, clear permissions, and the option to disable analytics, it fits seamlessly into any server setup. If you’re tired of manually muting spammers or dealing with clunky, overcomplicated plugins, give SpamHammer a try — your moderators will thank you.