Gnetum

A Minecraft mod that improves performance by distributing HUD updates over multiple frames.

Overview

Gnetum divides a full HUD update into multiple "passes." Only one pass is rendered each frame, reducing the time taken on HUD updates and improving FPS.

Based on the rendering time of each element, Gnetum automatically distributes their updates over multiple frames, improving both the average FPS and the minimum.

Technical explanations

The idea behind Gnetum is to reduce the framerate of the HUD, which is not cheap to render and does not really change often, to improve the overall performance of the game, in a way that improves both the average and the minimum FPS. To achieve this:

• Gnetum employs two framebuffers, called a back framebuffer and a front framebuffer, respectively
• Each frame will render a "pass", that is, a (customizable) portion of the complete HUD, to the back framebuffer
• If the number of passes is set to 4, for example, a full HUD update is distributed over 4 frames, saving a lot of draw calls every frame and improving FPS
• After all passes finish rendering, the back framebuffer is "swapped" with the front framebuffer
• Each frame also renders the front framebuffer, which contains a texture of the full HUD

There is also an HUD FPS limiter that defines the maximum FPS of the HUD.

Configuration

Starting from 4.0.0, integration is implemented with Sodium Config API. The configuration can be accessed from the Video Screen, allowing for adjustment of:

• the number of passes
• maximum HUD FPS
• enabling/disabling caching for each element

Compatibility

1.20.1, 1.21.1 & 1.21.11

✔️ ImmediatelyFast: fully compatible and recommended.

1.12.2

⚠️ OptiFine: make sure "Fast Render" is disabled (this mod would do nothing otherwise.)

⚠️ StellarCore: make sure their HUD Caching feature is disabled (if you are unsure how to disable it you can ignore this: it's disabled by default.)

Credits

This mod is inspired by the HUDCaching mod by Moulberry.