Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
ā MaceCooldown
Simple, effective Mace cooldown control for your server.
Prevent Mace spam by enforcing a configurable cooldown after every successful hit ā no dependencies, no bloat.
š Overview
MaceCooldown is a lightweight plugin that adds a configurable attack cooldown to the Mace weapon. After a player lands a hit with a Mace, the item is put on cooldown for a set duration. Any further attack attempts while on cooldown are cancelled and the player is notified. Everything is fully configurable ā duration, messages, and even message spam throttling ā and can be hot-reloaded without a restart.
⨠Why Choose MaceCooldown?
ā” Dead Simple ā One listener, one config, one command. Zero dependencies.
šØ Fully Configurable Messages ā All feedback messages support & color codes and are editable in config.yml.
š§ Spam Protection ā Built-in message throttle prevents players from getting flooded with cooldown warnings.
š Performance Friendly ā Minimal overhead: a single event listener and an in-memory cooldown map.
š ļø Hot Reload ā Change settings live with /macecooldown reload ā no restart needed.
⨠Features
š“ Core Features
āļø Enforces a configurable cooldown (default: 120 seconds) after every Mace hit
š« Cancels damage if the Mace is still on cooldown
š¬ Notifies the player when the cooldown is applied and when they try to attack while on cooldown
š Configurable message throttle to prevent notification spam (default: 3s between messages)
š¢ Customization
āļø Enable or disable the entire cooldown system without removing the plugin
šØ All messages customizable with full & color code support and {seconds} / {enabled} placeholders
š Live config reload with /macecooldown reload
š Documentation
āļø How It Works
When a player attacks any entity holding a Mace:
š¢ If not on cooldown ā the hit lands normally, then cooldown-seconds Ć 20 ticks of cooldown is applied to the Mace item. The player receives the cooldown-applied message.
š“ If already on cooldown ā the damage event is cancelled entirely (the hit deals no damage). The player receives the mace-on-cooldown message, subject to throttle.
The cooldown is applied using Bukkit's native item cooldown (player.setCooldown(Material.MACE, ticks)), so the Mace also shows the visual cooldown overlay in the player's hotbar automatically.
š Message Throttle
To prevent chat spam when a player rapidly clicks while on cooldown, the mace-on-cooldown message is rate-limited to once every throttle-seconds (default: 3). Setting throttle-seconds: 0 disables throttling and shows the message on every cancelled attack.
āļø Configuration
Configuration file: config.yml
# Enable or disable the mace cooldown feature entirely
cooldown-enabled: true
# Cooldown duration in seconds (converted to ticks internally)
# Default: 120 (2 minutes)
cooldown-seconds: 120
messages:
# Show message when player attacks while on cooldown
on-cooldown-enabled: true
# Show message when cooldown is first applied after a hit
cooldown-applied-enabled: true
# Throttle: minimum seconds between "on cooldown" messages per player
# Set to 0 to show every time
throttle-seconds: 3
text:
mace-on-cooldown: "&cMace is still on cooldown!"
cooldown-applied: "&6Mace cooldown applied for {seconds} seconds!"
no-permission: "&cYou don't have permission to use this command!"
reload-usage: "&eUsage: /macecooldown reload"
reload-success: "&aMaceCooldown configuration reloaded successfully!"
reload-info-enabled: "&7Cooldown enabled: {enabled}"
reload-info-duration: "&7Cooldown duration: {seconds} seconds"
š Configuration Options
| Option | Description | Default |
|---|---|---|
cooldown-enabled |
Enable or disable the entire feature | true |
cooldown-seconds |
Cooldown duration in seconds | 120 |
messages.on-cooldown-enabled |
Show message when attack is blocked | true |
messages.cooldown-applied-enabled |
Show message when cooldown is applied | true |
messages.throttle-seconds |
Minimum seconds between cooldown warnings | 3 |
text.mace-on-cooldown |
Message shown when Mace is on cooldown | see above |
text.cooldown-applied |
Message shown when cooldown is applied | see above |
Placeholders in messages:
{seconds}ā the configured cooldown duration{enabled}ātrueorfalse(used in reload info messages)
š” Note: All changes are applied instantly with /macecooldown reload. No restart required.
š» Commands
| Command | Description | Permission |
|---|---|---|
/macecooldown reload |
Reload the configuration from disk | macecooldown.admin |
Aliases: /mcd
š Permissions
| Permission | Description | Default |
|---|---|---|
macecooldown.admin |
Access to /macecooldown reload |
op |
š„ Installation
Getting started is easy!
š Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.21.x |
| Server Software | Paper, Spigot |
| Java | 21+ |
| Dependencies | None |
š Installation Steps
- š¦ Download the latest version of MaceCooldown.
- š Place the
.jarfile inside your server'splugins/folder. - š Restart your server.
- āļø Adjust
cooldown-secondsand messages inplugins/MaceCooldown/config.yml. - š Use
/mcd reloadto apply any changes live.
š Support & Bug Reports
Need help, found a bug, or have a suggestion?
Join the GetUrPlugins Discord community!
š Bug Reports ā Report bugs and unexpected behavior.
š¬ Support ā Get help with installation and configuration.
š” Suggestions ā Share ideas for future improvements.
š¢ Announcements ā Stay informed about updates and releases.
ā ļø Please include your Minecraft version, server software, and relevant error logs when reporting an issue.
š Credits & License
Developed by: GetUrPlugins
License: All Rights Reserved (ARR).
Ā© GetUrPlugins. All rights reserved.
ā Unauthorized redistribution or resale is prohibited.
ā Modification, decompilation, or republishing is prohibited without explicit permission.
ā
Usage is permitted under the conditions set by the author.
See https://gcl.onl/licenses/arr for the full license terms.
Made with ā¤ļø by GetUrPlugins
ā MaceCooldown ā Keep the Mace in check.


