Skip to content

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.

  1. Write the biome JSON with its temperature, downfall and colours.
  2. Add spawners and features to the lists when you want them.
  3. Reference it as <modid>:<name> in a dimension’s biome source.
  4. Check the world loads without a registry error in the log.

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.

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.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

Uses:

  • worldgen/biome
  • minecraft: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": {}
}

Uses:

  • Registries.BIOME
  • minecraft: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": [[], [], [], [], [], [], [], [], [], [], []]
}

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.