CooldownLib

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

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