AerogelVK

GPU-driven Vulkan terrain renderer for Fabric — greedy meshing, Hi-Z occlusion culling, CSM shadows, and Iris-style shader pack support, while the rest of the game stays on OpenGL.
AerogelVK
Create a server, get 25% off your first monthaffiliate logo
Create Server
affiliate banner image

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

AerogelVK Team

profile avatar
  • 2
    Projects
  • 23
    Downloads

More from Sakutarooo

  • Echo Engine project image

    Echo Engine

    Echo Engine is a physically simulated audio mod for Minecraft that models realistic sound propagation, occlusion, dynamic reverb, diffraction, structure-borne vibration, acoustic materials, and Simple Voice Chat integration.

    • 14
    • June 28, 2026
  • Echo Engine project image

    Echo Engine

    Echo Engine is a physically simulated audio mod for Minecraft that models realistic sound propagation, occlusion, dynamic reverb, diffraction, structure-borne vibration, acoustic materials, and Simple Voice Chat integration.

    • 14
    • June 28, 2026