Type object
File match **/data/*/worldgen/biome/*.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/minecraft-data-pack-biome/latest.json
Source https://www.schemastore.org/minecraft-biome.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Configuration file defining a biome for a data pack for Minecraft

Properties

depth number

Used for terrain noise generation. Biomes with positive depth are considered land, biomes with negative depth are oceans https://minecraft.wiki/w/Custom_biome

scale number

Used for terrain noise generation. Vertically stretches the terrain. Lower values produce flatter terrain https://minecraft.wiki/w/Custom_biome

has_precipitation boolean

Controls if the current biome has precipitation

category string
Values: "none" "taiga" "extreme_hills" "jungle" "mesa" "plains" "savanna" "icy" "the_end" "beach" "forest" "ocean" "desert" "river" "swamp" "mushroom" "nether"
temperature number

A temperature for the current biome https://minecraft.wiki/w/Custom_biome

temperature_modifier string

A temperature modifier for the current biome https://minecraft.wiki/w/Custom_biome

Default: "none"
Values: "none" "frozen"
downfall number

A grass and foliage color for the current biome https://minecraft.wiki/w/Custom_biome

min=0max=1
player_spawn_friendly boolean
creature_spawn_friendly number

Spawns passive mobs as long as random value is less than this https://minecraft.wiki/w/Custom_biome

min=0max=1
effects object

Effect options for the current biome https://minecraft.wiki/w/Custom_biome

12 nested properties
fog_color integer
foliage_color integer

Decimal value converted from Hex color to use for tree leaves and vines. If not present, the value depends on humidity and temperature https://minecraft.wiki/w/Custom_biome

grass_color integer
sky_color integer
water_color integer
water_fog_color integer

Decimal value converted from Hex color to use for fog https://minecraft.wiki/w/Custom_biome

grass_color_modifier string
Default: "none"
Values: "none" "dark_forest" "swamp"
particle object

Particle options for the current biome https://minecraft.wiki/w/Custom_biome

2 nested properties
probability number

A particle spawning frequency for the current biome https://minecraft.wiki/w/Custom_biome

min=0max=1
options object

A particle type for the current biome https://minecraft.wiki/w/Custom_biome

All of: variant, variant, variant, variant, variant, variant
2 nested properties
type string

A particle type for the current biome https://minecraft.wiki/w/Custom_biome

value Record<string, any>

A particle state for the current biome https://minecraft.wiki/w/Custom_biome

ambient_sound string

Sound event to use for ambient sound https://minecraft.wiki/w/Custom_biome

mood_sound object

Settings for mood sound https://minecraft.wiki/w/Custom_biome

4 nested properties
sound string
tick_delay integer
block_search_context integer

Determines the cubic range of possible positions to play the mood sound. The player is at the center of the cubic range, and the edge length is 2 * block_search_extent + 1 https://minecraft.wiki/w/Custom_biome

offset integer
additions_sound object

Settings for additions sound https://minecraft.wiki/w/Custom_biome

2 nested properties
sound string
tick_chance integer
music object

Specific music that should be played in the biome https://minecraft.wiki/w/Custom_biome

4 nested properties
sound string
min_delay integer
max_delay integer
replace_current_music boolean

Whether or not to replace music which is already playing https://minecraft.wiki/w/Custom_biome

surface_builder string

The namespaced id of the configured surface builder to use https://minecraft.wiki/w/Custom_biome

carvers object

Carvers to use for the current biome https://minecraft.wiki/w/Custom_biome

2 nested properties
air string[]

Carvers used during air generation step for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
liquid string[]

Carvers used during liquid generation step for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
features string | array[]

Features for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
creature_spawn_probability number

A creature spawn probability for the current biome https://minecraft.wiki/w/Custom_biome

min=0exclusiveMax=1
starts string[]

The structures to generate in this biome https://minecraft.wiki/w/Custom_biome

spawners object

Entity spawning options for the current biome https://minecraft.wiki/w/Custom_biome

8 nested properties
monster object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
creature object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
ambient object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
water_creature object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
underground_water_creature object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
water_ambient object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
misc object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
axolotls object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome

uniqueItems=true
spawn_costs Record<string, object>

Entity identifiers for the current biome https://minecraft.wiki/w/Custom_biome

Definitions

spawner-options object[]

Spawner options for the current biome https://minecraft.wiki/w/Custom_biome