Back to mods
LightAPI project artwork

CurseForge · Minecraft mod

LightAPI

High-performance dynamic lighting engine and spatial indexing API for Minecraft Fabric 1.21.11+. Features volumetric shapes, double-buffered bake pipeline, and multi-light grouping.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which LightAPI release should I use?

Updated 17 days ago
Latest stable file lightapi-1.0.jar
Game version 1.21.11
Loader Fabric

lightapi-1.0.jar targets 1.21.11 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is LightAPI required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does lightapi-1.0.jar need?

lightapi-1.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add LightAPI without breaking your instance.

Built for lightapi-1.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use lightapi-1.0.jar. It targets 1.21.11 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside lightapi-1.0.jar. It opens that exact file at the source.

About this project

What does LightAPI add?

💡 LightAPI

Fabric Minecraft Java Dependency

LightAPI is a next-generation dynamic lighting framework and spatial registry created for modern Minecraft (1.21.11+). Built to bridge the gap following Mojang's extensive GPU and vertex consumer pipeline overhaul (OrderedRenderCommandQueue, ModelCommandRenderer), LightAPI provides a resilient, clean, and thread-safe abstraction for registering, updating, and querying dynamic light sources in the world.


🚀 Key Features

  • 🌐 3D Spatial Partitioning:
    • Chunk-based spatial hashing (CellHasher, SpatialIndex) for (O(1)) spatial queries near players and cameras.
  • 🛡️ Thread-Safe Double Buffering (LightBaker):
    • Staged write-buffers and atomic snapshot swapping (LightSnapshot) ensure asynchronous light queries never cause concurrency locks or frame drops on the render thread.
  • 📐 Geometric Shapes & Volumetric Lighting:
    • Supports multiple volumetric emitters: SPHERE, VOLUME_BOX, CAPSULE, EDGE_CURVE, PLANE, ELLIPSE, and CONE.
    • Physics-based attenuation curves: LINEAR, QUADRATIC, and SMOOTH falloff.
  • 👥 Multi-Light Grouping (LightGroupManager):
    • Contiguous light fixtures (such as modular neon strips or linked light bars) automatically merge into unified volumetric groups, dramatically reducing GPU overhead.
  • 🔄 Decoupled Chromatic Math:
    • Modular Dual-Mode Architecture:
    • Standalone Mode: Zero external color dependencies. Operates as a pure vanilla lighting engine with 0–15 photometric scalar falloff.
    • Chromatic Mode: Dynamically detects ColorAPI via Fabric Loader / SPI (IColorEngineBridge) to unlock full multi-channel RGB/HSV spectral propagation without static bytecode coupling.

💻 Developer Quick Start

Add LightAPI to your build.gradle:

repositories {
    mavenCentral()
    mavenLocal()
}

dependencies {
    modImplementation "mb.bartra:colorapi:1.0"
    modImplementation "mb.bartra:lightapi:1.0"
}

Registering a Dynamic Light Source:

import mb.bartra.lightapi.LightAPI;
import mb.bartra.lightapi.core.LightRegistration;
import mb.bartra.lightapi.core.LightHandle;
import mb.bartra.lightapi.core.CompositeLightShape;
import mb.bartra.lightapi.engine.TickMode;
import net.minecraft.util.math.BlockPos;

// 1. Quick Registration
LightHandle handle = LightAPI.registerLight(pos, 15.0f, 0xFF5500);

// 2. Advanced Volumetric Registration
LightRegistration reg = new LightRegistration(pos, 15.0f, 0x00FF88)
    .compositeShape(CompositeLightShape.VOLUME_BOX)
    .tickMode(TickMode.REAL_TIME);

LightHandle advancedHandle = LightAPI.registerLight(reg);

// 3. Remove when done
LightAPI.removeLight(handle);

🧩 Dependencies

  • Fabric API (Required)
  • ColorAPI (Optional / Soft Dependency — enables multi-channel RGB chromatic lighting; operates in standalone monochrome mode if absent)

📄 License

MIT License. Free to use in any CurseForge or Modrinth modpack.

Project description from CurseForge.

Pick your setup

LightAPI by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

LightAPI versions and loaders

1 of 1 releases match

Looking for an older file? The official CurseForge project page is in Resources.