View source for Minecraft:Biome definition (Bedrock Edition)

{{italic title|Bedrock Edition}}
{{WIP}}
Vanilla [[Minecraft:Biome|biomes]] can be modified and custom biomes can be added with [[Minecraft:JSON]] files within both [[Minecraft:behavior packs]] and [[Minecraft:resource packs]] in the {{File|directory|biomes|inline=1}} directories.

== Overview ==
A biome is an area in the world with distinct [[Minecraft:world generation]] features, gameplay effects, and client-side effects. While the world generation itself cannot be customized, [[Minecraft:features]] and [[Minecraft:terrain features]] added by a biome are data-driven and custom biomes can override parts of vanilla biomes in behavior packs.<ref>{{Citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/biomes/biomeoverview?view=minecraft-bedrock-stable|title=Biome JSON and Overview|website=Microsoft Learn}}</ref> Resource packs can customize existing biomes client-side for visual and audio effects.<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/clientbiomesreference/examples/clientbiomesoverview?view=minecraft-bedrock-stable|title=Client Biome JSON and Overview|website=Microsoft Learn}}</ref>

To customize a vanilla biome, e.g. a [[Minecraft:forest]], the behavior pack needs to contain a biome definition named {{File|file|forest.biome.json|inline=1}} containing the [[Minecraft:Biome/ID|biome ID]] with namespace (<code>minecraft:forest</code>) as object. In the resource pack, this needs a client biome definition named {{File|file|forest.client_biome.json|inline=1}} and the identifier (<code>forest</code>).

=== Custom biomes ===
More biomes can be added to the [[Minecraft:Overworld]] and [[Minecraft:the Nether]] by adding a biome definition utilizing the <code>minecraft:replace_biomes</code> object.<ref>{{Citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/biomes/custompartialbiomereplacement?view=minecraft-bedrock-stable|title=Custom Partial Biome Replacements|website=Microsoft Learn}}</ref> Custom biomes cannot use the <code>minecraft:</code> namespace.

A custom biome can replace vanilla biomes only, in vanilla dimensions. A noise defines what parts of the world will be assigned to vanilla biomes and what parts will be overridden by custom biomes. The <code>amount</code> (0-1) defines what the minimum noise value is to replace vanilla biomes with a custom biome, therefore at most half of the world can be replaced by entering 0. The <code>noise_frequency_scale</code> (0-100) defines the frequency of the noise; generally how small contiguous areas of custom biomes are. A custom biome can have different noise settings for different biomes to replace; e.g. replacing most of a beach biome while rarely replacing plains.

When multiple custom biomes conflict for biome replacement, the game separates these using noise.

Like vanilla biomes, client biome definitions can be assigned to custom biomes when the namespaced identifier is provided. Custom biomes can be added to [[Minecraft:Single Biome|single biome]] generation or as default biome for [[Minecraft:Custom dimension|custom dimensions]]. The Biome Data Assignment Tool in the ''[[Minecraft:Editor]]'' can work with custom biomes in active behavior packs.

== Behavior pack ==

<div class=treeview>
* {{nbt|compound}}
** {{nbt|string|format_version}}: The format version of the file, requires <code>"1.26.0"</code> for all current features.
** {{nbt|compound|minecraft:biome}}
*** {{nbt|compound|description}}
**** {{nbt|string|identifier}}: A [[Minecraft:namespaced identifier]] for the biome.
*** {{nbt|compound|components}}: Components used to define the biome's generation.
**** {{nbt|compound|minecraft:replace_biomes}}: Allows this biome to replace parts of one or more [[Minecraft:biome#List of biomes|vanilla biomes]].
***** {{nbt|list|replacements}}: The list of replacements
****** {{nbt|compound}}: ''A replacement''
******* {{nbt|string|dimension}}: The dimension in which this replacement can occur. Can be either {{cd|d=or|minecraft:overworld|minecraft:nether}}.
******* {{nbt|list|targets}}: The biomes that can be replaced.
******** {{nbt|string}}: A [[Minecraft:Biome/ID|biome ID]] <u>without namespace</u>.
******* {{nbt|float|amount}}: Chance that the replacement is attempted. Must be &gt;0.0 and &le;1.0.
******* {{nbt|float|noise_frequency_scale}}: Scale to alter the frequency of replacements. Lower values make bigger areas that are less common, and higher values make smaller areas that are more common. Must be &gt;0.0 and &le;100.0.
**** {{nbt|compound|minecraft:tags}}
***** {{nbt|list|tags}}: [[Minecraft:Tag (Bedrock Edition)|Tags]] that apply to this biome. A (custom) tag can be used elsewhere in the behavior pack to reference the biome. See [[Minecraft:Biome tag (Bedrock Edition)|here]] for vanilla tags.
**** {{nbt|compound|minecraft:climate}}
***** {{nbt|float|temperature}}: [[Minecraft:Temperature]], controls at what height rainfall transitions to snowfall and water freezes, changes grass, sky, and foliage tints, affects sponge drying.
***** {{nbt|float|downfall}}: [[Minecraft:Downfall]], mainly causes grass and foliage tints to change in terms of humidity (if not overridden in resource packs), and the random extinction of [[Minecraft:fire]]. If set to 0, no [[Minecraft:precipitation]] occurs.
***** {{nbt|list|snow_accumulation}}: [[Minecraft:Snow accumulation]], the first value controls how much snow is pre-generated (0 being one uniform layer, 0.125 randomized patches without snow and stacked near blocks, higher increases the snow piles), the second value controls the speed of snow accumulation during snowfall and must be equal to or higher than the first value.
**** {{nbt|compound|minecraft:humidity}}
***** {{nbt|boolean|is_humid}}: Whether or not the biome allows precipitation. This overrides the downfall property with 0 or 1 while leaving tints unaffected.
**** {{nbt|compound|minecraft:creature_spawn_probability}}
***** {{nbt|float|probability}}: Chance of creatures spawning when the chunk is generated. Must be &le;0.75.
**** {{nbt|compound|minecraft:map_tints}}
***** {{nbt|list}}{{nbt|string|foliage}}: The color foliage will be tinted by on a [[Minecraft:map]] in this biome for example {{cd|#6a7039}}. If not set, this defaults to the colormap determined by temperature and downfall.
***** {{nbt|compound|grass}}: The color grass will be tinted by on a [[Minecraft:map]] in this biome.  If not set, this defaults to the colormap determined by temperature and downfall. 
****** {{nbt|string|type}}: It could be {{cd|noise}} or {{cd|tint}}. When set to {{cd|noise}}, this will apply a secondary randomized temperature gradient in the biome and use the colormap to tint grass, like in [[Minecraft:swamps]].
****** {{nbt|string|tint}}: Available only if the type is tint, it is used to define the fixed color of the grass on the map, for example {{cd|#aea42a}}.
**** {{nbt|compound|minecraft:village_type}}
***** {{nbt|string|type}}: The type of [[Minecraft:village]] for this biome. Valid values are {{cd|d=and|default|desert|ice|savanna|taiga}}.
**** {{nbt|compound|minecraft:mountain_parameters}}: Parameters used to drive [[Minecraft:Slopes|mountain slope]] blocks.
***** {{nbt|boolean|east_slopes}}: Whether to have custom east-facing slopes.
***** {{nbt|boolean|west_slopes}}: Whether to have custom west-facing slopes.
***** {{nbt|boolean|north_slopes}}: Whether to have custom north-facing slopes.
***** {{nbt|boolean|south_slopes}}: Whether to have custom south-facing slopes.
***** {{nbt|compound|material}}: Block to use as steep material.
****** {{nbt|string|name}}: [[Minecraft:Identifier]] of the block.
****** {{nbt|compound|states}}: Block states for the block.
***** {{nbt|compound|top_slide}}: Controls the density tapering that happens at the top of the world to prevent terrain from reaching too high.
****** {{nbt|boolean|enabled}}
***** {{nbt|compound|steep_material_adjustment}}: Defines surface material for steep slopes.
****** {{nbt|boolean|east_slopes}}: Whether to have east-facing slopes.
****** {{nbt|boolean|west_slopes}}: Whether to have west-facing slopes.
****** {{nbt|boolean|north_slopes}}: Whether to have north-facing slopes.
****** {{nbt|boolean|south_slopes}}: Whether to have south-facing slopes.
****** {{nbt|compound|material}}: Block to use as steep material.
******* {{nbt|string|name}}: [[Minecraft:Identifier]] of the block.
******* {{nbt|compound|states}}: Block states for the block.
**** {{nbt|compound|minecraft:surface_builder}}
***** {{nbt|compound|builder}}: Controls the blocks used for [[Minecraft:Surface layer|surface layers]].
****** {{nbt|string|type}}: The type of surface builder. Can be {{cd|d=or|minecraft:capped|minecraft:frozen_ocean|minecraft:mesa|minecraft:overworld|minecraft:swamp|minecraft:the_end}}.
******; If <code>type</code> is <code>minecraft:capped</code><nowiki>:</nowiki>
****** {{nbt|compound}}{{nbt|string|beach_material}}: Material used near sea level.
******* {{nbt|string|name}}: [[Minecraft:Identifier]] of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|ceiling_materials}}: Material used for the surface ceiling.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|floor_materials}}: Material used for the surface floor.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|foundation_material}}: Material used to replace solid blocks that are not surface blocks.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|sea_material}}: Material used to replace air below sea level.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
******; If <code>type</code> is <code>minecraft:frozen_ocean</code> or <code>minecraft:overworld</code><nowiki>:</nowiki>
****** {{nbt|compound}}{{nbt|string|foundation_material}}: Material used to replace solid blocks that are not surface blocks.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|mid_material}}: Material used a layer below the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|integer|sea_floor_depth}}: How deep below sea level the sea floor should be. Must be &le;127.
****** {{nbt|compound}}{{nbt|string|sea_floor_material}}: Material used as a floor for bodies of water.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|sea_material}}: Material used to replace air below sea level.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|top_material}}: Material used for the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
******; If <code>type</code> is <code>minecraft:mesa</code><nowiki>:</nowiki>
****** {{nbt|boolean|bryce_pillars}}: Whether the mesa generates with [[Minecraft:Hoodoo|hoodoos]].
****** {{nbt|compound}}{{nbt|string|clay_material}}: Base clay material.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|foundation_material}}: Material used to replace solid blocks that are not surface blocks.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|hard_clay_material}}: Hardened clay material.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|boolean|has_forest}}: Adds coarse dirt and grass at high altitudes.
****** {{nbt|compound}}{{nbt|string|mid_material}}: Material used a layer below the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|integer|sea_floor_depth}}: How deep below sea level the sea floor should be. Must be &le;127.
****** {{nbt|compound}}{{nbt|string|sea_floor_material}}: Material used as a floor for bodies of water.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|sea_material}}: Material used to replace air below sea level.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|top_material}}: Material used for the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
******; If <code>type</code> is <code>minecraft:swamp</code><nowiki>:</nowiki>
****** {{nbt|compound}}{{nbt|string|foundation_material}}: Material used to replace solid blocks that are not surface blocks.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|integer|max_puddle_depth_below_sea_level}}: The depth at which surface blocks can be replaced with water for puddles. Must be &le;127.
****** {{nbt|compound}}{{nbt|string|mid_material}}: Material used a layer below the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|integer|sea_floor_depth}}: How deep below sea level the sea floor should be. Must be &le;127.
****** {{nbt|compound}}{{nbt|string|sea_floor_material}}: Material used as a floor for bodies of water.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|sea_material}}: Material used to replace air below sea level.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
****** {{nbt|compound}}{{nbt|string|top_material}}: Material used for the surface of the biome.
******* {{nbt|string|name}}: Identifier of the block.
******* {{nbt|compound|states}}: Block states for the block.
***** {{nbt|compound|minecraft:surface_material_adjustments}}: Specify fine changes to blocks used in terrain generation.
****** {{nbt|list|adjustments}}
******* {{nbt|compound}}: ''An adjustment''
******** {{nbt|string}}{{nbt|boolean}}{{nbt|float|height_range}}: {{More info}}
******** {{nbt|float|noise_frequency_scale}}: The scale to apply to the position when accessing the noise value.
******** {{nbt|list|noise_range}}: A range of noise values for which this adjustment should be applied.
******** {{nbt|compound|materials}}: Materials to use when this adjustment is active.
********* {{nbt|compound}}{{nbt|string|foundation_material}}: Material used to replace solid blocks that are not surface blocks.
********** {{nbt|string|name}}: [[Minecraft:Identifier]] of the block.
********** {{nbt|compound|states}}: Block states for the block.
********* {{nbt|compound}}{{nbt|string|mid_material}}: Material used a layer below the surface of the biome.
********** {{nbt|string|name}}: Identifier of the block.
********** {{nbt|compound|states}}: Block states for the block.
********* {{nbt|compound}}{{nbt|string|sea_floor_material}}: Material used as a floor for bodies of water.
********** {{nbt|string|name}}: Identifier of the block.
********** {{nbt|compound|states}}: Block states for the block.
********* {{nbt|compound}}{{nbt|string|sea_material}}: Material used to replace air below sea level.
********** {{nbt|string|name}}: Identifier of the block.
********** {{nbt|compound|states}}: Block states for the block.
********* {{nbt|compound}}{{nbt|string|top_material}}: Material used for the surface of the biome.
********** {{nbt|string|name}}: Identifier of the block.
********** {{nbt|compound|states}}: Block states for the block.
**** '''Deprecated components:''' 
<div class="collapsible collapsed collapsetoggle-inline"><!-- not sure how to do this -->
** {{nbt|compound|minecraft:overworld_generation_rules}}: Used for pre-[[Minecraft:Caves & Cliffs]] generation. Specifies where the biome generates.
*** {{nbt|string|generate_for_climates}}: Controls where the biome initially attempts to generate, a climate zone ({{cd|medium}}, {{cd|warm}}, {{cd|lukewarm}}, {{cd|cold}}, or {{cd|frozen}}), and the weight relative to other biomes in that climate zone. Note that {{cd|lukewarm}} can only be used for oceans; as climate zones are placed differently here. A biome can be made to generate in the rare climate zones with the <code>rare</code> tag.
*** {{nbt|list|}}{{nbt|string|hills_transformation}}: The identifier of the biome to replace it in hills areas. This can either be one string, or a list of array pairs, containing the identifier and the weight, to randomly select from multiple biomes.
*** {{nbt|list|}}{{nbt|string|mutate_transformation}}: The identifier of the biome to replace it in mutated areas.
*** {{nbt|list|}}{{nbt|string|river_transformation}}: The identifier of the biome to replace it at [[Minecraft:river]] noise.
*** {{nbt|list|}}{{nbt|string|shore_transformation}}: The identifier of the biome to replace it at the border of [[Minecraft:ocean]]s (<code>ocean</code> tag except <code>deep</code>).
** {{nbt|compound|minecraft:overworld_height}}: Used for pre-[[Minecraft:Caves & Cliffs]] generation. Specifies the noise parameters used to drive terrain height.
*** {{nbt|list|noise_params}}: 2 values, first is depth, and the second is scale.
*** {{nbt|string|noise_type}}: Uses a built-in preset instead of specifying values. Available presets are: <div class="collapsible collapsed collapsetoggle-inline">
**** {{cd|d=|list-level=******|beach|deep_ocean|default|default_mutated|extreme|highlands|less_extreme|lowlands|mountains|mushroom|ocean|river|stone_beach|swamp|taiga}}</div>
</div>
</div>

== Resource pack ==
<div class="treeview">
* {{nbt|compound}}
** {{nbt|string|format_version}}: The 3-part schema version used in the file, <code>"1.26.0"</code> is required for all current features.
** {{nbt|compound|minecraft:client_biome}}
*** {{nbt|compound|description}}
**** {{nbt|string|identifier}}: The [[Minecraft:Biome/ID|namespaced identifier]] of the biome.
*** {{nbt|compound|components}}
**** {{nbt|compound|minecraft:biome_music}}
***** {{nbt|string|music_definition}}: The set of [[Minecraft:music]] to be played in this biome, which can be defined in {{File|file|music_definitions.json|inline=1}}. Empty will result in no music in this biome.
***** {{nbt|float|volume_multiplier}}: A multiplier added to music volume while in the biome, between 0 and 1.
**** {{nbt|compound|minecraft:ambient_sounds}}: Regular [[Minecraft:ambience]] and underwater ambience for the biome.
***** {{nbt|string|addition}}: [[Minecraft:Sounds.json|Identifier]] of one or multiple sounds that occasionally play at the listener position.
***** {{nbt|string|loop}}: Sounds that loop while the listener position is inside the biome.
***** {{nbt|string|mood}}: Sounds that rarely play at a nearby air block position when the light level is low, which defaults to <code>ambient.cave</code>.
***** {{nbt|compound|underwater_addition}}
****** {{nbt|string|asset}}: Sounds that occasionally plays at the listener position underwater.
****** {{nbt|float|chance}}: How commonly this loop addition plays.
***** {{nbt|string|underwater_loop}}: Sounds that loops while the listener position is inside the biome underwater.
**** {{nbt|compound|minecraft:precipitation}}: [[Minecraft:Particles#Weather particles|Weather particles]], textures taken from <code>weather.png</code>. Only one type can be set.
***** {{nbt|float|ash}}: Density of ash particles and visuals from [[Minecraft:Basalt Deltas|basalt deltas]].
***** {{nbt|float|blue_spores}}: Density of blue spore particles and visuals from [[Minecraft:Warped Forest|warped forests]].
***** {{nbt|float|red_spores}}: Density of red spore particles and visuals from [[Minecraft:Crimson Forest|crimson forests]].
***** {{nbt|float|white_ash}}: Density of white ash particles and visuals from [[Minecraft:Soul Sand Valleys|soul sand valleys]].
**** {{nbt|compound|minecraft:water_appearance}}
***** {{nbt|string}}{{nbt|int array|surface_color}}: The color of the [[Minecraft:water]] surface without Vibrant Visuals; supports HEX string or RGB array.
***** {{nbt|float|surface_opacity}}: The opacity of the water surface without Vibrant Visuals, between 0 (invisible) and 1 (opaque).
**** {{nbt|compound|minecraft:grass_appearance}}
***** {{nbt|compound}}{{nbt|string|color}}: The color for biome-tinted [[Minecraft:grass blocks]]; supports HEX string or an object with a colormap.
****** {{nbt|string|color_map}}: The name of a colormap placed in {{File|directory|textures/colormaps|inline=1}}, without the <code>.png</code> suffix. Defaults to the <code>grass.png</code> colormap, based on temperature and downfall.
**** {{nbt|compound|minecraft:foliage_appearance}}
***** {{nbt|compound}}{{nbt|string|color}}: The color for biome-tinted [[Minecraft:foliage]]; supports HEX string or an object with a colormap.
****** {{nbt|string|color_map}}: The name of a colormap placed in {{File|directory|textures/colormaps|inline=1}}, without the <code>.png</code> suffix. Defaults to the <code>foliage.png</code> colormap.
**** {{nbt|compound|minecraft:dry_foliage_color}}
***** {{nbt|string}}{{nbt|int array|color}}: The color of dry foliage used to color [[Minecraft:Leaf Litter|leaf litter]]; supports HEX string or RGB array. When not specified, the color is calculated with the [[Minecraft:Dry foliage.png|<code>dry_foliage.png</code>]] colormap.
**** {{nbt|compound|minecraft:sky_color}}
***** {{nbt|string}}{{nbt|int array|color}}: The color of the [[Minecraft:sky]] without Vibrant Visuals; supports HEX string or RGB array.
**** {{nbt|compound|minecraft:fog_appearance}}
***** {{nbt|string|fog_identifier}}: The namespaced identifier of the [[Minecraft:fog]] definition used for this biome in {{File|directory|[[Minecraft:Fog definition|fogs]]|inline=1}}.
**** {{nbt|compound|minecraft:atmosphere_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|atmosphere_identifier}}: The namespaced identifier of the [[Minecraft:Vibrant Visuals]] atmospherics configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Atmospherics|atmospherics]]|inline=1}}.
**** {{nbt|compound|minecraft:color_grading_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The namespaced identifier of the Vibrant Visuals color grading configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Color Grading|color_grading]]|inline=1}}.
**** {{nbt|compound|minecraft:cubemap_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|cubemap_identifier}}: The namespaced identifier of the Vibrant Visuals cubemap configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Cubemaps|cubemaps]]|inline=1}}.
**** {{nbt|compound|minecraft:lighting_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The namespaced identifier of the Vibrant Visuals lighting configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Lighting|lighting]]|inline=1}}.
**** {{nbt|compound|minecraft:water_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The namespaced identifier of the Vibrant Visuals water configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Water|water]]|inline=1}}.
</div>
{{fnlist}}

== Videos ==
{{Yt|zMF3JPahrPQ}}

== History ==
{{HistoryTable
|{{HistoryLine|bedrock}}
|{{HistoryLine||?|Custom biomes were added}}
|{{HistoryLine||1.18.0|Custom biomes have become obsolete and impossible to create due to the world generation change.}}
|{{HistoryLine||1.20.60|dev=Preview 1.20.60.24|Biome tags are now specified under an array within the <code>minecraft:tags</code> component rather than as loose JSON objects.}}
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.23|Removed unused experimental json field {{cd|peaks_factor}} from {{cd|minecraft:mountain_parameters}} in the behavior pack biome file.}}
|{{HistoryLine||1.21.80|dev=Preview 1.21.80.27|exp=Custom biomes|Added {{cd|minecraft:replace_biomes}} component to allow for custom biomes to replace portions of vanilla biomes. To use, add to custom biome files in behavior packs.}}
|{{HistoryLine||1.21.100|dev=Preview 1.21.100.20|exp=Custom biomes|Custom biome names are no longer implied by their filenames. Biome names are explicitly specified via the {{cd|identifier}} property under the {{cd|description}} sub-object of their JSON definition.|Biome identifiers must now be namespaced (ex: {{cd|minecraft:plains}}). Biomes with a format version lower than 1.21.90 will have their identifier automatically prefixed {{cd|minecraft:}} when loaded if no namespace is already specified.}}
|{{HistoryLine|||dev=Preview 1.21.100.22|Added a new server side biome component {{cd|surface_builder}} that will combine the components {{cd|surface_parameters}}, {{cd|frozen_ocean_surface}}, {{cd|mesa_surface}}, {{cd|swamp_surface}}, {{cd|capped_surface}}, and {{cd|the_end_surface}} into one component. Each biome can only use one builder type. The component can be used for world generation settings such as foundation material and sea floor depth.|Added {{cd|minecraft:humidity}} component with {{cd|is_humid}} this forces a biome to either always be humid or never humid. Humidity effects the spread chance, and spread rate of fire in the biome.|Added {{cd|minecraft:partially_frozen}}. This component will impact the temperature in a frozen biome, causing some areas to not be frozen. Ex: patchy ice, patchy snow.}}
|{{HistoryLine||1.21.111|dev=Preview 1.21.110.20|exp=Custom biomes|Added {{cd|max_puddle_depth_below_sea_level}} to the {{cd|surface_builder}} biome component for the swamp builder type. The component will set the search depth for how far below sea level to search for a surface to add a puddle.|Removed support for loading custom biomes for base game versions 1.21.100 and below.}}
|{{HistoryLine||1.21.111|dev=Preview 1.21.110.25|Custom biomes were released from experimental.}}
|{{HistoryLine||26.0|dev=Preview 26.0.25|Added {{cd|minecraft:village_type}} biome component that determines the type of the [[Minecraft:village]] in the biome. This also allows for the generation of villages in the biome; not using this component means the village will never be generated in the biome.|Enabled the Biome Replacement feature in the [[Minecraft:Nether]], however, currently it doesn't work as well as it should.}}
|{{HistoryLine||26.20|dev=Preview 26.20.23|exp=Upcoming Creator Features|Added {{cd|minecraft:subsurface_builder}} biome component to apply surface generation rules below the Overworld's terrain surface. Includes {{cd|minecraft:noise_gradient}} builder type for placing block bands via Perlin noise distribution, with parameters {{cd|non_replaceable_blocks}} and {{cd|gradient_blocks}}.|{{cd|minecraft:surface_builder}} now suppose the type {{cd|minecraft:noise_gradient}} doing the same as mentioned above.}}
|{{HistoryLine||26.30|dev=Preview 26.30.25|{{cd|minecraft:subsurface_builder}} and {{cd|minecraft:surface_builder}} with {{cd|minecraft:noise_gradient}} type are now stable and no longer require experimental features. Requires {{cd|format_version}} 1.26.30 or higher.}}
|{{HistoryLine|||dev=Preview 26.30.29|Biome replacement in the [[Minecraft:Nether]] is now working as it should.}}
}}

== See also ==
* [[Minecraft:Biome definition (Java Edition)]]

== External links ==

* {{Citation|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/biomesreference/examples/componentlist?view=minecraft-bedrock-stable|title=Biomes Documentation|website=Microsoft Learn}}
* {{Citation|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/clientbiomesreference/examples/componentlist?view=minecraft-bedrock-stable|title=Client Biomes Documentation|website=Microsoft Learn}}

== References ==
{{reflist}}

== Navigation ==

{{Navbox Bedrock Edition}}