Gnetum
Distribute HUD updates over multiple frames to improve performance
Screenshots
About this Mod
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.
Available Versions
How to Install Gnetum on Your Client
Install the Mod Loader Locally
Install fabric for your local Minecraft version.
Download the Matching File
Choose the Gnetum file for fabric and Minecraft 26.2.
Install Mod
Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.2-rc-1, 26.2-pre-6 (+14 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Does Gnetum need to be installed on the Minecraft server?
No. Modrinth marks Gnetum as unsupported on the server side. Install it only in your local Minecraft mods folder. Your server can remain unchanged unless the mod page lists an additional dependency.
Which version and loader does Gnetum require?
Use a file for fabric, forge, neoforge and your exact Minecraft version. Supported versions include 26.2, 26.2-rc-1, 26.2-pre-6. Files for different loaders are not interchangeable.
Gnetum is not working – what should I check?
First check the Minecraft version, loader version and required dependencies. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.
Similar Mods
Minecraft Server for Your Group
Gnetum stays on your client. Host a compatible world for your group.