Minecraft:Biome definition: Difference between revisions

Latest revision as of 11:04, 17 July 2026

Template:For Minecraft:Biomes are stored as Minecraft:JSON files within a Minecraft:data pack in the path Template:Cd Template:In or in a Minecraft:behavior pack in the folder Template:Cd Template:In.

JSON format

Java Edition

Template:Nbt: The root object.
- Template:Nbt: Determines whether or not the biome has precipitation.
- Template:Nbt: Controls gameplay features like grass and foliage color, and a height adjusted temperature (which controls whether raining or snowing occurs if Template:Nbt is Template:Cd, and generation details of some features).
- Template:Nbt: (optional, defaults to none) Either Template:Cd or Template:Cd. Modifies temperature before calculating the height adjusted temperature. If Template:Cd, makes some places' temperature high enough to rain (0.2).
- Template:Nbt: Controls grass and foliage color.
- Template:Nbt: Ambient effects in this biome.
  - Template:Nbt: (Required, but the normal value is 4159204) Decimal value converted from Hex color to use for water blocks and cauldrons.
  - Template:Nbt: (optional) Decimal value converted from Hex color to use for tree leaves and vines. If not present, the value depends on downfall and the temperature.
  - Template:Nbt: (optional) Decimal value converted from Hex color to use for leaf litter.
  - Template:Nbt: (optional) Decimal value converted from Hex color to use for grass blocks, short grass, tall grass, ferns, tall ferns, and sugar cane. If not present, the value depends on downfall and temperature.
  - Template:Nbt: (optional, defaults to none) Can be Template:Cd, Template:Cd or Template:Cd.
- Template:Nbt: (optional) Map of Minecraft:environment attributes that apply when in this biome.
- Template:Nbt Template:Nbt Template:Nbt: Template:Json ref (Required, but can be empty)
- Template:Nbt: List of generation steps (Can be empty). Usually there are 11 steps, but any amount is possible.
  - Template:Nbt Template:Nbt Template:Nbt each entry of the list: Template:Json ref — Features to place during that generation step. The same placed features in the same step in two biomes cannot be in different orders. In each step, all feature IDs need to be ordered consistently across biomes. For example, in the UNDERGROUND_ORES step of minecraft:plains, ore_dirt is before ore_gravel. In other biomes' UNDERGROUND_ORES step, if both ore_dirt and ore_gravel as present, ore_gravel cannot be before ore_dirt.
  These generation steps are also referred to by name for structure generation. They are, in order:
  - Template:Cd: Used by small end island features in vanilla.
  - Template:Cd: Used by lava lakes in vanilla.
  - Template:Cd: Used for amethyst geodes and icebergs in vanilla.
  - Template:Cd: Used for dungeons and overworld fossils in vanilla.
  - Template:Cd: Used for desert wells and blue ice patches in vanilla.
  - Template:Cd: Not used for features in vanilla.
  - Template:Cd: Used for overworld ore blobs, overworld dirt/gravel/stone variant blobs, and sand/gravel/clay disks in vanilla.
  - Template:Cd: Used for infested block blobs, nether gravel and blackstone blobs, and all nether ore blobs in vanilla.
  - Template:Cd: Used for water and lava springs in vanilla.
  - Template:Cd: Used for trees, bamboo, cacti, kelp, and other ground and ocean vegetation in vanilla.
  - Template:Cd: Used for surface freezing in vanilla.
- Template:Nbt Template:Until: (optional) Higher value results in more creatures spawned in world generation. Must be between 0.0 and 0.9999999 (both inclusive).
- Template:NbtTemplate:Until: (Required, but can be empty. If this object doesn't contain a certain category, mobs in this category do not spawn.) Entity spawning settings.
  - Template:Nbt: (Can be empty. If empty, mobs in this category do not spawn.) The key must be one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, or Template:Cd. A list of spawner data objects, one for each mob which should spawn in this biome.
    - Template:Nbt: The spawner data for a single mob.
      - Template:Nbt: The namespaced entity id of the mob.
      - Template:Nbt: How often this mob should spawn, higher values produce more spawns.
      - Template:Nbt: The minimum count of mobs to spawn in a pack. Must be greater than 0.
      - Template:Nbt: The maximum count of mobs to spawn in a pack. Must be greater than 0. And must be not less than Template:Nbt.
- Template:NbtTemplate:Until: (Required, but can be empty. Only mobs listed here use the spawn cost mechanism) See Template:Slink for details.
  - Template:Nbt: The namespaced entity id of the mob.
    - Template:Nbt: New mob's maximum potential.
    - Template:Nbt: New mob's charge.

Template:Calculator

Bedrock Edition

Template:WIP

Template:Nbt: The root object.
- Template:Nbt: The format version of the file, requires "1.21.110" for all current features.
- Template:Nbt: The biome definition.
  - Template:Nbt
    - Template:Nbt: A Minecraft:namespaced identifier for the biome.
  - Template:Nbt: Components used to define the biome's generation.
    - Template:Nbt: Defines the climate properties of the biome.
      - 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: Minecraft:Temperature, controls at what height rainfall transitions to snowfall and water freezes, changes grass, sky, and foliage tints, affects sponge drying.
    - Template:Nbt
      - Template:Nbt: Chance of creatures spawning when the chunk is generated. Must be ≤0.75.
    - Template:Nbt
      - Template:Nbt: Whether or not the biome is humid. This overrides the downfall property with 0 or 1 while leaving tints unaffected.
    - 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: 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: Deprecated, only used for pre-Minecraft:Caves & Cliffs generation and unexplored explorer map terrain rendering. 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
    - Template:Nbt: Deprecated, only 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. It is not possible to control rare climate zones or edge transformations.
      - 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.
    - Template:Nbt: Allows this biome to replace parts of one or more vanilla biomes.
      - Template:Nbt: The list of replacements
        Template:Nbt: An replacement
        Template:Nbt: Chance that the replacement is attempted. Must be >0.0 and ≤1.0.
        
        Template:Nbt: The dimension in which this replacement can occur. Can be either Template:Cd.
        
        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: The biomes that can be replaced.
        Template:Nbt: A biome ID.
  - 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.
    - Template:Nbt
      - Template:Nbt: Tags for the biome.
  - Template:Nbt
    - Template:Nbt: The type of Minecraft:village for this biome. Valid values are Template:Cd.

History

Java Edition

Template:HistoryTable

Bedrock Edition

Template:HistoryTable

External links

Biome Generator on misode.github.io

References

Navigation

Template:Navbox Java Edition technical Template:Navbox Bedrock Edition

Minecraft:de:Biomdefinition Minecraft:fr:Définition de biome Minecraft:ja:バイオームのカスタマイズ Minecraft:pt:Definição de biomas Minecraft:uk:Визначення біому Minecraft:zh:生物群系定义格式

@@ Line 34: / Line 34: @@
 *** {{cd|VEGETAL_DECORATION}}: Used for trees, bamboo, cacti, kelp, and other ground and ocean vegetation in vanilla.
 *** {{cd|TOP_LAYER_MODIFICATION}}: Used for surface freezing in vanilla.
-** {{nbt|float|creature_spawn_probability}}: (optional) Higher value results in more creatures spawned in world generation. Must be between 0.0 and 0.9999999 (both inclusive).
+** {{nbt|float|creature_spawn_probability}}{{until|JE 26.3}}: (optional) Higher value results in more creatures spawned in world generation. Must be between 0.0 and 0.9999999 (both inclusive).
-** {{nbt|compound|spawners}}: (Required, but can be empty. If this object doesn't contain a certain category, mobs in this category do not spawn.) Entity spawning settings.
+** {{nbt|compound|spawners}}{{until|JE 26.3}}: (Required, but can be empty. If this object doesn't contain a certain category, mobs in this category do not spawn.) Entity spawning settings.
 *** {{nbt|list|<mob category>}}: (Can be empty. If empty, mobs in this category do not spawn.) The key must be one of {{cd|monster}}, {{cd|creature}}, {{cd|ambient}}, {{cd|water_creature}}, {{cd|underground_water_creature}}, {{cd|water_ambient}}, {{cd|misc}}, or {{cd|axolotls}}. A list of spawner data objects, one for each mob which should spawn in this biome.
 **** {{nbt|compound}}: The spawner data for a single mob.
@@ Line 42: / Line 42: @@
 ***** {{nbt|int|minCount}}: The minimum count of mobs to spawn in a pack. Must be greater than 0.
 ***** {{nbt|int|maxCount}}: The maximum count of mobs to spawn in a pack. Must be greater than 0. And must be not less than {{nbt|int|minCount}}.
-** {{nbt|compound|spawn_costs}}: (Required, but can be empty. Only mobs listed here use the spawn cost mechanism) See {{slink|Mob spawning|Spawn costs}} for details.
+** {{nbt|compound|spawn_costs}}{{until|JE 26.3}}: (Required, but can be empty. Only mobs listed here use the spawn cost mechanism) See {{slink|Mob spawning|Spawn costs}} for details.
 *** {{nbt|compound|<entity id>}}: The namespaced entity id of the mob.
 **** {{nbt|double|energy_budget}}: New mob's maximum potential.
@@ Line 57: / Line 57: @@
 ** {{nbt|compound|minecraft:biome}}: The biome definition.
 *** {{nbt|compound|description}}
-**** {{nbt|string|identitfier}}: A [[Minecraft:namespaced identifier]] for the biome.
+**** {{nbt|string|identifier}}: A [[Minecraft:namespaced identifier]] for the biome.
 *** {{nbt|compound|components}}: Components used to define the biome's generation.
 **** {{nbt|compound|minecraft:climate}}: Defines the climate properties of the biome.
@@ Line 234: / Line 234: @@
 |Removed {{nbt|int|fog_color‌}}, {{nbt|int|sky_color‌}}, {{nbt|int|water_fog_color}}, {{nbt|compound|particle}}, {{nbt|string}}{{nbt|compound|ambient_sound}}, {{nbt|compound|mood_sound}}, {{nbt|compound|additions_sounds}}, {{nbt|list|music}}, and {{nbt|float|music_volume}} fields in {{nbt|compound|effects}}.}}
 |{{HistoryLine|||dev=25w44a|The {{nbt|string}}{{nbt|list}}{{nbt|int|water_color}}, {{nbt|string}}{{nbt|list}}{{nbt|int|foliage_color}}, {{nbt|string}}{{nbt|list}}{{nbt|int|dry_foliage_color}}, and {{nbt|string}}{{nbt|list}}{{nbt|int|grass_color}} fields now accept a hex-string or array of red, green, blue floats in addition to the packed integer value.}}
+|{{HistoryLine|java upcoming}}
+|{{HistoryLine||26.3|dev=snap4|Removed the following fields:
+* {{cd|creature_spawn_probability}}
+* {{cd|spawners}}
+* {{cd|spawn_costs}}
+|The above fields have been moved to [[Minecraft:Environment attribute|environment attributes]].}}
 }}
@@ Line 250: / Line 256: @@
 |{{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|upcoming bedrock}}
 |{{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.}}