Lucis: The Light Engine Add-On That Supercharges Minecraft Lighting
If you have ever tried to spawn a truly enormous structure in Minecraft, you have probably watched your server grind to a halt while the vanilla light engine struggles to keep up. Every block placement triggers a cascade of light calculations, and when thousands of blocks change at once, the whole tick loop can collapse under the weight. Lucis is a lightweight, server-side light engine built to solve exactly that problem. It replaces the expensive parts of the vanilla lighting pipeline with a faster, region-based system designed for high update throughput, quicker chunk lighting, and better scaling across multi-core CPUs.
Originally a research project to understand how Minecraft's light engine works under the hood, Lucis ended up as a full rewrite because the original implementation simply was not fast enough for massive builds. The result is a mod that speeds up lighting by roughly 8-12x compared to vanilla and around 1.5x faster than ScalableLux or Starlight in many workloads.
What Lucis Actually Does
Lucis optimizes two distinct areas of the lighting pipeline. First, it accelerates chunk lighting during world generation at the chunk preparation stage. Second, it handles runtime block light and skylight updates after block changes. Rather than relying purely on vanilla per-update behavior, Lucis groups light changes by region, processes them asynchronously where possible, and then publishes the finished light data back to Minecraft's light engine in batches.
The core idea is simple: reduce the cost of lighting during heavy block updates, chunk loading, and skylight changes. This matters most when you are generating terrain, editing large areas, or spawning structures with an absurd number of blocks.
How the Region System Works
Minecraft stores light per section and updates it whenever blocks are placed, removed, generated, or changed. That works fine for normal gameplay, but it becomes a bottleneck when many light-affecting blocks need processing in a short window. Lucis changes this by collecting lighting work into regions, where a region is a small owned area of chunks processed as a single unit.
When a block update happens, Lucis records the change, groups it with nearby changes, and sends that work to its runtime lighting system. For chunk lighting, Lucis computes light during world generation using its own relighting path, reading the chunk and nearby light data before publishing finished sections back into the Minecraft light thread. The heavy calculation is separated from publishing, so final section data goes back in batches instead of one tiny task at a time.
Benchmarks: How Fast Is Lucis Really?
Testing on Minecraft 1.21.1 with NeoForge 21.1.234 showed impressive gains. In the block_toggle_border workload, Lucis hit 28881.8 ns/change against vanilla's 322846.1, an 11.18x improvement and 1.52x over ScalableLux. The roof_toggle workload saw a 9.04x gain over vanilla and 1.92x over ScalableLux. A second benchmark on Minecraft 26.2 with NeoForge 26.2.0.1-beta pushed block_toggle_border to a 10.09x improvement over vanilla and a staggering 7.99x over ScalableLux.
Across the board, Lucis also improves world generation speed by roughly 15-25% depending on the scenario. For players running large modpacks, that is a meaningful difference.
Supported Versions and Loaders
Lucis is built for NeoForge, with benchmarked builds targeting Minecraft 1.21.1 and the newer 26.2 release line. Because it hooks into Minecraft's chunk state and light engine rules, it is designed to avoid breaking other mods that read or implement their own light data. If you are unsure whether a build matches your setup, checking the mod's own version notes is the safest route before you download Lucis.
Compatibility Notes You Should Know
- ScalableLux and any Starlight fork are incompatible by definition. Choose Lucis or ScalableLux, never both, or you will hit repeated crashes.
- Sable is compatible, though Lucis does not currently inject light into Sable plots, so those projections still use vanilla lighting.
- Worldgen optimization mods such as Generator Accelerator, C2ME, Fast Noise, and ModernFix generally work fine alongside Lucis.
- Any mod that heavily replaces or modifies Minecraft lighting internals is very likely to conflict.
How to Install Lucis for Minecraft
Installing Lucis follows the standard mod workflow. Place the Lucis jar file into your mods folder, make sure you are running a matching NeoForge version, and remove any Starlight-based lighting mods first. After that, launch the game and let the new lighting pipeline take over.
If you would rather skip the manual file juggling, the foxygame.net launcher offers a one-click install path for Lucis, pulling the correct build straight into your profile and handling updates automatically so you never end up with a mismatched version. For server owners, the same jar works server-side, and Lucis is licensed under LGPLv3, so you can include it in personal or public modpacks as long as those license terms are respected.
Final Thoughts
Lucis is not just another Starlight fork. It is a genuinely different approach to light calculation, built by someone who wanted to understand the problem from the inside and then solve it properly. If your worldgen feels sluggish, your TPS tanks whenever you paste a giant build, or you simply want faster chunk lighting on a busy server, Lucis for Minecraft is well worth adding to your setup. Just remember the golden rule: Lucis or ScalableLux, never both.
===ARTICLE===