Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
8,971
pages
in: Java Edition, Data packs, Removed features
English

Custom world generation

Revision as of 08:04, 31 August 2020 by Lakejason0 (talk | contribs) (→‎Default biomes: these contents should be archived on biome pages)
Sign in to edit
Gear (item)
This article is a work in progress. 
Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.
Note: In 20w29a noise settings have been moved to the worldgen folder and are no longer in the Dimension folder.
Information icon
This feature is exclusive to Java Edition. 

Custom world generation allows data packs to change how the world generates. This is particularly useful in conjunction with custom worlds.

Noise settings

Noise settings are for generating the shape of the terrain, stored as JSON files within a data pack in the path data/<namespace>/worldgen/noise_settings, and are used with the minecraft:noise generator in the dimension folder. Default settings include minecraft:overworld for normal Overworld generation, minecraft:amplified for Amplified Overworld generation, minecraft:nether for regular Nether generation, minecraft:caves for Cave (Nether-like generation but with Overworld terrain features) generation, minecraft:end for regular End generation, and minecraft:floating_islands for Floating Islands (similar to The End outer islands) generation.

JSON format

    •  sea_level: The sea level in this dimension. Note that this value only affects world generation. The sea level for mob spawning is a fixed value 63.
    •  disable_mob_generation: Disables creature spawning upon chunk generation.
    •  ore_veins_enabled: Whether ore veins generate.
    •  aquifers_enabled: Whether aquifers generate. If set to false, almost all caves below sea level will be filled with water.
    •  legacy_random_source: Whether to use the old random number generator from before 1.18 for world generation.
    •  default_block: The default block used for the terrain.
      • Block state
    •  default_fluid: The default block used for seas and lakes.
      • Block state
    •  spawn_target: (Required, but can be empty) A list of noise parameters to specify the points around which the player tries to spawn. The game will select some horizonal locations that are not more than 2560 blocks away from the origin (0,0), then sample the noise values ("depth" noise and "offset" are alway 0), and calculate ((x^2+z^2)^2) / 390625 + (the square of the mininum distance to the ranges in the list). The player will spawn near the location whose this value is smallest.
      • ：A range.
        • Noise parameter for biome (See Biome for usages of each parameter in vanilla game)
    •  noise: Fields for world generation.
      •  min_y: The minimum Y coordinate where terrain starts generating. Value between -2032 and 2031 (both inclusive). Must be divisible by 16.
      •  height: The total height where terrain generates. Value between 0 and 4064 (both inclusive). Must be divisible by 16. And min_y + height cannot exceed 2032.
      •  size_horizontal: Value between 0 and 4 (both inclusive)
      •  size_vertical: Value between 0 and 4 (both inclusive)
    •  noise_router: Routes density functions to noise parameters used for world generation. Each field can be an ID of density function or a density function (can be in constant form or object form).
      •  initial_density_without_jaggedness: Related to the generation of aquifer and surface rule. At a horizonal position, starting from the top of the world, the game searches from top to bottom with the precision of size_vertical*4 blocks. The first Y-level whose noise value greater than 25/64 is used as the initial terrain height for world generation. This height should be generally lower than the actual terrain height (determined by the final density).
      •  final_density: Determines where there is an air or a default block. If positive, returns default block which will can be replaced by the  surface_rule. Otherwise, an air where aquifers can generate.
      •  barrier: Affects whether to separate between aquifers and open areas in caves. Larger values leads to higher probability to separate.
      •  fluid_level_floodedness: Affects the probability of generating liquid in an cave for aquifer. The larger value leads to higher probability. The noise value greater than 1.0 is regarded as 1.0, and value less than -1.0 is regarded as -1.0.
      •  fluid_level_spread: Affects the height of the liquid surface at a horizonal position. Smaller value leads to higher probability for lower height.
      •  lava: Affects whether an aquifer here uses lava instead of water. The threshold is 0.3.
      •  vein_toggle: Affects ore vein type and vertical range. If the noise value is greater than 0.0, the vein will be a copper vein. If the noise value is less than or equal to 0.0, the vein will be an iron vein.
      •  vein_ridged: Controls which blocks are part of a vein. If greater than or equal to 0.0, the block will not be part of a vein. If less than 0.0, the block will be either the vein type's stone block, or possibly an ore block.
      •  vein_gap: Affects which blocks in a vein will be ore blocks. If greater than -0.3, and a random number is less than the absolute value of vein_toggle mapped from 0.4 - 0.6 to 0.1 - 0.3, with values outside of this range clamped, an ore block will be placed, with a 2% chance for the ore block to be a raw metal block. Otherwise, the ore type's stone block will be placed.
      •  temperature: The temperature values only for biome placement. Note that this field and the following five fields do not affect terrain shape, as terrain generation is defined in final_density.
      •  vegetation: The humidity values only for biome placement.
      •  continents: The continentalness values only for biome placement.
      •  erosion: The erosion values only for biome placement and aquifer generation.
      •  depth: The depth values only for biome placement and aquifer generation.
      •  ridges: The weirdness values only for biome placement.
    •  surface_rule: To place blocks in the terrain.
      • Surface rule


Default settings

These are the settings used by the 6 presets available for the minecraft:noise generator.

Structure defaults

These are the default values for all namespaced structures. Every preset uses the same values for all of these structures, with the exception of minecraft:ruined_portal.

*Placeholder values, have no effect

**Salt values aren't used for theses structures; changing them produces no effect

Biome

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

JSON format

Information icon
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 object.
    •  has_precipitation: Determines whether or not the biome has precipitation.
    •  temperature: Controls gameplay features like grass and foliage color, and a height adjusted temperature (which controls whether raining or snowing if  has_precipitation is true, and generation details of some features).
    •  temperature_modifier: (optional, defaults to none) Either none or frozen. Modifies temperature before calculating the height adjusted temperature. If frozen, makes some places' temperature high enough to rain (0.2).
    •  downfall: Controls grass and foliage color.
    •  effects: Ambient effects in this biome.
      •  fog_color: Decimal value converted from Hex color to use for fog.
      •  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.
      •  foliage_color: (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.
      •  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 downfall and temperature.
      •  grass_color_modifier: (optional, defaults to none) Can be none, dark_forest or swamp.
      •  particle: (optional) The particle to use throughout this biome.
        •  probability: Controls how often the particle spawns. Value higher than 1 is regarded as 1, lower than 0 is regarded as 0.
        •  options: Controls what particle to use. See also Commands/particle.
          •  type: The namespaced id of the particle type.
            If type is block, block_marker or falling_dust, additional field are as follows:
          •  value: Contains the block state used for the particle.
            • Block state
            If type is item, additional fields are as follows:
          •  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 in JSON format. See NBT format#JSON and NBT.
            If type is dust, additional fields are as follows:
          •  color: Three floats representing the red, green, and blue components of the dust color, each from 0 to 1.
          •  scale: Controls the size of the dust particles.
            If type is dust_color_transition, additional fields are as follows:
          •  fromColor: Three floats representing the red, green, and blue components of the start color, each from 0 to 1.
          •  toColor: Three floats representing the red, green, and blue components of the end color, each from 0 to 1.
          •  scale: Controls the size of the particles.
            If type is sculk_charge, additional field is as follows:
          •  roll: The angle the particle displays at in radians.
            If type is vibration, additional fields are as follows:
          •  destination: The destination.
            • A position source
          •  arrival_in_ticks: The duration of the move.
            If type is shriek, additional field is as follows:
          •  delay: The delay in ticks.
      •  ambient_sound: (optional) A namespace ID of the sound event to use for ambient sound. Can also be an object to specify a fixed audible range of the sound.
        •  sound_id: A namespace ID of the sound event to use.
        •  range: (optional) The fixed audible range of the sound.
      •  mood_sound: (optional) Settings for mood sound.
        •  sound: A namespace ID of the sound event to use. Can also be an object to specify a fixed range of the sound.
          •  sound_id: A namespace ID of the sound event to use.
          •  range: (optional) The fixed audible range of the sound.
        •  tick_delay: The mininum delay between two plays. See also Ambience#Mood_algorithm.
        •  block_search_extent: Determines the cubic range of possible positions to find place to play the mood sound. The player is at the center of the cubic range, and the edge length is 2 * block_search_extent.
        •  offset: The higher the value makes the sound source further away from the player.
      •  additions_sound: (optional) Settings for additions sound.
        •  sound: A namespace ID of the sound event to use. Can also be an object to specify a fixed range of the sound.
          •  sound_id: A namespace ID of the sound event to use.
          •  range: (optional) The fixed audible range of the sound.
        •  tick_chance: The propability to start playing the sound per tick. Value higher than 1 is regarded as 1, lower than 0 is regarded as 0.
      •  music: (optional) Specific music that should be played in the biome.
        •  sound: A namespace ID of the sound event to use. Can also be an object to specify a fixed range of the sound.
          •  sound_id: A namespace ID of the sound event to use.
          •  range: (optional) The fixed audible range of the sound.
        •  min_delay: The min delay between two music.
        •  max_delay: The max delay between two music.
        •  replace_current_music: Whether or not to replace music which is already playing.
    •  carvers: The carvers to use.
      •  air: (Optional, can be empty) List of carvers used during the air cave generation step. Can be an id of a configured carver, a tag of configured carvers, or a configured carver object, or a list of configured carver IDs, or a list of configured carver objects.
      •  liquid: (Optional, can be empty) List of carvers used during the liquid cave generation step. Currently doesn't work. Can be an id of a configured carver, a tag of configured carvers, or a configured carver object, or a list of configured carver IDs, or a list of configured carver objects.
    •  features: (Can be empty) A list of 11 elements. Each element can be a tag of placed feature, a list of placed feature IDs, or a list of placed feature objects. The features are applied to each chunk in order in each 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 UNDERGROUND_ORES step of minecraft:plains, ore_dirt is before ore_gravel, so in other biomes' UNDERGROUND_ORES step, if there are ore_dirt and ore_gravel, ore_gravel cannot be after ore_dirt. The generation steps are also used in stucture features.
      • : Generation step RAW_GENERATION. Used by small end island features in vanilla.
      • : Generation step LAKES. Used by lava lakes in vanilla.
      • : Generation step LOCAL_MODIFICATIONS. Used for amethyst geodes and icebergs in vanilla.
      • : Generation step UNDERGROUND_STRUCTURES. Used for dungeons and overworld fossils in vanilla.
      • : Generation step SURFACE_STRUCTURES. Used for desert wells and blue ice patches in vanilla.
      • : Generation step STRONGHOLDS. Not used for features in vanilla.
      • : Generation step UNDERGROUND_ORES. Used for overworld ore blobs, overworld dirt/gravel/stone variant blobs, and sand/gravel/clay disks in vanilla.
      • : Generation step UNDERGROUND_DECORATION. Used for infested block blobs, nether gravel and blackstone blobs, and all nether ore blobs in vanilla.
      • : Generation step FLUID_SPRINGS. Used for water and lava springs in vanilla.
      • : Generation step VEGETAL_DECORATION. Used for trees, bamboo, cacti, kelp, and other ground and ocean vegetation in vanilla.
      • : Generation step TOP_LAYER_MODIFICATION. Used for surface freezing in vanilla.
    •  creature_spawn_probability: (optional) Higher value results in more creatures spawned in world generation. Must be between 0.0 and 0.9999999 (both inclusive).
    •  spawners: (Required, but can be empty. If this object doesn't contain a certain category, mobs in this category will not be spawned) Entity spawning settings.
      •  <mob category>: (Can be empty. If empty, mobs in this category will not be spawned) The key must be 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. Must be greater than 0.
          •  maxCount: The maximum count of mobs to spawn in a pack. Must be greater than 0. And must be not less than  minCount.
    •  spawn_costs: (Required, but can be empty. Only mobs listed here use the spawn cost mechanism) See Spawn#Spawn costs for details.
      •  <entity id>: The namespaced entity id of the mob.
        •  energy_budget: New mob's maximum potential.
        •  charge: New mob's charge.

History

Java Edition
1.19
{{Extension DPL}}<ul><li>[[Blue Dye|Blue Dye]]<br/>{{Item
|image = Blue_Dye_JE1_BE1.png
|renewable = Yes
|stackable = Yes (64)
}}

'''Blue dye''' is a [[Dye#Primary|primary dye color]].

== Obtaining ==
=== Crafting ===
{{Crafting
 |Lapis Lazuli
 |Output=Blue Dye
 |type=Material
 |head=1
}}
{{Crafting
 |Cornflower
 |Output=Blue Dye
 |type=Material
 |foot=1
}}
=== Chest loot ===
{{#invoke:LootChest|base3|blue-dye}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}

=== Loom ingredient ===
{{Banner loom usage|Blue Dye}}

=== Trading ===
Expert-level shepherd villagers have a {{frac|1|6}} chance to buy 12 blue dye for an emerald.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|aliasid=dye / 18
|id=399
|form=item
|translationkey=item.dye.blue_new.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.14|snap=18w43a|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History|||snap=18w44a|Blue dyes now can changed the text color on the [[sign]]s to blue.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell blue dyes.}}
{{History|||snap=19w11a|Blue dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Blue dyes can now used to craft newly added [[blue candle]]s.}}
{{History|||snap=21w19a|Blue dyes can no longer used to craft blue candles.}}
{{History|||snap=Pre-release 1|Blue dyes can once again used to craft blue candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Blue dyes can now change the text color on [[hanging sign]]s to blue.}}
{{History||1.20|snap=23w12a|Blue dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Blue dye no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; blue dye now is in the common loot.}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History||1.9.0|snap=beta 1.9.0.0|Added [[flower|cornflowers]], which can be used to [[crafting|craft]] blue dye.}}
{{History||1.10.0|snap=beta 1.10.0.3|Blue dye can now be used to [[dye]] white [[carpet]]s and uncolored [[glass pane]]s.}}
{{History||1.11.0|snap=beta 1.11.0.4|Blue dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of blue dye has been changed from <code>dye/18</code> to <code>blue_dye</code>.}}

{{History|ps4}}
{{History||1.83|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

[[Category:Items]]
[[Category:Dyes]]
[[Category:Renewable resources]]

[[de:Blauer Farbstoff]]
[[es:Tinte azul]]
[[fr:Teinture bleue]]
[[ja:青色の染料]]
[[ko:파란색 염료]]
[[pl: Niebieski barwnik]]
[[pt:Corante azul]]
[[zh:蓝色染料]]</li><li>[[Recovery Compass|Recovery Compass]]<br/>{{About|the item used to point to the location of the player's last death|the item used to point to the world spawn or to a lodestone|Compass}}
{{Item
| image = Recovery Compass.gif
| renewable = No
| stackable = Yes (64)
}}

A '''recovery compass''' is an item used to point to the location of the [[Player|player's]] last death.

== Obtaining ==

=== Crafting ===
{{Crafting
|A1= Echo Shard |B1= Echo Shard   |C1= Echo Shard
|A2= Echo Shard |B2= Compass      |C2= Echo Shard
|A3= Echo Shard |B3= Echo Shard   |C3= Echo Shard
|Output= Recovery Compass
|type= Tool
}}

== Usage ==
When held by a player, the recovery compass will point towards the spot where they previously died.

The recovery compass will only work when it is held by a player who has previously died and is in the same dimension as their last death. Otherwise, it will spin around randomly.

Like other items, the recovery compass itself will still drop when a player dies and the <code>keepInventory</code> [[game rule]] is not enabled.

This item is useless on Hardcore mode, as once the player dies, the player cannot respawn.

=== Enchantments ===

A recovery compass can receive the following [[enchantment]]s:
{| class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Curse of Vanishing]]{{only|bedrock|short=1}}
|I
|{{Inventory slot|Anvil}}
|-
|}

== Data values ==
{{Missing information|section|data values for Bedrock Edition|type=data}}

=== ID ===
[[Java Edition|''Java Edition'']]:
{{ID table|edition=java|displayname=Recovery Compass|nameid=recovery_compass|translationkey=item.minecraft.recovery_compass|generatetranslationkeys=y|showforms=y|spritetype=item|form=item|foot=1}}

==History==
{{History|java}}
{{History||1.19|snap=22w14a|[[File:Recovery Compass JE1 BE1.gif|32px]] Added recovery compasses.}}
{{History|||snap=22w15a|Recovery compasses can no longer be used on [[lodestone]]s and can no longer be enchanted with [[Curse of Vanishing]].}}
{{History|bedrock}}
{{History||1.19.0|snap=beta 1.19.0.24|[[File:Recovery Compass JE1 BE1.gif|32px]] Added recovery compasses.}}
{{History|foot}}

==Issues==
{{issue list}}

==Gallery==
<gallery>
File:Recovery Compass In An Item Frame.jpg|Recovery Compass.<ref>{{tweet|kingbdogz|1511751971673419782|Tell us what you think of the new Recovery Compass! We're hoping it improves how rewarding it feels to obtain Ancient City loot. Despite that, how do you feel about it? Will you use it? If so, how? What situations would you use it instead of just trying to remember?|April 6, 2022}}</ref>
</gallery>

==References==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--recovery-compass Taking Inventory：Recovery Compass] – Minecraft.net on January 19, 2023

{{Items}}

[[Category:Tools]]
[[Category:Non-renewable resources]]

[[de:Bergungskompass]]
[[es:Brújula de recuperación]]
[[fr:Boussole de récupération]]
[[ja:リカバリーコンパス]]
[[pl:Kompas powrotny]]
[[pt:Bússola de retomada]]
[[ru:Компас восстановления]]
[[th:เข็มทิศกู้คืน]]
[[uk:Компас відновлення]]
[[zh:追溯指针]]</li></ul>
22w11aRemoved the category field. Functionality has been moved to biome tags.
1.19.3
{{Extension DPL}}<ul><li>[[Black Dye|Black Dye]]<br/>{{Item
| image = Black Dye.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Black dye''' is a [[Dye#Primary|primary color dye]] similar to an [[ink sac]].

== Obtaining ==

=== Trading ===
[[Wandering trader]]s have a chance to [[trading|trade]] 3 black dyes for 1 [[emerald]].{{only|java}}

=== Crafting ===
{{Crafting
  |head=1
  |showname=0
  |Ink Sac
  |Output=Black Dye
  |type=Material
}}
{{Crafting
  |Wither Rose
  |Output=Black Dye
  |type=Material
  |foot=1
}}

== Usage  ==

{{dye usage}}

=== Crafting ingredient ===

{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}

=== Loom ingredient ===
{{Banner loom usage|Black Dye}}

=== Trading ===

Apprentice-level Shepherd villagers have a 20%{{only|bedrock}} or {{frac|2|7}}{{only|java}} chance to buy 12 black dye for an emerald.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Black Dye
|spritetype=item
|nameid=black_dye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Black Dye
|spritetype=item
|nameid=black_dye
|aliasid=dye / 16
|id=395
|form=item
|translationkey=item.dye.black_new.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.14|snap=18w43a|[[File:Black Dye JE1 BE1.png|32px]] Added black dye.}}
{{History|||snap=18w44a|Black dyes now can changed the text color on the [[sign]]s to black.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell black dyes.}}
{{History|||snap=19w11a|Black dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.15|snap=Pre-release 1|Black dye can now be used to craft [[prismarine|dark prismarine]], just like [[Bedrock Edition]].}}
{{History||1.17|snap=20w45a|Black dyes can now used to craft newly added [[black candle]]s.}}
{{History|||snap=21w19a|Black dyes can no longer used to craft black candles.}}
{{History|||snap=Pre-release 1|Black dyes can once again used to craft black candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Black dyes now can change the text color on [[hanging sign]]s to black.}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:Black Dye JE1 BE1.png|32px]] Added black dye.}}
{{History||1.11.0|snap=beta 1.11.0.4|Black dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{history||1.13.0|snap=beta 1.13.0.9|Black dye can now be [[crafting|crafted]] from [[flower|wither roses]].}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of black dye has been changed from <code>dye/16</code> to <code>black_dye</code>.}}

{{History|ps4}}
{{History||1.83|[[File:Black Dye JE1 BE1.png|32px]] Added black dye.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

[[Category:Dyes]]
[[Category:Renewable resources]]

[[de:Schwarzer Farbstoff]]
[[es:Tinte negro]]
[[fr:Teinture noire]]
[[ja:黒色の染料]]
[[ko:검은색 염료]]
[[pl:Czarny barwnik]]
[[pt:Corante preto]]
[[th:สีย้อมสีดำ]]
[[zh:黑色染料]]</li><li>[[Wheat|Wheat]]<br/>{{About||the artifact in ''Minecraft Dungeons''|Minecraft Dungeons:Wonderful Wheat|the seed|Wheat Seeds}}
{{Item
| image = Wheat.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Wheat''' is an [[item]] primarily obtained by harvesting fully-grown [[Wheat Seeds|wheat crops]]. It is used for [[crafting]] as well as to feed certain animals.

== Obtaining ==

=== Natural generation ===

{{LootChestItem|wheat}}

=== Farming ===

{{main|Tutorials/Crop farming}}

When a fully-grown wheat crop is harvested, it drops 1 wheat and 1 to 4 [[wheat seeds]] ({{frac|2|5|7}} per crop harvested on average). A wheat crop has a total of eight stages (0-7) from the time it is planted until it can be harvested. If a crop is harvested before it is fully grown, it just drops one seed. Wheat needs light to grow; a seed is destroyed if planted without light. Harvesting with a [[Fortune]]-enchanted tool increases the number of seeds dropped but does not increase the yield of wheat.

=== Crafting ===

{{Crafting
|Hay Bale
|Output= Wheat,9
|type= Material
}}

=== Drops ===
A [[fox]] sometimes spawns holding wheat, which it always drops upon death. Alternatively, the player can drop a [[food]] item, causing the fox to drop the wheat.

== Usage ==

=== Food ===

[[File:New Cattle.png|thumb|Using wheat to lead a cow.]]
When wheat is held, it causes nearby [[cow]]s, [[sheep]], [[goat]]s and [[mooshroom]]s to follow the player, until either the player stops holding the wheat or goes too far away from the animal, thus leading them to lose interest.

Wheat may be used to [[breed]] cows, sheep, goats, and mooshrooms by first herding two of them together and then {{control|using}} the wheat on them to begin "Love Mode."

Wheat can heal a [[horse]] {{hp|1}} health or lower its temper by 3% when attempting to tame it. It can also decrease the time it takes for a foal to grow by 20 seconds.

Similarly, wheat can heal a [[llama]] {{hp|2}} health, and it decreases the time it takes a baby llama to grow by 10 seconds.

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===

Novice-level farmer [[Villager|villagers]] have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 20 wheat for one [[emerald]].

=== Composting ===
Placing wheat into a [[composter]] has a 65% chance of raising the compost level by 1. A stack of wheat yields an average of 5.94 [[bone meal]].

== Achievements ==
{{load achievements|Bake Bread;The Lie;Repopulation}}

== Advancements ==
{{load advancements|A Seedy Place}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wheat
|spritetype=item
|nameid=wheat
|id=334
|form=item
|foot=1}}

== Video ==

{{Video note|the narrator demonstrates at 0:56 that walking over wheat can destroy the crop and un-till the land. This is outdated: since version {{Version link|JE 1.1}}, wheat can be destroyed only by a player or mob jumping on it or falling on it.}}

<div style="text-align:center">{{yt|JbAURiYQZlA}}</div>

== History ==

{{History|java indev}}
{{History||20100206|[[File:Wheat JE1 BE1.png|32px]] Wheat has been added.
|Wheat can be used to craft [[bread]].}}
{{History||20100223|Bread now requires 3 wheat (1 row of 3) instead of 6 (2 rows of 3) to be crafted.}}
{{History|java infdev}}
{{History||20100625-2|Wheat can now be found in the new [[dungeon]] [[chest]]s.}}
{{History|java beta}}
{{History||1.2|Wheat can now be used to craft [[cake]].}}
{{History||1.4|Wheat can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Wheat can now be used in [[breeding]].}}
{{History||1.3.1|snap=12w21a|Wheat can now be [[trading|sold]] to farmer [[villager]]s, at 18–21 wheat for 1 [[emerald]].}}
{{History||1.4.2|snap=12w36a|[[Chicken]]s and [[pig]]s no longer use wheat to [[breeding|breed]].}}
{{History||1.6.1|snap=13w16a|[[Horse]]s can now be healed by being fed wheat.
|Foals can now have their growth increased by being fed wheat.}}
{{History|||snap=13w17a|[[Horse]]s can now have their tempers lowered with wheat.}}
{{History|||snap=13w18a|Nine wheat can now be crafted to make a [[hay bale]].}}
{{History||1.8|snap=14w02a|Trading has been changed: farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{history||1.9|snap=15w43a|Wheat may now be found in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of wheat in [[dungeon]] chests has been decreased.}}
{{History||1.11|snap=16w39a|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 296.}}
{{History|||snap=18w09a|Wheat can now generate in the chests of [[underwater ruins]].}}
{{History|||snap=18w11a|Wheat can now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History|||snap=18w47a|Wheat can now generate inside of loot chests on top of [[pillager outpost]]s.}}
{{History|||snap=18w49a|Wheat can now generate in chests in [[village]] butcher and shepherd houses.}}
{{History|||snap=18w50a|Wheat can now generate in chests in desert [[village]] houses.}}
{{History||1.14|snap=19w03a|Placing wheat into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Wheat now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with wheat in their mouths.}}
{{History||1.17|snap=21w13a|Wheat can now be used to breed [[goat]]s.}}
{{History||1.19|snap=22w11a|Wheat can now be used to craft [[packed mud]].}}
{{History||1.20|snap=23w12a|Wheat can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Wheat no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], wheat is now common loot.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Wheat is now obtainable via farming and can be used to craft [[bread]].}}
{{History||v0.7.0|Wheat can now be used to craft [[cake]].}}
{{History||v0.8.0|snap=build 1|Wheat can now be used to breed [[cow]]s and [[sheep]].
|Wheat can now be used to craft [[hay bale]]s.}}
{{History||v0.9.0|snap=build 1|Wheat [[crop]]s now naturally spawn in [[village]]s.
|Wheat can now be used to craft [[cookie]]s.}}
{{History||v0.15.0|snap=build 1|Wheat can now be used to grow, increase tame and heal [[horse]]s, [[donkey]]s and [[mule]]s.}}
{{History||v0.16.2|Wheat can now be found in the [[chest]]s inside of large houses in [[ice plains]] and [[cold taiga]] [[village]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Wheat can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Wheat can now be found inside [[shipwreck]] chests.}}
{{History|||snap=beta 1.2.20.1|Wheat can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Wheat can now be found in [[pillager outpost]] chests.
|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Wheat can now be found in [[desert]] [[village]] house chests, village shepherd and butcher house chests.
|Wheat can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has changed, farmer [[villager]]s now have a 25% chance to buy 20 wheat for one [[emerald]] as part of their first tier trade.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can drop wheat.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Wheat SDGP.png|Wheat in the [[Super Duper Graphics Pack]].
File:Field of Wheat.jpg|[[Steve]] and [[Kai]] in a field of wheat crops.<ref>https://www.instagram.com/p/CumuJleg6Ij/</ref>
</gallery>

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--wheat Taking Inventory: Wheat] – Minecraft.net on April 21, 2022
{{Items}}

[[Category:Plants]]
[[Category:Food]]

[[cs:Pšenice]]
[[de:Weizen]]
[[es:Trigo]]
[[fr:Blé]]
[[hu:Búza]]
[[it:Grano]]
[[ja:小麦]]
[[ko:밀]]
[[nl:Tarwe]]
[[pl:Pszenica]]
[[pt:Trigo]]
[[ru:Пшеница]]
[[th:ข้าวสาลี]]
[[uk:Пшениця]]
[[zh:小麦]]
[[Category:Renewable resources]]</li></ul>
Pre-release 3Now when specifying a sound event, a fixed audible range can be also specified within an object.
1.19.4
{{Extension DPL}}<ul><li>[[Nether Star|Nether Star]]<br/>{{Distinguish|Firework Star}}
{{Item
| image = Nether Star.gif
| renewable = Yes
| stackable = Yes (64)
| rarity = Uncommon
}}
The '''nether star''' is a rare item [[drops|dropped]] by the [[wither]] that is used solely to [[Crafting|craft]] [[beacon]]s.

== Obtaining ==

=== Mob loot ===

The nether star can be obtained only by defeating the [[wither]] [[Mob#Boss mobs|boss]], which is created using [[soul sand]] and [[Head|wither skeleton skulls]]. One nether star is dropped each time; the dropped amount is not affected by the [[Looting]] enchantment. {{IN|java}}, nether stars dropped by withers take 10 minutes to despawn and are immune to explosions. {{IN|bedrock}}, nether star items never despawn, neither by time nor by explosions.

== Usage ==

The nether star has the same animated glint as [[enchanted]] items, [[potion]]s, and [[end crystal]]s.

A dropped nether star item cannot be destroyed by [[explosion]]s. However, it can still be destroyed by a falling [[anvil]],‌{{only|java}} [[fire]], [[lava]], [[cacti]], or [[the Void]].

It is used to [[Crafting|craft]] a [[beacon]].

=== Crafting ingredient ===

{{crafting usage|match=start}}

== Achievements ==
{{load achievements|The beginning;The beginnig?.}}

== Advancements ==
{{load advancements|Withering Heights}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Nether Star
|spritetype=item
|nameid=nether_star
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Nether Star
|spritetype=item
|nameid=nether_star
|aliasid=netherstar
|id=518
|form=item
|translationkey=item.netherStar.name
|foot=1}}

== Video ==

<div style="text-align:center">{{yt|H6k28iUefMo}}</div>

== History ==

{{History|java}}
{{History||1.4.2|snap=12w34a|[[File:Nether Star JE1.png|32px]] The texture of the nether star has been added.}}
{{History|||snap=12w36a|[[File:Nether Star JE1.gif|32px]] Added nether stars.
|Nether stars are [[drops|dropped]] by the [[wither]].}}
{{History|||snap=12w37a|[[File:Nether Star JE2 BE1.gif|32px]] The texture of nether stars has been changed so that they no longer have a dark outline.}}
{{History||1.4.6|snap=12w49a|[[Drops|Dropped]] nether stars can no longer be destroyed by [[explosion]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 399.}}
{{History||1.14|snap=18w43a|[[File:Nether Star.gif|32px]] The texture of nether stars has been changed.}}
{{History||1.16|snap=20w07a|Nether star has become a [[renewable resource]], as [[soul sand]], one of the blocks used to construct withers, is now renewable through [[bartering]].}}

{{History|pocket alpha}}
{{History||v0.16.0|snap=build 4|[[File:Nether Star JE2 BE1.gif|32px]] Added nether stars.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Nether Star.gif|32px]] The texture of nether stars has been changed.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Nether Star JE2 BE1.gif|32px]] Added nether stars.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Nether Star.gif|32px]] The texture of nether stars has been changed.}}

{{History|New 3DS}}
{{History||1.3.12|[[File:Nether Star JE2 BE1.gif|32px]] Added nether stars.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==

<gallery>
File:Nether Star JE3 BE2.png|The nether star without enchanted animated glint.
File:Star Drop.png|The nether star dropped by the wither.
File:Wither, left- Nether Star, right.png|A wither to the left, and a nether star to the right.
</gallery>

== References ==
{{reflist}}

==External Links==
*[https://www.minecraft.net/en-us/article/taking-inventory--nether-star Taking Inventory: Nether Star] – Minecraft.net on May 11, 2023

{{Items}}

[[cs:Netheritová hvězda]]
[[de:Netherstern]]
[[es:Estrella del Inframundo]]
[[fr:Étoile du Nether]]
[[hu:Alvilági csillag]]
[[it:Stella del Nether]]
[[ja:ネザースター]]
[[ko:네더의 별]]
[[nl:Netherster]]
[[pl:Netherowa gwiazda]]
[[pt:Estrela do Nether]]
[[ru:Звезда Нижнего мира]]
[[tr:Nether Yıldızı]]
[[uk:Зірка Незеру]]
[[zh:下界之星]]
[[Category:Renewable resources]]</li><li>[[Scute|Scute]]<br/>{{about|the item used to craft turtle shell helmets|the helmet|Turtle Shell}}
{{Item
| image = Scute.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Scutes''' are [[item]]s that baby [[turtle]]s drop when they grow into adults. They can be used to craft [[turtle shell]]s which can be used to brew the [[potion of the Turtle Master]].

== Obtaining ==

=== Mob loot ===

Baby [[turtle]]s drop a single scute when they grow up into adults, which is the only way possible to obtain the [[item]].

== Usage ==

Scutes can be crafted into [[turtle shell]]s.

=== Crafting ingredient ===

{{crafting usage}}

=== Repairing ===
Scutes are the [[repair]] items for the turtle [[armor material]], and thus can be used to repair [[turtle shell]]s in an [[anvil]].

=== Trading ===
Expert-level cleric [[villager]]s have a {{frac|2|3}} chance to buy 4 scutes for an [[emerald]] as part of their [[trading|trades]].{{only|java}}

Expert-level cleric villagers have a 50% chance to buy 4 scutes for an emerald as part of their seventh trades.{{only|bedrock}}

Expert-level leatherworker villagers buy 4 scutes for an emerald as part of their trades.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Scute
|spritetype=item
|nameid=scute
|aliasid=turtle_shell_piece
|id=572
|form=item
|translationkey=item.turtle_shell_piece.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.13|snap=18w07a|[[File:Scute JE1 BE1.png|32px]] Added turtle shell pieces.}}
{{History|||snap=18w07b|"Turtle Shell Pieces" have now been renamed to "Scutes."}}
{{History||1.14|snap=19w11a|Cleric and leatherworker [[villager]]s now [[trading|buy]] scutes.}}

{{History|bedrock}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Scute JE1 BE1.png|32px]] Added scutes.}}
{{History||1.11.0|snap=beta 1.11.0.4|Scutes can be [[trading|sold]] to cleric and leatherworker [[villager]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Scute JE1 BE1.png|32px]] Added scutes.}}
{{history|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Scutes used to be called "Turtle Shell Pieces", they were renamed after it was pointed out that "Scute" was a more technical term.<ref>https://www.reddit.com/r/minecraftsuggestions/comments/7xnp2o/rename_turtle_shell_pieces_to_scutes/</ref>

== References ==
{{reflist}}

{{Items}}

[[Category:Renewable resources]]

[[de:Hornschild]]
[[es:Escama de tortuga]]
[[fr:Écaille de tortue]]
[[ja:カメのウロコ]]
[[ko:인갑]]
[[lzh:鱗]]
[[pl:Tarczka]]
[[pt:Escama de tartaruga]]
[[ru:Щиток]]
[[th:เกล็ดเต่า]]
[[uk:Черепок]]
[[zh:鳞甲]]</li></ul>
23w03aRenamed the precipitation field to has_precipitation. And now it is a boolean, and when it is true, whether it rains or snows are determined only by temperature. Before, it can be one of "none", "rain" and "snow".[1]
Pre-release 1Now  minCount and  maxCount in  spawners must be a positive integer. And  maxCount must be not less than  minCount.

References

  1. ↑ To fix MC-230678, MC-233893, MC-238904, MC-247836, MC-254132, and MC-255811.
Data packs
Components
World generation
Data packs
Tutorials

Biome categories

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

  • Any biomes in the category ocean will be 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 will play the underwater music instead of their normal music when the player is underwater.
  • Zombie sieges and patrols will not spawn in biomes in the category mushroom.
  • Rabbits spawning in biomes in the category desert will 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 will not spawn in any biome which isn't in the category ocean or river.

Default biomes

Main article: Biome

Carvers

Carvers are used to add carved out regions of biomes, either replaced with air or liquid. They stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_carver.

Whether it is possible to configure the "ocean" layer of carvers (for example the lava that appears below y=10 in Overworld caves) is unknown.

JSON format

The root tag

    •  type: The type of carver to use, must be one of either "cave", "nether_cave", "canyon", "underwater_canyon", or "underwater_cave".
    •  config: See below.

Shared by all carver types:

  •  config:Configuration values for the carver.
    •  probability: The probability that each chunk attempts to generate this carver, must be between 0 and 1.
    •  y: Height provider. The height at which this carver attempts to generate.
      • Height provider
    •  yScale: Float provider. Vertically scales the carved area.
      • Float provider
    •  lava_level: The vertical anchor where lava begins to generate.
      • Choices for a vertical anchor (must choose only one of three)
    •  aquifers_enabled: If true, aquifers will be generated.

When carver type is "cave", "nether_cave", or "underwater_cave":

  •  config: Configuration values for the carver

When carver type is "canyon" or "underwater_canyon":

  •  config: Configuration values for the carver.
    •  vertical_rotation:[needs testing] Creates the curves in the canyon as it continues.
      • Float provider
    •  shape: The shape to use for the ravine.
      •  thickness:[needs testing] The width of the canyon.
        • Float provider
      •  width_smoothness:[needs testing] Higher values seem to smooth canyon walls on the vertical axis. Must be positive.
      •  distance_factor:[needs testing]
        • Float provider
      •  horizontal_radius_factor:[needs testing]
        • Float provider
      •  vertical_radius_default_factor:[needs testing]
        • Float provider
      •  vertical_radius_center_factor:[needs testing]
        • Float provider

Surface builders

Surface builders control how the surface of the terrain is shaped and what blocks it is generated with. They stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_surface_builder.

JSON format

This page describes content that exists only in outdated versions of Minecraft. 
This feature used to be in the game but has since been removed.
Information icon
This feature is exclusive to Java Edition. 

Surface builders control how the surface of the terrain is shaped and what blocks it is generated with. Configured surface builders are stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_surface_builder. They are used in world generation.

JSON format

The root tag

    •  type:[needs testing] The type of surface builder to use, must be one of "default", "mountain", "shattered_savanna", "gravelly_mountain", "giant_tree_taiga", "swamp", "badlands", "wooded_badlands", "eroded_badlands", "frozen_ocean", "nether", "nether_forest", "soul_sand_valley", "basalt_deltas", or "nope". These choices change the generation of patterns of surface materials, and in the case of "frozen_ocean" and "eroded_badlands", add generated icebergs and buttes, respectively. For example, the mixed patterns of stone in mountains and the striped terracotta of mesas are coded for through these options.
    •  config: Configuration for the surface builder.
      •  top_material:[needs testing] The block to use for the topmost layer of the terrain.
        •  Name: The namespaced id of the block to use.
        •  Properties: Block states
          •  state: A block state key and its value.
      •  under_material:[needs testing] The block to use directly under the topmost layer of the terrain.
        •  Name: The namespaced id of the block to use.
        •  Properties: Block states
          •  state: A block state key and its value.
      •  underwater_material:[needs testing] The block to use under bodies of water.
        •  Name: The namespaced id of the block to use.
        •  Properties: Block states
          •  state: A block state key and its value.

Features

Features are unique elements of the world like trees, flowers, ore, etc. They stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_feature.

JSON format

When another configured feature is required inside the settings, it can either be provided with a string tag as the namespaced id of another configured feature, or with a compound tag as a nested definition.

  • : Root object.
    •  type: The ID of feature type.
    •  config: Configuration of this configured feature. The avialable properties vary depending on the  type. Types that are not listed below have no config, but must still have an empty config object.

Data types

The JSON format makes use of these relatively complex data types many times, so to avoid filling the main JSON format tree with too much redundant information, they are provided here:

Custom world generation/data types

Feature types

These are all of the valid types which can be used for configured features:

  • no_op
  • chorus_plant
  • void_start_platform
  • desert_well
  • fossil
  • ice_spike
  • glowstone_blob
  • freeze_top_layer
  • vines
  • monster_room
  • blue_ice
  • end_island
  • kelp
  • coral_tree
  • coral_mushroom
  • coral_claw
  • weeping_vines
  • twisting_vines
  • bonus_chest
  • basalt_pillar
  • tree
  • flower
  • random_patch
  • block_pile
  • nether_forest_vegetation
  • spring_feature
  • emerald_ore
  • huge_red_mushroom
  • huge_brown_mushroom
  • iceberg
  • forest_rock
  • lake
  • disk
  • ice_patch
  • ore
  • no_surface_ore
  • end_spike
  • end_gateway
  • seagrass
  • bamboo
  • sea_pickle
  • simple_block
  • huge_fungus
  • basalt_columns
  • delta_feature
  • netherrack_replace_blobs
  • fill_layer
  • random_selector
  • simple_random_selector
  • random_boolean_selector
  • decorated
  • decorated_flower

Decorators

Decorators are used to modify the generation of features in various ways.

JSON format

  • The root tag
    •  type: The type of configured decorator. Must be one of the types listed below.
    •  config: The settings for this configured decorator. The settings vary depending on type. Any name not listed under this tag has no settings; however, they must still include an empty config object in their definition.
      • If type is chance, lava_lake, or water_lake:
        •  chance:[needs testing] The chance for this feature to generate. Calculated by 1 / chance.
      • If type is count, fire, glowstone, or count_multilayer:
        •  count:[needs testing]
          • Uniform Int with minBase -10, maxBase 128, and maxSpread 128
      • If type is count_noise:
        •  noise_level: Determines the threshold within the Perlin noise of when to use below_noise or above_noise.
        •  below_noise: Determines the count placed when the noise is below noise_level .
        •  above_noise: Determines the count placed when the noise is above noise_level .
      • If type is count_noise_biased:
        •  noise_to_count_ratio: Determines the count features generated at the peak noise.
        •  noise_factor: Determines the size of the affected region, scales Perlin noise.
        •  noise_offset (optional): Determines the threshold of the "positive" area, where features are generated. Ranges from -1 to 1, defaults to 0 if not provided.
      • If type is count_extra:
      • If type is range, range_biased, or range_very_biased:
        •  bottom_offset (optional):[needs testing] Defaults to 0 if not provided.
        •  top_offset (optional):[needs testing] Defaults to 0 if not provided.
        •  maximum (optional):[needs testing] Defaults to 0 if not provided.
      • If type is depth_average:
      • If type is carving_mask:
      • If type is decorated:
        •  outer: The outer configured decorator.
        •  inner: The inner configured decorator.

Decorator types

These are all of the valid types which can be used for configured decorators:

  • nope
  • square
  • heightmap
  • heightmap_spread_double
  • top_solid_heightmap
  • heightmap_world_surface
  • spread_32_above
  • magma
  • emerald_ore
  • end_gateway
  • dark_oak_tree
  • iceberg
  • end_island
  • chance
  • lava_lake
  • water_lake
  • count
  • fire
  • glowstone
  • count_multilayer
  • count_noise
  • count_noise_biased
  • count_extra
  • range
  • range_biased
  • range_very_biased
  • depth_average
  • carving_mask
  • decorated

Structure features

Structure features are a special type of feature that generates a structure, stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_structure_feature. The logic behind what qualifies as a structure feature versus a regular feature is unclear. Dungeons and Desert wells are typically considered structures, but are not structure features. Also, Nether Fossils are structure features while Fossils are not even though they are essentially the same feature.

JSON format

Information icon
This feature is exclusive to Java Edition. 

Structures (also known as structure features) are a special type of feature that generates a structure.

Structure Feature Type

A structure feature type determines how and what to generate.

List

All structure feature types and their roles are listed below:

  • buried_treasure
  • desert_pyramid
  • end_city
    • To generate an end city with structure templates.
  • fortress
  • igloo
    • To generate an igloo with structure templates.
  • jigsaw
    • To generate a structure feature using custom structure templates. Often used to generate large structures by connecting multiple structural templates via jigsaw blocks.
  • jungle_temple
  • mineshaft
  • nether_fossil
  • ocean_monument
  • ocean_ruin
  • ruined_portal
  • shipwreck
    • To generate a shipwreck with structure templates.
  • stronghold
  • swamp_hut
  • woodland_mansion

Structure Template

Structure template refers to a structure file, which stores the template used to generate structure features. For structures of jigsaw type, the resource locations of the structure templates is customized. While for other structure features, such as end city, igloo, etc., the resource locations of structure templates are hardcoded.

Structure Pool

A structure pool (aka. jigsaw pool, template pool) groups multiple structure templates or placed features together to randomly select one of them to generate. Used in structures of type jigsaw. Stored as JSON files within a data pack in the data/<namespace>/worldgen/template_pool.

JSON Format

  • The root tag
    •  fallback: The fallback pool. Should be an ID of a structure pool. Template in the fallback pool generates in the following two cases:
      1. When the generation of jigsaw reaches the specified level/depth number, the fallback pool generates at the end of the last level.
      2. All the elements in this structure pool can not be successfully generated.
      In the above two cases, the game will try to generate a template from the fallback pool.
      When trying to generate a template from the fallback pool, if all the elements in the fallback pool cannot be generated successfully, nothing will be generated.
    •  elements: A list of elements to randomly select from.
      For the start pool of the jigsaw structure feature, if the name of the start jigsaw block is specified, but there's no jigsaw block with the corresponding name in the selected element, the whole structure feature fails to generate. For the non-start pool, a selected element successfully generates when the following conditions are met:
      1. There is a jigsaw block with the corresponding name and corresponding direction (the horizontal jigsaw blocks correspond to each other, and a up facing jigsaw block corresponds to a down facing block, while a down facing block corresponds to a up facing block) in the element.
      2. The 3D Chebyshev distance between the element and the start of the structure doesn't exceed the maximum distance specified in the configured structure feature, or doesn't exceed 128 when generated by commands or jigsaw block GUI.
      3. The element will not overlap with other generated jigsaws, unless the block pointed by the jigsaw block is inside the current jigsaw.
      4. If the block pointed by the jigsaw block is inside the current jigsaw, then this element and all the jigsaws generated later by this element must be completely inside the jigsaw where this jigsaw block is located.
      If the element fails to generate, it will try again to generate another element in the list. If all of the elements in the list cannot be generated successfully, the fallback pool will be used.
      • : An element.
        •  weight: How likely this element is to be chosen when using this pool. Value between 1 and 150 (inclusive).
        •  element: The properties of this element.
          •  projection: Can be rigid to place a fixed structure (like a house), or terrain_matching to match the terrain height (like a village road).
          •  element_type: Can be minecraft:empty_pool_element to generate nothing, minecraft:feature_pool_element to generate a placed feature, minecraft:list_pool_element to generate multiple elements one after another (lower elements replace their front ones), and minecraft:legacy_single_pool_element or minecraft:single_pool_element to generate a structure template. The difference between legacy_single_pool_element and single_pool_element, is that the legacy_single_pool_element will not replace existing blocks with air, and the single_pool_element will replace blocks with air and relies on the structure_void block to avoid not replacing blocks.
            If  element_type is feature_pool_element, additional fields are as follows:
          •  feature: The namespaced id of the placed feature.
            If  element_type is list_pool_element, additional fields are as follows:
          •  elements: A list of elements to choose from.
            • : An element, with the same format above.
            If  element_type is legacy_single_pool_element or single_pool_element, additional fields are as follows:
          •  location: The namespaced id of the structure template to generate.
          •  processors: (Required, but can be empty) The namespaced ID of a processor list, or a object of a processor list, or a list of processors.


Configured Structure Feature

A structure feature type determines how to generate a structure feature, but the specific details need to be configured additionally. After configured, it is called a configured structure feature, or simply called a structure feature or a structure.

Configured structure features are stored as JSON files within a data pack in the path data/<namespace>/worldgen/structure.

JSON Format

  • The root tag
    •  type: The ID of structure feature type.
    •  biomes: Biomes that this structure is allowed to generate in. Can be a biome ID or a biome tag, or a list of biome IDs.
    •  step: The step where the structure generates. See also the features field in custom biome. Structure features are generated prior to features in the same step. One of raw_generation, lakes, local_modifications, underground_structures, surface_structures, strongholds, underground_ores, underground_decoration, fluid_springs, vegetal_decoration, and top_layer_modification.
    •  terrain_adaptation: (Optional, defaults to none) The type of terrain adaptation used for the structure [needs testing]. none for no adaptation, beard_thin is used by pillager outposts and villages, beard_box is used by ancient cities, and bury is used by strongholds.
    •  spawn_overrides: (Required, but can be empty. If this object doesn't contain a certain category, the category's spawn setting won't be overridden, and mobs are spawned based on biome.) Overrides the mobs that can spawn in this structure. Used for things like blaze and wither skeleton spawning in nether fortresses, and can also be used to block mobs from spawning like in ancient cities.
      •  <mob category>: The key must be one of monster, creature, ambient, water_creature, underground_water_creature, water_ambient, misc, or axolotls.
        •  bounding_box：Can be piece or full. If full, overrides spawn setting inside the full bounding box of the structure. If piece, only the bounding boxs of all structure pieces.
        •  spawns：(Required, but can be empty. If empty, mobs in this category will not be spawned) 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. Must be greater than 0.
            •  maxCount: The maximum count of mobs to spawn in a pack. Must be greater than 0. And must be not less than  minCount.
      If type is minecraft:jigsaw, additional fields are as follows:
    •  start_pool: The structure pool the structure starts from. Can be an ID of structure pool, or a structure pool object.
    •  size: The depth of jigsaw structures to generate. Value between 0 and 7 (inclusive).
    •  start_height: If project_start_to_heightmap is unset, the structure will start at the value provided. Otherwise, the value acts as an offset from the heightmap.
      • Height provider
    •  project_start_to_heightmap: (optional) The heightmap the start height should project to. Can be WORLD_SURFACE_WG, WORLD_SURFACE, OCEAN_FLOOR_WG, OCEAN_FLOOR, MOTION_BLOCKING, or MOTION_BLOCKING_NO_LEAVES.
    •  start_jigsaw_name: (optional) The name of the jigsaw block the structure start attaches to.
    •  max_distance_from_center: The maximum 3D Chebyshev distance from the jigsaw pieces to the structure start. Value between 1 and 128 (inclusive) when  terrain_adaptation is "none", otherwise from 1 to 116 (inclusive).
    •  use_expansion_hack: Only used in villages.
      If type is minecraft:mineshaft, additional fields are as follows:
    •  type: Either normal or mesa. normal for mineshaft made of oak, while mesa for mineshaft made of dark oak.
      If type is minecraft:nether_fossil, additional fields are as follows:
    •  start_height: The y-value that the structure will start.
      • Height provider
      If type is minecraft:ocean_ruin, additional fields are as follows:
    •  biome_temp: Either warm or cold. Determines which variant this structure uses.
    •  large_probability: The probability of this structure using the large variant buildings. Value between 0.0 and 1.0 (inclusive).
    •  cluster_probability: The probability of a cluster of ocean ruins generating, instead of just one. Value between 0.0 and 1.0 (inclusive).
      If type is minecraft:ruined_portal, additional fields are as follows:
    •  setups: (Cannot be empty) A list of ruined portal setups to randomly choose one from it.
      •  weight: The weight this ruined portal setup will be chosen.
      •  placement: Either on_land_surface, partly_buried, on_ocean_floor, in_mountain, underground, in_nether. Determines how the ruined portal will be placed.
      •  air_pocket_probability: The probability that the ruined portal will generate an air pocket around it. Value between 0.0 and 1.0 (inclusive).
      •  mossiness: Determines how mossy the ruined portal is, as an argument for minecraft:block_age processor. Value between 0.0 and 1.0 (inclusive).
      •  overgrown: Determines whether or not jungle leaves generate.
      •  vines: Determines whether or not vines generate on the ruined portal.
      •  can_be_cold: Determines whether or not lava and magma can be replaced with netherrack.
      •  replace_with_blackstone: Determines whether or not stone bricks in the ruined portal will be replaced with their blackstone equivalents.
      If type is minecraft:shipwreck, additional fields are as follows:
    •  is_beached: (optional, defaults to false) Whether or not the shipwreck is beached.


Structure Set

A structure set is used to place structures in given locations, stored as JSON files within a data pack in the path data/<namespace>/worldgen/structure_set.

JSON Format

  • : Root object.
    •  structures: (Required, but can be empty) The structures that may be placed. One configured structure feature shouldn't be included by two structure sets.
      • : A structure to be placed.
        •  structure: The configured structure feature to be placed. Can be a namespaced ID or an object of configured structure feature.
        •  weight: Determines the chance of it being chosen over others. Must be a positive integer.
    •  placement: How the structures should be placed.
      •  salt: A number that assists in randomization; see salt (cryptography). Must be a non-negative integer.
      •  frequency: (Optional, default to 1.0) Probability to try to generate if other conditions below are met. Values between 0.0 to 1.0 (inclusive). Setting it to a number does not mean one structure is generated this often, only that the game attempts to generate one; biomes or terrain could lead to the structure not being generated.
      •  frequency_reduction_method: (Optional, defaults to default) Provides a random number generator algorithm for frequency. One of default (the random number depends on the the seed, position and  salt), legacy_type_1 (the random number depends only on the seed and position, and randomness only occurs when the locations differ greatly), legacy_type_2 (same as default, but with fixed salt: 10387320) and legacy_type_3 (the random number depends only on seed and position).
      •  exclusion_zone: Specifies that it cannot be placed near certain structures.
        •  chunk_count: Value betwenn 1 and 16 (inclusive).
        •  other_set: A structure set ID.
      •  locate_offset: (optional, defaults to [0,0,0]) The chunk coordinate offset given when using /locate structure.
        • : X. Value between -16 and 16 (inclusive).
        • : Y. Value between -16 and 16 (inclusive).
        • : Z. Value between -16 and 16 (inclusive).
      •  type: One of minecraft:concentric_rings or minecraft:random_spread.
        If type is minecraft:concentric_rings (distributed like strongholds), additional fields are as follows:
      •  distance: The thickness of a ring plus that of a gap between two rings. Value between 0 and 1023 (inclusive). Unit is 6 chunks
      •  count: The total number of generation attempts in this dimension. Value between 1 and 4095 (inclusive).
      •  preferred_biomes: Biomes in which the structure is likely to be generated. Can be a biome ID or a biome tag, or a list of biome IDs.
      •  spread: How many attempts are on the closest ring to spawn. Value between 0 and 1023 (inclusive). The number of attempts on the Nth ring is: spread * (N^2 + 3 * N + 2) / 6, until the number of attempts reaches the total  count.
        If type is minecraft:random_spread (distributed like bastion remnants or swamp huts), additional fields are as follows:
      •  spread_type: (optional, defaults to linear) One of linear or triangular.
      •  spacing: Average distance between two neighboring generation attempts. Value between 0 and 4096 (inclusive).
      •  separation: Minimum distance (in chunks) between two neighboring attempts. Value between 0 and 4096 (inclusive). And be not bigger than  spacing. The maximum distance of two neighboring generation attempts is 2*spacing - separation.


Processor List

A processor list is a list of processors used to transform blocks in a structure template, stored as JSON files within a data pack in the path data/<namespace>/worldgen/processor_list.

JSON Format

A processor list can be a list, or an object that contains a list.

A list:

  • : A list of processors.
    • : A processor object.
      • A processor

Or an object:

  • : An object of processor list.
    •  processors: A list of processors.
      • : A processor object.
        • A processor

History

Java Edition
1.19
{{Extension DPL}}<ul><li>[[Door|Door]]<br/>{{About|the block|the music track|Minecraft - Volume Alpha}}
{{See also|Trapdoor}}
{{Block
| image = <gallery>
Iron Door.png|Java Edition
Iron Door BE.png|Bedrock Edition
</gallery>
| extratext = View [[#Gallery|all renders]]
| transparent = Partial
| light = No
| tntres = {{Blast resistance values|Wooden Door}} <small>(Wood)</small><br>{{Blast resistance values|Iron Door}}<small> (Iron)</small>
| hardness = {{Hardness values|Wooden Door}} <small>(Wood)</small><br>{{Hardness values|Iron Door}}<small> (Iron)</small>
| tool = axe
| tool2 = wooden pickaxe
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = '''Overworld wood''': Yes<br>'''Nether wood''','''iron''': No
}}
A '''door''' is a block that can be used as a barrier that can be opened by hand or with [[redstone]].

== Obtaining ==
Doors can be found in any Overworld biome, and can also be crafted from any type of [[wood]] as well as materials found in [[the Nether]]. Some have built-in openings that are useful for determining the time of day.

=== Breaking ===
Wooden doors can be broken with anything, but [[axe]]s are fastest. An iron door can be broken with anything if the top half of the door is broken.<ref>{{bug|MC-189739}}</ref><ref>{{bug|MCPE-126620}}</ref> All doors drop themselves if they no longer have a block beneath them that can support them.
{{breaking row
|Oak Door, Spruce Door, Birch Door, Jungle Door, Acacia Door, Dark Oak Door, Mangrove Door, Cherry Door, Bamboo Door, Crimson Door, Warped Door; Iron Door
|textTrim=Door
|Axe;Pickaxe
|;
|item=1;1
|link=none;none
}}

A door is removed and drops itself as an item:

* if the block beneath the door is moved, removed, or destroyed
* if a [[piston]] tries to push the door (trying to pull a door does nothing) or moves a block into its space

=== Natural generation ===
Doors generate in some generated structures, forming the entrances to the majority of buildings. Doors do not generate in [[zombie village]]s.

;{{BlockSprite|Oak Door|text=Oak}}

Oak doors generate as part of:

* Plains [[village]]s
* [[Stronghold]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Spruce Door|text=Spruce}}

Spruce doors generate as part of:

* Taiga, snowy tundra and snowy taiga [[village]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Jungle Door|text=Jungle}}

Jungle doors generate as part of:

* Desert [[village]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Acacia Door|text=Acacia}}

Acacia doors generate as part of:

* Savanna [[village]]s
<!-- * Right-side-up [[shipwreck]]s{{only|BE}}{{need testing}} -->

;{{BlockSprite|Dark Oak Door|text=Dark oak}}

Dark oak doors generate as part of:

* Master bedroom closets in [[woodland mansion]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Iron Door|text=Iron}}

Iron doors generate as part of:

* Prison rooms in [[woodland mansion]]s
* [[Stronghold]]s with a stone [[button]] to open{{only|JE}}

=== Crafting ===
{{Crafting
|head=1
|name=[[Wood Door]]
|A1= Matching Planks
|B1= Matching Planks
|A2= Matching Planks
|B2= Matching Planks
|A3= Matching Planks
|B3= Matching Planks
|Output= Matching wood Door,3
|type= Redstone
}}
{{Crafting
|A1= Iron Ingot
|B1= Iron Ingot
|A2= Iron Ingot
|B2= Iron Ingot
|A3= Iron Ingot
|B3= Iron Ingot
|Output= Iron Door,3
|type= Redstone
|foot=1
}}

== Usage ==
Wooden doors can be opened and closed by players, [[villager]]s, [[wandering trader]]s{{only|bedrock|short=1}}<!--Wandering traders cannot open doors in java edition. -->, [[vindicator]]s{{only|java|short=1}}, and [[piglin]]s. Wooden doors can be broken by all variants of [[zombie]]s (except [[drowned]]) and [[vindicator]]s in Hard difficulty.

Iron doors can be opened only with redstone power.

=== Placement ===
Doors must be "attached" to a block beneath them. To place a door, {{control|use}} a door item while pointing at the top of the block it should be attached to. A door can be attached to:
* the '''top''' of any full solid [[opaque]] block ([[stone]], [[dirt]], [[blocks of gold]], etc.)
* the '''top''' of an upside-down [[slab]] or upside-down [[stairs]]
* the '''top''' of a [[slime block]] or downward-facing [[piston]]

More information about placement on transparent blocks can be found at [[Opacity/Placement]].

When placed, a door occupies the side of the block facing the player, or behind a player if placed in the player's own space.

By default, a door's "hinge" appears on the side of the half of the block that the player pointed at when placing and its "handle" on the opposite side{{only|java}}, but the hinge is forced to other side by:
* Placing a door besides another door (creating a double door where both doors open away from each other)
* Placing a door between a full solid and any opaque block (top or bottom), making the hinge appear to attach to the solid block.

=== Behavior ===
[[Water]] and [[lava]] flow around doors. Lava can create [[fire]] in air blocks next to wooden doors as if the wooden doors were flammable, but the doors do not burn (and cannot be burned by other methods either, except throwing them into lava).

[[Mob]]s can spawn in a space occupied by a door.

The sound of opening and closing of a door can be heard up to 16 blocks away, like most mob sounds.

When placed using the {{cmd|setblock}} command, only one half of a door is placed, because doors are actually two separate blocks. The lower half still works, but with graphical bugs, and the upper half does not. Redstone cannot be used because it updates the half, breaking it. The upper half does not drop anything when broken, the lower half drops a normal door. This implies that the upper half is dependent on the lower.

=== Barrier ===
A door can be used as a switchable barrier to entity movement. Although primarily used to block movement by mobs and players, a door can also be used to control the movement of boats (for example, a door placed in a two-wide water flow stops a boat when perpendicular to the flow, but allow it to move again when parallel), items and minecarts (a door can stop a falling item or minecart, then allow it to drop again when the door moves), etc.

{{IN|Java}}, doors provide a breathable space if placed underwater. {{IN|bedrock}}, doors in water source blocks are [[waterlogging|waterlogged]] and do not displace water source blocks.

Doors are 0.1875 ({{frac|3|16}}) blocks thick (0.1825 {{in|bedrock}}). The rest of a door's space can be moved through freely. A door occupies two block spaces and both halves normally act as a single barrier, although doors can be opened or closed with a player or mob occupying the bottom block of the door,<ref>{{bug|MC-54255}} – "You can stand on the bottom block of a door, allowing you to climb it like a ladder" resolved as "Won't Fix"</ref> in which case the player can jump up to land on the bottom half of the door and then again to land on top of the door.

To open or close a wooden door, use the {{control|use|text=Use Item/Place Block}} [[control]]. When a door opens or closes, it immediately changes its orientation without affecting anything in the space it "swings through". Moving doors do not push entities the way that pistons do.

[[Villager]]s, [[wandering trader]]s,{{only|bedrock|short=1}} [[vindicator]]s{{only|java|short=1}}, [[piglin]]s and [[piglin brute]]s can open and close wooden doors when pathfinding.

Some [[zombie]]s can break wooden doors in [[Hard]] [[difficulty]]. Zombies have a 5% chance to spawn with the ability to break doors. Vindicators spawned from a [[raid]] in [[Normal]] and Hard difficulty can also break wooden doors, but they do so only to reach targeted players, villagers, or wandering traders. Some vindicators may sometimes open a wooden door instead of breaking it.{{only|java}} Both zombies and vindicators attempt to break wooden doors only when in their "closed" state, even if a door is placed so that its "open" state blocks access (for example, by facing sideways when placing a door so that it allows passage when closed and blocks passage when open).

Iron doors can be opened only with redstone power (a [[button]], a [[redstone circuit]], etc.). Any mob can activate an iron door by stepping on a pressure plate or by triggering a tripwire.

=== Redstone component ===
{{see also|Redstone circuit}}

Both wood and iron doors can be controlled with redstone power.

A door is a redstone [[mechanism component]] and can be activated by:
* an adjacent active '''[[power component]]''', including above or below: for example, a [[redstone torch]], a [[block of redstone]], a [[daylight sensor]], etc.
* an adjacent '''powered block''' (for example, a block with an active redstone torch under it), including above or below
* a powered '''[[redstone comparator]]''' or '''[[redstone repeater]]''' facing the door
* powered '''[[redstone dust]]''' configured to point at the door or a directionless "dot" next to it; a door is ''not'' activated by adjacent powered redstone dust that is configured to point in another direction.

All methods of activating a door can be applied to either the top or bottom parts of a door.

When activated, a door immediately rotates around its hinge side to its open state. When deactivated, a door immediately returns to its closed state.

An activated wood door can still be closed by a player or villager and does not re-open until it receives a new activation signal (if a door has been closed "by hand", it still needs to be deactivated and then reactivated to open by redstone).

=== Fuel ===
Overworld wooden doors can be used as a [[Smelting#Fuel|fuel]] in [[furnace]]s, smelting 1 item per door.

=== Note blocks ===
Wooden doors can be placed under [[note block]]s to produce "bass" sound.

== Sounds ==
=== Generic ===
==== Iron ====
{{Sound table/Block/Metal}}

==== Normal wood ====
{{Sound table/Block/Wood}}

==== Cherry wood ====
{{Sound table/Block/Cherry wood}}

==== Bamboo wood ====
{{Sound table/Block/Bamboo wood}}

==== Nether wood ====
{{Sound table/Block/Nether wood}}

=== Unique ===
{{el|java}}:
{{Sound table
|sound=Iron Door open1.ogg
|sound2=Iron Door open2.ogg
|sound3=Iron Door open3.ogg
|sound4=Iron Door open4.ogg
|subtitle=Door creaks
|source=block
|description=When an iron door opens
|id=block.iron_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Iron Door close1.ogg
|sound2=Iron Door close2.ogg
|sound3=Iron Door close3.ogg
|sound4=Iron Door close4.ogg
|subtitle=Door creaks
|source=block
|description=When an iron door closes
|id=block.iron_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Wooden Door open3.ogg
|sound2=Wooden Door open4.ogg
|subtitle=Door creaks
|source=block
|description=When a wooden door opens
|id=block.wooden_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Wooden Door close2.ogg
|sound2=Wooden Door close5.ogg
|sound3=Wooden Door close6.ogg
|subtitle=Door creaks
|source=block
|description=When a wooden door closes
|id=block.wooden_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Cherry door toggle1.ogg
|sound2=Cherry door toggle2.ogg
|sound3=Cherry door toggle3.ogg
|sound4=Cherry door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a cherry wood door opens
|id=block.cherry_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a cherry wood door closes
|id=block.cherry_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Bamboo Door toggle1.ogg
|sound2=Bamboo Door toggle2.ogg
|sound3=Bamboo Door toggle3.ogg
|sound4=Bamboo Door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a bamboo wood door opens
|id=block.bamboo_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a bamboo wood door closes
|id=block.bamboo_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Nether Door toggle1.ogg
|sound2=Nether Door toggle2.ogg
|sound3=Nether Door toggle3.ogg
|sound4=Nether Door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a Nether wood door opens
|id=block.nether_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a Nether wood door closes
|id=block.nether_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Zombie hit wood1.ogg
|sound2=Zombie hit wood2.ogg
|sound3=Zombie hit wood3.ogg
|sound4=Zombie hit wood4.ogg
|subtitle=Door shakes
|source=hostile
|description=When a [[zombie]] attacks a door
|id=entity.zombie.attack_wooden_door
|translationkey=subtitles.entity.zombie.attack_wooden_door
|volume=2.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Zombie hit metal1.ogg
|sound2=Zombie hit metal2.ogg
|sound3=Zombie hit metal3.ogg
|subtitle=Block broken <ref group=sound name=ironsubtitle>{{Bug|MC-226770}}</ref>
|source=None
|description=''Unused sound event''<ref group=sound>{{bug|MC-218122}}</ref>
|id=entity.zombie.attack_iron_door
|translationkey=subtitles.block.generic.break|translationkeynote=<ref group=sound name=ironsubtitle/>
|volume=''None''
|pitch=''None''
|distance=''None''}}
{{Sound table
|sound=Zombie breaks door.ogg
|subtitle=Door breaks
|source=hostile
|description=When a zombie breaks a door
|id=entity.zombie.break_wooden_door
|translationkey=subtitles.entity.zombie.break_wooden_door
|volume=2.0
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|bedrock}}:
{{Sound table
|type=bedrock
|sound=Iron Door open1.ogg
|sound2=Iron Door open2.ogg
|sound3=Iron Door open3.ogg
|sound4=Iron Door open4.ogg
|source=block
|description=When an iron door opens
|id=open.iron_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Iron Door close1.ogg
|sound2=Iron Door close2.ogg
|sound3=Iron Door close3.ogg
|sound4=Iron Door close4.ogg
|source=block
|description=When an iron door closes
|id=close.iron_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Wooden Door open3.ogg
|sound2=Wooden Door open4.ogg
|source=block
|description=When a wooden door opens
|id=open.wooden_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Wooden Door close2.ogg
|sound2=Wooden Door close5.ogg
|sound3=Wooden Door close6.ogg
|source=block
|description=When a wooden door closes
|id=close.wooden_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Cherry door toggle1.ogg
|sound2=Cherry door toggle2.ogg
|sound3=Cherry door toggle3.ogg
|sound4=Cherry door toggle4.ogg
|source=block
|description=When a cherry wood door opens
|id=open.cherry_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a cherry wood door closes
|id=close.cherry_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Bamboo Door toggle1.ogg
|sound2=Bamboo Door toggle2.ogg
|sound3=Bamboo Door toggle3.ogg
|sound4=Bamboo Door toggle4.ogg
|source=block
|description=When a bamboo wood door opens
|id=open.bamboo_wood_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a bamboo wood door closes
|id=close.bamboo_wood_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Nether Door toggle1.ogg
|sound2=Nether Door toggle2.ogg
|sound3=Nether Door toggle3.ogg
|sound4=Nether Door toggle4.ogg
|source=block
|description=When a Nether wood door opens
|id=open.nether_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a Nether wood door closes
|id=close.nether_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|sound=Zombie hit wood1.ogg
|sound2=Zombie hit wood2.ogg
|sound3=Zombie hit wood3.ogg
|sound4=Zombie hit wood4.ogg
|source=hostile
|description=While a zombie is breaking a wooden door
|id=mob.zombie.wood
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Zombie breaks door.ogg
|source=hostile
|description=When a zombie breaks a wooden door
|id=mob.zombie.woodbreak
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Iron Door
|spritetype=block
|nameid=iron_door
|blocktags=doors
|itemtags=doors}}
{{ID table
|displayname=Oak Door
|spritetype=block
|nameid=oak_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Spruce Door
|spritetype=block
|nameid=spruce_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Birch Door
|spritetype=block
|nameid=birch_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Jungle Door
|spritetype=block
|nameid=jungle_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Acacia Door
|spritetype=block
|nameid=acacia_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Dark Oak Door
|spritetype=block
|nameid=dark_oak_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Mangrove Door
|spritetype=block
|nameid=mangrove_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Cherry Door
|spritetype=block
|nameid=cherry_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Bamboo Door
|spritetype=block
|nameid=bamboo_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Crimson Door
|spritetype=block
|nameid=crimson_door
|blocktags=doors, non_flammable_wood, wooden_doors
|itemtags=doors, non_flammable_wood, wooden_doors}}
{{ID table
|displayname=Warped Door
|spritetype=block
|nameid=warped_door
|blocktags=doors, non_flammable_wood, wooden_doors
|itemtags=doors, non_flammable_wood, wooden_doors
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|firstcolumnname=Door
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|spritename=iron-door
|displayname=Iron block
|spritetype=block
|nameid=iron_door
|id=71
|form=block
|itemform=item.iron_door}}
{{ID table
|spritename=oak-door
|displayname=Oak block
|spritetype=block
|nameid=wooden_door
|id=64
|form=block
|itemform=item.wooden_door
|translationkey=-}}
{{ID table
|spritename=spruce-door
|displayname=Spruce block
|spritetype=block
|nameid=spruce_door
|id=193
|form=block
|itemform=item.spruce_door
|translationkey=-}}
{{ID table
|spritename=birch-door
|displayname=Birch block
|spritetype=block
|nameid=birch_door
|id=194
|form=block
|itemform=item.birch_door
|translationkey=-}}
{{ID table
|spritename=jungle-door
|displayname=Jungle block
|spritetype=block
|nameid=jungle_door
|id=195
|form=block
|itemform=item.jungle_door
|translationkey=-}}
{{ID table
|spritename=acacia-door
|displayname=Acacia block
|spritetype=block
|nameid=acacia_door
|id=196
|form=block
|itemform=item.acacia_door
|translationkey=-}}
{{ID table
|spritename=dark-oak-door
|displayname=Dark Oak block
|spritetype=block
|nameid=dark_oak_door
|id=197
|form=block
|itemform=item.dark_oak_door
|translationkey=-}}
{{ID table
|spritename=mangrove-door
|displayname=Mangrove block
|spritetype=block
|nameid=mangrove_door
|id=-493
|form=block
|itemform=item.mangrove_door
|translationkey=-}}
{{ID table
|displayname=Cherry Door
|spritetype=block
|nameid=cherry_door
|id=-531
|itemtags=minecraft:door
|translationkey=item.cherry_door.name}}
{{ID table
|displayname=Bamboo Door
|spritetype=block
|nameid=bamboo_door
|id=-517
|itemtags=minecraft:door
|translationkey=item.bamboo_door.name}}
{{ID table
|spritename=crimson-door
|displayname=Crimson block
|spritetype=block
|nameid=crimson_door
|id=499
|form=block
|itemform=item.crimson_door}}
{{ID table
|spritename=warped-door
|displayname=Warped block
|spritetype=block
|nameid=warped_door
|id=500
|form=block
|itemform=item.warped_door}}
{{ID table
|spritename=iron-door
|displayname=Iron item
|spritetype=item
|nameid=iron_door
|id=372
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=oak-door
|displayname=Oak item
|spritetype=item
|nameid=wooden_door
|id=359
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=spruce-door
|displayname=Spruce item
|spritetype=item
|nameid=spruce_door
|id=553
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=birch-door
|displayname=Birch item
|spritetype=item
|nameid=birch_door
|id=554
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=jungle-door
|displayname=Jungle item
|spritetype=item
|nameid=jungle_door
|id=555
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=acacia-door
|displayname=Acacia item
|spritetype=item
|nameid=acacia_door
|id=556
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=dark-oak-door
|displayname=Dark Oak item
|spritetype=item
|nameid=dark_oak_door
|id=557
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=mangrove-door
|displayname=Mangrove item
|spritetype=item
|nameid=mangrove_door
|id=641
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=crimson-door
|displayname=Crimson item
|spritetype=item
|nameid=crimson_door
|id=616
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=warped-door
|displayname=Warped item
|spritetype=item
|nameid=warped_door
|id=617
|form=item
|itemtags=minecraft:door
|foot=1}}

=== Block states ===
{{see also|Block states}}

{{/BS}}

== Video ==
Note: The videos do not mention or state Crimson, Warped, Bamboo, or Cherry doors, since the videos were uploaded before 1.16.
<div style="text-align:center">
<span style="display:inline-block">{{yt|7jlIQcbHFts}}</span>
<span style="display:inline-block">{{yt|CC6ujEdvzQY}}</span>
</div>

== History ==
''For a history of changes to textures and models for each block state, see [[/Asset history]]''
{{History||3 June 2010|link=https://notch.tumblr.com/post/659506746/asynchronous-saving-and-loading-and-slightly-more|Notch states plans to implement doors.}}
{{History|java infdev}}{{History||20100607|[[File:Oak Door JE1.png|32px]] [[File:Oak Door (Right) JE1.png|32px]] [[File:Oak Door (item) JE1.png|32px]] Added wooden doors.}}
{{History||20100608|Doors have been given smarter rotation logic.}}
{{History||20100611|[[File:Oak Door JE2.png|32px]] [[File:Oak Door (Right) JE2.png|32px]] The models of doors have been changed to use door bottom half texture on sides instead of the wooden [[planks]] texture.}}
{{History||20100618|[[File:Oak Door JE3 BE1.png|32px]] [[File:Oak Door (Right) JE3.png|32px]] The textures of doors have been changed.}}
{{History||20100624|[[File:Oak Door (Right) JE4 BE1.png|32px]] The model of door with right hinge has been changed to mirror and use textures of door with left hinge.}}
{{History|java alpha}}
{{History||v1.0.1|[[File:Iron Door JE1 BE1.png|32px]] [[File:Iron Door (Right) JE1 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added iron doors.
|[[File:Oak Door (item) JE2 BE1.png|32px]] The texture of wooden doors in [[item]] form has been changed.
|Doors can now be controlled by redstone power.}}
{{History|java beta}}
{{History||1.7|Punching the back face of a left-hinge oak or iron door or the front face of a right-hinge door, as well as destroying a door, would [[Java Edition placeholder texture uses|create]] particles using the [[Placeholder texture#Texture atlas blank spaces|block placeholder texture]].}}
{{History||1.7.3|Doors no longer produce placeholder texture particles.}}
{{History||1.8|snap=Pre-release|Doors now occur naturally in [[village]]s and [[stronghold]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 6|Wooden doors are now broken faster using an [[axe]].
|Iron doors are broken much faster using a [[pickaxe]], and the [[mining]] speed is now [[tier]] dependent.}}
{{History|||snap=RC1|The opening and closing [[sound]]s for doors have been changed.}}
{{History||1.1|snap=11w47a|Double doors now open correctly.}}
{{History||1.2.1|snap=12w05b|[[Villager]]s can now open and close doors.}}
{{History|||snap=12w06a|[[File:Oak Door JE4 BE3.png|32px]] [[File:Iron Door JE2 BE5.png|32px]] Changed top model of door.
|[[Zombie]]s can now break wooden doors.
|Doors have been changed to properly detect if they are open or closed. Placing two [[pressure plate]]s directly in front of doors and stepping on them now opens them correctly.}}
{{History|||snap=12w07a|Zombies can no longer break iron doors.}}
{{History||1.4.2|snap=12w40a|Wooden doors can no longer be opened by attacking (left-click).}}
{{History||1.8|snap=December 13, 2013|slink=https://twitter.com/jeb_/status/411425952338808832|[[Jens Bergensten|Jeb]] tweeted an image showing that the crafting recipes for doors are changed so that 3 doors are crafted at once. Doors are also stackable to 64.}}
{{History|||snap=14w02a|Doors are now stackable to 64.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.}}
{{History|||snap=14w10a|[[File:Oak Door JE5.png|32px]] [[File:Iron Door JE3.png|32px]] The models of doors have been changed.}}
{{History|||snap=August 8, 2014|slink=https://twitter.com/TheMogMiner/status/497751889102905344|[[Ryan Holtz|TheMogMiner]] tweeted an image showing new types of [[wood]] doors.}}
{{History|||snap=14w32d|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE1.png|32px]] [[File:Acacia Door JE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Spruce Door (item) JE1.png|32px]] [[File:Birch Door (item) JE1.png|32px]] [[File:Jungle Door (item) JE1.png|32px]] [[File:Acacia Door (item) JE1.png|32px]] [[File:Dark Oak Door (item) JE1.png|32px]] New types of wood doors have been added: spruce, birch, jungle, acacia and dark oak.}}
{{History|||snap=14w33a|[[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] The models of jungle and acacia doors no longer have inner faces in the holes in their models.
|[[File:Spruce Door (item) JE2.png|32px]] [[File:Birch Door (item) JE2.png|32px]] [[File:Jungle Door (item) JE2.png|32px]] [[File:Acacia Door (item) JE2.png|32px]] [[File:Dark Oak Door (item) JE2.png|32px]] [[Item]] textures of new doors have been changed to match the dimensions of oak and iron doors.
|The wooden door (''Door'') has been renamed to ''Oak Door''.}}
{{History|||snap=14w33b|[[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]][[File:Iron Door (item) JE2 BE2.png|32px]] All [[item]] textures for all doors have been changed. Doors now have hinges on the left and handles on the right, existing wooden doors & iron doors have a slight item textures change as well.}}
{{History||1.9|snap=15w31a|[[File:Birch Door JE2.png|32px]] [[File:Jungle Door JE3.png|32px]] [[File:Acacia Door JE3.png|32px]] [[File:Dark Oak Door JE2.png|32px]] Shading on the [[block]] textures of birch, jungle, acacia, and dark oak doors have been changed, so that the shadow is in the upper left and the highlight is in the lower right.}}
{{History|||snap=15w43a|Iron doors now have different [[sound]]s than wooden doors.
|Doors now have [[sound]]s for placing and different sounds for opening and closing - see sounds section.}}
{{History|||snap=15w47a|Doors now make [[sound]]s when placed,<ref>{{bug|MC-2844}} – "Doors have no placement sound." resolved as "Fixed"</ref> despite these apparently already being added in 15w43a.}}
{{History|||snap=15w49a|Doors are now placed facing left/right depending on which half of the [[block]] the [[player]] clicks on, unless neighboring doors or solid/opaque blocks cause them to place a certain way.}}
{{History||1.10|snap=16w20a|Acacia and spruce doors now generate in [[savanna]] and [[taiga]] [[villages]].}}
{{History||1.11|snap=16w33a|Wooden doors can now be used to fuel [[furnace]]s.|Iron doors no longer have a right-click action - previously they would result in the hand swinging, and would override other valid right click actions such as snowball throwing.}}
{{History|||snap=16w39a|Dark oak doors and iron doors now generate in [[woodland mansion]]s.}}
{{History||July 19, 2017|link=https://twitter.com/jeb_/status/887599625045250048|[[Jeb]] tweets image of a new jungle [[wood planks]], jungle doors, [[cauldron]], and [[dandelion]] textures.}}
{{History||1.13|snap=17w47a|The oak door ID has been changed from <code>wooden_door</code> to <code>oak_door</code>.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[block]]s' numeral IDs were 64, 71, 193, 194, 195, 196 and 197, and the [[item]]s' 324, 330, 427, 428, 429, 430 and 431.}}
{{History|||snap=18w11a|Doors now generate as part of the newly added [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Oak Door JE6.png|32px]] [[File:Spruce Door JE2.png|32px]] [[File:Birch Door JE3.png|32px]] [[File:Jungle Door JE4.png|32px]] [[File:Acacia Door JE4.png|32px]] [[File:Dark Oak Door JE3.png|32px]] [[File:Iron Door JE4.png|32px]] The textures of all doors have been changed.
|[[Vindicator]]s can now break doors.}}
{{History|||snap=18w47b|[[File:Spruce Door JE3.png|32px]] The textures of spruce doors have been changed.}}
{{History|||snap=18w49a|Added [[snowy tundra]] villages, which generate with spruce doors.}}
{{History|||snap=18w50a|The updated [[desert]] villages now generate with jungle doors instead of oak doors.}}
{{History|||snap=19w08a|[[File:Oak Door JE7.png|32px]] The texture of oak doors has been changed.}}
{{History|||snap=19w12b|Doors can now be placed on glass, ice, glowstone and sea lanterns.}}
{{History|||snap=19w13a|[[Evoker]]s and [[pillager]]s can now open doors during [[raid]]s.}}
{{History|||snap=19w14a|Pillagers can no longer open doors.}}
{{History||1.15|snap=19w39a|Iron doors must now be mined with a [[pickaxe]] for it to be dropped as an [[item]].}}
{{History||1.16|snap=20w06a|[[File:Crimson Door JE1.png|32px]] [[File:Warped Door JE1.png|32px]] [[File:Crimson Door (item) JE1 BE1.png|32px]] [[File:Warped Door (item) JE1 BE1.png|32px]] Added crimson and warped doors.}}
{{History|||snap=20w07a|Added [[piglin]]s, which can open and close doors.}}
{{History|||snap=20w19a|[[File:Crimson Door JE2.png|32px]] [[File:Warped Door JE2.png|32px]] [[File:Crimson Door (item) JE2 BE2.png|32px]] [[File:Warped Door (item) JE2 BE2.png|32px]] The textures of crimson and warped doors have been changed.}}
{{History||1.17|snap=21w11a|[[File:Jungle Door (item) JE4 BE2.png|32px]] Changed the texture of the jungle door item.}}
{{History||1.18|snap=21w41a|[[File:Oak Door (item) JE4 BE3.png|32px]] [[File:Spruce Door (item) JE4 BE2.png|32px]] [[File:Birch Door (item) JE4 BE2.png|32px]] [[File:Jungle Door (item) JE5 BE3.png|32px]] [[File:Acacia Door (item) JE4 BE2.png|32px]] [[File:Dark Oak Door (item) JE4 BE2.png|32px]][[File:Iron Door (item) JE3 BE3.png|32px]] All [[item]] textures for all doors except crimson and warped have been changed.}}
{{History|||snap=Pre-release 5|[[File:Oak Door JE8.png|32px]] [[File:Spruce Door JE4.png|32px]] [[File:Birch Door JE4.png|32px]] [[File:Jungle Door JE5.png|32px]] [[File:Acacia Door JE5.png|32px]] [[File:Dark Oak Door JE4.png|32px]] [[File:Crimson Door JE3.png|32px]] [[File:Warped Door JE3.png|32px]] [[File:Iron Door JE5.png|32px]] Changed top and bottom models of door. Changed oak and iron doors textures.}}
{{History||1.19|snap=22w11a|[[File:Mangrove Door JE1.png|32px]][[File:Mangrove Door (item) JE1 BE1.png|32px]] Added mangrove door.}}
{{History|||snap=22w14a|Due to the addition of the [[mangrove tree]] and [[mangrove swamp]], mangrove doors are now obtainable and renewable.}}
{{History||October 15, 2022|link={{ytl|https://youtu.be/iM9KtHaDcUg?t=5659}}|[[File:Bamboo Door JE1.png|32px]] Bamboo doors were shown on [[Minecraft Live 2022]].}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|[[File:Bamboo Door JE1.png|32px]] [[File:Bamboo Door (item) JE1 BE1.png|32px]] Added bamboo doors behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Cherry Door JE1.png|32px]] [[File:Cherry Door (item) JE1.png|32px]] Added cherry doors behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History|||snap=1.19.4-pre2|[[File:Cherry Door JE2.png|32px]] [[File:Cherry Door (item) JE2.png|32px]] Changed the texture of cherry doors.}}
{{History||1.20|snap=23w12a|Bamboo and cherry doors are now available without using the "Update 1.20" experimental datapack.}}

{{History|pocket alpha}}
{{History||v0.1.0|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] Added doors.
[[File:Oak Door (bottom texture) JE2 BE1.png|32px]] [[File:Iron Door (bottom texture) JE1 BE1.png|32px]] These are the textures defined for the door blocks in <samp>[[gui_blocks.png]]</samp>. The door items exist, but due to a bug in the code that renders items in the hotbar, they cannot be used.}}
{{History||v0.1.3|[[File:Oak Door BE2.png|32px]] [[File:Iron Door BE2.png|32px]] The models of doors have been changed to not display transparency on upper half.}}
{{History||v0.2.0|[[File:Oak Door (item) JE2 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added door inventory icons.
|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] The models of doors have been changed to display transparency on upper half.
|Wooden doors are now available in the inventory, including in [[Creative]].}}
{{History||v0.2.1 alpha2|link=Pocket Edition v0.2.1 alpha2|[[File:Iron Door BE3.png|32px]] The textures of iron doors have been changed.}}
{{History||v0.3.0|A crafting recipe for wooden doors has been added.
|Survival players no longer start out with an infinite stack of wooden doors in the inventory.}}
{{History||v0.3.2|Wooden doors now drop their item form when broken.}}
{{History||v0.5.0|[[File:Oak Door JE4 BE3.png|32px]] [[File:Iron Door BE4.png|32px]] The models of doors have been changed.
|Wooden doors can now be obtained after activating the [[nether reactor]].}}
{{History||v0.8.0|snap=build 2|[[File:Iron Door JE2 BE5.png|32px]] The textures of iron doors have been changed to before v0.2.1 alpha2.}}
{{History||v0.11.0|snap=build 1|''Door'' has been now renamed to ''Oak Door''.}}
{{History||v0.12.1|snap=build 1|Doors are now stackable to 64.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.
|[[Zombie]]s can now break down wooden doors.
|Oak doors can now be opened by [[villager]]s.
|Oak doors are no longer available from the [[nether reactor]].}}
{{History||v0.13.0|snap=build 1|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] Added spruce, birch, jungle, acacia and dark oak doors.
|Iron doors are now available in the [[Creative]] [[inventory]].
|A [[crafting]] recipe for iron doors has been added.
|Redstone mechanics added, making iron doors able to function normally.}}
{{History|||snap=build 2|Spruce, birch, jungle, acacia, and dark oak doors can now be opened by [[villager]]s.}}
{{History|||snap=build 4|[[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Iron Door (item) JE2 BE2.png|32px]] The [[item]] textures of oak and iron door has been changed.}}
{{History||v0.15.0|snap=build 1|Acacia doors now generate in [[savanna]] [[village]]s.
|Spruce doors now generate in [[taiga]] and [[snowy tundra]] villages.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Dark oak doors and iron doors now generate in [[woodland mansion]]s.
|Doors now have [[sound]]s when placed.<ref>{{bug|MCPE-10079}} – "Doors don't have a placement sound" resolved as "Fixed"</ref>}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Various wooden doors now generate in [[shipwreck]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Oak Door BE4.png|32px]] [[File:Spruce Door BE2.png|32px]] [[File:Birch Door BE2.png|32px]] [[File:Jungle Door BE2.png|32px]] [[File:Acacia Door BE2.png|32px]] [[File:Dark Oak Door BE2.png|32px]] [[File:Iron Door BE6.png|32px]] The textures of all doors have been changed.
|Jungle doors now generate in the new [[desert]] [[village]]s.
|Added [[wandering trader]]s, which can open and close wooden doors.}}
{{History||1.11.0|snap=beta 1.11.0.7|[[Vindicator]]s can now break doors during [[raid]]s.}}
{{History||1.16.0|snap=beta 1.15.0.51|Zombies can no longer break iron doors.<ref>{{bug|MCPE-43725}}</ref>}}
{{History|||snap=beta 1.16.0.51|[[File:Crimson Door BE1.png|32px]] [[File:Warped Door BE1.png|32px]] [[File:Crimson Door (item) JE1 BE1.png|32px]] [[File:Warped Door (item) JE1 BE1.png|32px]] Added crimson and warped doors.
|Added [[piglin]]s, which can open and close doors.}}
{{History|||snap=beta 1.16.0.63|[[File:Crimson Door BE2.png|32px]] [[File:Warped Door BE2.png|32px]] [[File:Crimson Door (item) JE2 BE2.png|32px]] [[File:Warped Door (item) JE2 BE2.png|32px]] The textures of crimson and warped doors have been changed.}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Jungle Door (item) JE4 BE2.png|32px]] Changed the texture of the jungle door item.}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Oak Door (item) JE4 BE3.png|32px]] [[File:Spruce Door (item) JE4 BE2.png|32px]] [[File:Birch Door (item) JE4 BE2.png|32px]] [[File:Jungle Door (item) JE5 BE3.png|32px]] [[File:Acacia Door (item) JE4 BE2.png|32px]] [[File:Dark Oak Door (item) JE4 BE2.png|32px]][[File:Iron Door (item) JE3 BE3.png|32px]] All [[item]] textures for all doors except crimson and warped have been changed.}}
{{History||1.19.0|snap=beta 1.19.0.20|[[File:Mangrove Door BE1.png|32px]] [[File:Mangrove Door (item) JE1 BE1.png|32px]] Added mangrove doors.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|[[File:Bamboo Door BE1.png|32px]] [[File:Bamboo Door (item) JE1 BE1.png|32px]] Added bamboo doors behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.
|The doors now use the same opening and closing [[sound]] effects as ''[[Java Edition]]''.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|[[File:Cherry Door JE2.png|32px]] [[File:Cherry Door (item) JE2.png|32px]] Added cherry doors behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.}}
{{History||1.20.0|snap=beta 1.20.0.21|Bamboo and cherry doors are now available without using the "Next Major Update" experimental toggle.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] [[File:Oak Door (item) JE2 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added doors.}}
{{History||xbox=TU5|Doors can be found in the Redstone & Transportation tab in the [[Creative inventory]].}}
{{History||xbox=TU14|ps=1.04|Doors being broken by [[zombie]]s now show [[damage]].
|Moved doors to the Building Blocks tab in the Creative inventory.}}
{{History||xbox=TU25|xbone=CU14|ps=1.17|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] Added spruce, birch, and jungle door variants.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.
|The original wooden door (''Door'') has been renamed to ''Oak Door''.}}
{{History||xbox=TU27|xbone=CU15|ps=1.18|[[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] Acacia and dark oak doors have been added to the [[Creative]] [[inventory]].}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Acacia doors and dark oak doors are now obtainable in [[survival]] mode.}}
{{History||?| [[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Iron Door (item) JE2 BE2.png|32px]] Oak and iron door's inventory textures have been changed to match Java Edition}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Oak Door BE4.png|32px]] [[File:Spruce Door BE2.png|32px]] [[File:Birch Door BE2.png|32px]] [[File:Jungle Door BE2.png|32px]] [[File:Acacia Door BE2.png|32px]] [[File:Dark Oak Door BE2.png|32px]] [[File:Iron Door BE6.png|32px]] The textures of all doors have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Oak Door JE2.png|32px]] [[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Iron Door JE2 BE5.png|32px]] [[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added doors.}}
{{History|foot}}

<gallery>
Beta 1.7 punching oak door.png|From [[Java Edition Beta 1.7]] to Beta 1.7.2, doors produced [[placeholder texture]] particles when broken or punched on some sides.
</gallery>

Historical sounds:
{| class="wikitable"
! Sound
! From
! to
! Pitch
|-
| {{sound||Door closing old.ogg|Door opening old.ogg}}
| ?
| Sound Update
| ?
|-
| {{sound||Door open.ogg|Door close.ogg}}
| Sound Update
| 15w43a
| ?
|}

=== Door "items" ===
{{:Technical blocks/Doors}}

== Issues ==
{{Issue list}}

== Trivia ==

* Door models have an extra hinge on the opposite side of the actual functional hinge.<ref>{{bug|MC-106697|||WAI}}</ref>

== Gallery ==
<gallery>
Oak Door.png|Oak Door
Spruce Door.png|Spruce Door
Birch Door.png|Birch Door
Jungle Door.png|Jungle Door
Acacia Door.png|Acacia Door
Dark Oak Door.png|Dark Oak Door
Mangrove Door.png|Mangrove Door
Cherry Door.png|Cherry Door
Bamboo Door.png|Bamboo Door
Crimson Door.png|Crimson Door
Warped Door.png|Warped Door
Iron Door.png|Iron Door
Oak Door (item) JE4 BE3.png|Oak Door (item)
Spruce Door (item) JE4 BE2.png|Spruce Door (item)
Birch Door (item) JE4 BE2.png|Birch Door (item)
Jungle Door (item) JE5 BE3.png|Jungle Door (item)
Acacia Door (item) JE4 BE2.png|Acacia Door (item)
Dark Oak Door (item) JE4 BE2.png|Dark Oak Door (item)
Mangrove Door (item) JE1 BE1.png|Mangrove Door (item)
Cherry Door (item) JE2.png|Cherry Door (item)
Bamboo Door (item) JE1 BE1.png|Bamboo Door (item)
Crimson Door (item) JE2 BE2.png|Crimson Door (item)
Warped Door (item) JE2 BE2.png|Warped Door (item)
Iron Door (item) JE3 BE3.png|Iron Door (item)
</gallery>

=== Screenshots ===
<gallery>
Iron Door in Stronghold.png|Naturally occurring iron door in a [[stronghold]].
Wooden Doors 1.8.png|First picture of brand-new 1.8 variants of doors.
Door Creeper.png|A creeper behind some dark oak doors.
Doortypes.png|All types of doors with their respective trapdoors.
FloatingDoorArrows.jpg|Arrows shot into a door that was opened, causing a floating bug.
Jeb Crafting Doors.png|First image of three doors being crafted at once.
Jappa Closet.jpg|A closet made from oak doors.
</gallery>

=== Concept Art ===
<gallery>
Bamboo Wood and Door Concept Art.png|Bamboo door concept art.
Bamboo Door Prototype Textures.png|Bamboo door prototype textures.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--door Taking Inventory: Door] – Minecraft.net on September 29, 2022

{{Redstone}}
{{Blocks|Utility}}
{{Items}}

[[Category:Manufactured blocks]]
[[Category:Generated structure blocks]]
[[Category:Utility blocks]]
[[Category:Mechanics]]
[[Category:Redstone mechanics]]
[[Category:Mechanisms]]

[[cs:Dveře]]
[[de:Tür]]
[[el:Door]]
[[es:Puerta]]
[[fr:Porte]]
[[hu:Ajtók]]
[[it:Porta]]
[[ja:ドア]]
[[ko:문]]
[[nl:Deur]]
[[pl:Drzwi]]
[[pt:Porta]]
[[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>
22w11aThe structure system was rewritten.
Renamed "configured structure feature" to "structure".
Moved worldgen/configured_structure_feature to worldgen/structure folder.
22w12aAdded max_distance_from_center field to jigsaw structure.
22w13aAdded rottable_blocks field into minecraft:block_rot processor.
Now the integrity field in minecraft:block_rot processor becomes a required field, and now it must be between 0.0 and 1.0 (inclusive).
Replaced the  adapt_noise feild in configured structure feature with  terrain_adaptation field. Before, it is an optional boolean value that defaults to false.
All fields except type of jigsaw structure are now wrapped in a value field.
22w14aReverted the change on jigsaw structure from last snapshot.
Now the rottable_blocks field in minecraft:block_rot processor also accepts a block ID or a list of block IDs, and the block tag now needs to be prefixed with a #.
22w17aAdded  start_jigsaw_name field in minecraft:jigsaw config type of configured structure feature.
1.19.3
{{Extension DPL}}<ul><li>[[Chorus Fruit|Chorus Fruit]]<br/>{{about|the fruit that drops from [[chorus tree]]s|the building material|Popped Chorus Fruit|other uses|Chorus}}
{{Item
| title = Chorus Fruit
| image = Chorus Fruit.png
| renewable = Yes
| heals = {{hunger|4}}
| stackable = Yes (64)
}}

'''Chorus fruit''' is a [[food]] [[item]] native to [[the End]] that can be eaten, or [[smelting|smelted]] into [[Popped Chorus Fruit|popped chorus fruit]]. It can be eaten even when the hunger bar is full, and eating it may teleport the [[player]] up to 8 blocks in any direction.

== Obtaining ==
{{see also|Tutorials/Chorus fruit farming}}

Chorus fruit can be obtained by breaking [[Chorus Plant (block)|chorus plant blocks]]. Each block of chorus plant has a 50% chance to drop a chorus fruit. This is not affected by [[Fortune]].<ref>{{bug|MC-198924||Chorus Fruit doesn't have a higher chance with Fortune|Invalid}}</ref>

== Usage ==
To eat chorus fruit, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|4}} [[hunger]] and 2.4 hunger [[Hunger#Mechanics|saturation]].

Unlike most foods, chorus fruits can be eaten when the player has a full hunger bar.

The player may also be [[teleportation|teleported]]: up to 16 attempts are made to choose a random destination within ±8 on all three axes in the same manner as [[Enderman#Teleportation|enderman teleportation]], with the exception that the player may teleport into an area only 2 blocks high, or one block tall if the player is crawling. The player does not land in the average centroid of the block, but rather to any position within an 8-block range. The player will be teleported directly down to the ground regardless of the height it was used at if the player is too far from a valid destination.

The chorus fruit, unlike an [[Ender Pearl|ender pearl]], can teleport the player through [[solid block]]s. The algorithm tries to avoid [[fluid]]s; the player cannot teleport into a space occupied by [[water]] or [[lava]]. However, the player can be teleported onto dangerous blocks such as fire, cacti and magma blocks.<ref>{{bug|MC-102836||Enderman and chorus fruit can teleport to some dangerous places}}</ref>

If a teleport succeeds, a sound similar to an enderman teleporting plays originating from the teleportation origin location. Chorus fruit has a cooldown of 1 second before being able to be used again. The cooldown is represented by a white overlay on the chorus fruit in the hotbar. The cooldown is applied to all chorus fruits items, including those in the player's inventory and containers.<ref>{{bug|MC-88236|||WAI}}</ref>

Eating chorus fruit may teleport the player into areas protected by [[bedrock]], [[barrier|barrier blocks]], or other blocks that are otherwise unbreakable in [[Survival]] mode. However, it cannot teleport the player onto [[the Nether]] roof.<ref>{{bug|MC-84198|||Fixed}}</ref>

Chorus fruit is completely non-functional above the nether roof.

[[Fox]]es can also eat chorus fruit and the teleportation effect works the same as with players.

=== Smelting ingredient ===

{{smelting
|Chorus Fruit
|Popped Chorus Fruit
|0.1}}

== Sounds ==
===Generic===
{{Sound table/Entity/Food}}
===Unique===
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Teleport1.ogg
|sound2=Teleport2.ogg
|subtitle=Player teleports
|source=player
|description=When a player teleports by eating a chorus fruit
|id=item.chorus_fruit.teleport
|translationkey=subtitles.item.chorus_fruit.teleport
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Fox teleports
|source=Players & Friendly Creatures<wbr><ref group=sound>{{Bug|MC-257516||"Fox teleports" sound plays for both Players and Friendly Creatures sound categories}}</ref>|overridesource=1
|description=When a fox teleports by eating a chorus fruit
|id=entity.fox.teleport
|translationkey=subtitles.entity.fox.teleport
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Teleport1.ogg
|sound2=Teleport2.ogg
|source=hostile
|description=When something teleports by eating a chorus fruit
|id=mob.shulker.teleport
|volume=1.0
|pitch=1.0
|foot=1}}

==Data values ==

===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Chorus Fruit
|spritetype=item
|nameid=chorus_fruit
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Chorus Fruit
|spritetype=item
|nameid=chorus_fruit
|id=558
|form=item
|foot=1}}

==Advancements==
{{load advancements|Husbandry;A Balanced Diet}}

==History==
{{History|java}}
{{History||1.9|snap=15w31a|[[File:Chorus Fruit JE1 BE1.png|32px]] Added chorus fruit.}}
{{History|||snap=15w34c|A cooldown for using chorus fruit has now been added.}}
{{History|||snap=15w37a|The chorus fruit's teleportation range has now been reduced from ±32 to ±8.}}
{{History|||snap=15w50a|Added a [[sound]] for chorus fruit: <code>item.chorus_fruit.teleport</code>.}}
{{History||1.10|snap=16w21a|Chorus fruit can now teleport riders off their mounts.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 432.}}
{{History||1.14|snap=18w43a|[[File:Chorus Fruit JE2 BE2.png|32px]] The texture of chorus fruit has now been changed.}}
{{History||1.20.2|snap=23w33a|Eating chorus fruit now resets fall distance.<ref>{{bug|MC-112133||Eating chorus fruit does not reset fall distance|Fixed}}</ref>}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Chorus Fruit JE1 BE1.png|32px]] Added chorus fruit.}}
{{History|||snap=alpha 1.0.0.1|The cooldown of chorus fruit now has an animation.}}
{{History|bedrock}}
{{History||1.7.0|snap=beta 1.7.0.2|The category that chorus fruit are apart of in the [[Creative inventory]] has been changed from "Nature" to "Items".}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Chorus Fruit JE2 BE2.png|32px]] The texture of chorus fruit has now been changed.}}
{{History||1.13.0|snap=beta 1.13.0.15|Chorus fruit has been moved back to the "Nature" section in the Creative inventory.}}

{{History|console}}
{{History||xbox=TU46|xbone=CU36|switch=1.0.1|ps=1.38|wiiu=Patch 15|[[File:Chorus Fruit JE1 BE1.png|32px]] Added chorus fruit.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Chorus Fruit JE2 BE2.png|32px]] The texture of chorus fruit has now been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Chorus Fruit JE1 BE1.png|32px]] Added chorus fruit.}}
{{History|foot}}

==Issues==
{{issue list}}

==References==
{{reflist}}

==External Links==
*[https://www.minecraft.net/en-us/article/taking-inventory--chorus-fruit Taking Inventory: Chorus Fruit] – Minecraft.net on November 5, 2020

{{Items}}

[[Category:Plants]]
[[Category:Food]]
[[Category:Renewable resources]]

[[de:Chorusfrucht]]
[[es:Fruta chorus]]
[[fr:Chorus]]
[[ja:コーラスフルーツ]]
[[ko:후렴과]]
[[nl:Chorusfruit]]
[[pl:Owoc refrenusu]]
[[pt:Fruta do coro]]
[[ru:Плод коруса]]
[[uk:Фрукт хорусу]]
[[zh:紫颂果]]</li><li>[[Raw Gold|Raw Gold]]<br/>{{Item
| image = Raw Gold.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw gold''' is a raw metal resource obtained from mining [[gold ore]].

== Obtaining ==
=== Mining ===
[[Gold ore]] and [[deepslate gold ore]] mined with an [[iron pickaxe]] or higher drops 1 unit of raw gold. If the pickaxe is enchanted with [[Fortune]], it can drop an extra unit per level of Fortune, allowing for a maximum of 4 with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops the ore block instead.

=== Crafting ===
{{Crafting
|showname=1
|Block of Raw Gold
|Output=Raw Gold,9
|type=Material
|foot=1
}}

== Usage ==
The primary usage of raw gold is smelting it into [[gold ingot]]s.

=== Crafting ===
{{crafting usage|Raw Gold}}

=== Smelting ingredient ===
{{Smelting
|showname=2
|Raw Gold
|Gold Ingot
|1.0
}}

=== Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to raw gold. They run toward any raw gold on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory.

== Advancements ==
{{load advancements|Oh Shiny}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|itemtags=piglin_loved
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|form=item
|id=506
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=21w14a|[[File:Raw Gold JE1.png|32px]] Added raw gold.}}
{{History|||snap=April 13, 2021|slink={{Tweet|JasperBoerstra|1381991999952277513}}|[[File:Raw Gold JE2.png|32px]] [[JAPPA]] shows a new raw gold texture.}}
{{History|||snap=21w15a|[[File:Raw Gold JE2.png|32px]] The texture of raw gold has been changed.
|Raw gold can now be used to craft [[block of raw gold]].}}
{{History|||snap=April 16, 2021|slink={{Tweet|JasperBoerstra|1383047666037325829}}|[[File:Raw Gold (pre-release).png|32px]] [[JAPPA]] shows a new raw gold texture again.}}
{{History|||snap=21w16a|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}

{{History|Bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Raw Gold JE2.png|32px]] Added raw gold.}}
{{History|||snap=beta 1.17.0.52|Raw gold are now available without enabling [[experimental gameplay]].}}
{{History|||snap=beta 1.17.0.54|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}
{{History|foot}}

== Issues ==
{{Issue list}}

==Gallery==
<gallery>
JE 1.17 Dev Raw Metals.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 1.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 2.png|Jappa shows raw ore textures.
Jappa Raw Ores 3.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 4.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 5.jpg|Jappa shows raw ore textures.
</gallery>

{{Items}}

[[Category:Non-renewable resources]]

[[de:Rohgold]]
[[es:Oro en bruto]]
[[fr:Or brut]]
[[ja:金の原石]]
[[pl:Surowe złoto]]
[[pt:Ouro bruto]]
[[ru:Необработанное золото]]
[[uk:Необроблене золото]]
[[zh:粗金]]</li></ul>
22w44aRemoved the  name field in structure pool. Before, this field was a required field, but had no effect.
1.19.4
{{Extension DPL}}<ul><li>[[Potion|Potion]]<br/>{{about|the drinkable potions|the throwable potions|Splash Potion|the throwable potions that leave a lingering area of effect|Lingering Potion}}
{{Redirect|Potion of Water Breathing|the potion in Minecraft Dungeons|MCD:Potion of Water Breathing}}{{About|the mechanics of potions|instructions on how to brew potions, and their recipes|Brewing}}{{update|The texture for ''[[Bedrock Edition]]'' is different, please add it.

Some potions texture/color was changed as of 1.19.4 pre-release 3, please add them.}}
{{Item
| image = Water Bottle.png
| extratext = View [[#Potions|all potions]]
| renewable = '''Uncraftable, Luck{{only|je|short=y}}, Decay{{only|be|short=y}}''': No<br>'''All others''': Yes
| stackable = BE: No<br/>JE: No{{until|Java Combat Tests}}<br>Yes (16){{upcoming|Java Combat Tests}}
}}'''Potions''' are bottled substances designed to inflict [[effects]]. They are created by [[brewing]] and when drunk give the player an [[effect]] for a limited time. All potions are brewed from a '''water bottle''', which is considered a type of potion but has no effects.

== Obtaining ==

=== Mob loot ===

==== Witches ====

[[Witch]]es can drop potions of Healing, Fire Resistance, Swiftness, or Water Breathing if they die while drinking that potion.

==== Wandering traders ====

[[Wandering trader]]s have a chance to drop a Potion of Invisibility if they die while drinking the potion.

=== Fishing ===
[[Water bottle]]s can be [[fishing|fished]] up as junk items.

=== Brewing ===
{{main|Brewing}}

Almost all potions are obtained by [[brewing]].

The Potion of Luck{{only|java|short=1}} and the Potion of Decay{{only|bedrock|short=1}} cannot be brewed. A command to give a Luck Potion is {{cmd|give @s minecraft:potion{Potion:luck} }}, while a Potion of Decay can be obtained via {{cmd|give @s potion 1 36}}. Both are also available in the [[creative inventory]].

=== Chest loot ===

Two Health II potions can be found in the brewing stand on ships in [[end cities]], and one splash potion of Weakness can be found in a brewing stand in [[igloo]] basements.

{{In|Bedrock}}, the cauldron in a [[swamp hut]] contains a random potion.
{{LootChestItem|potion-of-regeneration,potion-of-water-breathing,potion-of-healing}}

=== Bartering ===
[[Piglin]]s may [[barter]] a potion or a splash potion of Fire Resistance when given a [[gold ingot]].

== Usage ==

Potions are used by pressing and holding {{control|use}} with the potion bottle in hand, as with all consumable items. When drunk they bestow the corresponding [[status effect]] to the player.

Drinking a potion while already under the effects of the same potion does not add onto the effect's duration, but simply resets it. A potion effect does not "downgrade" if a lower level is activated. For example, if a [[player]] has [[Regeneration]] II, drinking a regular potion of Regeneration does not have any effect.

Using a potion on a cauldron does not transfer the potion to the cauldron, but begins to play the drinking animation.{{only|java|short=1}}

=== Modifiers ===
{{main|Brewing}}

Potions can be modified in five ways. 
# Brewing [[glowstone dust]] into certain potions will ''enhance'' their level of effect. 
# Adding [[redstone]] will ''extend'' the duration of the effect.
# Brewing [[gunpowder]] into a potion makes it into a ''splash'' potion (area effect).
# Adding [[dragon's breath]] to a splash potion creates a [[lingering potion]] (area effect that lingers on the ground).
# Brewing a [[fermented spider eye]] into specific potions modifies their effect, usually inverting it, which is referred to as "corruption". 

The modifications of Enhancement and Extension are mutually exclusive. 

Enhancing most potions trades some of its duration for a bigger effect. For example, the base Regeneration works for 44 seconds whereas Regeneration II lasts for only 22 seconds but heals more per tick during that time. 

Extending a potion generally makes it last {{frac|8|3}} as long as its base potion, so a duration of 3 minutes becomes 8 minutes. 
==== Corruption ====
The usual result of corruption is to invert the potion's effect (for example Swiftness becomes Slowness). Interestingly, corrupting Poison (continuous damage effect) creates a Potion of Harming, an instant damage effect, instead of the continuous healing effect (regeneration) one would normally expect. Corrupting a Potion of Night Vision turns it into a Potion of Invisibility rather than an inverse effect that might be something like blindness.

Corrupting an extended or enhanced potion results in a corrupted potion with the same modifier, if it is supported by the corrupted effect. All of the "corrupted" potions except Harming can be extended, but it is the only one that can be enhanced. {{IN|bedrock}}, the corruption of Healing II or Poison II potions results in a potion of Harming I.

=== Base potions ===

Base potions are potions that have no effect when the player drinks them, but are necessary as the basis for other potions.

{| class="wikitable col-1-center col3-left" data-description="Base potions"
! Icon
! Name
! Use
|-
| {{Slot|Water Bottle|link=none}}
! Water Bottle
| the base for the Awkward Potion and Potions of Weakness
|-
| rowspan="3"| {{Slot|Water Bottle|link=none}}
! Awkward Potion
| The base for all other effect potions
|-
! Mundane Potion
| Only usable as an alternative base for  Potion of Weakness{{only|bedrock}}
|-
! Thick Potion
| No use
|}

=== Effect potions ===

==== Potions with positive effects ====

{| class="wikitable col-1-center" data-description="Positive potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of Regeneration|link=none}}
! {{text anchor|Potion of Regeneration}}
| 0:45
| rowspan="3" | {{EffectLink|Regeneration}}
| Restores {{hp|18}} health over time, {{hp|1}} every 50 [[tick]]s (2.5 seconds).
|-
! Potion of Regeneration +
| 1:30{{only|java|short=1}}<br>2:00{{only|bedrock|short=1}}
| Restores {{hp|36}}{{only|java|short=1}} or {{hp|48}}{{only|bedrock|short=1}} health over time, {{hp|1}} every 50 ticks (2.5 seconds).
|-
! Potion of Regeneration II
| 0:22.5
| Restores {{hp|18}} health over time, {{hp|1}} every 25 ticks (1.25 seconds).
|-
| rowspan="3" | {{Slot|Potion of Swiftness|link=none}}
! {{text anchor|Potion of Swiftness}}
| 3:00
| rowspan="3" | {{EffectLink|Speed}}
| rowspan="2" | Increases speed and jump distance by 20% and increases FOV (6.6 meters per second sprinting).
|-
! Potion of Swiftness +
| 8:00
|-
! Potion of Swiftness II
| 1:30
| Increases speed and jump distance by 40% and increases FOV (8 meters per second sprinting).
|-
| rowspan="2" | {{Slot|Potion of Fire Resistance|link=none}}
! {{text anchor|Potion of Fire Resistance}}
| 3:00
| rowspan="2" | {{EffectLink|Fire Resistance}}
| rowspan="2" | Gives immunity to all heat-related damage.
|-
! Potion of Fire Resistance +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Healing|link=none}}
! {{text anchor|Potion of Healing}}
| Instant
| rowspan="2" | {{EffectLink|Instant Health}}
| Restores {{hp|4}} health.
|-
! Potion of Healing II
| Instant
| Restores {{hp|8}} health. (doubles with every additional level)
|-
| rowspan="2" | {{Slot|Potion of Night Vision|link=none}}
! {{text anchor|Potion of Night Vision}}
| 3:00
| rowspan="2" | {{EffectLink|Night Vision}}
| rowspan="2" | Visually brightens everything to a light level of 15, brightens up water with a blue shine, brightens up lava with an orange shine (other players cannot see the enhanced lighting without this effect).
|-
! Potion of Night Vision +
| 8:00
|-
| rowspan="3" | {{Slot|Potion of Strength|link=none}}
! {{text anchor|Potion of Strength}}
| 3:00
| rowspan="3" | {{EffectLink|Strength}}
| rowspan="2" | Increases melee damage by {{hp|3}}.{{only|java}}<br>Increases melee damage by 30% of the base damage and {{Hp|1}}.{{only|bedrock}}
|-
! Potion of Strength +
| 8:00
|-
! Potion of Strength II
| 1:30
| Increases melee damage by {{hp|6}} (+ {{hp|3}} per tier).{{only|java}}<br>Increases melee damage by 69% of the base damage and {{Hp|1.3}}. 
For each level: (<math>BaseDamage\times1.3^{level}+{1.3^{level}-1\over0.3}</math>){{only|bedrock}}
|-
| rowspan="3" | {{Slot|Potion of Leaping|link=none}}
! {{text anchor|Potion of Leaping}}
| 3:00
| rowspan="3" | {{EffectLink|Jump Boost}}
| rowspan="2" | Allows the player to jump {{frac|1|2}} blocks higher and reduces fall damage.
|-
!Potion of Leaping +
| 8:00
|-
! Potion of Leaping II
| 1:30
| Further increases jump height to {{frac|2|1|2}} blocks and further reduces fall damage.
|-
| rowspan="2" | {{Slot|Potion of Water Breathing|link=none}}
! style="white-space:nowrap" | {{text anchor|Potion of Water Breathing}}
| 3:00
| rowspan="2" | {{EffectLink|Water Breathing}}
| rowspan="2" | Allows the entity to swim without drowning or needing to surface for air. The oxygen bar does not decrease when underwater.
|-
! Potion of Water Breathing +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Invisibility|link=none}}
! {{text anchor|Potion of Invisibility}}
| 3:00
| rowspan="2" | {{EffectLink|Invisibility}}
| rowspan="2" |
Makes player  disappear from view. Mobs can detect and track the player only at close range, although the range increases when the player wears armor. The splash version make mobs or other players invisible. Some items are unaffected and so remain visible. These include: armor, items held in hand, arrows stuck into the player, a [[pig]]'s saddle, a [[llama]]'s carpet pattern, a [[shulker]]'s yellow head, and the glowing eyes of [[spider]]s, [[Phantom|phantoms]], and [[enderman|endermen]].
|-
! Potion of Invisibility +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Slow Falling|link=none}}
! {{text anchor|Potion of Slow Falling}}
| 1:30
| rowspan="2" | {{EffectLink|Slow Falling}}
| rowspan="2" | The mob/player falls at a much slower rate, and damage from hitting the ground is reduced to zero. A sprinting  leap of almost 6 blocks becomes possible and farmland is not affected by the player falling onto it.
|-
! Potion of Slow Falling +
| 4:00
|-
| {{Slot|Potion of Luck|link=none}}
! {{text anchor|Potion of Luck}}<br>{{only|java|short=1}}{{only|Console|short=1}}
| 5:00
| {{EffectLink|Luck}}
| Increases the luck [[Attribute#Attributes for players|attribute]] by 1 point.
|}

==== Potions with negative effects ====

{| class="wikitable col-1-center" data-description="Negative potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of Poison|link=none}}
! {{text anchor|Potion of Poison}}
| 0:45
| rowspan="3" | {{EffectLink|Poison}}
| Causes up to {{hp|36|poisoned=1}} damage over time at a rate of 1 every 50 ticks, but does not reduce health below {{hp|1}}.
|-
! Potion of Poison +
| 1:30
| Causes up to {{hp|72|poisoned=1}}{{only|java|short=1}} or {{hp|96|poisoned=1}}{{only|bedrock|short=1}} damage over time, but does not reduce health below {{hp|1}}.
|-
! Potion of Poison II
| 0:21.6{{only|java|short=1}}<br>0:22.5{{only|bedrock|short=1}}
| Causes up to {{hp|38|poisoned=1}} damage over time, but does not reduce health below {{hp|1}}.
|-
| rowspan="2" | {{Slot|Potion of Weakness|link=none}}
! {{text anchor|Potion of Weakness}}
| 1:30
| rowspan="2" | {{EffectLink|Weakness}}
| rowspan="2" | Reduces melee damage by {{hp|4}}.{{only|java}}<br>Reduces melee damage by 20% of the base damage and {{hp|0.5}}.{{only|bedrock}}
|-
! Potion of Weakness +
| 4:00
|-
| rowspan="3" | {{Slot|Potion of Slowness|link=none}}
! {{text anchor|Potion of Slowness}}
| 1:30
| rowspan="3" | {{EffectLink|Slowness}}
| rowspan="2" | Slows players and mobs by 15%, to about 4.75 blocks per second sprinting.
|-
! Potion of Slowness +
| 4:00
|-
! Potion of Slowness IV<!--The IV is correct, it is not Slowness II-->
| 0:20
| Slows players and mobs by 60%, to about 2.25 blocks per second sprinting.
|-
| rowspan="2" |{{Slot|Potion of Harming|link=none}}
! {{text anchor|Potion of Harming}}
| Instant
| rowspan="2" | {{EffectLink|Instant Damage}}
| Damages {{hp|6}}.
|-
! Potion of Harming II
| Instant
| Damages {{hp|12}}. (doubles with every additional level)
|-
| {{Slot|Potion of Decay|link=none}}
! Potion of Decay<br>{{only|bedrock|short=1}}{{Anchor|Potion of Decay}}
| 0:40
| {{EffectLink|Wither|link=Wither (status effect)}}
| Damages {{hp|1|withered=1}} every second, making a total of {{hp|40|withered=1}} damage 
|}

==== Potions with mixed effects ====

{| class="wikitable col-1-center col-2-center" data-description="Base potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of the Turtle Master|link=none}}
! {{text anchor|Potion of the Turtle Master}}
| style="text-align:center" | 0:20
| rowspan="3" | {{EffectLink|Slowness}}<br>{{EffectLink|Resistance}}
| rowspan="2" | Slows players and mobs by 60%, to about 2.25 blocks per second sprinting, and reduces their damage taken by 60%.
|-
! Potion of the Turtle Master +<br>
| 0:40
|-
! Potion of the Turtle Master II<br>
| 0:20
| Slows players and mobs by 90%, to about 0.5625 blocks per second sprinting, and reduces their damage taken by 80%.
|}

=== Uncraftable potion ===

{{IN|java}}, the Uncraftable Potion is a potion with no effect that is unobtainable in regular gameplay.

It is also available in splash potion and lingering potion forms, as well as for tipped arrows.

It can be obtained using the following command: {{cmd|give @s minecraft:potion{Potion:"minecraft:empty"} }}. It is also obtained any time a potion has invalid or missing potion effect tags, and thus serves as a placeholder.

{| class="wikitable" style="text-align: center;" data-description="Unused potions"
! Icon
! Name
! Effect
|-
| {{Slot|Uncraftable Potion|link=none}}
! Uncraftable Potion
| No effect
|}

=== Joke potions===

====[[Java Edition 15w14a]]====

{| class="wikitable col-1-center col-2-center" data-description="Base potions"
!Icon
!Name
!Duration
!Effect
! Description 
|-
|{{Slot|Potion of Slowness Revision 1|link=none}}
!{{text anchor|Potion of Caring}}
| style="text-align:center" |Instant
|{{EffectLink|id=Slowness Revision 1|Caring}}
| rowspan="3" |Changes the mob AI to move toward the nearest mob as if it were to attack it.
|-
| rowspan="2" |{{Slot|Potion of Poison Revision 1|link=none}}
!{{text anchor|Potion of Caring}}
| style="text-align:center" |Instant
| rowspan="2" | {{EffectLink|id=Poison Revision 1|Caring}} 
|-
! {{text anchor|Potion of Caring II}}
| style="text-align:center" |Instant
|-
| rowspan="2" |{{Slot|Potion of Weakness Revision 1|link=none}}
!{{text anchor|Potion of Sharing}}
| style="text-align:center" |1:30
| rowspan="2" |{{EffectLink|id=Weakness Revision 1|Sharing}}
| rowspan="2" |Drops items in a random amount of time, ranging from food to rare items like [[saddle]]s or [[diamond]]s.
|-
!{{text anchor|Potion of Sharing +}}
| style="text-align:center" |4:00
|}

==== [[Java Edition 23w13a_or_b]]====

{{Empty section}}

===Undead mobs===

The effects given by Potions of Healing and Harming are opposite on undead mobs, which includes skeletons and zombies. Potions of Healing cause harm, and Harming heals them. In addition, undead mobs are not affected by Poison or Regeneration. 

{{IN|bedrock}}, hitting an undead mob with a Regeneration Potion will always register as Regeneration I, no matter the level of the used potion.

===Mud conversion===

Using a water bottle, splash water bottle, or lingering water bottle on [[dirt]], [[coarse dirt]], or [[rooted dirt]] will convert it into [[mud]], returning a glass bottle with it. This process can be automated with a [[dispenser]]. 

===Filling cauldrons with Potions===

{{IN|Bedrock|Legacy Console}} potion bottles may be used on a cauldron to fill it. Using a glass bottle on a cauldron filled with a potion drains it and fills the bottle. Potions cannot be combined in a cauldron, nor can they be mixed with water, but as an added bonus if you use a stack of arrows in a full cauldron you get a stack of tipped arrows. for 1 layer you get 16, 2 layers 32.

==Custom effects==

{{IN|java}}, potions can also be obtained with any status effect using {{cmd|give}} and the tag <code>CustomPotionEffects</code>, which is an array of effects for the potion. See [[Item format#Potion Effects]] for more information, and [[status effect]] for a list of effects and IDs.

==Sounds==
{{edition|java}}:
{{Sound table
|sound=Drink.ogg
|subtitle=Sipping
|source=player
|description=While a player is drinking a potion
|id=entity.generic.drink
|translationkey=subtitles.entity.generic.drink
|volume=0.5
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Witch drink1.ogg
|sound2=Witch drink2.ogg
|sound3=Witch drink3.ogg
|sound4=Witch drink4.ogg
|subtitle=Witch drinks
|source=hostile
|description=When a witch drinks a potion
|id=entity.witch.drink
|translationkey=subtitles.entity.witch.drink
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Wandering trader drink potion.ogg
|sound2=Drink.ogg
|subtitle=Wandering Trader drinks potion
|source=neutral
|description=While a [[wandering trader]] is drinking a potion to become invisible during nighttime
|id=entity.wandering_trader.drink_potion
|translationkey=subtitles.entity.wandering_trader.drink_potion
|volume=''varies'' <ref group=sound>0.35 for the first sound, 0.325 for the second sound</ref>
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|subtitle=Bottle empties
|source=block
|description=When a water bottle is emptied
|id=item.bottle.empty
|translationkey=subtitles.item.bottle.empty
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bottle fill water1.ogg
|sound2=Bottle fill water2.ogg
|sound3=Bottle fill water3.ogg
|sound4=Bottle fill water4.ogg
|subtitle=Bottle fills
|source=block
|description=When a water bottle is filled
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Drink.ogg
|source=player
|description=When a player drinks a potion
|id=random.drink
|volume=0.35
|pitch=0.9-1.1}}
{{Sound table
|sound=Witch drink1.ogg
|sound2=Witch drink2.ogg
|sound3=Witch drink3.ogg
|sound4=Witch drink4.ogg
|source=hostile
|description=When a witch drinks a potion
|id=mob.witch.drink
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Wandering trader drink potion.ogg
|sound2=Drink.ogg
|source=neutral
|description=When a wandering trader drinks a potion to become invisible during nighttime
|id=mob.wanderingtrader.drink_potion
|volume=''varies'' <ref group=sound>0.7 for the first sound, 0.65 for the second sound</ref>
|pitch=0.8-1.2}}
{{Sound table
|rowspan=4
|sound=Water Splash Old.ogg
|source=block
|description=When a potion is placed in a cauldron<wbr><ref group=sound name=potionsplash>{{Bug|MCPE-174867}}</ref>
|id=cauldron.fillpotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a potion is taken from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takepotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When water from a bottle is placed in a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.fillwater
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When water from a bottle is taken from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takewater
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|source=sound<!--bottle-->
|description=When a water bottle or potion is emptied<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.empty
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bottle fill water1.ogg
|sound2=Bottle fill water2.ogg
|sound3=Bottle fill water3.ogg
|sound4=Bottle fill water4.ogg
|source=sound<!--bottle-->
|description=When a water bottle or potion is filled<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.fill
|volume=1.0
|pitch=1.0
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Potion
|spritetype=item
|nameid=potion
|form=item
|translationkey=item.minecraft.potion,item.minecraft.potion.effect.empty,item.minecraft.potion.effect.water,item.minecraft.potion.effect.mundane,item.minecraft.potion.effect.thick,item.minecraft.potion.effect.awkward,item.minecraft.potion.effect.night_vision,item.minecraft.potion.effect.invisibility,item.minecraft.potion.effect.leaping,item.minecraft.potion.effect.fire_resistance,item.minecraft.potion.effect.swiftness,item.minecraft.potion.effect.slowness,item.minecraft.potion.effect.water_breathing,item.minecraft.potion.effect.healing,item.minecraft.potion.effect.harming,item.minecraft.potion.effect.poison,item.minecraft.potion.effect.regeneration,item.minecraft.potion.effect.strength,item.minecraft.potion.effect.weakness,item.minecraft.potion.effect.levitation,item.minecraft.potion.effect.luck,item.minecraft.potion.effect.turtle_master,item.minecraft.potion.effect.slow_falling
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Potion
|spritetype=item
|nameid=potion
|id=426
|form=item
|translationkey=potion.emptyPotion.name,potion.mundane.name,potion.mundane.extended.name,potion.thick.name,potion.awkward.name,potion.nightVision.name,potion.invisibility.name,potion.jump.name,potion.fireResistance.name,potion.moveSpeed.name,potion.moveSlowdown.name,potion.heal.name,potion.harm.name,potion.poison.name,potion.regeneration.name,potion.damageBoost.name,potion.weakness.name,potion.wither.name,potion.turtleMaster.name,potion.slowFalling.name
|foot=1}}

=== Metadata===
{{IN|bedrock}}, potions use the following item data values to indicate the kind of potion:
{{/DV}}

===Item data===

====Java Edition====

<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Potion}}
</div>
Normal potions use an NBT "Potion" tag to indicate the potion type. The values of the tag (to be prefixed with <code>minecraft:</code>) are:
{| class="wikitable sortable" style="text-align: center;" data-description="Potion NBT data"
!Potion
! Regular
!Level II
!Extended + 
|-
| Uncraftable Potion
|anything except the below
|–
|–
|-
|Water Bottle
|{{code|water}} 
|–
|–
|-
|Mundane Potion
|{{code|mundane}}
|–
|–
|-
| Thick Potion
|{{code|thick}}
|–
|–
|-
|Awkward Potion
|{{code|awkward}}
|–
|–
|-
| Night Vision
|{{code|night_vision}}
|–
|{{code|long_night_vision}}
|-
|Invisibility
|{{code|invisibility}}
|–
|{{code|long_invisibility}}
|-
|Leaping
|{{code|leaping}}
|{{code|strong_leaping}}
|{{code|long_leaping}}
|-
|Fire Resistance
|{{code|fire_resistance}}
|–
|{{code|long_fire_resistance}}
|-
|Swiftness
|{{code|swiftness}}
|{{code|strong_swiftness}}
|{{code|long_swiftness}}
|-
|Slowness
|{{code|slowness}}
|{{code|strong_slowness}}
|{{code|long_slowness}}
|-
|Water Breathing
|{{code|water_breathing}}
|–
|{{code|long_water_breathing}}
|-
| Instant Health
|{{code|healing}}
|{{code|strong_healing}}
|–
|-
| Harming
|{{code|harming}}
|{{code|strong_harming}}
|–
|-
|Poison
|{{code|poison}}
|{{code|strong_poison}}
|{{code|long_poison}}
|-
|Regeneration
|{{code|regeneration}}
|{{code|strong_regeneration}}
| {{code|long_regeneration}}
|-
|Strength
|{{code|strength}} 
| {{code|strong_strength}}
|{{code|long_strength}}
|-
|Weakness
|{{code|weakness}}
|–
|{{code|long_weakness}}
|-
|Luck
|{{code|luck}}
|–
|–
|-
|The Turtle Master
|{{code|turtle_master}}
|{{code|strong_turtle_master}}
|{{code|long_turtle_master}}
|-
| Slow Falling
|{{code|slow_falling}}
|–
|{{code|long_slow_falling}}
|}

====Bedrock Edition====

:See [[Bedrock Edition level format/Item format]].

==Achievements==
{{load achievements|Local Brewery|Taste of your own Medicine}}

==Advancements==
{{Load advancements|Local Brewery;A Furious Cocktail;How Did We Get Here?;Husbandry}}

==History==
{{Info needed section|Potion of Weakness;Uncraftable Potion texture in JE 1.11}}
{{History|java beta}}
{{History||July 7, 2010|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/779956568/the-rationale-for-redstone|[[Brewing|Alchemy]] was first hinted by [[Notch]] when he explained why [[redstone ore]] disintegrates into "[[redstone|dust]]". He states that dust would be used later in potions.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[Jeb]] tweeted a screenshot showing potion durations and [[glass bottle]]s.<ref>{{tweet|jeb|118681103350501376|This will probably ->NOT<- be included in Beta 1.9, but it's a nice screenshot: http://i.imgur.com/oK2tE.png |September 28, 2011}}</ref>
|Potions are [[brewing|brewed]] using [[cauldron]]s<ref>{{tweet|jeb|119466949708222465|Potions are delayed because *add to cauldron, pick up, look at tooltip, pour back into cauldron, repeat* was extremely tedious|September 30, 2011}}</ref> by combining ingredients and other potions in cauldrons. Cauldrons, although they are functional and can be used to brew potions, are unavailable in this update.
|In total, there are 161 possible potion combinations and 2,653 different types of potions.<ref>{{tweet|jeb|120520408792432641|In the prerelease, there are 161 brewable unique potions. Unless we change it, there are 2,653 with all ingredients added.|October 3, 2011}}</ref>
|[[Jeb]] later tweeted that both [[Notch]] and he had come up with a different way to [[brewing|brew]] potions, which was revealed to be [[brewing stand]]s.<ref>{{tweet|jeb|119710836469149697|A quick discussion with @notch led me in on a new way of doing the potion brewing. Cauldron is out...|September 30, 2011}}</ref>}}
{{History|||snap=Beta 1.9 Prerelease 3|[[Brewing stand]]s have been implemented, which has replaced the (previously unimplemented) [[cauldron]]s' [[brewing]] functionality, so potions are now obtainable without mods. Potions Brewed in the previous version will now be glitched. Water Bottles have been added.}}
{{History||1.3.1|snap=12w21b|[[File:Water Bottle JE1 BE1.png|32px]] Water bottles have been added to the [[Creative inventory]].}}
{{History||1.3.1|snap=12w22a|[[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Potions have been added to the [[Creative]] [[inventory]]. This includes extended-enhanced potions with both extended duration and enhanced effect for four potion effects.}}
{{History||1.4.2|snap=12w32a|[[File:Potion of Night Vision JE1 BE1.png|32px]] Added potion of [[Night Vision]]. However, it is [[brewing|unbrewable]] at the time.}}
{{History|||snap=12w38a|Added Healing and Harming potions to the Creative inventory.}}
{{History||1.5|snap=?|Extended-enhanced potions are no longer available in the Creative inventory for all four potion effects. {{info needed}}{{verify}}<!--only checked v1.4.7 and v1.5.2, but did not check any version in between, please check all-->}}
{{History|||snap=12w34a|[[File:Potion of Invisibility JE1 BE1.png|32px]] Added potions of [[Invisibility]].
|Potions of Night Vision are now [[brewing|brewable]].}}
{{History|||snap=12w38a|[[Witch]]es now cast potions at [[player]]s and can rarely [[drops|drop]] potions upon [[death]].}}
{{History|||snap=12w39a|Potions are now customizable using NBT editors or MCEdit.}}
{{History||1.6.1|snap=?|Potions of [[Weakness]] now reduce [[damage]] by half hearts, instead of 1 heart as it was before.}}
{{History|||snap=13w23a|Potions of [[Healing]] and [[Regeneration]] have been nerfed (by 33.3% and 50%).}} 
{{History||1.7.2|snap=13w36a|[[File:Potion of Water Breathing JE1 BE1.png|32px]] Added potions of [[Water Breathing]].
|[[Water bottle]]s can now be obtained as one of the "junk" [[item]]s from [[fishing]].}}
{{History||1.8|snap=14w27a|[[File:Potion of Leaping JE1 BE1.png|32px]] Added potions of [[Leaping]].}}
{{History||1.8.1|snap=pre1|Potion of Leaping can now be extended.}}
{{History||1.9|snap=15w31a|Numeric IDs are no longer used for potions. Instead, an NBT "Potion" [[tag]] is used, e.g. {{cmd|give @p minecraft:potion 1 0 {Potion:"minecraft:swiftness"} }}. See [[/Before 1.9|here]] for the old numeric IDs. This means the order of potion effects have changed in the Creative inventory.
|Splash potions now have a separate data value and ID name.
|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Water Bottle JE1 BE1.png|32px]] [[File:Water Bottle JE1 BE1.png|32px]] Added Mundane, Thick and Awkward potions to the [[creative]] [[inventory]].
|Mixed potions' colors now blend.}}
{{History|||snap=15w33a|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].
|The duration of potions of [[Poison]] has been extended, the duration of potions of [[Regeneration]] has been extended, and the duration of potions of [[Poison]] II has been reduced.
|Potion of [[Strength]] has been changed from 130% increase to 3-point increase.
|Potion of [[Weakness]] has been changed to 4-point decrease, was 0.5-point decrease.}}
{{History|||snap=15w44b|[[File:Uncraftable Potion JE1.png|32px]] Added the uncraftable potion.
|[[File:Potion of Luck JE1.png|32px]] Added potions of [[Luck]].}}
{{History||1.11|snap=16w33a|A [[water bottle]] is now able to add 1 water level to a [[cauldron]].}}
{{History|||snap=16w38a|The uncraftable potion is now magenta, has no glint, and is now obtained anytime a potion is specified with invalid or missing potion effect [[tag]]s.
|Due to the [[water bottle]] without tags being changed to the uncraftable potion, the [[brewing]] icon has also been changed to the uncraftable potion in [[creative]] [[inventory]].
|The uncraftable potion has been removed from the [[creative]] [[inventory]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 373.}}
{{History|||snap=18w07a|[[File:Potion of the Turtle Master JE1 BE1.png|32px]] Added potion of the Turtle Master, which gives Slowness IV and Resistance IV for 1 minute.
|Extended potions give both effects for 3 minutes.
|Level 2 potions give level VI of both effects for 1 minute.}}
{{History|||snap=18w14a|[[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Slow Falling]].}}
{{History|||snap=18w16a|Regular and extended potions of the Turtle Master now give only Resistance III.
|Level 2 potions of the Turtle Master now give only Resistance IV. This is because Resistance VI made the player invincible.}}
{{History||1.14|snap=18w43a|[[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Luck JE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] [[File:Water Bottle JE2 BE2.png|32px]] [[File:Uncraftable Potion JE2.png|32px]]<br>[[File:Potion of Night Vision.gif|32px]] [[File:Potion of Invisibility.gif|32px]] [[File:Potion of Leaping.gif|32px]] [[File:Potion of Fire Resistance.gif|32px]] [[File:Potion of Swiftness.gif|32px]] [[File:Potion of Slowness.gif|32px]] [[File:Potion of the Turtle Master.gif|32px]] [[File:Potion of Water Breathing.gif|32px]] [[File:Potion of Healing.gif|32px]] [[File:Potion of Harming.gif|32px]] [[File:Potion of Poison.gif|32px]] [[File:Potion of Regeneration.gif|32px]] [[File:Potion of Strength.gif|32px]] [[File:Potion of Weakness.gif|32px]] [[File:Potion of Luck.gif|32px]] [[File:Potion of Slow Falling.gif|32px]] The textures of potions have been changed.}}
{{History|||snap=19w06a|[[Wandering trader]]s now drink [[Invisibility]] potions at [[night]] and [[milk bucket]]s at dawn.}}
{{History||1.16|snap=20w09a|[[Fire resistance]] potions can now be obtained through [[bartering]].}}
{{History||1.16.2|snap=20w28a|Water bottles can now be obtained through [[bartering]].|Potions and splash potions of Fire Resistance now have a {{frac|8|459}} (~1.74%) chance of being offered by [[piglin]]s when bartering.}}
{{History||1.18|snap=21w39a|Potions of Water Breathing can now generate in [[buried treasure]] chests.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Potions of Healing now generate in [[ancient city]] chests.}}
{{History|||snap=22w11a|Water bottles can now be used on [[dirt]], [[coarse dirt]], or [[rooted dirt]] to turn it into [[mud]].}}
{{History|||snap=22w13a|Potions of Healing no longer generate in [[ancient city]] [[chest]]s.|Potions of Regeneration may now be found in [[ancient city]] [[chest]]s.}}
{{History||1.19.4|snap=Pre-release 1|Potions no longer have an enchantment glint.}}
{{History|||snap=Pre-release 3|[[File:Potion of Night Vision JE3.png|32px]] [[File:Potion of Invisibility JE3.png|32px]] [[File:Potion of Leaping JE3.png|32px]] [[File:Potion of Fire Resistance JE3.png|32px]] [[File:Potion of Swiftness JE3.png|32px]] [[File:Potion of Slowness JE3.png|32px]] [[File:Potion of the Turtle Master JE3.png|32px]] [[File:Potion of Water Breathing JE3.png|32px]] [[File:Potion of Harming JE3.png|32px]] [[File:Potion of Poison JE3.png|32px]] [[File:Potion of Strength JE3.png|32px]] Changed colors of the following potions (all forms): Night Vision, Invisibility, Leaping, Fire Resistance, Swiftness, Slowness, Turtle Master, Water Breathing, Harming, Poison, Strength, Resistance.}}
{{History||1.20|snap=23w12a|Wither [[effect]] particle colors have been adjusted to make them more distinguishable.
|The potion of [[Slow Falling]] has had its color tweaked to make it more distinguishable from the potion of [[Invisibility]].}}
{{History|java upcoming}}
{{History||Combat Tests|snap=Combat Test 7c|Potions with the same tags can now stack to 16.}}
{{History|||snap=Combat Test 8b|Potions (and liquid food) can now be drank faster (20 ticks, was 32 ticks).}}
{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|[[Wandering trader]]s now have a chance to [[trading|buy]] a water bottle or sell a potion of Invisibility.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] [[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Water Breathing JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.
|Water bottles, mundane, long mundane, thick, and awkward potions are all available in the Creative inventory.}}
{{History||v0.13.0|snap=build 1|Potions of [[Leaping]] are now obtainable in [[survival]].}}
{{History||v0.14.0|snap=build 1|Potions can now be used to fill 1/3 layer of [[cauldron]], filling cauldron with different [[liquids|liquid]] empties the cauldron.
|Using a [[glass bottle]] to a [[cauldron]] filled by a potion now fills the glass bottle with that potion.
|[[Swamp hut]]s now generate [[cauldron]]s filled with a random potion, making potions now obtainable in [[survival]] without [[brewing]].
|Potions of [[Healing]], [[Fire Resistance]], [[Water Breathing]] and [[Swiftness]] can now be obtained by killing [[witch]]es while they're drinking potions.}}
{{History||v0.16.0|snap=build 4|[[File:Potion of Decay BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|2 Potions of [[Healing]] II can now be found in a [[brewing stand]] inside [[end ship]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Potions of [[Water Breathing]] and potions of [[Regeneration]] can now be found inside [[buried treasure]] chests.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Potion of the Turtle Master JE1 BE1.png|32px]] Added potions of the Turtle Master.}}
{{History||1.6.0|snap=beta 1.6.0.5|[[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Slow Falling]].}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Water Bottle JE2 BE2.png|32px]] [[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Decay BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] The textures of potions have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.3|Potions of [[Invisibility]] can now be obtained by killing [[wandering trader]]s while they're drinking potions.}}
{{History||1.16.0|snap=beta 1.15.0.51|Added potions of [[Slowness]] IV, which can be brewed from potions of Slowness using glowstone dust.}}
{{History|||snap=beta 1.16.0.57|[[Fire resistance]] potions can now be obtained through [[bartering]].}}
{{History||1.16.100|snap=beta 1.16.100.54|Water Bottles can now be obtained through [[bartering]].|Potions and splash potions of Fire Resistance now have a {{frac|8|459}} (~1.74%) chance of being offered by [[piglin]]s when bartering.}}
{{History||1.19.80|snap=beta 1.19.80.21|Changed potion colors for the following potions: Fire Resistance, Harming, Invisibility, Leaping, Night Vision, Poison, Slowness, Strength, Swiftness, Turtle Master, and Water Breathing.
|Removed enchantment glint from splash potions.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.}}
{{History||xbox=TU8|Added the awkward potion to the [[Creative]] menu.}}
{{History||xbox=TU14|ps=1.04|[[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] Added potions of [[Night Vision]] and potions of [[Invisibility]].
|Awkward potion is no longer obtainable from the [[Creative inventory]].
|Extended-enhanced potions are now listed individually for four potion effects.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Water Breathing JE1 BE1.png|32px]] Added potions of [[Jump Boost|Leaping]] and potions of [[Water Breathing]]. These are both available in four variants unlike ''Java'' and ''Bedrock'' where the latter group only added two variants of water breathing and three variants for leaping.}}
{{History||xbox=TU34|xbone=CU22|ps=1.25|wiiu=Patch 4|Removed two of the four types of water breathing potions and splash potions.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|[[File:Potion of Luck JE1.png|32px]] Added potions of [[Luck]].
|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].
|Removed all types of extended-enhanced potions for all five potion effects.
|Potions effects are now arranged more like ''Java Edition''.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|[[File:Potion of Decay BE1.png|32px]] [[File:Potion of the Turtle Master JE1 BE1.png|32px]] [[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]], Turtle Master, and [[Slow Falling]].}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|Awkward potion is once again obtainable from the Creative inventory.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Water Bottle JE2 BE2.png|32px]] [[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Luck JE2.png|32px]] [[File:Potion of Decay BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] The textures of potions have been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] [[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.
|Water bottles, mundane, thick, and awkward potions are all available in the Creative inventory.}}
{{History||1.3.12|[[File:Potion of Decay BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]].}}
{{History||1.7.10|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].}}
{{History|foot}}

<gallery>
Health_Potion.png|Thick Potion with status effects of Mining Fatigue (duration 4:00) and Instant Health II (duration 4:00).
Invisible_sheep.png|An invisible sheep. Its wool can still be seen.
New Potion Colors.png|The new potion colors.
</gallery>

==Issues==
{{issue list}}

==Trivia==
*A potion can reach a maximum tier of 127, but using the {{cmd|effect}} [[commands|command]], effect levels can reach 255.
*When a player drinks two potions by quickly switching to another potion immediately after drinking one, the second drinking animation is not shown.{{verify|type=current|Still in recent versions?}} 
*A potion of [[Poison]] II lasts for 22.5 seconds, but it is displayed as 22 seconds because the [[item]] hover display shows rounded-down integer values.
*The "Local Brewery" [[advancement]] uses the Uncraftable Potion texture for its icon.

==Unused potions ==
''[[Bedrock Edition]]'' has [[History of textures/Unused textures#Unused potions|unused potion textures]] for several [[effect]]s, along with their [[Splash Potion#Unused splash potions|splash variants]]. These effects are: [[Absorption]], [[Blindness]], [[Haste]], [[Health Boost]], [[Hunger]], [[Mining Fatigue]], [[Nausea]], [[Resistance]], [[Saturation]], and [[Levitation]], as well as the [[Luck]] potion textures also present in [[Java Edition]]. These unused textures were added along with the other potion textures in [[Pocket Edition v0.12.1 alpha]], except for the potion of levitation, which was added in [[Pocket Edition 1.0.0]]. The textures were changed along with the other potion textures during the [[texture update]] in [[Bedrock Edition 1.10.0]]. Strangely, the potion of levitation texture is a duplicate of the splash potion of levitation texture.
<gallery>
Potion of Absorption BE2.png|Potion of Absorption
Potion of Blindness BE2.png|Potion of Blindness
Potion of Haste BE2.png|Potion of Haste
Potion of Health Boost BE2.png|Potion of Health Boost
Potion of Hunger BE2.png|Potion of Hunger
Potion of Mining Fatigue BE2.png|Potion of Mining Fatigue
Potion of Nausea BE2.png|Potion of Nausea
Potion of Resistance BE2.png|Potion of Resistance
Potion of Saturation BE2.png|Potion of Saturation
Potion of Levitation BE2.png|Potion of Levitation
</gallery>

==Gallery==
===Potions===
;Java Edition
<gallery>
Water Bottle.png|Water Bottle
Potion of Night Vision.png|Potion of Night Vision
Potion of Invisibility.png|Potion of Invisibility
Potion of Leaping.png|Potion of Leaping
Potion of Fire Resistance.png|Potion of Fire Resistance
Potion of Swiftness.png|Potion of Swiftness
Potion of Slowness.png|Potion of Slowness
Potion of the Turtle Master.png|Potion of the Turtle Master
Potion of Water Breathing.png|Potion of Water Breathing
Potion of Healing.png|Potion of Healing
Potion of Harming.png|Potion of Harming
Potion of Poison.png|Potion of Poison
Potion of Regeneration.png|Potion of Regeneration
Potion of Strength.png|Potion of Strength
Potion of Weakness.png|Potion of Weakness
Potion of Slow Falling.png|Potion of Slow Falling
Potion of Luck.png|Potion of Luck
Potion of Decay.png|Potion of Decay
Uncraftable Potion.png|Uncraftable Potion
</gallery>

===Screenshots===
<gallery>
OK2tE.png|Potion effects showing up in [[inventory]].
PotionBubbles.png|The bubbles emitted when a player drinks a potion.
Nightvision.png|The effect of night vision (left image is with night vision, right image is without).
NetherPotionEffect.png|The view when a player uses night vision in the Nether.
PotionTable.png|A brewing stand with a potion displayed next to it.
MinecraftPotionsClean.png|A guide to brewing before [[Java Edition 1.6.1|1.6]].
</gallery>

=== In other media===
<gallery>
File:Elixir (MCSM).png|The [[Minecraft Story Mode:Elixir|Elixir]], a unique potion featured in [[Minecraft Story Mode]].
File:Witch Potion (Dungeons).png|A potion thrown by a [[MCD:Witch|witch]], as depicted in [[Minecraft Dungeons]].
File:Strength Potion.png|A [[MCD:Strength Potion|strength potion]], as it appears in Minecraft Dungeons.
File:Swiftness Potion.png|A [[MCD:Swiftness Potion|Swiftness Potion]], as depicted in Minecraft Dungeons.
File:Potion of Water Breathing (MCD).png|A [[MCD:Potion of Water Breathing|Potion of Water Breathing]], as it appears in Minecraft Dungeons.
File:Bottle Lamp.jpg|An officially licensed bottle LED desk lamp.
File:Potion Bottle Bottle.jpg|A water bottle depicting many potions.
</gallery>

==See also==
*{{ItemLink|Glass Bottle}}
*{{ItemLink|Medicine}}
*{{ItemLink|Splash Potion}}
*{{ItemLink|Lingering Potion}}

==Notes==
<references group="note" />

==References==
{{reflist}}

==External links==
*[https://www.minecraft.net/en-us/article/taking-inventory--potion Taking Inventory: Potion] – Minecraft.net on May 11, 2022
*[http://potioncraft.net Minecraft Potions - A Visual Guide] (version 1.9)

{{items}}
{{effects}}

[[Category:Food]]

[[de:Trank]]
[[es:Poción]]
[[fr:Potion]]
[[hu:Bájital]]
[[it:Pozione]]
[[ja:ポーション]]
[[ko:물약]]
[[nl:Dranken]]
[[pl:Mikstury]]
[[pt:Poção]]
[[ru:Зелья]]
[[uk:Зілля]]
[[zh:药水]]</li><li>[[Written Book|Written Book]]<br/>{{Item
| title = Written Book
| image = Written Book.gif
| renewable = Yes
| stackable = Yes (16)
}}
A '''written book''' is an [[item]] created after a [[book and quill]] is signed.

== Obtaining ==

=== Signing a book and quill ===

Written books can be obtained by signing a [[book and quill]]. After it has been signed, it cannot be edited again. The label does not say "Written Book", but whatever the [[player]] titles it. The title appears on the top line of the label, and "by <''player''>" (the player's username) on the bottom. {{IN|bedrock}}, this is customizable without [[commands]].

=== Copying ===

{{crafting
|name=Written Book
|showdescription=1
|;;;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;;Book and Quill;Book and Quill;Book and Quill
|Book and Quill
|Written Book
|;;;;;;Book and Quill;Book and Quill
|;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;;;;Book and Quill
|Output= Written Book; Written Book,2; Written Book,3; Written Book,4; Written Book,5; Written Book,6; Written Book,7; Written Book,8
|description=The input written book is not consumed.<br>The new copies are "Copy of Original" or "Copy of Copy", depending on whether the input written book is "Original" or "Copy of Original".<br>Copies of copies cannot be copied.<br>Copied books of the same generation ("Original", "Copy of Original", "Copy of Copy", or "Tattered") stack.
|type=Miscellaneous
}}

== Usage ==

Written books can be opened by right-clicking (or holding down on the screen {{in|bedrock}}), and display a GUI allowing the [[player]] to read it or turn the page.

The contents of a book are an extra set of data attached to the item. This means that when a book is destroyed, its contents are lost with it.

=== Lecterns ===

One can place a [[written book]] on an empty [[lectern]].

The lectern then emits a redstone signal depending on the displayed page in the book. On the last page, the lectern emits a signal strength of 15.

=== Chiseled bookshelf ===
{{control|Use|text=Using}} the [[chiseled bookshelf]] while having a written book in the main hand will put the book inside the chiseled bookshelf.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Page turn1.ogg
|sound2=Page turn2.ogg
|sound3=Page turn3.ogg
|subtitle=Page rustles
|source=master
|description=When the page of a book is turned
|id=item.book.page_turn
|translationkey=subtitles.item.book.page_turn
|volume=2.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Page turn1.ogg
|sound2=Page turn2.ogg
|sound3=Page turn3.ogg
|subtitle=Page rustles
|source=block
|description=When the page of a book is turned on a lectern
|id=item.book.page_turn
|translationkey=subtitles.item.book.page_turn
|volume=2.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Book thump1.ogg
|sound2=Book thump2.ogg
|subtitle=Book thumps
|source=block
|description=When a book is placed on a lectern
|id=item.book.put
|translationkey=subtitles.item.book.put
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Chiseled bookshelf insert1.ogg
|sound2=Chiseled bookshelf insert2.ogg
|sound3=Chiseled bookshelf insert3.ogg
|sound4=Chiseled bookshelf insert4.ogg
|subtitle=Book placed
|source=block
|description=When a written book is placed in a chiseled bookshelf
|id=block.chiseled_bookshelf.insert
|translationkey=subtitles.chiseled_bookshelf.insert
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.85, or 1.1 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Chiseled bookshelf pickup1.ogg
|sound2=Chiseled bookshelf pickup2.ogg
|sound3=Chiseled bookshelf pickup3.ogg
|subtitle=Book taken
|source=block
|description=When a written book is removed from a chiseled bookshelf
|id=block.chiseled_bookshelf.pickup
|translationkey=subtitles.chiseled_bookshelf.take
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Page turn1.ogg
|sound2=Page turn2.ogg
|sound3=Page turn3.ogg
|source=sound
|description=When the page of a book is turned
|id=item.book.page_turn
|volume=2.0
|pitch=1.0}}
{{Sound table
|sound=Book thump1.ogg
|sound2=Book thump2.ogg
|source=block
|description=When a book is placed on a lectern
|id=item.book.put
|volume=4.8
|pitch=1.0}}
{{Sound table
|type=bedrock
|sound=Chiseled bookshelf insert1.ogg
|sound2=Chiseled bookshelf insert2.ogg
|sound3=Chiseled bookshelf insert3.ogg
|sound4=Chiseled bookshelf insert4.ogg
|source=block
|description=When a written book is placed in a chiseled bookshelf
|id=insert.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.85, or 1.1 for each sound</ref>}}
{{Sound table
|sound=Chiseled bookshelf pickup1.ogg
|sound2=Chiseled bookshelf pickup2.ogg
|sound3=Chiseled bookshelf pickup3.ogg
|source=block
|description=When a written book is removed from a chiseled bookshelf
|id=pickup.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|foot=1}}

== Data values ==
=== ID ===
{{JE}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Written Book
|spritetype=item
|nameid=written_book
|itemtags=bookshelf_books, lectern_books
|form=item
|foot=1}}

{{BE}}:
{{ID table
|edition=bedrock
|showitemtags=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Written Book
|spritetype=item
|nameid=written_book
|id=511
|itemtags=minecraft:bookshelf_books, minecraft:lectern_books
|form=item
|foot=1}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Written Books}}
</div>

{{el|bedrock}}:
: See [[Bedrock Edition level format/Item format]].

== History ==
{{History|java}}
{{History||1.3.1|snap=12w17a|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History|||snap=12w21a|Written books can now be [[trading|sold]] to librarian [[villager]]s, at 1 written book for 1 [[emerald]].}}
{{History||1.7.2|snap=13w36a|Written books can now be cloned the same way [[map]]s can, but by using [[book and quill|books and quills]] instead of Empty Maps. Multiple copies of the same written book can be cloned by putting more book and quills in the crafting grid. 
|Written books can now be stacked (up to 16 per stack).}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: librarian [[villager]]s now [[trading|buy]] 2 written books for 1 [[emerald]].}}
{{History|||snap=14w05a|Copying written books now mark them as "Copy of Original" or "Copy of Copy". The copying status of a book is denoted in a separate line in the tooltip, beneath the author's name. Copies of copies cannot be copied.}}
{{History||1.9|snap=15w33c|A written book titled "Work in Progress" now generates within a [[hopper]] as a part of the [[end ship]] in the [[end cities]]. It reads: "We will have something else here soon..." and is signed by [[Searge]].}}
{{History|||snap=15w41a|End ships no longer contain a written book.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 387.}}
{{History||1.14|snap=18w43a|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.}}
{{History|||snap=19w02a|Written books can now be held on [[lectern]]s.}}
{{History|||snap=19w11a|Librarian [[villager]]s no longer [[trading|buy]] written books.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Written books can now interact with [[chiseled bookshelves]].}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.
|Written books can now be held on [[lectern]]s.}}

{{History|console}}
{{History||xbox=TU25|xbone=CU14|ps=1.17|wiiu=Patch 1|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History|PS4}}
{{History||1.90|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*When written books are obtained with [[commands]] (without the correct [[Player.dat format#Written Books|data tag]]), the label shows "Written Book" and has the text "*Invalid book tag*" when opened. The book is signed and cannot be edited without commands.
*Commands that were added to a written book using serialized JSON objects are executed through the chat system. This means that any command added to a written book can't be longer than 256 characters, which is the maximum chat line limit.
*During the 2020 April Fools Update [[Java Edition 20w14∞]], throwing a written book into a lit [[Nether Portal (block)|nether portal]] would create a portal to one of the 2,147,483,645 new dimensions.

== Gallery ==
<gallery>
Written Book tooltip.png|A signed book.
Test by Dinnerbone.png|Copying a signed book.
BookandQuillOperators12w17a.png|Different types of characters can be used to simulate a different font.
JSON Book.png|First image of a book using JSON text.
No NBT written book GUI.png|A no NBT written book using commands.
Book Background (JE).png|Java Edition book background texture.
Book Background (BE).png|Bedrock Edition book background texture.
Book Arrowleft (JE).png|Java Edition left arrow texture.
Book Arrowright (JE).png|Java Edition right arrow texture.
Book Arrowleft (BE).png|Bedrock Edition left arrow texture.
Book Arrowright (BE).png|Bedrock Edition Right arrow texture.
</gallery>

== See also ==
*[[Book]]
*[[Bookshelf]]
*[[Book and Quill]]

{{Items}}

[[Category:Renewable resources]]

[[cs:Napsaná kniha]]
[[es:Libro escrito]]
[[fr:Livre édité]]
[[hu:Megírt könyv]]
[[it:Libro]]
[[ja:記入済みの本]]
[[ko:글이 쓰인 책]]
[[nl:Geschreven boek]]
[[pl:Zapisana książka]]
[[pt:Livro escrito]]
[[ru:Написанная книга]]
[[uk:Написана книга]]
[[zh:成书]]</li></ul>
Pre-release 1Now  minCount and  maxCount in  spawners in configured structure feature must be a positive integer. And  maxCount must be not less than  minCount.
1.20
{{Extension DPL}}<ul><li>[[Yellow Dye|Yellow Dye]]<br/>{{Item
| title = Yellow Dye
| renewable = Yes
| stackable = Yes (64)
}}
'''Yellow dye''' is a [[Dye#Primary|primary dye]] created by placing a [[dandelion]] or [[sunflower]] into a [[crafting]] grid.

== Obtaining ==

=== Crafting ===
{{Crafting
  |Dandelion;Sunflower
  |Output=Yellow Dye;Yellow Dye,2
  |type=Material
}}

=== Chest loot ===
{{LootChestItem|yellow-dye}}

=== Trading ===

[[Wandering trader]]s sell 3 yellow dye for an [[emerald]].

== Usage ==
{{dye usage}}

=== Crafting ingredient ===
{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}

=== Loom ingredient ===
{{Banner loom usage|Yellow Dye}}

=== Trading ===
Expert-level shepherd villagers have a {{frac|1|6}} chance to buy 12 yellow dye for an emerald.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Yellow Dye
|spritetype=item
|nameid=yellow_dye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Yellow Dye
|spritetype=item
|nameid=yellow_dye
|aliasid=dye / 11
|id=406
|form=item
|translationkey=item.dye.yellow.name
|foot=1}}

== Video ==
{{yt|nOQUDjEHGRg}}

== History ==
{{History|java beta}}
{{History||1.2|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History||1.6.6|Dandelions can now be generated using [[Bone Meal|bone meal]], making dandelion yellow [[renewable resource|renewable]].}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Dandelion yellow can be crafted with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{History||1.7.2|snap=13w36a|Can now be crafted using sunflower.}}
{{History|||snap=13w37a|Each dandelion now yields only 1 dandelion yellow, instead of 2.}}
{{History|||snap=13w41a|[[Stained glass]] can now be [[crafting|crafted]].}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be [[dye]]d.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Yellow dye can now be used to craft yellow [[concrete powder]].}}
{{History|||snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|"Dandelion Yellow" has now been renamed to "Yellow Dye".
|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}
{{History|||snap=18w44a|Yellow dye can now change the text color on [[sign]]s to yellow.}}
{{History|||snap=18w49a|Yellow dye can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells yellow dye.}}
{{History|||snap=19w11a|Yellow dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Yellow dye can now be used to craft [[yellow candle]]s.}}
{{History|||snap=21w19a|Yellow dye can no longer be used to craft yellow candles.}}
{{History|||snap=Pre-release 1|Yellow dye can once again used to craft yellow candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Yellow dye can now change the text color on [[hanging sign]]s to yellow.}}
{{History||1.20|snap=23w12a|Yellow dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Yellow dye no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], yellow dye is now common loot.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History||v0.8.0|snap=build 1|Dandelion yellow is now used to craft [[cocoa beans]].}}
{{History||v0.14.0|snap=build 1|Yellow dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History||v0.16.0|snap=build 1|Dandelion yellow is no longer used to [[crafting|craft]] cocoa beans.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Yellow dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Yellow dye can now be used to dye [[shulker box]]es, [[bed]]s, and craft [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Yellow dye can now be used to craft patterns on [[banner]]s, [[firework star]]s, and [[stained glass]].}}
{{History||1.4.0|snap=beta 1.2.20.1|Yellow dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Dandelion yellow can now be used to dye [[cat]] collars.}}
{{History|||snap=beta 1.8.0.10|"Dandelion Yellow" has now been renamed to "Yellow Dye".}}
{{History||1.10.0|snap=beta 1.10.0.3|Yellow dye is now [[trading|sold]] by [[wandering trader]]s.
|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Yellow dye can now be found in [[village]] mason [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Yellow dye can now be sold to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of yellow dye has been changed from <code>dye/11</code> to <code>yellow_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History|ps4}}
{{History||1.83|"Dandelion Yellow" has now been renamed to "Yellow Dye".}}
{{History||1.90|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}}

{{Items}}

[[cs:Pampelišková žluť]]
[[de:Gelber Farbstoff]]
[[es:Tinte amarillo]]
[[fr:Teinture jaune]]
[[hu:Pitypangsárga]]
[[ja:黄色の染料]]
[[ko:노란색 염료]]
[[nl:Paardenbloemgeel]]
[[pl:Żółty barwnik]]
[[pt:Corante amarelo]]
[[ru:Жёлтый краситель]]
[[zh:黄色染料]]

[[Category:Items]]
[[Category:Dyes]]
[[Category:Renewable resources]]</li><li>[[:Category:Food|Category:Food]]<br/>Foods in Minecraft.

[[Category:Items]]

[[cs:Kategorie:Potraviny]]
[[fr:Catégorie:Nourriture]]
[[hu:Kategória:Ételek]]
[[zh:Category:食物]]</li></ul>
23w12aAdded capped processer.
The  output_nbt field in the rule processer used to set fixed NBT data to the block entity has now been changed to  block_entity_modifier. Before,  output_nbt was an NBT compound in JSON object form, see NBT format#JSON and NBT.

Reference

Data packs
Components
World generation
Data packs
Tutorials
Minecraft: Java Edition
Versions
Development
Version history
Technical
.minecraft
Development resources
Legacy development resources
Multiplayer
Game customization

Structure feature types

These are all of the valid types which can be used for structure features:

  • mansion
  • jungle_pyramid
  • desert_pyramid
  • igloo
  • swamp_hut
  • stronghold
  • monument
  • fortress
  • endcity
  • nether_fossil
  • pillager_outpost
  • village
  • bastion_remnant
  • mineshaft
  • ruined_portal
  • shipwreck
  • ocean_ruin
  • buried_treasure

Jigsaw pools

Jigsaw pools or template pools are used to generate structures using jigsaw blocks, stored as JSON files within a data pack in the path data/<namespace>/worldgen/template_pool.

JSON format

  • The root tag
    •  fallback: The fallback pool. Should be an ID of a structure pool. Template in the fallback pool generates in the following two cases:
      1. When the generation of jigsaw reaches the specified level/depth number, the fallback pool generates at the end of the last level.
      2. All the elements in this structure pool can not be successfully generated.
      In the above two cases, the game will try to generate a template from the fallback pool.
      When trying to generate a template from the fallback pool, if all the elements in the fallback pool cannot be generated successfully, nothing will be generated.
    •  elements: A list of elements to randomly select from.
      For the start pool of the jigsaw structure feature, if the name of the start jigsaw block is specified, but there's no jigsaw block with the corresponding name in the selected element, the whole structure feature fails to generate. For the non-start pool, a selected element successfully generates when the following conditions are met:
      1. There is a jigsaw block with the corresponding name and corresponding direction (the horizontal jigsaw blocks correspond to each other, and a up facing jigsaw block corresponds to a down facing block, while a down facing block corresponds to a up facing block) in the element.
      2. The 3D Chebyshev distance between the element and the start of the structure doesn't exceed the maximum distance specified in the configured structure feature, or doesn't exceed 128 when generated by commands or jigsaw block GUI.
      3. The element will not overlap with other generated jigsaws, unless the block pointed by the jigsaw block is inside the current jigsaw.
      4. If the block pointed by the jigsaw block is inside the current jigsaw, then this element and all the jigsaws generated later by this element must be completely inside the jigsaw where this jigsaw block is located.
      If the element fails to generate, it will try again to generate another element in the list. If all of the elements in the list cannot be generated successfully, the fallback pool will be used.
      • : An element.
        •  weight: How likely this element is to be chosen when using this pool. Value between 1 and 150 (inclusive).
        •  element: The properties of this element.
          •  projection: Can be rigid to place a fixed structure (like a house), or terrain_matching to match the terrain height (like a village road).
          •  element_type: Can be minecraft:empty_pool_element to generate nothing, minecraft:feature_pool_element to generate a placed feature, minecraft:list_pool_element to generate multiple elements one after another (lower elements replace their front ones), and minecraft:legacy_single_pool_element or minecraft:single_pool_element to generate a structure template. The difference between legacy_single_pool_element and single_pool_element, is that the legacy_single_pool_element will not replace existing blocks with air, and the single_pool_element will replace blocks with air and relies on the structure_void block to avoid not replacing blocks.
            If  element_type is feature_pool_element, additional fields are as follows:
          •  feature: The namespaced id of the placed feature.
            If  element_type is list_pool_element, additional fields are as follows:
          •  elements: A list of elements to choose from.
            • : An element, with the same format above.
            If  element_type is legacy_single_pool_element or single_pool_element, additional fields are as follows:
          •  location: The namespaced id of the structure template to generate.
          •  processors: (Required, but can be empty) The namespaced ID of a processor list, or a object of a processor list, or a list of processors.


Processor lists

Processor lists are lists of processors used to affect blocks in structures, stored as JSON files within a data pack in the path data/<namespace>/worldgen/processor_list.

JSON format

Custom world generation/processor list

Predicates

    •  predicate_type: Can be always_true, block_match to test for a block, blockstate_match to test for a specific block state, random_block_match to test for a block with a random chance, random_blockstate_match to test for a block state with a random chance, or tag_match to test for a block in a block tag.
      If predicate_type is block_match, additional fields are as follows:
    •  block: A block ID.
      If predicate_type is blockstate_match, additional fields are as follows:
    •  block_state: A block state.
      • Block state
      If predicate_type is random_block_match, additional fields are as follows:
    •  block: A block ID.
    •  probability: The probability of the predicate to pass if the block is found. Values below 0.0 is treated as 0.0; values above 1.0 is treated as 1.0.
      If predicate_type is random_blockstate_match, additional fields are as follows:
    •  block_state: A block state.
      • Block state
    •  probability: The probability of the predicate to pass if the block state is found. Values below 0.0 is treated as 0.0; values above 1.0 is treated as 1.0.
      If predicate_type is tag_match, additional fields are as follows:
    •  tag: A block tag without #.

History

Java Edition
1.16.2
{{Extension DPL}}<ul><li>[[Cooked Cod|Cooked Cod]]<br/>{{redirect|Cooked Fish|cooked salmon|Cooked Salmon}}
{{Item
| title = Cooked Cod
| image = Cooked Cod.png
| renewable = Yes
| heals = {{hunger|5}}
| stackable = Yes (64)
}}
'''Cooked cod''' is a food item obtained by cooking [[raw cod]].

== Obtaining ==

=== Mob loot ===
====Cod====
[[Cod]] always drops 1 [[Raw Cod|raw cod]] when killed, unaffected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref> If it is killed while on [[fire]], it drops 1 cooked cod instead.
====Dolphins ====
When killed, [[Dolphin|dolphins]] drop 0–1 raw cod. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 0-4 with Looting III. If killed while on fire, they drop cooked cod instead.
====Guardians and elder guardians====
[[Guardian]]s and [[elder guardian]]s have a 40% and 50% chance, respectively, to drop raw cod when killed. {{IN|java}}, cooked cod is dropped if a guardian is on fire when killed.

Guardians and elder guardians also drop a 2.5% chance to drop a random fish, with 60% of them being raw cod, which drops as cooked if the guardian was on fire. The chance of getting the fish drop is increased by 1% per level with [[Looting]] (for a maximum of 5.5% with Looting III), but the type of fish is not affected.
====Polar bears====
[[Polar bear]]s have a 75% chance of dropping 0–2 raw cod when killed. The maximum amount can be increased by 1 per level of Looting, for a maximum of 0-5 with Looting III. If killed while on fire, they drop cooked cod instead.
===Chest loot===
{{LootChestItem|cooked-cod}}

===Cooking===

Cooked cod can be obtained by cooking [[raw cod]] in a [[furnace]], [[smoker]], or [[campfire]]. 

{{smelting|Raw Cod|Cooked Cod|0,35}}

===Trading===

Novice-level Fisherman [[Villager|villagers]] have a 50% chance to sell 6 cooked cod for 6 raw cod and 1 [[emerald]].

== Usage ==

=== Food ===

To eat cooked cod, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|5}} [[hunger]] and 6 hunger [[Hunger#Mechanics|saturation]].

=== Wolves ===

{{IN|Bedrock}}, cooked cod can be used to feed a wolf not at full health, healing by {{hp|5|mob=1}}. However, unlike other wolf food, cooked cod cannot be used to speed up the growth of baby wolves nor used to breed them.

==Sounds==
{{Sound table/Entity/Food}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Cooked Cod
|spritetype=item
|nameid=cooked_cod
|itemtags=fishes
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Cooked Cod
|spritetype=item
|nameid=cooked_cod
|aliasid=cooked_fish
|id=268
|form=item
|translationkey=item.cooked_fish.name
|foot=1}}

== Achievements ==

{{load achievements|Delicious Fish}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet}}

== Video ==
<div style="text-align:center">{{yt|nPl0HUGPMcA}}</div>

== History ==

{{History|java alpha}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|[[File:Cooked Cod JE1 BE1.png|32px]] Added cooked fish, which restores {{hp|5}}.}}
{{History|java beta}}
{{History||1.5|Cooking fish now gives the '''Delicious Fish''' [[achievement]].}}
{{History||1.8|snap=Pre-release|Cooked fish is now stackable to 64.
|Cooked fish now fills {{hunger|5}} instead of {{hp|5}}.}}
{{History|java}}
{{History||1.3.1|snap=12w21a|Farmer [[villager]]s now [[trading|buy]] 9–12 cooked fish for 1 [[emerald]].}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 [[raw cod|raw fish]].
|Farmer villagers no longer buy cooked fish.}}
{{History|||snap=14w04a|The name of cooked fish has been corrected from <code>cooked_fished</code> to <code>cooked_fish</code>.}}
{{History|||snap=14w25a|Cooked fish are now obtainable rare [[drops]] from [[guardian]]s and [[elder guardians]].}}
{{History||1.13|snap=17w47a|The different data values for the <code>cooked_fish</code> IDs have been split up into their own IDs.
|"Cooked Fish" have been renamed to "Cooked Cod".
|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral ID were 349 and 350.}}
{{History|||snap=18w08b|[[Cod]], and other [[fish]], have been added as [[mob]]s, which [[drops|drop]] their cooked [[item]] form when killed with [[fire]].
|[[File:Cooked Cod JE2 BE2.png|32px]] The texture of cooked cod has been changed.}}
{{History|||snap=18w10a|Cooked cod now generates in [[buried treasure]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Cooked Cod JE3.png|32px]] The texture of cooked cod has been changed.}}
{{History|||snap=18w47b|[[File:Cooked Cod JE4 BE3.png|32px]] The texture of cooked cod has been changed, once again to match {{el|be}}.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Cooked Cod JE1 BE1.png|32px]] Added cooked fish.}}
{{History||v0.12.1|snap=build 1|Cooked fish now restores [[hunger]] instead of [[health]].}}
{{History||v0.16.0|snap=build 1|Cooked fish is now [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 [[raw cod|raw fish]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[Cod]] and other [[fish]] have been added as [[mob]]s, which [[drops|drop]] their cooked [[item]] form when killed with [[fire]].
|[[File:Cooked Cod JE2 BE2.png|32px]] The texture of cooked fish has been changed.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Cooked Cod JE4 BE3.png|32px]] The texture of cooked fish has been changed.}}
{{History||1.7.0|snap=beta 1.7.0.2|"Cooked Fish" has been renamed to "Cooked Cod".}}
{{History||1.11.0|snap=beta 1.11.0.4|Fisherman [[villager]]s now have a 50% chance to [[trading|sell]] 6 cooked cod for 6 [[raw cod]] and 1 [[emerald]].}}
{{History||1.16.100|snap=beta 1.16.100.52|Cod now drop their cooked cod when killed with fire.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Cooked Cod JE1 BE1.png|32px]] Added cooked fish.}}
{{History||xbox=TU5|Cooked fish is now stackable to 64.
|Cooked fish now fills [[hunger]] instead of [[health]].}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|"Cooked Fish" has been renamed to "Cooked Cod".
|[[File:Cooked Cod JE2 BE2.png|32px]] The texture of cooked cod has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Cooked Cod JE1 BE1.png|32px]] Added cooked fish.}}
{{History|foot}}

== Issues ==

{{Issue list}}

{{Items}}

[[Category:Food]]
[[Category:Renewable resources]]

[[de:Gebratener Kabeljau]]
[[es:Bacalao cocinado]]
[[ko:익힌 대구]]
[[pt:Bacalhau assado]]
[[ru:Жареная треска]]
[[th:Cod (ไอเทม)]]
[[zh:熟鳕鱼]]</li><li>[[Dupe Hack|Dupe Hack]]<br/>{{for|the method to duplicate items and blocks|Tutorials/Block and item duplication}}
{{stub}}
{{Joke feature}}
{{exclusive|java}}{{item
| image = Missing Model.png
| rarity=Common
| stackable=No
|title=minecraft:dupe_hack|renewable=Yes}}
'''minecraft:dupe_hack''' is a joke item from [[Java Edition 23w13a_or_b]].

==Obtaining==

Once the <code>dupe_hack_occurrence_chance</code> vote is approved the '''dupe hack''' item has a random chance of dropping whenever an entity with chests is killed by a player, e.g. when destroying a [[Minecart with Chest|minecart with chest]] with a [[sword]].

It doesn't appear in the [[creative]] menu, not even when the [[Options#Controls|option]] "Operator Items Tab" is enabled, but can be given to the player with [[Commands/give|<code>/give</code>]] and other commands.

==Usage==
The dupe hack item can be used to create a limited amount of duplicate items by placing it on a [[crafting table]] with any other item. It has a random chance of breaking, controlled by the <code>dupe_hack_break_chance</code> vote. This limitation can be mostly bypassed by putting the items in an [[Ender Chest|ender chest]] first and duplicating the chest.

===Crafting ingredient===

{{Crafting
  |Any Item
  |Dupe Hack
  |Output=Any Item, 2
  |showdescription=1
  |description=The dupe hack item remains in the crafting grid after duplicating an item.
  |foot=1
}}

==Data values==
===ID===
{{edition|java}}:{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=minecraft:dupe_hack
|spritetype=item
|nameid=dupe_hack
|form=item|foot=1|spritename=missingno}}
==History==
{{History|java}}
{{History||23w13a_or_b|[[File:Missing Model.png|32px]] Added minecraft:dupe_hack.}}
{{History|foot}}

{{items}}
{{Jokes}}
<references />
[[ja:Dupe Hack]]
[[pt:Dupe Hack]]
[[Category:Joke items]]</li></ul></nowiki>
20w28aAdded support for custom world generation.
20w29aNoise settings moved from dimensions to worldgen.

External links

Settings for vanilla world generation (direct download)

Notes


Data packs
Components
World generation
Data packs
Tutorials
Deutsch 日本語 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki