Skip to content

Fabric · NeoForge · Forge · Minecraft 1.20.1 – 26.3

CoolCatLib

Write it once, run it everywhere, and make it look purr-fect.

The foundation and the visuals for multi-loader Minecraft mods: one common codebase for Fabric, NeoForge and Forge, with no Architectury API needed.

Fabric NeoForge Forge Library Discord

The game with no effect A blue tint over the world Dark corners closing in on the view The world drained of color A red tint over the world The game with its colors inverted
Live Screen effects · No effect

One download, two halves

Core

net.ixdarklord.coolcatcore · the purr-fect foundation

Entrypoints that replace per-loader setup; events, registration, commands and networking; synced TOML configs; attachments; containers and storage menus; item decorators.

Getting started

Canvas

net.ixdarklord.coolcatcanvas · the cat's whiskers of visuals

Live post-processing shaders, layered skyboxes, world effects, block entity renderers, animated armatures, cutscenes, gradient and rainbow text, panels, pan & zoom views and easing curves. Its own mod, coolcatcanvas, inside CoolCatLib's jar.

Screen effects

Why CoolCatLib

  • Truly cross-loader

    Your logic lives in common. Events, registries, payloads, menus and client registries are bridged to every loader.

  • No boilerplate payloads

    Record payloads get their StreamCodec derived for you, from primitives to lists, maps, optionals and records.

  • Configs players love

    Typed values with ranges, presets and migrations. Server values sync live, and players edit them in game with Glazed Menu or Configured.

  • Data on anything

    Attachments on entities, block entities and item stacks, with sync policies, copy on death and change events.

  • Inventories done right

    Slot roles, per-face access, automation-style transfer and texture-free storage menus.

  • Visuals without the pain

    Shader effects with per-frame uniforms, layered skies, animated models from Blockbench, gradient text and outlines.

A thirty-second tour

MyMod.java — runs on Fabric, NeoForge and Forge alike
public class MyMod implements ModConstructor {
    public static final ConfigBuilder CONFIG = Config.builder("mymod", ConfigScope.SERVER);
    public static final ConfigValue<Integer> MAX_HOMES = CONFIG.intValue("maxHomes", 3).range(0, 64).slider().build();

    @Override
    public void onConstructMod() {
        CONFIG.build(); // (1)!
        Network.registerServerbound(PingPayload.class, (payload, context) -> // (2)!
                context.getPlayer().sendSystemMessage(Component.literal("Pong from " + payload.pos())));
        PlayerEvents.JOIN.register(player -> // (3)!
                player.sendSystemMessage(ColorGradient.RAINBOW.literal("Welcome, " + player.getName().getString() + "!")));
    }
}

public record PingPayload(BlockPos pos) implements CustomPacketPayload {
    public static final Type<PingPayload> TYPE = new Type<>(Identifier.fromNamespaceAndPath("mymod", "ping"));
    @Override public Type<PingPayload> type() { return TYPE; }
}
  1. Registers and loads config/mymod-server.toml. Its values sync to every client, and players can edit it in game with Glazed Menu or Configured.
  2. A record payload: CoolCatLib derives its network codec from the record's components.
  3. An animated rainbow message, drawn by Canvas wherever the text shows up.

How it fits together

flowchart LR
    subgraph YourMod["Your mod"]
        C["common module<br/>ModConstructor · ClientModConstructor"]
        F["fabric"]
        N["neoforge / forge"]
    end
    subgraph CCL["CoolCatLib"]
        CORE["Core<br/>events · registries · network<br/>configs · attachments"]
        CANVAS["Canvas (coolcatcanvas)<br/>effects · skyboxes · armatures · GUI"]
    end
    F -- "coolcatlib:* entrypoints" --> C
    N -- "NeoForgeModEntrypoint<br/>ForgeModEntrypoint" --> C
    C --> CORE
    C --> CANVAS
    CANVAS --> CORE

Versions and loaders

Minecraft Latest NeoForge Forge Fabric Source
26.3 9.0.0+26.3 – 26.3
26.2 9.0.0+26.2 – 26.2
26.1 – 26.1.2 9.0.0+26.1.2 – 26.1.2
1.21 – 1.21.1 9.0.0+1.21.1 1.21
1.20.1 9.0.0+1.20.1 – 1.20.1

About these docs

The pages are written against 26.1.2; 26.2 and 26.3 have the same API. Pages say when something is newer than the latest release, or missing from a version. The backports share the same API, adjusted for their Minecraft version: ResourceLocation instead of Identifier, GuiGraphics instead of GuiGraphicsExtractor, and a Forge entrypoint.