MaceCooldown Strategic Combat Balance for 1.21+
OVERVIEWThe Mace introduced in 1.21 is a powerful weapon, but without limits, it can ruin the balance of PvP and PvE. MaceCooldown is a lightweight, performance-optimized plugin designed for Paper/Spigot 1.21.1 - 1.21.11 servers. It adds a configurable cooldown to the Mace, preventing spam attacks and forcing players to think tactically. Perfect for Survival, SMP, PvP Arenas, and RPG servers.
KEY FEATURES
Configurable Cooldown: Set the exact duration in seconds (Default: 2 minutes).
Native API: Uses the official Minecraft visual cooldown system (not just chat messages).
Smart Detection: Only triggers when hitting an entity with a Mace in the main hand.
High Performance: Minimal resource usage, 0% impact on TPS.
Visual Feedback: Players see the cooldown animation on the item and receive a customizable message.
Hot Reload: Update settings instantly without restarting the server.
Modern Standards: Built for Java 21 and Minecraft 1.21+.
HOW IT WORKS1. Attack: A player hits an entity (mob or player) with a Mace. 2. Trigger: The plugin detects the hit and checks the config. 3. Cooldown: The Mace item enters a "cooldown" state (visual grey overlay) for the set time. 4. Restriction: The player cannot use the Mace again until the cooldown expires.
CONFIGURATIONEverything is controlled via a simple config.yml.
YAML:
# MaceCooldown Configuration # Built for Minecraft 1.21.1 - 1.21.11 # Toggle the plugin functionality on/off cooldown-enabled: true # Cooldown duration in seconds # 120 seconds = 2 minutes # The plugin automatically converts this to ticks (x20) cooldown-seconds: 120
COMMANDS & PERMISSIONS
Code:
COMMAND: /macecooldown reload (Alias: /mcd reload) DESCRIPTION: Reloads the configuration file. PERMISSION: macecooldown.admin DEFAULT: OP only
INSTALLATION- Ensure your server is running Java 21 and Paper/Spigot 1.21+.
- Download the .jar file.
- Upload it to your server's /plugins folder.
- Restart the server.
- Edit config.yml if needed and run /mcd reload.
FAQQ: Does this work with custom Maces? A: Yes, as long as the base item material is Material.MACE. Q: Does it affect off-hand usage? A: No, only main-hand attacks trigger the cooldown to ensure combat fluidity. Q: Can players bypass this by crafting a new Mace? A: No. The cooldown applies to the player for that Item Material type. Switching to a different Mace will still show the cooldown.
SYSTEM REQUIREMENTS- Minecraft Version: 1.21.1 up to 1.21.11
- Java Version: Java 21 (LTS)
- Software: Paper (Recommended), Spigot, or Purpur.
Make combat fair again.
Latest reviews
- MasterStudios
- Version: v1.0
plugin is easy to make with a script the plugin spams chat way to much
however the second point is valid i can fix that by putting a toggle system there in config to turn it on and off or so
also ur first argument is so cheap and childish tbh ngl