VoxLib
by Mystery2099
VoxLib is a library of helper functions for building, combining, rotating and caching Minecraft's VoxelShape objects, used by mod developers.
What it does
Developers who write block shapes by hand often recreate the same cuboids, slabs, stairs and fences in many places. VoxLib supplies factories for these common shapes and lets cuboids be declared with Minecraft's ordinary 0 to 16 block coordinates. Shapes can be joined with operators such as +, and left or right rotations and flips are provided as utilities. Conditional assembly and bounded caching of repeated rotations and unions keep the code short and avoid recomputing the same results.
The library started as a collection of utilities inside Wooden Accents, which needed Fabric Language Kotlin under the same design. Its code was split into a separate project so other mods can reuse it without copying. It works with the existing VoxelShape system underneath rather than replacing it. The optional simplification tools produce less detailed outlines, and debug tools draw outline and collision shapes in-game. Mod Menu is optional. Builds are published for Fabric, Forge and NeoForge, and the environment is client and server, so both sides of a multiplayer game need it.
Key features
Cuboid and shape helpers
Cuboids are declared with block coordinates from 0 to 16, and common shapes such as slabs, pillars, tables, chairs, stairs and fences are ready-made.
Combining and rotating shapes
Shapes are joined with operators such as +, and left or right rotation and flipping are available as functions.
Cached results
Repeated rotations and shape unions are cached within fixed bounds, so the same work is not repeated each time.
Shape simplification and debugging
Optional tools produce less detailed outlines, and debug tools draw outline and collision shapes in the game world.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
Required by 1 mod
Use cases
Directional block variants
A developer who has written a north-facing block can derive the other directions with the rotation utilities, rather than writing each shape by hand.
Who it’s for: Mod developers who write block shapes in Kotlin or Java and want a shorter way to build, rotate and combine VoxelShape objects. Players who only use other mods have no direct interaction with the library.
Questions
Does Wooden Accents Mod need VoxLib installed?
Which loader and version should be installed?
Does Fabric Language Kotlin have to be installed?
In the catalog
VoxLib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 32,366 mods support Minecraft 1.21.1.
More from Mystery2099
Similar mods
What the author says
VoxLib is a lightweight Fabric and NeoForge library for working with Minecraft's VoxelShape system. It originally started as a collection of utilities inside my Wooden Accents Mod. I kept finding myself writing the same kinds of shape code over and over again, and since I was already using Kotlin, I started turning…
Official listing
- Modrinth page
- modrinth.com/mod/voxlib
- Owner
- Mystery2099
- Published
- 2023-12-02
- Updated on Modrinth
- 2026-09-18
- Facts verified
- 2026-10-15
