mace cooldown v3.1

Removed cooldown message!!

MaceCooldown – /exception Mechanic​

The /exception system allows you to create special maces with custom cooldown behavior. Normal maces follow the default cooldown and hit counter settings, while exception maces can have custom hit thresholds, cooldown durations, and counter reset timers.

Available Subcommands​

1. /exception create <name> <hits> <cooldown> <reset>
   • Creates a new exception in the plugin’s config.
   • Parameters:
     • <name> → the unique name of the exception.
     • <hits> → number of hits required before the cooldown triggers.
     • <cooldown> → cooldown duration in seconds after reaching the hit count.
     • <reset> → seconds after which the hit counter resets if no hits occur.
2. /exception give <name>
   • Applies the exception to the mace the player is holding.
   • Adds a hidden tag to the item so the plugin recognizes it as an exception mace.
   • Exception maces override the default hit counter and cooldown behavior.
3. /exception remove
   • Removes the exception tag from the held mace.
   • The mace returns to default cooldown behavior.
4. /exception list
   • Lists all currently created exceptions in the plugin’s config.

How it works in-game​

• Normal maces:
  • Use default settings from config.yml (hits-to-cooldown, cooldown-seconds, counter-reset-seconds).
  • Hit counter triggers the cooldown normally.
• Exception maces:
  • Use custom settings specified during creation.
  • Hit counter is separate from normal maces.
  • The cooldown activates after the specified number of hits, and the triggering hit is allowed.
  • White cooldown bar is shown on the player’s screen.
  • Hit counter resets automatically if no hits occur within the counter-reset-seconds.
• Per-player tracking:
  • Hit counters and cooldowns are tracked per-player, so multiple players can use maces independently.

Permissions​

• mace.admin → required to use any /exception command.

1-Fixed the the bug that does let u hit with a mace while in cooldown

MaceCooldown Plugin​

Description:
MaceCooldown is a configurable Minecraft plugin designed for Spigot and Paper servers (1.21+), adding a dynamic cooldown system to the new Mace weapon. This plugin allows server owners to customize how the Mace behaves in combat, balancing gameplay while keeping fights fun and strategic.
Features:

• Configurable Hits Before Cooldown: Specify how many times a player can hit with a Mace before a cooldown is applied.
• Counter Reset Timer: Automatically resets the hit counter if the player hasn’t attacked within a set number of seconds.
• Custom Cooldown Duration: Set how long the cooldown lasts once triggered.
• White Cooldown Bar: Displays the familiar Minecraft cooldown visual on the hotbar slot.
• Customizable Messages: Notify players when their Mace is on cooldown, including the remaining time.
• Lightweight & Efficient: Minimal performance impact, fully compatible with Spigot and Paper servers
  Use Cases:
• Make PvP combat more strategic by limiting rapid Mace attacks.
• Add a skill-based requirement for using powerful weapons.
• Customize combat experience for mini-games or survival servers.
  Installation:
• Place the plugin JAR into your server’s plugins folder.
• Start the server to generate config.yml.
• Configure hits, cooldown duration, and reset timer as desired.
• Reload or restart the server to apply changes.