Use cooldown

Minecraft Wiki article. Categories: Combat, Gameplay

📌 Mirrored from Minecraft Wiki

This article is reproduced from Use cooldown on the Minecraft Wiki. Mirrored from revision 3617016. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

An example of an item being affected by the use cooldown.

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:

Removed

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.

History

Java Edition
1.915w34cAdded the use cooldown, currently only used by ender pearls, chorus fruit, and shields.
1.21.224w34aMade the use_cooldown component a data component.

Sources