
The use cooldown (also known as recharge, item cooldown, or simply cooldown) is a mechanic that delays using an item for a given time. It is represented by a transparent white bar that appears over the item in the hotbar and inventory.
Mechanic
For most items that are affected by it, the use cooldown triggers after using the item, and is represented by a transparent white bar that decreases in height as the cooldown nears the end of its duration. The use cooldown affects all instances of a given item type that a player has, not just the one that was used. For shields specifically, the use cooldown activates when the shield has been disabled by an axe. For spears in Bedrock Edition specifically, the use cooldown activates after performing a jab attack.
Affected items
The following is a list of items that have a use cooldown:
Ender Pearl: 1 second / 20 ticks
Chorus Fruit: 1 second / 20 ticks
Ice Bomb: 1 second / 20 ticks[Bedrock Edition and Minecraft Education only]
Wind Charge: 1 second / 20 ticks
Goat Horn: 7 seconds / 140 ticks
Shield: 5 seconds / 100 ticks
Spear[Bedrock Edition only]
Wooden Spear: 0.65 seconds / 13 ticks
Stone Spear: 0.75 seconds / 15 ticks
Copper Spear: 0.85 seconds / 17 ticks
Golden Spear: 0.95 seconds / 19 ticks
Iron Spear: 0.95 seconds / 19 ticks
Diamond Spear: 1.05 seconds / 21 ticks
Netherite Spear: 1.15 seconds / 23 ticks
Snowball: 0.2 seconds / 4 ticks[upcoming: JE Combat Tests]
Egg: 0.2 seconds / 4 ticks[upcoming: JE Combat Tests]
Removed
Copper Horn: 7 seconds / 140 ticks
Attribute
In Java Edition, the use cooldown of a given item is controlled by its use cooldown data component:
- [NBT Compound / JSON Object] components: Parent tag.
- [NBT Compound / JSON Object] minecraft:use_cooldown: If present, this item applies a use cooldown to all items of the same type when it has been used.
- [Float] seconds: The use cooldown duration in seconds.
- [String] cooldown_group: The unique resource location to identify this cooldown group. If present, the item is included in a use cooldown group and no longer shares cooldowns with its base item type, but instead with any other items that are part of the same use cooldown group. Optional.
- [NBT Compound / JSON Object] minecraft:use_cooldown: If present, this item applies a use cooldown to all items of the same type when it has been used.
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.9 | 15w34c | Added the use cooldown, currently only used by ender pearls, chorus fruit, and shields. | |||||
| 1.21.2 | 24w34a | Made the use_cooldown component a data component. | |||||



