WorldgenFeatureFix: Stop Lake Feature Crashes in Minecraft

WorldgenFeatureFix patches the lake and snow_and_freeze crash in custom world generation, restoring stable chunk loading for Minecraft.

Download worldgenfeaturefix fabric for Minecraft 1.21.2-Snapshot

Original name: worldgenfeaturefix fabric

Minecraft: 1.21.2-Snapshot

Loaders: Fabric, Forge, NeoForge

FileVersionLoaderSize
worldgenfeaturefix-fabric-1.21-1.0.1.jar1.21.2-SnapshotFabric14 КБDownload
WorldgenFeatureFix-forge-1.21-1.0.1.jar1.21.2-SnapshotForge13 КБDownload
worldgenfeaturefix-neoforge-1.21-1.0.1.jar1.21.2-SnapshotNeoForge14 КБDownload

WorldgenFeatureFix

Custom world generation is one of the most exciting frontiers in modern Minecraft, letting datapack authors sculpt terrain that vanilla players never get to see. But if you have ever built a worldgen datapack that leans on the minecraft:lake or minecraft:snow_and_freeze placed features with water, you already know the pain. The chunk generator throws an exception, the world refuses to load properly, and your carefully designed biome turns into a crash report. WorldgenFeatureFix exists to solve exactly that problem.

What WorldgenFeatureFix Actually Fixes

The issue is documented in bug reports such as MC-273228 and MC-272370. When a custom datapack places a lake feature containing water, the chunk generator can crash during world generation. This is not a random glitch; it is a direct side effect of how Mojang optimized chunk generation in version 1.21.

In 1.21, chunk generation received heavy performance improvements. Those optimizations unintentionally broke the freeze detection logic inside the lake feature, because the feature may try to access chunks that are not currently accessible. Since Mojang only uses the lake feature for lava lakes in vanilla Minecraft, regular players never notice anything wrong. Custom world generators, however, hit the wall immediately.

How the Fix Works Under the Hood

WorldgenFeatureFix applies mixins that fall back to getUncachedNoiseChunk, which allows the lake feature to function correctly again. In practice, this means your water lakes generate as intended instead of triggering a hard crash. The mod is inspired by a community pull request that tackled the same root cause, and it packages that approach into a drop-in solution.

Supported Minecraft versions include 1.21 and later releases where the optimized chunk generation pipeline is active. The mod is built for the Fabric loader, so you will need Fabric API installed alongside it. If you are running a server, the fix works on both client and server sides, though servers benefit the most since chunk generation happens there.

A Word of Caution

The original pull request notes that LakeFeature is deprecated. Vanilla has moved away from using it for anything except lava lakes. The unsafe chunk error being suppressed here is actually an intentional safeguard against bad code, specifically the dead path in LakeFeature when creating water lakes. WorldgenFeatureFix makes the symptom disappear, but it is not a proper long-term solution. It can cause other, more serious problems to go undetected. Use it at your own risk, ideally on a test server before committing to a live world.

Installing WorldgenFeatureFix

If you want to download WorldgenFeatureFix, the process is straightforward. Here is how to install it on a typical Fabric setup:

  • Install the Fabric loader for your Minecraft version.
  • Place the Fabric API jar in your mods folder.
  • Drop the WorldgenFeatureFix jar into the same mods folder.
  • Launch the game and confirm the mod appears in your mod list.
  • Load a world that uses a custom lake or snow_and_freeze feature to verify the fix.

For players who prefer a smoother path, the foxygame.net launcher bundles WorldgenFeatureFix directly in its add-on catalog, so you can enable it with a single click and skip manual jar management entirely. That approach also handles version matching automatically, which saves time when you switch between Minecraft releases.

Who Should Use This Mod

WorldgenFeatureFix is aimed at a specific audience: datapack developers, modpack creators, and server owners who rely on custom terrain generation. If you only play vanilla Minecraft, you almost certainly do not need it, because vanilla never triggers the broken code path. If you build or run worlds with custom lake features, though, this mod can be the difference between a working server and a crash loop.

It is also worth pairing with careful testing. Generate a few chunks in a fresh world, check your logs for exceptions, and confirm that water lakes appear where your datapack intends them to. Because the mod suppresses a safeguard, keeping an eye on your logs is a smart habit rather than an optional one.

Final Thoughts

WorldgenFeatureFix for Minecraft fills a narrow but genuinely frustrating gap. It restores water lake generation for custom worldgen datapacks on Fabric, letting creators focus on design instead of debugging chunk generator crashes. Just remember the disclaimer: this is a workaround, not a cure. Treat it as a tool for development and controlled environments, test thoroughly, and keep an eye on future Minecraft updates that may change how the lake feature behaves.

===END===