

Modrinth · Fabric, Forge, NeoForge, Quilt
Subsurface on your Minecraft server
Subsurface runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
11 New cave/underground biomes
- Downloads
- 102.3K
- Author
- EMD123
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.20 – 26.2
- Updated
- –
Screenshots
What Subsurface looks like
Images: Subsurface on Modrinth, published by the project team.
Setup
Install Subsurface on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
6 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.2.
- 03
Install the mod
Search the mod browser for “Subsurface” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Subsurface is optional on the client. Players connect using the server address from the panel.
- On the server
- Required
- On the client
- Optional
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 26.2, 26.1.2, 26.1.1 +20 more
- License
- Apache License 2.0
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Subsurface · Modrinth- Fixes & Support continuesJune 23, 2026Minecraft 26.1, 26.1.1, 26.1.2, 26.2 · Fabric, Forge, NeoForge, Quilt
- Fixes & Support continuesJune 23, 2026Minecraft 26.1, 26.1.1, 26.1.2, 26.2 · datapack
- Support continuesDecember 13, 2025Minecraft 1.21.10, 1.21.11, 1.21.9 · Fabric, Forge, NeoForge, Quilt
- Support continuesDecember 13, 2025Minecraft 1.21.10, 1.21.11, 1.21.9 · datapack
- Added leaf litterJuly 30, 2025Minecraft 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 · Fabric, Forge, NeoForge, Quilt
Original description by the project author

Subsurface adds 11 new cave biomes to the overworld and nether. Subsurface cave biomes can generate inside of other vanilla cave biomes, creating hybrid cave biomes, and are compatible with almost all other datapacks/mods.
Cave Biomes
Icicle Caves
Icicle caves can spawn under snowy non-mountain biomes. They contain Icicles on the celling and the floor, and ice patches, which have blue ice if they replace deepslate. Aquifers in this cave biome are frozen over. Be careful when placing torches, as they could melt the ice and wash the torches away.
Sand Caves
Sand caves can spawn under the desert biome. They contain sand and sandstone patches. Some of the sand spawns floating, so be careful not to cause a cave-in.
Swamp Caves
Swamp caves can spawn under the swamp and mangrove swamp biomes. They contain mushrooms, dead bushes, vines, and patches of clay, mud, water and various dripleafs. Aquifers in this cave biome have lily pads and seagrass patches.
Underground Forest
Underground forests can spawn under biomes that generate oak trees. The ground here is covered in grass, and they contain mushrooms, vines, patches of coarse dirt, and oak trees. glow lichen spawns on the leaves
Coral Caves
Coral caves can spawn under the warm ocean biome. They only exist in aquifers and water caves. They contain coral, kelp and seagrass.
Foliage Caves
Foliage caves can spawn under jungle biomes. The ground here is covered in grass and ferns. Jungle bushes, jungle trees, mega jungle trees, and bamboo spawn here, and the caves contain mushrooms, vines, and glow lichen on the celling of large caves. Aquifers in this cave biome are made of mud and have seagrass patches. Caves that spawn close to the surface can have skylights.
Fungal Caves
Fungal caves can spawn under the mushroom island biome. The ground here is covered in mycelium, and large and small mushrooms. this biome also contains hanging mushroom roots, wall mushrooms, and glow lichen patches.
Mesa Caves
Mesa caves can spawn under mesa biomes. They contain red sand and red sandstone patches. colored terracotta spawns here, as well as terracotta plateaus.
Underground Taiga
Underground taigas can spawn under biomes that generate spruce trees. The ground here is covered in grass and ferns, and they contain mushrooms, vines, patches of coarse dirt, spruce trees, mega spruce trees, sweet berries, pumpkins, and mossy cobblestone rocks. glow lichen spawns on the leaves.
Soul Canyons
Soul canyons spawn in the nether in the nether wastes and soul sand valley. The ground here is covered in soul sand and soul soil. They contain nether wart, soul fire, fossils, giant nether warts, and weeping vines and nether wart blocks on the celling.
Quartz Canyons
Soul canyons spawn in the nether in the crimson and warped forests. They contain giant quartz crystals, and quartz ore can be found in the surrounding netherrack.
Extra Links
You can leave a comment on the PMC page!
Also check out: Better Lush Caves
Subsurface server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Subsurface run on?
According to Modrinth, Subsurface supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.2, 26.1.2, 26.1.1. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.
How much RAM does a server with Subsurface need?
As guidance, 4–6 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Server-ready
Xaero's Minimap
by thexaero
Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.
Server-ready
Xaero's World Map
by thexaero
Adds a full screen world map which shows you what you have explored in the world. Works great together with Xaero's Minimap.
Client only
Not Enough Animations
by tr7zw
Bringing first-person animations to the third-person
Client only
3D Skin Layers
by tr7zw
Render the player skin layer in 3d!
Ready for your server with Subsurface?
6 GB of RAM from €12.00 per month. 35% off your first month with MADO35.



