What TerraBlender works with.
| Platform | Java Edition |
|---|---|
| Loaders | Fabric, Forge, NeoForge, Quilt |
| Minecraft versions | 1.18.2, 1.19.2, 1.20.1, 1.20.4, 1.21.1, 1.21.8, 26.1, 26.1.2 |
| Environment | Client, Server |
TerraBlender is a library mod for Minecraft Java. It gives Fabric, Forge, NeoForge, and Quilt biome mods a shared system for adding custom biomes to the overworld and other dimensions without overwriting each other. It changes nothing in-game by itself, so install it only because a biome mod you use, such as Biomes O' Plenty or Terralith, lists it as a required dependency.
Why biome mods need TerraBlender
Vanilla Minecraft assigns each biome a fixed spot in world generation. When two mods both try to add biomes to the overworld the old way, one usually overwrites the other. TerraBlender solves that by giving every mod its own weighted region. Biomes O' Plenty uses it to slot lush, alien, and classic biomes into the standard overworld climate map, and heavier worldgen overhauls lean on the same system to blend reworked terrain in without conflicting with anything else installed. The weight a mod sets on its region controls how often its biomes show up relative to vanilla and other mods' regions.
Installing TerraBlender on Fabric, Forge, and NeoForge
TerraBlender ships separate builds per loader, so download the file that matches the mod you are installing it for. On Fabric it needs Fabric API as a required dependency. Forge and NeoForge builds carry no separate mod dependency.
- 1.Check which loader and Minecraft version the mod that needs TerraBlender targets.
- 2.Download the matching Fabric, Forge, NeoForge, or Quilt build from the source link on this page.
- 3.Drop the jar into the mods folder alongside the mod that requires it.
- 4.On Fabric, confirm Fabric API is installed too.
- 5.Match every version exactly. A build for the wrong Minecraft version or loader will crash on launch or fail to register biomes.
Release build vs beta channel
TerraBlender's last stable release-channel build is 3.3.0.12, published in January 2024 for Fabric, Forge, and NeoForge on Minecraft 1.20.4. Every build since has shipped on Modrinth's beta channel instead of a full release, including the newest one, 26.1.2.0.3 for Forge, Fabric, and NeoForge on Minecraft 26.1.2, published in July 2026. That is the honest state of the project: modern Minecraft support exists and updates regularly, but it has not graduated out of beta in over two years. Quilt lags further behind, still sitting on a 1.20.1 build from March 2025.
- Fabric: 26.1.2.0.3 (beta), Minecraft 26.1.2, published July 2026
- Forge: 26.1.2.0.3 (beta), Minecraft 26.1.2, published July 2026
- NeoForge: 26.1.2.0.3 (beta), Minecraft 26.1.2, published July 2026
- Quilt: 3.0.1.10 (beta), Minecraft 1.20.1, published March 2025
How TerraBlender's region system works
Fabric modding tutorial covering TerraBlender custom biomes
Questions about TerraBlender.
5 questions
What does TerraBlender do?
TerraBlender is a library mod that gives Minecraft Java biome mods a shared, weighted region system for adding custom biomes to the overworld and other dimensions. It has no biomes or features of its own. Mods like Biomes O' Plenty and Terralith use its API to register their content without overwriting vanilla or each other's world generation.
Do I need TerraBlender if I only use Biomes O' Plenty?
Yes. Biomes O' Plenty lists TerraBlender as a required dependency for adding its biomes to the standard overworld. Without it installed, Biomes O' Plenty will fail to load or will not generate its biomes, depending on the version you run.
Does TerraBlender work with NeoForge?
Yes. TerraBlender ships separate NeoForge builds alongside its Fabric, Forge, and Quilt builds. The newest beta, 26.1.2.0.3, covers NeoForge on Minecraft 26.1.2, so match the build you download to both your loader and your Minecraft version.
Which Minecraft version does TerraBlender support?
The last stable release, 3.3.0.12, covers Minecraft 1.20.4. Every build since has shipped on the beta channel, with the newest reaching Minecraft 26.1.2 for Fabric, Forge, and NeoForge. Quilt users are further behind, on a build for 1.20.1 published in March 2025.
Is TerraBlender safe to use on multiplayer servers?
TerraBlender runs on both client and server, and needs installing on each side to match. It is distributed under the LGPL-3.0 license through Modrinth, with no bundled installer or ad-laden download page, so treat it like any other required-side library mod and keep client and server versions identical.
