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
- Install Fabric Loader for Minecraft
1.21.8.
- Install Fabric API.
- Download the PearlCooldowns
.jar file.
- Place the
.jar into your Minecraft mods folder.
- 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.
