RC CoolDown

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

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

🎯 Use Cases

- Any Server: Balance powerful items like Golden Apples, Ender Pearls, and weapons - Any Server: Prevent item spam and create strategic gameplay - Any Server: Control item usage in custom game modes - Any Server: 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`:

```yaml

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

- click_type: Language for plugin messages (EN, RU, UA, ES, DE) - click_type: Enable or disable cooldown for this item (true/false) - click_type: 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:

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

3. 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:

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

Change language in `config.yml`: ```yaml 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:

- Other Items: Cooldown activates after consumption - Other Items: Cooldown activates after successful attack - Other Items: 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:

- Mace (enchantment): 15 seconds - Mace: 20 seconds - Mace: 5 seconds - Mace: 30 seconds - Mace: 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.