Overview#
YUNG's Better Caves is a complete reimagining of the Minecraft underground. Originally created for older versions and now modernized for the latest releases, this mod replaces the standard vanilla cave generator with a sophisticated noise-based system. It introduces a variety of cave shapes, from tight, winding tunnels to massive, open-air caverns that can span dozens of chunks.

The mod is designed with a "Vanilla+" philosophy; it does not add new blocks, items, or mobs, ensuring total compatibility with other mods and resource packs. Instead, it focuses on the procedural generation of the environment itself, creating a more immersive and challenging exploration experience.
Cave Types#
The mod utilizes two primary noise-based generation types to create distinct underground environments. These types are often interconnected, leading to a seamless transition between different subterranean landscapes.
Type 1: Sinuous Caves (Cubic Noise)
These caves are characterized by their long, winding, and turbulent nature. They resemble traditional "worm" caves but with significantly more variety in width and height. They are often cramped near the surface and become more complex as the player descends.
Type 2: Spacious Caves (Simplex Noise)
Type 2 caves focus on more open, room-like structures. They feature shorter winding passages that frequently open into large, bulbous chambers. These are ideal for players looking for large-scale underground bases or massive ore veins.

Specialized Caverns#
Beyond standard tunnels, the mod generates specialized cavern biomes that drastically change the gameplay loop of caving.
| Cavern Type | Location | Primary Fluid | Description |
|---|---|---|---|
| Lava Caverns | Low Altitudes (near Bedrock) | Lava | Massive, open rooms where the floor is replaced by vast lava lakes. |
| Flooded Caves | Under Ocean/River Biomes | Water | Caves that are partially or entirely submerged, requiring aquatic gear to explore. |
| Underground Lakes | Various Altitudes | Water | Large pockets of water that break up standard cave systems. |
| Underground Rivers | Various Altitudes | Water | Long, flowing bodies of water that can span hundreds of blocks through tunnels. |


Mechanics & World Generation#
YUNG's Better Caves introduces several mechanical changes to how the world is structured:
- Bedrock Flattening: By default, the mod replaces the jagged, multi-layered vanilla bedrock with a single, flat layer. This can be configured for both the Overworld and the Nether, providing a clean floor for mining and building.
- Surface Openings: Cave entrances on the surface are more varied. Some appear as small cracks, while others are massive sinkholes leading directly into deep cavern systems.
- Transition Logic: The mod features smooth transition boundaries between different cave types and cavern regions, preventing the appearance of "straight walls" or unnatural chunk borders.
- Vanilla Integration: In modern versions (1.20.1+), the mod can be configured to generate alongside vanilla noise caves, combining the best of both generation styles for maximum variety.
Configuration#
The mod is highly customizable through its configuration files (typically found in config/bettercaves/). Users can adjust nearly every aspect of the generation.
Key Configuration Options
| Option | Default Value | Description |
|---|---|---|
Cave Frequency |
Very Common | Controls how often Type 1 and Type 2 caves generate. |
Cavern Size |
Large | Determines the average diameter of large open caverns. |
Liquid Altitude |
10 | The Y-level at which air is replaced by lava or water. |
Enable Bedrock Flattening |
True | Toggles the flat bedrock layer at the bottom of the world. |
Bedrock Layer Width |
1 | Sets how many layers of bedrock are generated. |
Water/Lava Block |
Vanilla | Allows the use of modded fluids for cave filling. |
Dimension Whitelisting
Players can specify which dimensions should use Better Caves generation. By default, it is enabled for the Overworld, but it can be added to the Nether or modded dimensions like The Beneath.
Compatibility#
YUNG's Better Caves is built to be compatible with the broader YUNG's Better series and other major world-gen mods:
- YUNG's Cave Biomes: Highly recommended to add actual biomes (like Lush or Dripstone) and custom mobs to the shapes generated by Better Caves.
- Alex's Caves: Fully compatible; Better Caves will generate around the specialized biomes added by Alex's Caves.
- Quark: Works seamlessly with Quark's underground features like crystal caves and stalactites.
- Tectonic/Terraforged: Compatible with large-scale terrain overhauls, though configuration may be needed to balance cave frequency.