Luminance Block Entities - Fabric
Lighting in Minecraft has always been a bit rigid. A torch glows, a glowstone block glows, and that's mostly it. But what if your chest could cast a warm glow when you open it, or a furnace could brighten the room while it smelts? That is exactly the problem Luminance Block Entities - Fabric solves. This lightweight utility API lets block entities emit light into the world, and it does so without touching blockstates at all.
What This Fabric Mod Actually Does
At its core, this is a library mod aimed at developers, but regular players benefit from it too. Any mod that depends on it can make block entities like chests, furnaces, dispensers, and hoppers produce light, similar to how a redstone lamp works. The key difference is that it completely skips blockstates. That matters because blocks with many states already carry a lot of overhead, and adding lighting variants on top of that gets messy fast.
Because the API avoids blockstates entirely, it is ideal for mods that need fine-grained control over lighting or that add complex blocks with dozens of states. Instead of swapping states to change brightness, the block entity simply reports a luminance value, and the world lighting updates accordingly.
Supported Versions and Loader
As the name suggests, this is a Fabric-only mod. There is no Forge or NeoForge build, and the author is upfront about that limitation. It targets modern Minecraft releases, so check the download page for the exact Minecraft versions supported before you grab it. If you run a Fabric profile, you are good to go.
For Players: Installing and Using It
Most people will encounter this mod as a dependency. If another mod lists it as required, you do not need to configure anything. Just drop the jar into your mods folder alongside your other Fabric mods and launch the game.
If you want to download Luminance Block Entities - Fabric manually, the process is straightforward:
- Make sure Fabric Loader and Fabric API are installed for your Minecraft version.
- Download the jar that matches your game version.
- Place it in the
modsfolder inside your Minecraft directory. - Launch the Fabric profile and confirm the mod appears in your mod list.
If you are wondering how to install it without hunting through folders, the foxygame.net launcher handles the whole process in a single click, and its catalog keeps Luminance Block Entities - Fabric updated automatically whenever a new compatible build appears. That takes the guesswork out of matching versions.
For Developers: How the API Works
The developer side is where this mod shines. Setup is quick: place the jar somewhere in your Fabric development environment, add a flatDir entry pointing to that directory in your build.gradle repositories, and add the mod implementation line to your dependencies. Swap the version string for whichever build you are using, and you are ready to code.
Extending LuminanceBlockEntity
Instead of extending the vanilla BlockEntity class, your block entity extends LuminanceBlockEntity. The constructor takes a LuminanceBehavior enum that decides how lighting is resolved:
- IGNORE — only the block entity's light counts; blockstate lighting is ignored. This is the usual choice.
- FALLBACK — use the block entity's light when it is above zero, otherwise fall back to the blockstate's light.
- PRIORITY — prefer the blockstate's light, falling back to the block entity when the state emits nothing.
After that, you implement getLuminance and return whatever value you like. When the value changes, call updateLuminance to refresh the world lighting. Only call it when the light level has genuinely changed, since the update is somewhat expensive. A bundled example block entity, loaded through LuminanceBlockEntitiesMod.initializeExample(), generates a random light value between 0 and 15 every tick so you can see the effect in action.
Final Thoughts
Luminance Block Entities - Fabric for Minecraft fills a niche that vanilla lighting simply cannot handle, and it does so cleanly. Players get smoother, more dynamic lighting from dependent mods, while developers get a small, focused API that avoids the blockstate bloat. If you are building a Fabric modpack or writing your own mod, this is one library worth keeping in your toolkit.