How to install Biomes O' Plenty, step by step
A clear walkthrough for installing the Biomes O' Plenty mod: choosing a loader, adding TerraBlender and GlitchCore, and placing the files in your mods folder.
Biomes O' Plenty is a Minecraft: Java Edition mod, so installing it follows the same pattern as most content mods: install a mod loader, add the mod and the libraries it depends on, then start the game through that loader. The part that trips people up is matching versions. This guide walks through each stage in the order you should do it.
Before you start
Decide which Minecraft version you want to play and stick to it for every file you download. A jar built for one Minecraft version will not load on another, even if the numbers look close. It also helps to launch the plain version of Minecraft once through the official launcher, so that the game folder and the correct Java runtime already exist.
- Know your exact Minecraft version, including the last digit (for example 1.20.1, not just "1.20").
- Back up any world you care about before adding a world-generation mod.
- Close the game completely before copying files.
Pick your loader
The project's own installation notes tell players to download the recommended Forge, NeoForge or Fabric build for their Minecraft version. Which of those three is available depends on the version you picked:
- Forge covers the long history of the mod, including legacy lines like 1.12.2 and the popular 1.20.1 line.
- NeoForge builds are published for recent Minecraft releases.
- Fabric builds are published for recent releases as well; the Fabric version additionally needs Fabric API. Our Fabric setup guide covers that path in detail.
Run the loader's installer, choose "install client", and then start the new loader profile once from your launcher. That first launch creates the mods folder if it does not exist yet.
Collect the dependencies
Modern Biomes O' Plenty does not work alone. According to the mod's own project page:
- TerraBlender is required for Minecraft 1.18 and above. It is the library that blends new biomes into the vanilla terrain system.
- GlitchCore is required for Minecraft 1.20.4 and above, and also for 1.20.1 on mod version 19.0.0.91 or newer.
- Fabric API is required for the Fabric version.
Download each library for the same Minecraft version and the same loader as the mod itself. TerraBlender, for example, is published as separate Forge, NeoForge and Fabric projects, so grabbing the wrong one is an easy mistake.
Versions 1.17 and older do not use TerraBlender. Instead you choose the Biomes O' Plenty world type when creating a world. See the 1.12.2 guide if you are playing an older version.
Put the files in place
Copy the mod jar and every dependency jar into the mods folder of your Minecraft directory:
| System | Default mods folder |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
Place the jar files directly in mods, not inside a sub-folder and not still inside a zip archive. If you downloaded the source archive from the download section on our homepage, remember that it contains the project's source code rather than a ready-to-play jar; the download sources guide explains the difference.
First launch and first world
Start the game using the loader profile. If everything matches, you reach the main menu without an error screen. For Minecraft 1.18 and newer, no special world type is needed: new biomes are mixed into regular world generation. Create a new world, or travel to chunks you have never visited in an existing world, to see them.
After the first run, a configuration folder appears at config/biomesoplenty. You can leave it alone; the defaults are what most players use.
Using a third-party launcher
Launchers such as MultiMC let you create a separate instance for each modded setup. The process is the same in spirit: create an instance for your Minecraft version, add the loader, then add the mod and its libraries through the instance's mod list or by dragging the files into the instance window. Keeping modded play in its own instance also keeps your vanilla saves untouched.
If the game refuses to start, the crash fixes guide lists the errors people run into most often and what each one usually means.