How to define a new biome in a Minecraft mod
A biome is a data file in data/<modid>/worldgen/biome. It sets the weather (temperature, downfall, precipitation), the colours of sky, fog and water, the mobs that spawn, the carvers and one list of features per generation step. The file only defines the biome. To put it in the world you place it in a dimension’s biome source, or add it to the overworld with a region library.
Works on Minecraft 1.20.1 to 26.3 on NeoForge; Minecraft 1.16.5 to 26.3 on Fabric; Minecraft 1.16.5 to 1.20.1 on Forge. Each example was compiled against its loader and version before it shipped in Linen.
- Write the biome JSON with its temperature, downfall and colours.
- Add spawners and features to the lists when you want them.
- Reference it as <modid>:<name> in a dimension’s biome source.
- Check the world loads without a registry error in the log.
What you can change
Section titled “What you can change”The example uses these values. Change them in the code.
| Setting | In the example | What it does |
|---|---|---|
| temperature | 0.1 |
Below 0.15 it snows instead of raining. Deserts use 2.0. |
| downfall | 0.8 |
How wet it is, 0 to 1. |
For each loader and version
Section titled “For each loader and version”The example mod is examplemod in the package com.example.examplemod. Use your own mod id and package.
Fabric and NeoForge 1.20.4 to 1.21.1, NeoForge 1.20.1 to 1.20.2
Section titled “Fabric and NeoForge 1.20.4 to 1.21.1, NeoForge 1.20.1 to 1.20.2”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": {}, "features": [[], [], [], [], [], [], [], [], [], [], []]}Fabric and NeoForge 1.21.2 to 1.21.10
Section titled “Fabric and NeoForge 1.21.2 to 1.21.10”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": [], "features": [[], [], [], [], [], [], [], [], [], [], []]}Fabric and NeoForge 1.21.11 to 26.2
Section titled “Fabric and NeoForge 1.21.11 to 26.2”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "attributes": { "minecraft:visual/sky_color": "#78a7ff", "minecraft:visual/fog_color": "#c0d8ff", "minecraft:visual/water_fog_color": "#050533" }, "effects": { "water_color": "#3f76e4" }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": [], "features": [[], [], [], [], [], [], [], [], [], [], []]}Fabric and NeoForge 26.3
Section titled “Fabric and NeoForge 26.3”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "attributes": { "minecraft:visual/sky_color": "#78a7ff", "minecraft:visual/fog_color": "#c0d8ff", "minecraft:visual/water_fog_color": "#050533" }, "effects": { "water_color": "#3f76e4" }, "carvers": [], "features": [[], [], [], [], [], [], [], [], [], [], []]}Forge 1.17.1 to 1.19.3
Section titled “Forge 1.17.1 to 1.19.3”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "precipitation": "rain", "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": {}, "features": [[], [], [], [], [], [], [], [], [], [], []]}Forge 1.19.4 to 1.20.1
Section titled “Forge 1.19.4 to 1.20.1”Uses:
Registries.BIOMEminecraft:biome
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": {}, "features": [[], [], [], [], [], [], [], [], [], [], []]}Fabric 1.16.5 to 1.19.3
Section titled “Fabric 1.16.5 to 1.19.3”Uses:
Registries.BIOMEminecraft:biome
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "precipitation": "rain", "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": {}, "features": [[], [], [], [], [], [], [], [], [], [], []]}Forge 1.16.5
Section titled “Forge 1.16.5”Uses:
worldgen/biomeminecraft:grass surface builder
This file defines the biome. A biome only appears where something places it: a custom dimension (see the dimension how-to), or a region mod on the overworld.
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "precipitation": "rain", "category": "plains", "depth": 0.125, "scale": 0.05, "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "surface_builder": "minecraft:grass", "carvers": { "air": [] }, "features": [[], [], [], [], [], [], [], [], [], []], "starts": [], "spawners": { "monster": [], "creature": [], "ambient": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}}Fabric 1.19.4 to 1.20.3
Section titled “Fabric 1.19.4 to 1.20.3”Uses:
Registries.BIOMEminecraft:biome
src/main/resources/data/examplemod/worldgen/biome/frozen_glade.json
{ "has_precipitation": true, "temperature": 0.1, "downfall": 0.8, "effects": { "sky_color": 7907327, "fog_color": 12638463, "water_color": 4159204, "water_fog_color": 329011 }, "spawners": { "monster": [], "creature": [], "ambient": [], "axolotls": [], "underground_water_creature": [], "water_creature": [], "water_ambient": [], "misc": [] }, "spawn_costs": {}, "carvers": {}, "features": [[], [], [], [], [], [], [], [], [], [], []]}Sources
Section titled “Sources”- https://docs.neoforged.net/docs/1.21.1/worldgen/
- https://docs.neoforged.net/docs/1.21.1/resources/server/
- https://docs.fabricmc.net/develop/
Related how-tos
Section titled “Related how-tos”- A new dimension
- An enchantment that heals you (lifesteal)
- Define a damage type
- Generate ore in the world
- Make a mob spawn in the world
In Linen
Section titled “In Linen”Linen’s How-tos library has this page too, with the example for your own mod’s loader and Minecraft version. Hover a name in your code and Linen points to the how-tos that explain it. Both are free. Download Linen.