RC Cooldown - Advanced Item Cooldown Management Plugin

📋 Overview

RC Cooldown is a powerful and flexible Spigot plugin that allows server administrators to set custom cooldowns on any Minecraft items, weapons, and enchantments. With support for multiple languages, visual cooldown animations, and intelligent use detection, this plugin provides a comprehensive solution for balancing gameplay and preventing item spam.

✨ Features

• Universal Item Support: Set cooldowns on any Minecraft item, weapon, or enchantment
• Smart Use Detection: Automatically detects item usage type (interact, consume, attack) and applies cooldowns accordingly
• Visual Cooldown Animation: Native Minecraft cooldown animation (like Ender Pearls) that matches your configured duration
• Enchantment Support: Set cooldowns on enchantments like Riptide, Channeling, and more
• Multi-Language Support: Built-in translations for English, Russian, Ukrainian, Spanish, and German
• Click Type Configuration: Choose between right-click or left-click activation for each item
• Anti-Spam Protection: Cooldown messages are rate-limited to prevent chat spam (max once per 3 seconds)
• Easy Configuration: Simple YAML configuration with default examples
• Admin Commands: Full command suite for managing cooldowns without editing config files
• Automatic Reload: Hot-reload configuration without server restart

🎯 Use Cases

• PvP Servers: Balance powerful items like Golden Apples, Ender Pearls, and weapons
• Survival Servers: Prevent item spam and create strategic gameplay
• Minigame Servers: Control item usage in custom game modes
• KitPvP: Balance kit items with custom cooldowns
• Any Server: Add cooldowns to any item for better gameplay balance

📦 Installation

1. Download the latest version of RC Cooldown from the releases page
2. Place the .jar file into your server's plugins folder
3. Restart your server or use /reload command
4. Configure the plugin by editing plugins/RCCooldown/config.yml
5. Use /rccd reload to apply changes

⚙️ Config

Basic Configuration

Open plugins/RCCooldown/config.yml:

# Language: EN, RU, UA, ES, DE
lang: EN

items:
  # Enchantments
  enchantment:riptide:
    enable: true
    cooldown: 15
    click_type: right_click
  
  # Items
  ENDER_PEARL:
    enable: true
    cooldown: 20
    click_type: right_click
  GOLDEN_APPLE:
    enable: true
    cooldown: 5
    click_type: right_click

Configuration Options

• lang: Language for plugin messages (EN, RU, UA, ES, DE)
• enable: Enable or disable cooldown for this item (true/false)
• cooldown: Cooldown duration in seconds
• click_type: Mouse click type (right_click or left_click)

📝 Adding Items

Method 1: Edit Config File

1. Open plugins/RCCooldown/config.yml
2. Add your item under the items: section:

items:
  DIAMOND_SWORD:
    enable: true
    cooldown: 10
    click_type: right_click

1. Save the file and run /rccd reload

Method 2: Use Commands (Recommended)

Use the /rccd add command to add items directly in-game:

/rccd add <item_id> <click_type> <seconds>

Examples:

/rccd add DIAMOND_SWORD right_click 10
/rccd add riptide right_click 15
/rccd add BOW left_click 5

Adding Enchantments

To add enchantments, simply use the enchantment name:

/rccd add riptide right_click 15
/rccd add channeling right_click 10

The plugin automatically detects if an ID is an item or enchantment - no prefix needed!

Finding Item IDs

• Use /rccd list to see all active cooldowns
• Minecraft item IDs are in UPPERCASE_WITH_UNDERSCORES format (e.g., DIAMOND_SWORD, GOLDEN_APPLE)
• Enchantment names are lowercase (e.g., riptide, channeling)

🎮 Commands

Command	Description	Permission
/rccd reload	Reload plugin configuration	rccd.admin (OP by default)
/rccd list	List all active cooldowns	rccd.admin (OP by default)
/rccd add <id> <click_type> <seconds>	Add a new cooldown	rccd.admin (OP by default)
/rccd delete <id>	Remove a cooldown	rccd.admin (OP by default)

Command Examples

/rccd reload                    # Reload configuration
/rccd list                      # Show all active cooldowns
/rccd add MACE right_click 5    # Add 5-second cooldown to Mace
/rccd delete ENDER_PEARL        # Remove Ender Pearl cooldown

🌍 Languages

The plugin supports 5 languages:

• EN - English
• RU - Russian (Русский)
• UA - Ukrainian (Українська)
• ES - Spanish (Español)
• DE - German (Deutsch)

Change language in config.yml:

lang: RU  # Change to your preferred language

Language files are automatically created in plugins/RCCooldown/lang/ folder.

🔧 Mechanics

Smart Use Detection

The plugin automatically detects how items are used:

• Food/Consumables: Cooldown activates after consumption
• Weapons: Cooldown activates after successful attack
• Enchantments: Cooldown activates after successful enchantment use (e.g., Riptide only activates when player actually flies)
• Other Items: Cooldown activates after successful interaction

Visual Cooldown

• Native Minecraft cooldown animation appears in the inventory
• Animation duration matches your configured cooldown time
• Works exactly like Ender Pearl cooldown animation
• Cooldown does not reset or update during active cooldown

Anti-Spam Protection

• Cooldown messages are limited to once per 3 seconds
• Prevents chat spam when players repeatedly click items on cooldown
• Item usage is still blocked, but messages are rate-limited

💡 Benefits

1. Flexibility

• Works with ANY Minecraft item, weapon, or enchantment
• No need to modify server code or use complex plugins
• Easy to add or remove cooldowns

2. Smart Detection

• Automatically detects item usage type
• No manual configuration needed for different item types
• Handles special cases like Riptide enchantment correctly

3. User-Friendly

• Visual cooldown animation for better UX
• Multi-language support for international servers
• Clear, informative messages

4. Performance

• Lightweight and optimized
• No performance impact on server
• Efficient cooldown tracking

5. Easy Management

• In-game commands for all operations
• No server restart needed for changes
• Simple YAML configuration

6. Professional Features

• Rate-limited messages prevent spam
• Proper event handling prevents exploits
• Reliable cooldown tracking

📋 Defaults

The plugin comes with pre-configured cooldowns for popular items:

• Riptide (enchantment): 15 seconds
• Ender Pearl: 20 seconds
• Golden Apple: 5 seconds
• Enchanted Golden Apple: 30 seconds
• Firework Rocket: 3 seconds
• Mace: 5 seconds

You can modify or remove these as needed.

🐛 Troubleshooting

Cooldown not working?

• Make sure enable: true in config
• Check that cooldown value is greater than 0
• Verify correct click_type (right_click/left_click)
• Run /rccd reload after config changes

Messages not in my language?

• Check lang: setting in config.yml
• Verify language file exists in plugins/RCCooldown/lang/
• Run /rccd reload after changing language

Item not found when adding?

• Use correct item ID format (UPPERCASE_WITH_UNDERSCORES)
• For enchantments, use lowercase name (e.g., riptide, not RIPTIDE)
• Check spelling - use /rccd list to see examples

📄 Permissions

• rccd.admin - Access to all /rccd commands (OP by default)

🔄 Updates

The plugin is actively maintained and updated. Check the releases page for:

• Bug fixes
• New features
• Performance improvements
• Additional language support

📞 Support

For support, bug reports, or feature requests, please visit the plugin's page on Discord.

📜 License

This plugin is provided as-is for use on Minecraft servers.

---

Version: 1.0.0
Minecraft Version: 1.21.4+
Spigot/Paper: Required