Fix GPU memory leak [Forge/Fabric]: what it does and how to install it

Fix GPU memory leak [Forge/Fabric]: what it does and how to install it

fix GPU memory leak is a small client-side mod for Minecraft Java that patches bugs where the game claims memory on your graphics card and never hands it back. It targets three OpenGL errors: GL_OUT_OF_MEMORY, GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT and GL_INVALID_FRAMEBUFFER_OPERATION. You drop one jar into your mods folder, add the Cupboard library next to it, and that is the whole job. Here is how to pick the right file, install it on Fabric, Forge or NeoForge, and what to try if the crashes carry on.

What the mod fixes

It plugs holes where Minecraft books space in video memory and then loses track of it.

Your graphics card has its own pool of memory, called VRAM, and it is separate from the RAM you hand the game in the launcher. Minecraft fills that pool with block textures, chunk meshes and a stack of off-screen images it draws into before you ever see a frame. Those off-screen images get made and thrown away constantly while you play. When the game drops one without telling the driver to release it, the space stays booked. Nothing gets it back until you quit.

What the mod fixes
Source: pcgamer

Play for an hour or two in a heavy pack and the pool runs dry. The driver then starts refusing new requests, and GL_OUT_OF_MEMORY turns up in your log. The other two errors are the same story from a different angle: the game tries to draw into one of those off-screen images and finds it in a broken state.

Big modpacks hit this wall first, and not because they are badly made. More mods means more custom rendering: minimaps redrawing themselves, machine screens, glowing outlines, extra dimensions with their own sky. Each of those asks the card for space, so a leak that would take a full day to matter in vanilla shows up inside an evening.

The mod comes from someaddon and lives on CurseForge, where it went up in July 2023 and has since passed 100 million downloads. The jar itself is about 6 KB, which tells you how narrow the job is. It is a client mod, and that matters in a minute.

Is a GPU memory leak actually your problem?

If your video memory climbs all session and never drops back, and restarting buys you another clean hour or two, you are looking at a leak.

The pattern is fairly distinct. Frame rate holds up for a while, then sags. Textures start flashing black or white where they should not. The game freezes for a few seconds, and either recovers with a jolt or closes on the spot. On some machines the screen blinks and window borders go plain for a moment, which is the driver resetting itself under you. None of that happens in the first ten minutes, and all of it goes away when you relaunch.

The trap is that Minecraft cannot show you this. The memory line on the F3 screen tracks the Java heap, which is ordinary system RAM. Video memory never appears there at all.

Raising the RAM slider in your launcher does nothing for a full graphics card. They are two separate pools, and the one that is filling up is the one Minecraft does not report.

On Windows, open Task Manager, go to Performance, pick your GPU and watch the Dedicated GPU memory graph while you play. A leak looks like a staircase that only goes up, including while you sit in the pause menu doing nothing. Your log says the same thing in words. A line reading java.lang.OutOfMemoryError: Java heap space is a RAM problem, and more RAM helps. A line about the OpenGL driver running out of memory is a VRAM problem, and more RAM will not touch it.

How to install it

Five steps, about five minutes.

How to install it
Source: pcgamesn
  • Write down your version and loader. Open your launcher or instance settings and note both, for example 26.2 on Fabric, or 1.21.11 on NeoForge. Nearly every failed install comes down to guessing one of these.
  • Grab the matching jar. Head to the mod’s files page on CurseForge and filter by your game version and loader. There are 31 release files there, covering game versions from 1.18.2 up to 26.2, so the filters save real time.
  • Grab Cupboard too. The mod needs Cupboard, a shared code library by the same author, and it has to be the build for your version and loader as well. Skipping this is the usual reason the game dies on startup afterwards.
  • Put both jars in the mods folder. On Windows that is %appdata%\.minecraft\mods, on macOS ~/Library/Application Support/minecraft/mods, on Linux ~/.minecraft/mods. If you use Prism, MultiMC or the CurseForge app, use that instance’s own mods folder instead of the default one. Do not unzip the jars.
  • Launch and watch. Check the mod list on the title screen to confirm both loaded, then play a long session with Task Manager open. Flat video memory after two hours means it worked.

Which file matches your setup

The file name tells you the loader, and CurseForge lists it in the Mod Loaders column next to every download.

Your loaderWhat to downloadExample file name
FabricThe jar with “fabric” in the namegpumemleakfix-fabric-26.2-1.9.jar
NeoForgeThe jar without “fabric” in the namegpumemleakfix-1.21.11-1.9.jar
ForgeFilter the files page to Forge and take the newest matchSame name pattern, older game versions

Version numbers changed shape in 2026, which throws people. Minecraft moved to year-based numbering, so the 1.21 line was followed by 26.1 in March and then 26.2 in June, not by 1.22. The newest build of the mod went up in July 2026 and covers 26.2.

If there is no file for your exact version, do not force an older one. A jar built against different game code usually fails to load or crashes on startup, and neither is worth the gamble.

Does the server need it as well?

No. It runs on the client only, so nobody else on your server has to install anything and the server itself needs no change.

This holds on multiplayer too. The mod adds no blocks, items or network messages, and it never touches world data, so you can add it to an existing save and pull it out again later with nothing lost. Every player who wants the fix installs it on their own machine.

When the crashes keep coming

If video memory still fills up with the mod installed, something else is holding onto it, and shaders are the first place to look.

Every time you switch shader packs or change a shader setting, the game builds a fresh set of buffers on the card. Do that a dozen times in one session and usage climbs whether or not any single mod is at fault. Restart the game after a round of shader tinkering rather than playing on.

When the crashes keep coming
Source: thisdaylive

The other suspects are worth working through in order, one change at a time:

  • High-resolution resource packs. A 128x or 256x pack can use several times the texture memory of a 16x one. Drop to 32x or 64x for a session and see if the crash goes away.
  • Render distance. Every loaded chunk costs memory on the card. Going from 16 down to 10 frees a lot more than it looks like it should.
  • Graphics drivers. Old drivers cause out-of-memory errors that no mod can patch around. Update them before you rebuild your whole mod list.
  • Background programs. Browsers, Discord and recording software all reserve video memory. Close them and rerun the same test.

If none of that helps, find the guilty mod by halving. Move half your mods out of the folder, play until you would normally crash, and see what happens. Whichever half breaks holds the culprit, so halve that one and repeat. Six or seven rounds gets you from 200 mods to one, and it beats guessing.

Watch out for the Java heap problem wearing the same costume. Slow decline, stutter and a freeze can also come from a leak in RAM, and that one is fixed by a different mod entirely and by a sensible allocation, usually 6 GB to 8 GB for a big pack. The log line you found earlier tells you which fight you are in.

Frequently asked questions

Which file do I need for Minecraft 26.2?

On Fabric, use the 26.2 Fabric build released in July 2026. On NeoForge, use the file listed under 26.2 in the Mod Loaders column. Add the matching Cupboard build for the same version either way.

Does this mod increase FPS?

Not directly. It stops the slow slide into stutter and crashing that a full graphics card causes, so long sessions stay smooth. For raw frame rate, a rendering mod like Sodium or Embeddium is the tool.

Will it work with Sodium, Iris or OptiFine?

Yes. It has no known incompatibilities and needs no setup beyond the jar, so it sits alongside rendering and shader mods without special ordering.

Does it work on Minecraft Bedrock Edition?

No. Bedrock has no mod loader, so this is Java Edition only, on Fabric, Forge or NeoForge.

My game crashes on startup after adding it. What went wrong?

Almost always a missing Cupboard library, or a jar built for a different loader or game version. Check both jars against your exact version, then read the crash log for the mod it names.

Conclusion

Install the jar that matches your version and loader, add Cupboard beside it, and the three OpenGL leaks this mod covers stop eating your video memory. A good result looks boring: memory that holds steady after two hours instead of climbing, and no crash when you finally head home from a long build session. If it still climbs, shaders, texture resolution and drivers are the next three things to test.

Related Post:

M4 Pro GPU Equivalent: What NVIDIA and AMD Cards It Matches

How to Fix “Could Not Find a Version That Satisfies the Requirement faiss-gpu”

Can You Use an AMD CPU With an Nvidia GPU?

Should You Overclock Your GPU? An Honest 2026 Answer

Do FreeSync Monitors Work With NVIDIA GPUs? Yes, Here’s How