CooldownLib is a simple and lightweight Fabric library that allows Minecraft mod developers to easily add cooldown systems to their mods.
Instead of creating custom timers, HashMaps, and tick logic for every ability or item, CooldownLib provides a clean and easy-to-use API for managing cooldowns.
Example:
Cooldown.trigger(player)
.key("fireball")
.ticks(20 * 10)
.message("§cFireball is still on cooldown!")
.run(() -> {
castFireball();
});
CooldownLib automatically handles:
Cooldown storage Multiple cooldowns per player Time calculation Cooldown expiration Custom cooldown messages Features
✅ Simple and readable Fluent API
✅ Multiple cooldowns per player
✅ Tick-based cooldown system
✅ Custom cooldown keys
✅ Custom cooldown messages
✅ Lightweight and easy to integrate
✅ Designed for Fabric 1.21.11 Why CooldownLib?
Many Minecraft mods need cooldown systems for:
Abilities Spells Weapons Special attacks Items Machines Custom mechanics
Without a library, developers often have to create their own cooldown handling system again and again.
CooldownLib provides a clean and reusable solution, allowing developers to focus on creating their gameplay features instead of rewriting cooldown code.
Installation
Add CooldownLib as a dependency to your Fabric mod.
Import:
import com.cooldown.lib.Cooldown;
Example:
Cooldown.trigger(player)
.key("dash")
.ticks(200)
.message("§cDash is still charging!")
.run(() -> {
performDash();
});
API Usage Create a Cooldown
Cooldown.trigger(player)
.key("ability")
.ticks(100)
.message("Ability is unavailable!")
.run(() -> {
// Your action here
});
Check a Cooldown
Cooldown.active(player, "ability");
Remove a Cooldown
Cooldown.clear(player, "ability");
Supported Versions
Minecraft: 1.21.11 Loader: Fabric Language: Java
