# RC Cooldown – Advanced Item Cooldown Management Plugin<\/p>\n
## \ud83d\udccb Overview<\/p>\n
**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.<\/p>\n
## \u2728 Features<\/p>\n
– **Universal Item Support**: Set cooldowns on any Minecraft item, weapon, or enchantment
\n– **Smart Use Detection**: Automatically detects item usage type (interact, consume, attack) and applies cooldowns accordingly
\n– **Visual Cooldown Animation**: Native Minecraft cooldown animation (like Ender Pearls) that matches your configured duration
\n– **Enchantment Support**: Set cooldowns on enchantments like Riptide, Channeling, and more
\n– **Multi-Language Support**: Built-in translations for English, Russian, Ukrainian, Spanish, and German
\n– **Click Type Configuration**: Choose between right-click or left-click activation for each item
\n– **Anti-Spam Protection**: Cooldown messages are rate-limited to prevent chat spam (max once per 3 seconds)
\n– **Easy Configuration**: Simple YAML configuration with default examples
\n– **Admin Commands**: Full command suite for managing cooldowns without editing config files
\n– **Automatic Reload**: Hot-reload configuration without server restart<\/p>\n
## \ud83c\udfaf Use Cases<\/p>\n
– **PvP Servers**: Balance powerful items like Golden Apples, Ender Pearls, and weapons
\n– **Survival Servers**: Prevent item spam and create strategic gameplay
\n– **Minigame Servers**: Control item usage in custom game modes
\n– **KitPvP**: Balance kit items with custom cooldowns
\n– **Any Server**: Add cooldowns to any item for better gameplay balance<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest version of **RC Cooldown** from the releases page
\n2. Place the `.jar` file into your server’s `plugins` folder
\n3. Restart your server or use `\/reload` command
\n4. Configure the plugin by editing `plugins\/RCCooldown\/config.yml`
\n5. Use `\/rccd reload` to apply changes<\/p>\n
## \u2699\ufe0f Config<\/p>\n
### Basic Configuration<\/p>\n
Open `plugins\/RCCooldown\/config.yml`:<\/p>\n
“`yaml
\n# Language: EN, RU, UA, ES, DE
\nlang: EN<\/p>\n
items:
\n # Enchantments
\n enchantment:riptide:
\n enable: true
\n cooldown: 15
\n click_type: right_click<\/p>\n
# Items
\n ENDER_PEARL:
\n enable: true
\n cooldown: 20
\n click_type: right_click
\n GOLDEN_APPLE:
\n enable: true
\n cooldown: 5
\n click_type: right_click
\n“`<\/p>\n
### Configuration Options<\/p>\n
– **lang**: Language for plugin messages (EN, RU, UA, ES, DE)
\n– **enable**: Enable or disable cooldown for this item (true\/false)
\n– **cooldown**: Cooldown duration in seconds
\n– **click_type**: Mouse click type (`right_click` or `left_click`)<\/p>\n
## \ud83d\udcdd Adding Items<\/p>\n
### Method 1: Edit Config File<\/p>\n
1. Open `plugins\/RCCooldown\/config.yml`
\n2. Add your item under the `items:` section:<\/p>\n
“`yaml
\nitems:
\n DIAMOND_SWORD:
\n enable: true
\n cooldown: 10
\n click_type: right_click
\n“`<\/p>\n
3. Save the file and run `\/rccd reload`<\/p>\n
### Method 2: Use Commands (Recommended)<\/p>\n
Use the `\/rccd add` command to add items directly in-game:<\/p>\n
“` **Examples:** ### Adding Enchantments<\/p>\n To add enchantments, simply use the enchantment name:<\/p>\n “` The plugin automatically detects if an ID is an item or enchantment – no prefix needed!<\/p>\n ### Finding Item IDs<\/p>\n – Use `\/rccd list` to see all active cooldowns ## \ud83c\udfae Commands<\/p>\n | Command | Description | Permission | ### Command Examples<\/p>\n “` ## \ud83c\udf0d Languages<\/p>\n The plugin supports 5 languages:<\/p>\n – **EN** – English Change language in `config.yml`: Language files are automatically created in `plugins\/RCCooldown\/lang\/` folder.<\/p>\n ## \ud83d\udd27 Mechanics<\/p>\n ### Smart Use Detection<\/p>\n The plugin automatically detects how items are used:<\/p>\n – **Food\/Consumables**: Cooldown activates after consumption ### Visual Cooldown<\/p>\n – Native Minecraft cooldown animation appears in the inventory ### Anti-Spam Protection<\/p>\n – Cooldown messages are limited to once per 3 seconds ## \ud83d\udca1 Benefits<\/p>\n ### 1. **Flexibility** ### 2. **Smart Detection** ### 3. **User-Friendly** ### 4. **Performance** ### 5. **Easy Management** ### 6. **Professional Features** ## \ud83d\udccb Defaults<\/p>\n The plugin comes with pre-configured cooldowns for popular items:<\/p>\n – **Riptide** (enchantment): 15 seconds You can modify or remove these as needed.<\/p>\n ## \ud83d\udc1b Troubleshooting<\/p>\n ### Cooldown not working? ### Messages not in my language? ### Item not found when adding? ## \ud83d\udcc4 Permissions<\/p>\n – `rccd.admin` – Access to all `\/rccd` commands (OP by default)<\/p>\n ## \ud83d\udd04 Updates<\/p>\n The plugin is actively maintained and updated. Check the releases page for: ## \ud83d\udcde Support<\/p>\n For support, bug reports, or feature requests, please visit the plugin’s page on Discord.<\/p>\n ## \ud83d\udcdc License<\/p>\n This plugin is provided as-is for use on Minecraft servers.<\/p>\n","protected":false},"excerpt":{"rendered":" RC Cooldown is a powerful and flexible Spigot plugin that allows server administrators to set custom cooldowns on any Minecraft items, weapons, and enchantments.<\/p>\n","protected":false},"featured_media":129435,"template":"","meta":{"_minecraft_slug":"rc-cooldown","_minecraft_project_id":"gubsgxLU","_minecraft_author":"rocketsops","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":186,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"rc-cooldown.zip","_minecraft_size_bytes":68456,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:57:52.376615Z","_minecraft_date_created":"2026-01-24T22:51:30.984788Z","_minecraft_date_modified":"2026-03-14T20:34:20.152750Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/rc-cooldown","_minecraft_icon_attachment_id":129435,"_minecraft_imported_at":"2026-06-07T14:56:58+00:00","_minecraft_import_hash":"d2c9d5ef93a30bbb7435cd4377992a97","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,90,127,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-129434","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/rccd add
\n“`<\/p>\n
\n“`
\n\/rccd add DIAMOND_SWORD right_click 10
\n\/rccd add riptide right_click 15
\n\/rccd add BOW left_click 5
\n“`<\/p>\n
\n\/rccd add riptide right_click 15
\n\/rccd add channeling right_click 10
\n“`<\/p>\n
\n– Minecraft item IDs are in UPPERCASE_WITH_UNDERSCORES format (e.g., `DIAMOND_SWORD`, `GOLDEN_APPLE`)
\n– Enchantment names are lowercase (e.g., `riptide`, `channeling`)<\/p>\n
\n|———|————-|————|
\n| `\/rccd reload` | Reload plugin configuration | `rccd.admin` (OP by default) |
\n| `\/rccd list` | List all active cooldowns | `rccd.admin` (OP by default) |
\n| `\/rccd add
\n| `\/rccd delete
\n\/rccd reload # Reload configuration
\n\/rccd list # Show all active cooldowns
\n\/rccd add MACE right_click 5 # Add 5-second cooldown to Mace
\n\/rccd delete ENDER_PEARL # Remove Ender Pearl cooldown
\n“`<\/p>\n
\n– **RU** – Russian (\u0420\u0443\u0441\u0441\u043a\u0438\u0439)
\n– **UA** – Ukrainian (\u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0430)
\n– **ES** – Spanish (Espa\u00f1ol)
\n– **DE** – German (Deutsch)<\/p>\n
\n“`yaml
\nlang: RU # Change to your preferred language
\n“`<\/p>\n
\n– **Weapons**: Cooldown activates after successful attack
\n– **Enchantments**: Cooldown activates after successful enchantment use (e.g., Riptide only activates when player actually flies)
\n– **Other Items**: Cooldown activates after successful interaction<\/p>\n
\n– Animation duration matches your configured cooldown time
\n– Works exactly like Ender Pearl cooldown animation
\n– Cooldown does not reset or update during active cooldown<\/p>\n
\n– Prevents chat spam when players repeatedly click items on cooldown
\n– Item usage is still blocked, but messages are rate-limited<\/p>\n
\n– Works with ANY Minecraft item, weapon, or enchantment
\n– No need to modify server code or use complex plugins
\n– Easy to add or remove cooldowns<\/p>\n
\n– Automatically detects item usage type
\n– No manual configuration needed for different item types
\n– Handles special cases like Riptide enchantment correctly<\/p>\n
\n– Visual cooldown animation for better UX
\n– Multi-language support for international servers
\n– Clear, informative messages<\/p>\n
\n– Lightweight and optimized
\n– No performance impact on server
\n– Efficient cooldown tracking<\/p>\n
\n– In-game commands for all operations
\n– No server restart needed for changes
\n– Simple YAML configuration<\/p>\n
\n– Rate-limited messages prevent spam
\n– Proper event handling prevents exploits
\n– Reliable cooldown tracking<\/p>\n
\n– **Ender Pearl**: 20 seconds
\n– **Golden Apple**: 5 seconds
\n– **Enchanted Golden Apple**: 30 seconds
\n– **Firework Rocket**: 3 seconds
\n– **Mace**: 5 seconds<\/p>\n
\n– Make sure `enable: true` in config
\n– Check that cooldown value is greater than 0
\n– Verify correct `click_type` (right_click\/left_click)
\n– Run `\/rccd reload` after config changes<\/p>\n
\n– Check `lang:` setting in config.yml
\n– Verify language file exists in `plugins\/RCCooldown\/lang\/`
\n– Run `\/rccd reload` after changing language<\/p>\n
\n– Use correct item ID format (UPPERCASE_WITH_UNDERSCORES)
\n– For enchantments, use lowercase name (e.g., `riptide`, not `RIPTIDE`)
\n– Check spelling – use `\/rccd list` to see examples<\/p>\n
\n– Bug fixes
\n– New features
\n– Performance improvements
\n– Additional language support<\/p>\n