Minecraft Wiki
Advertisement
Information icon.svg
This feature is exclusive to Java Edition. 

Biomes stored as JSON files within a data pack in the path data/<namespace>/worldgen/biome.

JSON format[]

  • The root tag
    •  precipitation: The type of precipitation found in this biome. One of none, rain, or snow. If snow, rabbits spawning in this biome will be white or black-and-white.
    •  temperature: Controls gameplay features like grass and foliage color and whether snow golems take damage.
    •  temperature_modifier: (optional) Either none or frozen.
    •  downfall: Controls grass and foliage color, a value above 0.85 also makes fire burn out faster.
    •  creature_spawn_probability: (optional) Spawns passive mobs as long as random value is less than this. Must be between 0 and 1.
    •  effects: Ambient effects in this biome.
      •  fog_color: Decimal value converted from Hex color to use for fog.
      •  foliage_color: (optional) Decimal value converted from Hex color to use for tree leaves and vines. If not present, the value depends on humidity and temperature.
      •  grass_color: (optional) Decimal value converted from Hex color to use for grass blocks, grass, tall grass, ferns, tall ferns, and sugar cane. If not present, the value depends on humidity and temperature.
      •  sky_color: Decimal value converted from Hex color to use for the sky.
      •  water_color: Decimal value converted from Hex color to use for water blocks and cauldrons.
      •  water_fog_color: Decimal value converted from Hex color to use for fog.
      •  grass_color_modifier: Can be none, dark_forest or swamp.
      •  particle: (optional) The particle to use throughout this biome.
        •  probability: Controls how often the particle spawns.
        •  options: Controls what particle to use.
          •  type: The namespaced id of the particle type.
          • If type is block or falling_dust:
            •  value: Contains the block state used for the particle.
              • Block state
          • If type is item:
            •  value: Contains the item data used for the particle.
              •  id: Namespaced id of the item to use.
              •  Count: The amount of the item.
              •  tag: NBT data present on the item.
          • If type is dust:
            •  color: Three values representing the red, green, and blue components of the dust color, each from 0 to 1.
            •  scale: Controls the size of the dust particles.
      •  ambient_sound: (optional) Sound event to use for ambient sound.
      •  mood_sound: (optional) Settings for mood sound.
        •  sound: Sound event to use
        •  tick_delay:
        •  block_search_extent: 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.
        •  offset:
      •  additions_sound: (optional) Settings for additions sound.
        •  sound: Sound event to use
        •  tick_chance:
      •  music: (optional) Specific music that should be played in the biome.
        •  sound: Sound event to use
        •  min_delay:
        •  max_delay:
        •  replace_current_music: Whether or not to replace music which is already playing.
    •  carvers: The carvers to use.
      •  air: List of carvers used during the air generation step.
        • : The namespaced id of a configured carver.
      •  liquid: List of carvers used during the liquid generation step.
        • : The namespaced id of a configured carver.
    •  features: A list of 11 lists of features. In vanilla, each of those lists corresponds to a different type of feature: the feature lists are applied to each chunk in order. The index of the list which the feature is placed in is also used to generate part of the feature seed, so moving features to a different list definitely has some effect on generation. Each element of each list is a namespaced id of a placed feature. Can be a empty list.
      • : Internal feature type RAW_GENERATION. Used by miniature end island features by default.
      • : Internal feature type LAKES. Used by water and lava lakes by default.
      • : Internal feature type LOCAL_MODIFICATIONS. Used for rocks in taigas and icebergs by default.
      • : Internal feature type UNDERGROUND_STRUCTURES. Used for dungeons and overworld fossils by default.
      • : Internal feature type SURFACE_STRUCTURES. Used for desert wells and blue ice patches by default.
      • : Internal feature type STRONGHOLDS. Not used for any features by default.
      • : Internal feature type UNDERGROUND_ORES. Used for overworld ore blobs, overworld dirt/gravel/stone variant patches, and sand/gravel/clay disks by default.
      • : Internal feature type UNDERGROUND_DECORATION. Used for infested block blobs, nether gravel and blackstone blobs, and all nether ore blobs by default.
      • : Internal feature type FLUID_SPRINGS. Used for water and lava springs.
      • : Internal feature type VEGETAL_DECORATION. Used for trees, bamboo, cacti, kelp, and other ground and ocean vegetation, as well as lava and water springs by default.
      • : Internal feature type TOP_LAYER_MODIFICATION. Used for surface freezing by default.
    •  spawners: Entity spawning settings.
      •  <mob category>: One of monster, creature, ambient, water_creature, underground_water_creature, water_ambient, misc, or axolotls.
        • A list of spawner data objects, one for each mob which should spawn in this biome.
          • The spawner data for a single mob.
            •  type: The namespaced entity id of the mob.
            •  weight: How often this mob should spawn, higher values produce more spawns.
            •  minCount: The minimum count of mobs to spawn in a pack.
            •  maxCount: The maximum count of mobs to spawn in a pack.
    •  spawn_costs: List of entity ids.
      •  <entity id>:
        •  energy_budget:
        •  charge:

Biome categories[]

Biome categories are used by several game mechanics:[needs testing]

  • Any biomes in the category ocean are considered part of the ocean temperature category; other temperature categories are controlled by the biome's temperature value. This means that biomes in the ocean category should typically be placed near each other.
  • Biomes in the categories ocean and river play the underwater music instead of their normal music when the player is underwater.
  • Zombie sieges and patrols do not spawn in biomes in the category mushroom.
  • Rabbits spawning in biomes in the category desert always have the desert skin, unless they are in a biome with precipitation set to snow.
  • Mobs in the water_ambient category spawn much less often in biomes in the category river.
  • Ocean monuments do not spawn in any biome which isn't in the category ocean or river.

History[]

Java Edition
1.16.220w28aAdded experimental support for biomes in data packs.
20w30aAdded the grass_color, foliage_color, water_color, and water_fog_color effects properties.
pre2Added the player_spawn_friendly property.
Advertisement