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