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

Download the latest version of RC Cooldown from the releases page
Place the .jar file into your server's plugins folder
Restart your server or use /reload command
Configure the plugin by editing plugins/RCCooldown/config.yml
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

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

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

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

RC CoolDown

📖About RC CoolDown