CooldownsX icon

CooldownsX -----

A plugin that adds configurable cooldowns to items.




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/CooldownsX/job/main/

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.
----------, Jul 5, 2025

Change Log:
  • Update to BlueSlimeCore 2.9-SNAPSHOT.
  • Added support for Folia.
  • Fix bug with packet cooldown not being delayed.
----------, May 20, 2023

Change Log:
  • Update to BlueSlimeCore 2.7.0 and CombatLogX 11.2.
  • Fix outdated links in default cooldowns.yml.
----------, Mar 16, 2023

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
 
----------, Sep 20, 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/main/java/com/cryptomorin/xseries/XMaterial.java
## cooldown-type: https://github.com/SirBlobman/CooldownsX/blob/main/src/main/java/com/github/sirblobman/cooldowns/object/CooldownType.java
## potion-effect: https://github.com/CryptoMorin/XSeries/blob/master/src/main/java/com/cryptomorin/xseries/XPotion.java
## combat-mode: https://github.com/SirBlobman/CooldownsX/blob/main/src/main/java/com/github/sirblobman/cooldowns/object/CombatMode.java

# 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
 
----------, Aug 17, 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.
----------, Jul 10, 2022

Change Log:
  • Fixed potion material not being read correctly.
  • Fix MVdWPlaceholderAPI hook spamming placeholders by using a wildcard instead.
  • Slight improvements and code cleanup.
----------, Oct 3, 2021

Change Log:
  • Fixed cooldown message still being sent in chat when it was set to an empty string.
----------, Jun 28, 2021

Change Log:
  • Updated SirBlobmanCore to 2.2.0
  • Added support for 1.17
----------, Jun 12, 2021

Change Log:
  • Fixed totem cooldown not working correctly.
  • Please delete your undying.yml so that it can be regenerated correctly.
----------, Apr 30, 2021

Change Log:
----------, Apr 22, 2021

Change Log:
  • Fix NullPointerException when checking cooldown values.
----------, Apr 16, 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.
----------, Mar 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.
----------, Mar 19, 2021

Change Log:
  • Fix typo in plugin.yml causing command registry error.
----------, Mar 6, 2021

Change Log:
  • Fixed reload command not working correctly.
  • Use `/cooldownsx` to reload the configuration files. Some changes may require a restart.
----------, Mar 4, 2021

Change Log:
  • Updated to SirBlobmanCore 2.0.0
  • Added support for 1.16.5
----------, Jan 26, 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."
     
----------, Jan 6, 2021

Change Log:
- Fixed issue with golden apple cooldowns not working when OldCombatMechanics was installed.
----------, Nov 1, 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.
----------, Sep 18, 2020

This plugin was previously known as Enderpearl Cooldown.
The main description has been updated to reflect the features of CooldownsX
----------, May 31, 2020

- Added support for 1.15.1
- Improved code significantly, should reduce lag and fix issues
- Messages set to "" in the config will not be sent to players
- Requires a config reset. Make sure to backup your old config and transfer any changes you made.
----------, Jan 8, 2020

Removed debug message that spammed console for placeholders
----------, Oct 13, 2019

- Fixed placeholders for PlaceholderAPI and MVdWPlaceholderAPI
- Make sure to check the main page for updated placeholders.
----------, Oct 13, 2019

- Fixed possible bypass when clicking a block
- Added config option for blocks to ignore (e.g. ender chest)

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"
 
----------, Sep 11, 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
----------, Aug 27, 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
----------, Aug 23, 2019

- Fixed 1.14.4 not being supported properly
----------, Jul 23, 2019

Fixed InvalidPluginException on startup when missing MVdWPlaceholderAPI.
----------, Jun 30, 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
----------, Jun 29, 2019

Fixed config not generating properly on first startup
----------, Jun 16, 2019

- Fixed issue with blank config messages still sending a blank line
----------, Mar 23, 2019

- Fixed issues with 1.13 and 1.13.2
- Added fallback NMS to prevent errors
----------, Mar 21, 2019

- Left and right-click bug fix
- 2.1 is broken, don't use it
----------, Dec 7, 2018

- Fixed left-click bug
----------, Dec 7, 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
----------, Oct 10, 2018

You can now disable worlds in the config file
----------, May 21, 2018

Added an inventory update after cancellation to prevent visual bugs
----------, Jan 28, 2018

Added variables for MVdWPlaceholderAPI
- {enderpearlc_time_left}
----------, Jan 18, 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
----------, Jan 6, 2018

Fixed cooldown being bypassed with off hand
----------, Sep 25, 2017

Fixed enderpearl cooldown being bypassed by entity clicking
----------, Sep 21, 2017

The cooldown should now work properly, even when you right click a block
----------, Sep 21, 2017

Fixed another configuration null spam
(make sure to backup your config, and always restart, never reload)
----------, Sep 21, 2017

Hotfix:
- fix null config spamming
----------, Jun 20, 2017

New Features:
-
Config option for bypass permission
- Updated to 1.12
----------, Jun 20, 2017

Added placeholder API support
%enderpearlc_time_left%: Amount of cooldown time left
----------, Jun 8, 2017

Resource Information
Author:
----------
Total Downloads: 20,521
First Release: Jun 8, 2017
Last Update: Jul 5, 2025
Category: ---------------
All-Time Rating:
33 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings