Minecraft:Biome definition (Bedrock Edition)

Template:Italic title Template:WIP Vanilla 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 Template:File 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>Template:Citation</ref> Resource packs can customize existing biomes client-side for visual and audio effects.<ref>Template:Cite</ref>

To customize a vanilla biome, e.g. a Minecraft:forest, the behavior pack needs to contain a biome definition named Template:File containing the biome ID with namespace (minecraft:forest) as object. In the resource pack, this needs a client biome definition named Template:File and the identifier (forest).

Custom biomes

More biomes can be added to the Minecraft:Overworld and Minecraft:the Nether by adding a biome definition utilizing the minecraft:replace_biomes object.<ref>Template:Citation</ref> Custom biomes cannot use the minecraft: 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 amount (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 noise_frequency_scale (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 single biome generation or as default biome for custom dimensions. The Biome Data Assignment Tool in the Minecraft:Editor can work with custom biomes in active behavior packs.

Behavior pack

Template:Nbt
- Template:Nbt: The format version of the file, requires "1.26.0" for all current features.
- Template:Nbt
  - Template:Nbt
    - Template:Nbt: A Minecraft:namespaced identifier for the biome.
  - Template:Nbt: Components used to define the biome's generation.
    - Template:Nbt: Allows this biome to replace parts of one or more vanilla biomes.
      - Template:Nbt: The list of replacements
        Template:Nbt: A replacement
        Template:Nbt: The dimension in which this replacement can occur. Can be either Template:Cd.
        
        Template:Nbt: The biomes that can be replaced.
        Template:Nbt: A biome ID without namespace.
        
        Template:Nbt: Chance that the replacement is attempted. Must be >0.0 and ≤1.0.
        
        Template:Nbt: 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 >0.0 and ≤100.0.
    - Template:Nbt
      - Template:Nbt: Tags that apply to this biome. A (custom) tag can be used elsewhere in the behavior pack to reference the biome. See here for vanilla tags.
    - Template:Nbt
      - Template:Nbt: Minecraft:Temperature, controls at what height rainfall transitions to snowfall and water freezes, changes grass, sky, and foliage tints, affects sponge drying.
      - Template:Nbt: 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.
      - Template:Nbt: 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.
    - Template:Nbt
      - Template:Nbt: Whether or not the biome allows precipitation. This overrides the downfall property with 0 or 1 while leaving tints unaffected.
    - Template:Nbt
      - Template:Nbt: Chance of creatures spawning when the chunk is generated. Must be ≤0.75.
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color foliage will be tinted by on a Minecraft:map in this biome for example Template:Cd. If not set, this defaults to the colormap determined by temperature and downfall.
      - Template:Nbt: 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.
        Template:Nbt: It could be Template:Cd or Template:Cd. When set to Template:Cd, this will apply a secondary randomized temperature gradient in the biome and use the colormap to tint grass, like in Minecraft:swamps.
        
        Template:Nbt: Available only if the type is tint, it is used to define the fixed color of the grass on the map, for example Template:Cd.
    - Template:Nbt
      - Template:Nbt: The type of Minecraft:village for this biome. Valid values are Template:Cd.
    - Template:Nbt: Parameters used to drive mountain slope blocks.
      - Template:Nbt: Whether to have custom east-facing slopes.
      - Template:Nbt: Whether to have custom west-facing slopes.
      - Template:Nbt: Whether to have custom north-facing slopes.
      - Template:Nbt: Whether to have custom south-facing slopes.
      - Template:Nbt: Block to use as steep material.
        Template:Nbt: Minecraft:Identifier of the block.
        
        Template:Nbt: Block states for the block.
      - Template:Nbt: Controls the density tapering that happens at the top of the world to prevent terrain from reaching too high.
        Template:Nbt
      - Template:Nbt: Defines surface material for steep slopes.
        Template:Nbt: Whether to have east-facing slopes.
        
        Template:Nbt: Whether to have west-facing slopes.
        
        Template:Nbt: Whether to have north-facing slopes.
        
        Template:Nbt: Whether to have south-facing slopes.
        
        Template:Nbt: Block to use as steep material.
        Template:Nbt: Minecraft:Identifier of the block.
        
        Template:Nbt: Block states for the block.
    - Template:Nbt
      - Template:Nbt: Controls the blocks used for surface layers.
        Template:Nbt: The type of surface builder. Can be Template:Cd.
        If type is minecraft:capped:
        
        Template:Nbt Template:Nbt: Material used near sea level.
        Template:Nbt: Minecraft:Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface ceiling.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface floor.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace solid blocks that are not surface blocks.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace air below sea level.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        If type is minecraft:frozen_ocean or minecraft:overworld:
        
        Template:Nbt Template:Nbt: Material used to replace solid blocks that are not surface blocks.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used a layer below the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt: How deep below sea level the sea floor should be. Must be ≤127.
        
        Template:Nbt Template:Nbt: Material used as a floor for bodies of water.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace air below sea level.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        If type is minecraft:mesa:
        
        Template:Nbt: Whether the mesa generates with hoodoos.
        
        Template:Nbt Template:Nbt: Base clay material.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace solid blocks that are not surface blocks.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Hardened clay material.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt: Adds coarse dirt and grass at high altitudes.
        
        Template:Nbt Template:Nbt: Material used a layer below the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt: How deep below sea level the sea floor should be. Must be ≤127.
        
        Template:Nbt Template:Nbt: Material used as a floor for bodies of water.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace air below sea level.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        If type is minecraft:swamp:
        
        Template:Nbt Template:Nbt: Material used to replace solid blocks that are not surface blocks.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt: The depth at which surface blocks can be replaced with water for puddles. Must be ≤127.
        
        Template:Nbt Template:Nbt: Material used a layer below the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt: How deep below sea level the sea floor should be. Must be ≤127.
        
        Template:Nbt Template:Nbt: Material used as a floor for bodies of water.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace air below sea level.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
      - Template:Nbt: Specify fine changes to blocks used in terrain generation.
        Template:Nbt
        Template:Nbt: An adjustment
        Template:Nbt Template:Nbt Template:Nbt: Template:More info
        
        Template:Nbt: The scale to apply to the position when accessing the noise value.
        
        Template:Nbt: A range of noise values for which this adjustment should be applied.
        
        Template:Nbt: Materials to use when this adjustment is active.
        Template:Nbt Template:Nbt: Material used to replace solid blocks that are not surface blocks.
        Template:Nbt: Minecraft:Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used a layer below the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used as a floor for bodies of water.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used to replace air below sea level.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
        
        Template:Nbt Template:Nbt: Material used for the surface of the biome.
        Template:Nbt: Identifier of the block.
        
        Template:Nbt: Block states for the block.
    - Deprecated components:

- Template:Nbt: Used for pre-Minecraft:Caves & Cliffs generation. Specifies where the biome generates.
  - Template:Nbt: Controls where the biome initially attempts to generate, a climate zone (Template:Cd, Template:Cd, Template:Cd, Template:Cd, or Template:Cd), and the weight relative to other biomes in that climate zone. Note that Template:Cd 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 rare tag.
  - Template:Nbt Template:Nbt: 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.
  - Template:Nbt Template:Nbt: The identifier of the biome to replace it in mutated areas.
  - Template:Nbt Template:Nbt: The identifier of the biome to replace it at Minecraft:river noise.
  - Template:Nbt Template:Nbt: The identifier of the biome to replace it at the border of Minecraft:oceans (ocean tag except deep).
- Template:Nbt: Used for pre-Minecraft:Caves & Cliffs generation. Specifies the noise parameters used to drive terrain height.
  - Template:Nbt: 2 values, first is depth, and the second is scale.
  - Template:Nbt: Uses a built-in preset instead of specifying values. Available presets are:
    - Template:Cd

Resource pack

Template:Nbt
- Template:Nbt: The 3-part schema version used in the file, "1.26.0" is required for all current features.
- Template:Nbt
  - Template:Nbt
    - Template:Nbt: The namespaced identifier of the biome.
  - Template:Nbt
    - Template:Nbt
      - Template:Nbt: The set of Minecraft:music to be played in this biome, which can be defined in Template:File. Empty will result in no music in this biome.
      - Template:Nbt: A multiplier added to music volume while in the biome, between 0 and 1.
    - Template:Nbt: Regular Minecraft:ambience and underwater ambience for the biome.
      - Template:Nbt: Identifier of one or multiple sounds that occasionally play at the listener position.
      - Template:Nbt: Sounds that loop while the listener position is inside the biome.
      - Template:Nbt: Sounds that rarely play at a nearby air block position when the light level is low, which defaults to ambient.cave.
      - Template:Nbt
        Template:Nbt: Sounds that occasionally plays at the listener position underwater.
        
        Template:Nbt: How commonly this loop addition plays.
      - Template:Nbt: Sounds that loops while the listener position is inside the biome underwater.
    - Template:Nbt: Weather particles, textures taken from weather.png. Only one type can be set.
      - Template:Nbt: Density of ash particles and visuals from basalt deltas.
      - Template:Nbt: Density of blue spore particles and visuals from warped forests.
      - Template:Nbt: Density of red spore particles and visuals from crimson forests.
      - Template:Nbt: Density of white ash particles and visuals from soul sand valleys.
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color of the Minecraft:water surface without Vibrant Visuals; supports HEX string or RGB array.
      - Template:Nbt: The opacity of the water surface without Vibrant Visuals, between 0 (invisible) and 1 (opaque).
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color for biome-tinted Minecraft:grass blocks; supports HEX string or an object with a colormap.
        Template:Nbt: The name of a colormap placed in Template:File, without the .png suffix. Defaults to the grass.png colormap, based on temperature and downfall.
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color for biome-tinted Minecraft:foliage; supports HEX string or an object with a colormap.
        Template:Nbt: The name of a colormap placed in Template:File, without the .png suffix. Defaults to the foliage.png colormap.
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color of dry foliage used to color leaf litter; supports HEX string or RGB array. When not specified, the color is calculated with the dry_foliage.png colormap.
    - Template:Nbt
      - Template:Nbt Template:Nbt: The color of the Minecraft:sky without Vibrant Visuals; supports HEX string or RGB array.
    - Template:Nbt
      - Template:Nbt: The namespaced identifier of the Minecraft:fog definition used for this biome in Template:File.
    - Template:NbtTemplate:Fn
      - Template:Nbt: The namespaced identifier of the Minecraft:Vibrant Visuals atmospherics configurations used for this biome, in Template:File.
    - Template:NbtTemplate:Fn
      - Template:Nbt: The namespaced identifier of the Vibrant Visuals color grading configurations used for this biome, in Template:File.
    - Template:NbtTemplate:Fn
      - Template:Nbt: The namespaced identifier of the Vibrant Visuals cubemap configurations used for this biome, in Template:File.
    - Template:NbtTemplate:Fn
      - Template:Nbt: The namespaced identifier of the Vibrant Visuals lighting configurations used for this biome, in Template:File.
    - Template:NbtTemplate:Fn
      - Template:Nbt: The namespaced identifier of the Vibrant Visuals water configurations used for this biome, in Template:File.