Lazuli
Lazuli is a personal library mod for NeoForge, built to make modding a little less tedious through shared helper code.
What it does
Lazuli collects foundational helper code written for the author's own mods. Its block base class, AbstractBlockWithEntity, gives a block a block entity with less setup. Energy, inventory and fluid block entities have their own helper classes, including IEnergyBE, AbstractEnergyBE, AbstractCapacitorBE, AbstractGeneratorBE, IInventoryBE, AbstractInventoryBE, IFluidBE and AbstractSingleTankBE. Zoned block entities are covered by IZonedBE, a piece ripped from Minefactorial.
The library also holds client-side pieces: particle helpers and a two-dimensional particle engine for GUIs, named IParticleEngine2D and ScreenParticleEngine2D. The author describes it as a personal library that became a shared base, and the helpers are meant for use in other mods that depend on it.
Lazuli is published for 1.21 – 1.21.1 on NeoForge only, with the latest file 0.1.1+1.21.1 for 1.21.1. Installation covers the server and each player's game. The code is released under the MIT License and is open source.
Key features
Block entity base class
AbstractBlockWithEntity gives a block its block entity, so mods can skip the usual boilerplate.
Energy block helpers
Interfaces and abstract classes cover energy storage, capacitors and generators inside block entities.
Inventory and fluid helpers
Classes for inventories and single fluid tanks provide ready structure for item and fluid handling.
Zoned block entities
IZonedBE handles block entities split into zones, a pattern taken from Minefactorial.
2D particle engine
IParticleEngine2D and ScreenParticleEngine2D let a GUI draw and animate particles.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
FancyModLib is a NeoForge library for 1.21.11, released under All rights reserved and not open source. CooParticlesAPI is a particle library for Fabric and NeoForge on 1.21.1, under All rights reserved and not open source, so it covers particles only. Iceberg spans Fabric, Forge and NeoForge across 1.16.5 – 26.3 under a Creative Commons Attribution Non Commercial No Derivatives 4.0 license and is not open source. Lazuli is open source under the MIT License and covers block entities, energy, inventories and fluids as well as particles.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Lazuli | NeoForge | 1.21 – 1.21.1 | Client and server | 2025-07-15 |
| FancyModLib | NeoForge | 1.21.11 | Client and server | 2026-03-11 |
| CooParticlesAPI | Fabric and NeoForge | 1.21.1 | Client and server | 2026-08-14 |
| Iceberg | Fabric, Forge and NeoForge | 1.16.5 – 26.3 | Client and server | 2026-10-11 |
Questions
Does Lazuli need to be installed on the server?
Which loader does Lazuli support?
Can a mod use Lazuli's energy helpers?
In the catalog
Lazuli is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from EmmaTheMartian
Similar mods
What the author says
Lazuli is a personal library mod made to make modding a little less tedious. This library is the culmination of all the foundational and API code that I wrote for my mods. I started to dislike having to rewrite it all every time, so I decided that it's time to make Yet Another Library Mod.
Official listing
- Modrinth page
- modrinth.com/mod/lazuli
- Owner
- EmmaTheMartian
- Published
- 2025-06-18
- Updated on Modrinth
- 2025-07-15
- Facts verified
- 2026-10-15