
AerogelVK
AerogelVK moves Minecraft's terrain rendering to Vulkan — and only the terrain. Entities, UI and everything else keep rendering through the normal OpenGL pipeline, bridged by EXT_external_objects interop. The idea: use Vulkan's parallelism and GPU-driven rendering where it pays off, without breaking the mod ecosystem around it.
Why terrain only?
A full Vulkan replacement has to reimplement the entire render pipeline — and everything that hooks into rendering tends to break with it, while every Minecraft update becomes a major rewrite. It isn't automatically faster either: the real wins come from GPU-driven culling and meshing design, not from the API's name. And when a driver misbehaves, the whole game goes down with it.
AerogelVK takes the narrower bet: isolate the one part where Vulkan pays off — terrain — and keep everything else on the proven OpenGL path. If Vulkan is unavailable or fails to initialize, the mod steps aside and the game renders normally.
Features
- GPU-driven terrain: greedy meshing with 64-bit packed vertices, compute-shader frustum + Hi-Z occlusion culling, indirect draws
- Cascaded shadow maps (CSM) with texel snapping
- Built-in deferred PBR lighting, plus an optional lightweight Vanilla Lighting mode that mimics vanilla's lightmap look
- Iris-style shader pack support: a GLSL → SPIR-V transpiler runs BSL, Complementary, Sildur's and other popular packs on the Vulkan pipeline (14 packs tested)
- Shader pack render scale (0.5–1.0) and shadow resolution cap for low-end GPUs
- In-game settings screen via ModMenu + Cloth Config
- Playable chunk loading: near-first meshing with per-frame budgets instead of a load-time freeze
- Graceful fallback: if Vulkan 1.3 is unavailable, the mod steps aside and vanilla/Sodium renders as usual — no black world, no crash
Requirements & compatibility
- Minecraft 1.21.1, Fabric Loader 0.16+, Java 21
- Requires Cloth Config; ModMenu optional (for the settings screen)
- Designed to coexist with Sodium, Lithium and Distant Horizons
- A Vulkan 1.3-capable GPU and driver
Performance notes
Measured on an Intel HD Graphics 530 (iGPU): Hi-Z occlusion culling roughly doubled terrain throughput in a dense test scene versus culling disabled. Treat this as an experimental renderer under active development, not a Sodium replacement — feedback and bug reports are very welcome.
Known issues
- On Windows with Intel Gen9 integrated graphics, enabling an external shader pack can crash the Intel Vulkan driver (the built-in renderer works fine). A fix is in progress.
License
LGPL-3.0