Custom biome

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
- 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.
- 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:
        Block state
      - 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

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.2

{{Extension DPL}}<ul><li>[[Magma Cream|Magma Cream]]<br/>{{Item
| title = Magma Cream
| image = Magma Cream.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Magma cream''' is an [[item]] used in [[brewing]] to create [[potion]]s of [[Fire Resistance]], and to manually craft [[magma block]]s.

== Obtaining ==

=== Mob loot ===

==== Magma cubes ====

All but tiny-sized [[magma cube]]s drop 0–1 magma cream. The maximum amount of magma cream is increased by 1 per level of [[Looting]], for a maximum of 4 with Looting III.

=== Crafting ===

{{Crafting
|Blaze Powder
|Slimeball
|Output= Magma Cream
|type= Brewing
}}

=== Chest Loot ===
{{LootChestItem|magma-cream}}

== Usage ==

=== Brewing ingredient ===

{{brewing
  |showname=1
  |head=1
  |Magma Cream|Mundane Potion|base=Water Bottle
}}
{{brewing
  |foot=1
  |Magma Cream
  |Potion of Fire Resistance
}}

=== Crafting ingredient ===

{{crafting usage}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Magma Cream
|spritetype=item
|nameid=magma_cream
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Magma Cream
|spritetype=item
|nameid=magma_cream
|id=430
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Magma Cream JE1.png|32px]] Added magma cream.}}
{{History|||snap=Beta 1.9 Prerelease 3|Magma cream can now be [[brewing|brewed]] in a [[water bottle]] to create a mundane [[potion]], or in an awkward potion to create a potion of [[Fire Resistance]].}}
{{History||1.1|snap=release|[[Magma cube]]s now [[drops|drop]] magma cream.}}
{{History||1.3.1|snap=1.3|[[File:Magma Cream JE2 BE1.png|32px]] The texture of magma cream has been changed.}}
{{History||1.10|snap=16w20a|Magma cream can now be [[crafting|crafted]] into [[magma block]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 378.}}
{{History||1.14|snap=18w43a|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}
{{History||1.16|snap=20w07a|Magma cream has a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 1–3.}}
{{History|||snap=20w09a|Magma cream now has a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w16a|Magma cream now generates in [[bastion remnant]]s chests.}}
{{History||1.16.2|snap=20w28a|Magma cream can no longer be obtained from bartering with piglins.}}
{{History|||snap=20w30a|The average yield of magma cream from bastion remnant chests has been slightly increased.}}

{{History|pocket edition alpha}}
{{History||v0.11.0|snap=build 1|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.
|Magma cream is currently unobtainable.}}
{{History||v0.11.0|snap=build 8|[[Magma cube]]s now [[drops|drop]] magma cream.}}
{{History||v0.12.1|snap=build 1|Added magma cream to the [[Creative]] mode [[inventory]].
|Magma cream can now be [[crafting|crafted]].}}
{{History|pocket}}
{{History||1.1.3|snap=alpha 1.1.3.0|Magma cream can now be crafted into [[magma block]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.57|Magma cream can be obtained from bartering with piglins.
|Magma cream can now be found in [[bastion remnants]] chests.}}
{{History||1.16.100|snap=beta 1.16.100.54|Magma cream can no longer be obtained from [[barter]]ing with [[piglin]]s.}}

{{History|console}} 
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.}}
{{history|foot}}

== Issues ==

{{issue list}}

{{items}}

[[Category:Renewable resources]]

[[cs:Lávová pěna]]
[[de:Magmacreme]]
[[es:Crema de magma]]
[[fr:Crème de magma]]
[[hu:Magmakrém]]
[[ja:マグマクリーム]]
[[ko:마그마 크림]]
[[lzh:火漿膏]]
[[nl:Magmacrème]]
[[pl:Magmowy krem]]
[[pt:Creme de magma]]
[[ru:Лавовый крем]]
[[th:ครีมแมกม่า]]
[[uk:Магмовий крем]]
[[zh:岩浆膏]]</li><li>[[Prismarine Shard|Prismarine Shard]]<br/>{{Item
| renewable =  Yes
| stackable = Yes (64)
| type =
}}
A '''prismarine shard''' is an item obtained by defeating [[guardian]]s or [[elder guardian]]s. It can be used to craft various [[prismarine]] blocks as well as [[sea lantern]]s.

== Obtaining ==

Prismarine shards are dropped upon the death of [[guardian]]s and [[elder guardian]]s. From these mobs, 0–2 shards are dropped each time. This can be increased to a maximum of 5 with the [[Looting]] enchantment.

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Prismarine Shard
|spritetype=item
|nameid=prismarine_shard
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Prismarine Shard
|spritetype=item
|nameid=prismarine_shard
|aliasid=prismarineshard
|id=565
|form=item
|foot=1}}

== History ==

{{History|java}}
{{history||1.8|snap=14w25a|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 409.}}
{{History||1.14|snap=18w43a|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|pocket alpha}}
{{History||v0.16.0|snap=build 1|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|New 3DS}}
{{History||1.3.12|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{items}}

[[de:Prismarinscherbe]]
[[es:Fragmento de prismarina]]
[[fr:Éclat de prismarine]]
[[ja:プリズマリンの欠片]]
[[ko:프리즈머린 조각]]
[[nl:Prismarienscherf]]
[[pl:Odłamek pryzmarynu]]
[[pt:Pedaço de prismarinho]]
[[ru:Призмариновый осколок]]
[[uk:Призмариновий уламок]]
[[zh:海晶碎片]]
[[Category:Renewable resources]]</li></ul>

20w28a

Added experimental support for biomes in data packs.

20w30a Added the grass_color, foliage_color, water_color, and water_fog_color effects properties.

pre2 Added the player_spawn_friendly property.

Custom biome

JSON format

Biome categories

History

Fan Feed