Home›Java›Mods›MaceCooldownn
MaceCooldownn
ModsJava

MaceCooldownn

Java mod listed for Minecraft 1.21. Downloads from the MC Java Mods app on Android.

by geturplugins · on Modrinth

⬇ Download on Modrinth
MaceCooldownn — screenshot 1MaceCooldownn — screenshot 2MaceCooldownn — screenshot 3

** 📖 MaceCooldown Plugin - Complete Description


🎯 Overview

MaceCooldown is a lightweight, performance-optimized Minecraft plugin designed for Paper/Spigot 1.21.1-1.21.11 servers. It introduces a strategic cooldown mechanic to the Mace weapon, preventing spam attacks and adding tactical depth to PvP and PvE combat scenarios.

When a player attacks any entity using a Mace, the weapon is placed on cooldown for a configurable duration, during which the player cannot use the Mace again. This creates balanced gameplay and prevents overpowered Mace spamming.


✨ Key Features

1. Cooldown System

2. Smart Detection

3. Configuration System

4. Administration

5. Performance & Compatibility


🎮 Use Cases & Applications

PvP Servers

Survival/SMP Servers

RPG/Adventure Servers

Mini-Games


🔧 How It Works

Technical Flow:

1. Player attacks entity with Mace in main hand
           ↓
2. Plugin detects EntityDamageByEntityEvent
           ↓
3. Checks if cooldown-enabled = true
           ↓
4. Validates attacker is a Player
           ↓
5. Checks if weapon is Material.MACE
           ↓
6. Converts config seconds to ticks (seconds × 20)
           ↓
7. Applies cooldown using player.setCooldown(Material.MACE, ticks)
           ↓
8. Player receives feedback message
           ↓
9. Mace cannot be used until cooldown expires

Visual Player Experience:


⚙️ Configuration Details

config.yml Breakdown:

cooldown-enabled: true
cooldown-seconds: 120

Configuration Examples:

Use Case cooldown-seconds Real Time Best For
Fast-Paced PvP 30 30 seconds Quick respawn servers
Balanced PvP 60 1 minute Arena/duels
Default 120 2 minutes General use
Hard Survival 180 3 minutes Challenging PvE
Boss Battles 300 5 minutes Epic encounters

📋 Commands & Permissions

Commands:

Command Aliases Description Permission
/macecooldown reload /mcd reload Reloads config.yml macecooldown.admin

Permissions:

Permission Default Description
macecooldown.admin OP Access to reload command and admin functions

Command Usage:

 Reload configuration after editing config.yml
/macecooldown reload
/mcd reload   Shorter alias

 Output example:
✓ MaceCooldown configuration reloaded successfully!
  Cooldown enabled: true
  Cooldown duration: 120 seconds

📦 Installation Guide

Step 1: Download

Step 2: Install

  1. Stop your server
  2. Copy MaceCooldown-1.0.0.jar to plugins/ folder
  3. Start your server

Step 3: Configure

  1. Find plugins/MaceCooldown/config.yml (auto-generated)
  2. Edit settings as desired
  3. Run /macecooldown reload (no restart needed!)

Step 4: Test

  1. Join your server
  2. Get a Mace: /give @s mace
  3. Attack any mob/player
  4. Observe cooldown activation

💡 Benefits & Advantages

For Server Owners:

For Players:

For Developers:


🖥️ System Requirements

Server Requirements:

Client Requirements:


🎯 Plugin Behavior Details

What Triggers Cooldown: ✅ Hitting any entity with Mace in main hand
✅ Any successful attack (damage dealt)
✅ PvP attacks (player vs player)
✅ PvE attacks (player vs mob)

What Does NOT Trigger: ❌ Mace in off-hand (only main hand counts)
❌ Missing attacks (not hitting anything)
❌ Attacking while cooldown is disabled in config
❌ Attacking with other weapons
❌ Breaking blocks with Mace

Cooldown Scope:


📊 Performance Metrics

Metric Value
Event Listeners 1 (EntityDamageByEntityEvent)
Memory Footprint < 1 MB
CPU Impact Negligible (< 0.1% TPS)
Disk Usage < 100 KB
Startup Time < 50ms
Config Reload Time < 10ms

🔒 Security & Safety


🆚 Comparison with Alternatives

Feature MaceCooldown Generic Cooldown Plugins Manual Config
Mace-Specific ✅ Optimized ⚠️ Generic ❌ Complex
Easy Setup ✅ 1 file ⚠️ Multiple configs ❌ Requires knowledge
Performance ✅ Lightweight ⚠️ Varies ✅ N/A
1.21+ Support ✅ Native ⚠️ May lag behind ✅ If supported
Hot Reload ✅ Built-in ⚠️ Varies ❌ Requires restart

🎓 Example Scenarios

Scenario 1: PvP Arena Setup: 60-second cooldown
Effect: Players can use Mace once per minute in fights
Result: Encourages weapon switching and tactical planning

Scenario 2: Survival Server Setup: 120-second cooldown (default)
Effect: Mace becomes a powerful but limited tool
Result: Players save Mace for tough mobs, use other weapons for farming

Scenario 3: Boss Battle Event Setup: 300-second cooldown (5 minutes)
Effect: Mace usable once or twice per boss fight
Result: Makes boss fights more challenging and strategic

Scenario 4: Temporarily Disable Setup: Set cooldown-enabled: false
Effect: Plugin stays installed but does nothing
Result: Quickly disable for special events, re-enable after


❓ FAQ

Q: Does this work with custom Maces from other plugins?
A: Yes, as long as the item type is Material.MACE.

Q: Can I set different cooldowns for different players?
A: Not in this version, but you can modify the code to add permission-based tiers.

Q: Does it work with off-hand Maces?
A: No, only main hand attacks trigger cooldown (design choice for balance).

Q: What happens if I set cooldown to 0?
A: The cooldown will be instant (essentially disabled for that player after attack).

Q: Is there a maximum cooldown limit?
A: No hard limit, but extremely high values (> 1 hour) are impractical.

Q: Does this affect Mace durability?
A: No, normal durability loss still applies.

Q: Can players bypass with multiple Maces?
A: No, cooldown applies to the Material type, affecting all Maces.


📞 Support & Updates

Getting Help:


🏆 Why Choose MaceCooldown?

  1. ✅ Purpose-Built: Specifically designed for Mace balancing
  2. ✅ Modern: Uses latest Minecraft and Java versions
  3. ✅ Simple: One plugin, one config, one command
  4. ✅ Reliable: Uses native Minecraft API (no hacks)
  5. ✅ Free: Open source, no hidden costs
  6. ✅ Efficient: Minimal performance impact
  7. ✅ Flexible: Customize to your exact needs

MaceCooldown - Balance Your Combat, Enhance Your Server ⚔️**

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more