CaveBiomesAPI
Mod adding custom world height limits and 3D biomes to 1.12.2!
About this Mod
CaveBiomesAPI
!!! It is a library mod! By defaultmeans byte-for-byte vanilla behavior. Everything is opt-in. !!!
CaveBiomesAPI is a core/library mod for Minecraft 1.12.2 designed specifically for mod developers. It significantly expands the vanilla world generation capabilities by introducing vertical (3D) biomes and custom world height limits.
If you've ever wanted to create massive underground ecosystems with different biomes stacked beneath the surface, or high mountains scrapping the sky, this API is for you!
Features
- Vertical Biomes (3D Biomes): Allows developers to generate completely different biomes at varying Y-levels (heights) in the same column. You can easily stack different biomes one under another (e.g., a lush surface biome with a glowing mushroom cave biome directly underneath).
- World Height Configuration: Gives modders the ability to easily configure and extend the world height limits in 1.12.2.
- Developer-Friendly: Provides a clean and accessible API to integrate complex underground world generation into your own mods.
Requirements
- Minecraft 1.12.2 / Forge 14.23.5.2864
- MixinBootstrap (runtime dependency)
For Developers
- Check the GitHub repo for API documentation and examples
Available Versions
How to Install CaveBiomesAPI on Your Server
Order Server
Order a Minecraft Java server with at least 4 GB RAM (6 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).
Install Mod
Open the mod browser in the dashboard and search for "CaveBiomesAPI". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.12.2
Server-side
✓ RequiredRecommended RAM
6 GB(min. 4 GB)Frequently Asked Questions
CaveBiomesAPI server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 4 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.
Is CaveBiomesAPI compatible with forge?
CaveBiomesAPI officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CaveBiomesAPI – how to optimize performance?
Recommended RAM: 6 GB (per 5 players). Use /spark profiler to check if CaveBiomesAPI consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install CaveBiomesAPI with just one click on your server.