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.
Quick answer
Which LightAPI release should I use?
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.
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.
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.
- 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.
- 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.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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
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.
- Chunk-based spatial hashing (
- 🛡️ 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.
- Staged write-buffers and atomic snapshot swapping (
- 📐 Geometric Shapes & Volumetric Lighting:
- Supports multiple volumetric emitters:
SPHERE,VOLUME_BOX,CAPSULE,EDGE_CURVE,PLANE,ELLIPSE, andCONE. - Physics-based attenuation curves:
LINEAR,QUADRATIC, andSMOOTHfalloff.
- Supports multiple volumetric emitters:
- 👥 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.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
LightAPI versions and loaders
lightapi-1.0.jar
2 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.