CCooldowns

C-Cooldowns

C-Cooldowns is a Minecraft plugin that applies item cooldowns globally or based on WorldGuard regions. Designed for seamless integration with DeluxeCombat, it enables fine-tuned control over PvP mechanics by delaying the reuse of powerful items like ender pearls, golden apples, or potions.

Cooldowns can be applied server-wide or limited to specific regions. You can disable them in safe areas like spawn or safezone, while maintaining strict rules elsewhere. All durations and item types are fully configurable via config.yml.

---

🧭 Features

• Set item-specific cooldowns (e.g. ender pearls, enchanted apples, rods)
• Supports regionless and region-based cooldown behavior
• Integrates with WorldGuard and DeluxeCombat
• Disable cooldowns in regions like spawn or safezone
• Simple admin command and permission system
• YAML-driven config for easy adjustments

---

🛠️ Commands

• /ccooldown status – View the current cooldown settings
• /ccooldown reload – Reloads the plugin's configuration without restarting the server

---

⚙️ Setup Instructions

1. Install on a Paper/Purpur server (Minecraft 1.20+)
2. Drop the plugin .jar into your plugins/ folder
3. Restart the server to generate the default config.yml
4. Modify cooldown values, enabled items, and region settings
5. Use /ccooldown reload to apply changes instantly
6. Define regions in WorldGuard if using region-based cooldowns
7. Players using cooldown-triggering items will see delays enforced

---

📁 Configuration Reference (config.yml)

cooldowns:
  wind: 5
  pearl: 10
  golden_apple:
    regular: 30
    enchanted: 60
  fishing_rod: 8
  splash_potion: 15

enabled:
  wind: true
  pearl: true
  golden_apple: true
  fishing_rod: true
  splash_potion: true

regions:
  enabled_in: []  # Cooldowns apply everywhere unless listed
  disabled_in:
    - safezone
    - spawn

---

🔐 Permissions