Biome/JSON format

From Minecraft Wiki
Jump to: navigation, search
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[edit]

  • The root tag
    •  depth: Used for terrain noise generation. Biomes with positive depth are considered land, biomes with negative depth are oceans.
    •  scale: Used for terrain noise generation. Vertically stretches the terrain. Lower values produce flatter terrain.
    •  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.
    •  category: One of none, taiga, extreme_hills, jungle, mesa, plains, savanna, icy, the_end, beach, forest, ocean, desert, river, swamp, mushroom, or nether.
    •  temperature: Controls gameplay features like grass and foliage color and whether snow golems take damage.
    •  temperature_modifier: Either none or frozen.
    •  downfall: Controls grass and foliage color, a value above 0.85 also makes fire burn out faster.
    •  player_spawn_friendly: Can be true or false.
    •  creature_spawn_probability: 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: 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: 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:
            • Tags common to all block states
          • If type is dust:
            •  r: The red component of the dust color, from 0 to 1.
            •  g: The green component of the dust color, from 0 to 1.
            •  b: The blue component of the dust color, from 0 to 1.
            •  scale: Controls the size of the dust particles.
          • If type is item:
            •  id: Namespaced id of the item to use.
            •  Count: The amount of the item.
            •  tag: NBT data present on the item.
      •  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.
    •  surface_builder: The namespaced id of the configured surface builder to use.
    •  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 10 lists of features. In vanilla, each of the 10 lists corresponds to a different type of feature: the feature lists are applied to each chunk in order from top to bottom. 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 configured 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 veins, overworld dirt/gravel/stone variant patches, and sand/gravel/clay disks by default.
      • : Internal feature type UNDERGROUND_DECORATION. Used for infested block veins, nether gravel and blackstone veins, and all nether ore veins by default.
      • : 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.
    •  starts: The structures to generate in this biome.
      • The namespaced id of a configured structure feature.
    •  spawners: Entity spawning settings.
      •  <mob category>: One of monster, creature, ambient, water_creature, water_ambient, or misc.
        • 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[edit]

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[edit]

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.