Sueta

CooldownsX

6.0.0.252

A plugin that adds configurable cooldowns to items.

·Config
  1. 6.0.0.252latestJul 5, 2025
    This is a list of changes since v5.1.1.231 For faster updates, please use the Jenkins builds: https://jenkins.sirblobman.xyz/job/SirBlobman/job/Cooldow… API Changes: · Bump version to 6.0.0-SNAPSHOT. · Rename multiple packages and add enum values. Plugin Changes: · Updated to Spigot API v1.21.7. · Updated to BlueSlimeCore v2.3.7. · Added a new cooldown type: PLACE_ENTITY · This type detects when entities are "placed". · Examples include armor stands and end crystals. · Update links in default configuration files. · Added configurable potion triggers.
    5115 downloads
  2. 5.1.1.231May 19, 2023
    Change Log: · Update to BlueSlimeCore 2.9-SNAPSHOT. · Added support for Folia. · Fix bug with packet cooldown not being delayed.
    6903 downloads
  3. 5.1.0.220Mar 16, 2023
    Change Log: · Update to BlueSlimeCore 2.7.0 and CombatLogX 11.2. · Fix outdated links in default cooldowns.yml.
    653 downloads
  4. 5.0.0.214Sep 20, 2022
    This is a major update, please read the full changelog. Change Log: · API methods and classes changed, any plugins that use the CooldownsX API will need to be updated. · Fix dictionary files not being saved properly. · Fixed potion detection and added a POTION_THROW cooldown type. · Fixed typo and error in CombatLogX checks. New example in cooldowns.yml Code (YAML): exampleSeven: cooldown : 30 cooldown-type : POTION_THROW potion-effect : - HARM amount : 2 reset-amount : true
    1196 downloads
  5. 4.4.0.140Aug 17, 2022
    This is a major update, please read the full changelog. Change Log: · Updated cooldowns.yml to use an improved format for setting up cooldowns. · Cooldowns can now have multiple materials and potion effects. · There are more cooldown types available. · Added support for cooldowns after a specific amount of times an action is taken. · Added better support for potion effects. · Added more examples in the default files. · Added support for different cooldowns during combat. (Requires CombatLogX) · Updated to BlueSlimeCore 2.5.1. · Updated all language files to use the new MiniMessage format instead of legacy color codes. · Added anonymous bStats metrics. New Default cooldowns.yml Code (YAML): ## These are the cooldowns that will be triggered by CooldownsX ## You can add as many entries as you need. ## Extra Information: ## material: https://github.com/CryptoMorin/XSeries/blob/master/src/ma… ## cooldown-type: https://github.com/SirBlobman/CooldownsX/blob/main/src/ma… ## potion-effect: https://github.com/CryptoMorin/XSeries/blob/master/src/ma… ## combat-mode: https://github.com/SirBlobman/CooldownsX/blob/main/src/ma… # Example One: Ender Pearl Cooldown of 10 seconds. exampleOne : # How many times can the action be done before the cooldown is triggered? # Default: 1 amount : 1 # Should CooldownsX reset the action count after the cooldown is triggered? reset-amount : false # How long must players wait before doing the action again? # Default: 10 seconds cooldown : 10 # Valid cooldown types can be found in the link above. # Default: INTERACT_ITEM cooldown-type : INTERACT_ITEM # Valid XMaterial types can be found in the link above. # Default: [] (Empty List) material : - ENDER_PEARL # The bypass permission is optional. # When the permission is not set or empty, bypass will not be possible for that item. # Default: No bypass bypass-permission : "cooldownsx.bypass.ENDER_PEARL" # The packet cooldown setting is optional and only works in Spigot 1.9 or higher. # This also requires a cooldown type with a material. # This will show a cooldown bar on the item itself, but may prevent some item features, such as crossbow reloading. # Default: false packet-cooldown : true # Requires CombatLogX # Valid combat modes can be found above. # Default: "IGNORE" combat-mode : "FALSE" # Requires CombatLogX and 'combat-mode: "DIFFERENT"' # Default: 5 seconds # combat-cooldown-seconds: 5 # A list of worlds in which this cooldown should be disabled. # If this option is not set, the cooldown will work in all worlds. # World names are case-sensitive. disabled-world-list : - "World2" - "wOrLd3" # Set this to true if the 'disabled-world-list' should be the list of enabled worlds instead. # Default: false disabled-world-list-inverted : false # What message will be displayed in chat when the player tries to do the action? # Default: "" (no message) message-format : "<red>You must wait <gray>{time_left}</gray> seconds before using <gray>{material}</gray> again.</red>" # The action bar section is optional. action-bar : # Should the action bar be enabled for this item? # Default: false enabled : true # What priority does this action bar have? # Higher priority means it will display on top of other cooldown action bars with lower priority. # If more than one item has the same priority, a random one may be chosen. # Default: 0 priority : 0 # What message will be displayed? # Placeholders: # {time_left}: The amount of time left in seconds. # Default: disabled (no message) message-format : "<green>Ender Pearl Cooldown:</green> <red>{time_left} seconds</red>" exampleTwo: cooldown : 5 cooldown-type : CONSUME_ITEM material : - CHORUS_FRUIT - GOLDEN_APPLE exampleThree: cooldown : 30 cooldown-type : CONSUME_ITEM material : - ENCHANTED_GOLDEN_APPLE action-bar: enabled : true priority : 1 message-format : "<green>Enchanted Golden Apple Cooldown:</green> <red>{time_left} seconds</red>" exampleFour: cooldown-type : UNDYING cooldown : 30 exampleFive: cooldown : 30 cooldown-type : POTION potion-effect : INCREASE_DAMAGE exampleSix: cooldown : 30 cooldown-type : INTERACT_ITEM material : - FIREWORK_ROCKET amount : 5 reset-amount : true
    446 downloads
  6. 4.3.0Jul 10, 2022
    4.3.0: · Update to Spigot 1.19. · Update to SirBlobmanCore 2.4.0 · Bumped XSeries to 9.0.0 to fix an issue with spawn egg materials. · Removed support for MVdWPlaceholderAPI. 4.2.0: · Add support for disabled worlds per-material.
    1562 downloads
  7. 4.1.2Oct 3, 2021
    Change Log: · Fixed potion material not being read correctly. · Fix MVdWPlaceholderAPI hook spamming placeholders by using a wildcard instead. · Slight improvements and code cleanup.
    1391 downloads
  8. 4.1.1Jun 28, 2021
    Change Log: · Fixed cooldown message still being sent in chat when it was set to an empty string.
    598 downloads
  9. 4.1.0Jun 12, 2021
    Change Log: · Updated SirBlobmanCore to 2.2.0 · Added support for 1.17
    250 downloads
  10. 4.0.3Apr 30, 2021
    Change Log: · Fixed totem cooldown not working correctly. · Please delete your undying.yml so that it can be regenerated correctly.
    393 downloads
  11. 4.0.2Apr 22, 2021
    Change Log: · Added placeholder support again. · Read the GitHub README for placeholder information. · https://github.com/SirBlobman/CooldownsX#placeholders
    151 downloads
  12. 4.0.1Apr 16, 2021
    Change Log: · Fix NullPointerException when checking cooldown values.
    125 downloads
  13. 4.0.03.2.3Mar 19, 2021
    Change Log: · Fixed crossbow reloading not working during cooldown. Check your config to make sure that 'packet-cooldown' is false if you are using cooldowns on weapons.
    385 downloads
  14. 3.2.34.0.0Mar 19, 2021
    You may need to reset your configuration files before installing this update. Change Log: · Added support for older versions by using XMaterial · Moved packet-cooldown option into the configuration section for each item. · Moved action bar settings into the configuration section for each item. · Added material dictionary option to rename material enums. · Added cooldown-type setting for each item.
    109 downloads
  15. 3.2.2Mar 6, 2021
    Change Log: · Fix typo in plugin.yml causing command registry error.
    171 downloads
  16. 3.2.1Mar 4, 2021
    Change Log: · Fixed reload command not working correctly. · Use /cooldownsx to reload the configuration files. Some changes may require a restart.
    122 downloads
  17. 3.2.0Jan 25, 2021
    Change Log: · Updated to SirBlobmanCore 2.0.0 · Added support for 1.16.5
    330 downloads
  18. 3.1.0Jan 6, 2021
    Change Log: · Added a configuration file for totems of undying. (undying.yml) Code (YAML): # How long is the cooldown between uses of undying totems? # Set this to -1 to disable the cooldown. # Default: 30 seconds totem-cooldown : 30000 # What message will be sent if a player can't use a totem due to cooldown? totem-message : "&cYou must wait &7{time_left} seconds&c before using another totem."
    215 downloads
  19. 3.0.1Nov 1, 2020
    Change Log: - Fixed issue with golden apple cooldowns not working when OldCombatMechanics was installed.
    381 downloads
  20. 3.0.0Sep 18, 2020
    The community on Spigot and Discord has voted and decided the the plugin should have the following features: · 1.13+ · Each material is configured separately (cooldown and bypass permission) · An API for developers to add their own cooldowns I have also fixed the discord link and updated the overview page.
    324 downloads
  21. 1.0.0May 31, 2020
    This plugin was previously known as Enderpearl Cooldown. The main description has been updated to reflect the features of CooldownsX
    750 downloads
  22. 3.33.2Oct 13, 2019
    - Fixed placeholders for PlaceholderAPI and MVdWPlaceholderAPI - Make sure to check the main page for updated placeholders.
    566 downloads
  23. 3.23.3Oct 13, 2019
    Removed debug message that spammed console for placeholders
    113 downloads
  24. 3.1Sep 11, 2019
    - Fixed possible bypass when clicking a block - Added config option for blocks to ignore (e.g. ender chest) .SpoilerTarget">Spoiler: Add this to your config Code (YAML): # A list of blocks that will be ignored when Enderpearl Cooldown checks interaction # # Default: # - "ENDER_CHEST" # - "CHEST" # - "CRAFTING_TABLE" ignore interaction blocks : - "ENDER_CHEST" - "CHEST" - "CRAFTING_TABLE"
    313 downloads
  25. 3.03.0 - RecodedAug 27, 2019
    This update has major changes so you will need to delete your old Enderpearl Cooldown folder and reconfigure it Change Log: - Improved code to prevent config and timer issues - Added option "cooldown mode" to choose between permission based and normal cooldown - Fixed crafting tables, buttons, and ender chests glitching the cooldown
    277 downloads
  26. 2.9Aug 23, 2019
    - Updated internal code to prevent issues with my other plugins - Fixed enderpearl disappearing glitch - Fixed mini-bug that prevent tiles from being opened if you right-clicked with an enderpearl during cooldown
    146 downloads
  27. 2.8Jul 23, 2019
    - Fixed 1.14.4 not being supported properly
    395 downloads
  28. 2.7Jun 30, 2019
    Fixed InvalidPluginException on startup when missing MVdWPlaceholderAPI.
    312 downloads
  29. 2.6Jun 29, 2019
    - Added new placeholder {time_left_decimal} This allows you to see more accurate timers e.g. 9.9 seconds instead of 10 seconds - Fixed action bar not working in 1.14
    126 downloads
  30. 2.5Jun 16, 2019
    Fixed config not generating properly on first startup
    265 downloads
  31. 2.4Mar 23, 2019
    - Fixed issue with blank config messages still sending a blank line
    518 downloads
  32. 2.3Mar 21, 2019
    - Fixed issues with 1.13 and 1.13.2 - Added fallback NMS to prevent errors
    142 downloads
  33. 2.22.1Dec 7, 2018
    - Fixed left-click bug
    430 downloads
  34. 2.12.2Dec 7, 2018
    - Left and right-click bug fix - 2.1 is broken, don't use it
    1 download
  35. 2.0Recode Time!Oct 10, 2018
    Made this entire plugin better with a full recode. If you find any bugs please report them on my discord. Requires a Config Reset! - Added action bar messages - All messages are configurable
    233 downloads
  36. 1.1.0Disabled WorldsMay 20, 2018
    You can now disable worlds in the config file
    307 downloads
  37. 1.0.9InventoryJan 28, 2018
    Added an inventory update after cancellation to prevent visual bugs
    223 downloads
  38. 1.0.8MVdWPlaceholderAPIJan 18, 2018
    Added variables for MVdWPlaceholderAPI - {enderpearlc_time_left}
    153 downloads
  39. 1.0.7Compatability with 1.8.8Jan 6, 2018
    Changes the way that items are checked to fix 1.8.8 compatability There should no longer be any "MainHand/OffHand" checks in 1.8.8
    196 downloads
  40. 1.0.6Sep 25, 2017
    Fixed cooldown being bypassed with off hand
    252 downloads
  41. 1.0.5Another config bug fix attemptSep 21, 2017
    Fixed another configuration null spam (make sure to backup your config, and always restart, never reload)
    139 downloads
  42. 1.0.4Right-Click BlocksSep 21, 2017
    The cooldown should now work properly, even when you right click a block
    127 downloads
  43. 1.0.3Entity ClickingSep 21, 2017
    Fixed enderpearl cooldown being bypassed by entity clicking
    132 downloads
  44. 1.0.2 (hotfix)BypassJun 19, 2017
    New Features: - Config option for bypass permission - Updated to 1.12
    227 downloads
  45. 1.0.2HotfixJun 19, 2017
    Hotfix: - fix null config spamming
    123 downloads
  46. 1.0.1Placeholder APIJun 8, 2017
    Added placeholder API support .SpoilerTarget">Spoiler: Variables %enderpearlc_time_left%: Amount of cooldown time left
    140 downloads

Similar projects

Config →