Hero Renderer Docs

~2 min read v2.1 Fabric

Overview #

Hero Renderer is a professional-grade, backend-independent rendering engine for Minecraft — the rendering foundation of the Hero Studios ecosystem. It incrementally replaces the vanilla rendering pipeline with a modular, multithreaded engine behind the HGFX graphics API, which ships complete OpenGL 4.6 and Vulkan backends plus a Null backend, all behind one abstraction. A frame-graph renderer handles pass scheduling, transient resources and resource aliasing; a modular multithreaded chunk renderer is presented inside Minecraft via a GL blit. Advanced visuals cover chunk and entity rendering, a water shader, sky, clouds, shadows, fog, bloom and colour grading. Adaptive performance adds bottleneck detection, dynamic quality scaling, a render-distance manager, distance/LOD management and impostors for distant geometry — all behind a version abstraction layer that proves API independence across Minecraft versions.

Minecraft's renderer is powerful but constrained. Hero Renderer is the Hero Studios rendering foundation — a modular, multithreaded engine behind its own graphics API (HGFX) that incrementally replaces the vanilla pipeline. Advanced graphics, rendering extensibility, and maximum performance, with a version abstraction layer that proves API independence.

Quick start #

  1. Install Fabric Loader and Fabric API for your Minecraft version — builds ship for 1.21, 1.21.1–1.21.5, 1.21.11 and 26.2 (Java 21 for 1.21.x, Java 25 for 26.x).
  2. Place the Hero Renderer JAR into your mods folder — v2.1 is a beta with real Fabric builds, for testing and feedback.
  3. Launch the game — the engine's frame is presented inside Minecraft via a GL blit; the chunk renderer runs behind the HGFX abstraction.
  4. Choose a backend if you want to: OpenGL 4.6 or Vulkan, both complete behind HGFX.
  5. Tune rendering quality from the engine's config — adaptive quality scaling, render distance, LOD and impostors.
  6. Explore the visuals: water shader, sky, clouds, shadows, fog, bloom and colour grading.
  7. Watch the adaptive performance layer — bottleneck detection scales quality dynamically to hold frame rate.

Configuration #

Rendering quality is tuned from the engine's config. Adaptive performance and the render-distance manager act on their own unless you override them.

SettingDefaultDescription
BackendOpenGL 4.6OpenGL 4.6 or Vulkan behind the HGFX abstraction; a Null backend also exists for testing.
Adaptive qualityEnabledBottleneck detection and dynamic quality scaling hold frame rate automatically.
Render distanceManagedA render-distance manager plus distance/LOD management with impostors for distant geometry.
Visual stackEnabledChunk and entity rendering, water shader, sky, clouds, shadows, fog, bloom and colour grading.

Frequently asked questions #

Is Hero Renderer released?
Yes — v2.1 is available as a beta with Fabric builds, for testing and feedback.
Which backends does it support?
OpenGL 4.6 and Vulkan, behind the HGFX abstraction — plus a Null backend for testing.
What versions are supported?
1.21, 1.21.1–1.21.5, 1.21.11, and 26.2 builds. Java 21 for 1.21.x, Java 25 for 26.x.
How does it relate to Hero Client?
It is the planned rendering foundation for Hero Client and future ecosystem products.
Does it replace the vanilla renderer?
It incrementally replaces the vanilla rendering pipeline — its frame is presented inside Minecraft via a GL blit.
What performance features are built in?
Bottleneck detection, dynamic quality scaling, a render-distance manager, distance/LOD management with impostors for distant geometry.
What is HGFX?
The backend-independent graphics API — a version abstraction layer that proves API independence across Minecraft versions, with complete OpenGL 4.6 and Vulkan backends.

Compatibility #

PropertyValue
Loader / platformFabric
Minecraft versions1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.11, 26.2
Latest version2.1

Fabric builds; Java 21 for 1.21.x, Java 25 for 26.x.

Learn more. Step-by-step walkthroughs live in the tutorials, with install guides for every platform and a general guide to configuration. Still stuck? Open the support portal and we'll reply from support@herostudios.dev.