PearlCooldowns

PearlCooldowns is a lightweight Fabric client-side mod for Minecraft PvP that shows a configurable cooldown timer for ender pearls.

It is designed for servers with custom pearl cooldowns, where vanilla cooldown visuals may not match the actual server rules.

Features

• Ender pearl cooldown overlay
• Timer shown directly on pearl item stacks
• Optional cooldown text below the crosshair
• Green OK text when pearls are ready
• Configurable cooldown duration in seconds
• Configurable countdown and OK colors
• Text size toggle: Small, Normal, Big
• Resets cooldown on death, disconnect, reconnect, and world changes
• Timer only starts when a pearl is actually thrown

How It Works

PearlCooldowns does not simply start the timer when you right-click.

Instead, it detects when an actual ender pearl entity is spawned by the local player. This means:

• Clicking while pearls cannot be thrown will not reset the timer
• Throwing a pearl successfully starts the timer
• Throwing another pearl resets the timer
• The cooldown display is based on the configured server cooldown

Usage

Open the config menu using:

O

You can also open the config through Mod Menu if installed.

From the config screen you can change:

• Pearl cooldown duration
• Whether OK is shown when ready
• OK display duration
• Countdown color
• OK color
• Crosshair text visibility
• Crosshair text size
• Crosshair Y offset

Installation

1. Install Fabric Loader for Minecraft 1.21.8.
2. Install Fabric API.
3. Download the PearlCooldowns .jar file.
4. Place the .jar into your Minecraft mods folder.
5. Launch the game with your Fabric profile.

Requirements

• Minecraft 1.21.8
• Fabric Loader
• Fabric API
• Java 21

Optional

• Mod Menu, for easier access to the config screen

Notes

PearlCooldowns is a client-side visual helper. It does not change pearl behavior, cooldowns, packets, or server-side gameplay.

The cooldown value should be set to match the server you are playing on.