SpaMute is a lightweight and efficient Minecraft server plugin specifically designed to automatically detect and punish chat spamming behavior. By issuing temporary mutes (TempMute) to offending players, it effectively maintains a clean and orderly chat environment, significantly reducing the burden on server administrators.
- Automatic Spam Detection: Real-time monitoring of message frequency sent by players within a short period.
- Automatic Temporary Muting: Upon detecting spam, the plugin automatically executes a mute for a configurable duration.
- Persistent Mute Records: Mute data is stored in
mutes.yml, ensuring records persist even after server restarts. - Administrator Commands: Provides commands for manually unmuting players and reloading configuration files.
- Minecraft Server: Paper / Spigot (Paper recommended) 1.17.x - 1.21+
- Java Version: Java 21 or higher
- Download the latest
file from GitHub Releases.
- Place the file into your server's
plugins/folder. - Restart your server.
- The plugin will automatically generate
config.ymlandmessage.ymlinside theplugins/SpaMute/folder.
| Setting | Default Value | Description |
|---|---|---|
spam-max-count |
3 |
The number of messages a player can send within spam-check-seconds before being considered spamming. |
spam-check-seconds |
3 |
The time window (in seconds) used for checking spam behavior. |
mute-duration-seconds |
300 |
The duration (in seconds) the player will be muted for when spam is detected. (300 seconds = 5 minutes) |
mute-command |
chat |
The type of permission revoked after muting (e.g., chat for standard chat restriction). |
| Command | Description | Permission Node |
|---|---|---|
/spamute help |
Displays the command list. | spamute.admin |
/spamute reload |
Reloads the plugin's main configurations (config.yml and message.yml). |
spamute.admin |
/unmute <player> |
Manually un-mutes the specified player. | spamute.admin |
| Permission Node | Description | Default |
|---|---|---|
spamute.bypass |
Players with this permission are exempt from spam detection and will never be automatically muted by the plugin. | Op |
spamute.admin |
Grants access to administrative commands (e.g., /spamute reload, /unmute) and receives automatic mute notifications. |
Op |
If you encounter any issues, find bugs, or have feature suggestions, please feel free to contact us via the following channels:
Contributions are welcome in any form! If you wish to submit bug fixes or new features, please do so via a Pull Request.