Minecraft Wiki
Advertisement
See also: South-east rule

Coordinates numerically represent a location in a dimension.

World coordinates[]

Coordinates

X, Y and Z coordinate on a Minecraft map.

North is upward, at *negative* z and 180 degrees. Moving clockwise, East is to the right at positive X and -90 degrees. South is down, at *positive* Z and 0 degrees. West is left, at negative X and +90 degrees.

X and Z axes with directions shown, from a birds-eye view. Red highlights where these axes are different than standard.

World coordinates are expressed as a set of three absolute world coordinates (X Y Z), each number representing a distance along an axis from the world origin.

Coordinate system[]

World coordinates are based on a grid where three lines or axes intersect at the origin point.

  • The x-axis indicates the player's distance east (positive) or west (negative) of the origin point—i.e., the longitude,
  • The z-axis indicates the player's distance south (positive) or north (negative) of the origin point—i.e., the latitude,
  • The y-axis indicates how high or low (from 0 to 255 (pre 1.18) or -64 to 320 (from 1.18), with 63 being sea level) the player is—i.e., the elevation,
  • The unit length of the three axes equals the side of one block. And, in terms of real-world measurement, one block equals 1 cubic meter.

The origin point marks the zero point for the x and z coordinates. Hence, it may be thought of as the 0,0 coordinate:

  • X-axis = 0
  • Z-axis = 0

As the player travels south, the z-axis number increases; travel north and it decreases. Similarly, the x-axis number increases as the player travels east and decreases as you travel west. As the player's elevation rises, the y-axis number increases, and as the player's elevation lowers, that number decreases.

An entity's coordinates are actually the coordinates of the center at the bottom of player's collision box. When the display shows you are at Y=63, then the player's feet are at Y=63, and their eyes are at 64.62.

Block position[]

The position of a block is actually the coordinates of the point at the lower northwest corner of the block, that is, the integer coordinates obtained by rounding down the coordinates inside the block.

In Minecraft, decimal coordinates usually needs to be converted into integer coordinates by rounding down, which is called the block position of the coordinate.

Displaying coordinates[]

DebugScreen

Screenshot showing the debug information, with coordinates XYZ, Facing, and Block position.

Bedrock Edition Coordinates

The block position of player shown in Bedrock Edition.

Debug screen without coordinates

Debug screen when reducedDebugInfo is true.

In Java Edition, pressing F3 (or Fn + F3 on Macs and some laptops or Alt + Fn + F3 on newer Macs) brings up a debug screen which gives the player's current coordinates and rotation in the upper left part of the screen. It can be disabled using the command /gamerule reducedDebugInfo true.

In Java Edition, pressing F3 can also replace the crosshair with a display of these three directions: +X in red, +Y in green, +Z in blue (eastward, upward, and southward, respectively).

In Bedrock Edition, the block position of the player can be displayed by changing the world options. The coordinates are displayed in a box in the top left, if the "Show Coordinates" option is turned on in the game settings screen or /gamerule showcoordinates true is used.


Commands[]

Some commands use require the player to specify coordinates. They can be expressed explicitly, using absolute world coordinates, or relative to the command source, using relative world coordinates or local coordinates.

Relative world coordinates[]

When specifying coordinates, each coordinate can alternatively be expressed as a relative world coordinate, written in tilde notation (~ΔX ~ΔY ~ΔZ). A number following a tilde (~) describes an offset from execution position along one of the world axes, and a lone tilde assumes an offset of 0. For example, the position 32 blocks SSW ~10 ~ ~-30 means "10 blocks east (+X) and 30 blocks north (–Z) of here." And ~ ~ ~ means the command's current position.

Relative world coordinates can mix with absolute coordinates; for example, /tp ~ 64 ~ keeps the sender's X and Z positions unchanged but teleports them to an absolute height of 64 blocks.

The /execute command can update a command's current position, changing the meaning of ~ ~ ~.

Local coordinates[]

The other way to describe positions is with local coordinates, written in caret notation (^ΔXlocal ^ΔYlocal ^ΔZlocal).

Like relative coordinates, these describe positions relative to where a command is executed from, but with different directions. A number following a caret (^) is an offset within a moving, entity-centric frame: This coordinate system is centered at the executor's position, with +Xlocal directed to its left, +Ylocal directed upward, and +Zlocal directed in the direction the sender faces. (Note that an entity with rotation 0 0 has its local frame aligned with the world frame.)

Described in other terms, these coordinates express ^ΔSway ^ΔHeave ^ΔSurge

For example, /tp ^ ^ ^5 teleports the player 5 blocks forward. If they turn around and repeat the command, they are teleported back to where they started.

In Java Edition, pressing F3+B displays the +Zlocal direction for all entities as a blue ray centered on their heads.

Local coordinates cannot be mixed with world coordinates (e.g. ^ 0 ^, ^ 0 ~1), and attempting so alerts the typist, "Cannot mix world & local coordinates (everything must either use ^ or not)." So such a command fails to be parsed. However, this effect can be achieved using /execute rotated ~ 0 to "globalize" the y coordinate, and /execute rotated 0 ~ to "globalize" the x and z coordinates. For example, /execute rotated ~ 0 run tp ^ ^ ^3 will teleport the player 3 blocks in forward, but at the same y level.

A command's execution position, rotation, dimension, and anchor all can change the effect of using ^ ^ ^. These can be updated by the /execute command.

History[]

Clock JE3
This section needs to be updated. 
Please update this section to reflect recent updates or newly available information.
Reason: Doesn't show when the coordinates display was added in Bedrock Edition.
Java Edition Alpha
v1.2.3
{{Extension DPL}}<ul><li>[[Ghast Tear|Ghast Tear]]<br/>{{Item
| image = Ghast Tear.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Ghast tears''' are items [[Drops|dropped]] by [[ghast]]s. They can be used to make potions of [[Regeneration]] and [[end crystal]]s.

== Obtaining ==

=== Mob loot ===
[[Ghast]]s drop 0–1 ghast tears. [[Looting]] increases the maximum ghast tears dropped by one per level, for a maximum of 4 ghast tears with Looting III. Looting also works when knocking back a [[fireball]] with an enchanted item.

== Usage ==

=== Brewing ingredient ===
{{brewing
  |showname=1
  |head=1
  |Ghast Tear
  |Mundane Potion
  |base=Water Bottle
}}
{{brewing
  |foot=1
  |Ghast Tear
  |Potion of Regeneration
}}

=== Crafting ingredient ===

{{crafting usage}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Ghast Tear
|spritetype=item
|nameid=ghast_tear
|id=424
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|[[File:Ghast Tear JE1 BE1.png|32px]] Added ghast tears.}}
{{History|||snap=Beta 1.9 Prerelease 3|Ghast tears can now be brewed in a [[water bottle]] to create a [[mundane potion]], or in an [[awkward potion]] to create a [[potion of Healing]].}}
{{History|||snap=Beta 1.9 Prerelease 4|Ghast tears now create [[potion of regeneration|potions of Regeneration]]. This was due to the sheer difficulty in obtaining them.<ref>{{tweet|jeb|123671273904680960|Since Ghast Tears are so hard to get, I've decided to replace the "Instant Health" with "Regeneration" for them|October 11, 2011}}</ref> [[Glistering melon]]s have been added to create potions of Healing, instead.}}
{{History||1.9|snap=15w44b|A ghast tear is now used to [[crafting|craft]] an [[end crystal]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 370.}}
{{History||1.14|snap=18w43a|[[File:Ghast Tear JE2 BE2.png|32px]] The texture of ghast tears has been changed.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Ghast Tear JE1 BE1.png|32px]] Added ghast tears.|Ghast tears are currently unobtainable as [[ghast]]s don’t [[drops|drop]] them.}}
{{History|||snap=build 7|Ghasts now drop ghast tears.<ref>{{bug|MCPE-9338}}</ref>}} 
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|A ghast tear is now used to [[crafting|craft]] an [[end crystal]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Ghast Tear JE2 BE2.png|32px]] The texture of ghast tears has been changed.}}

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

{{History|New 3DS}}
{{History||0.1.0|[[File:Ghast Tear JE1 BE1.png|32px]] Added ghast tears.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}}

{{items}}

[[Category:Renewable resources]]
[[Category:Brewing recipe]]

[[cs:Ďasova slza]]
[[de:Ghast-Träne]]
[[es:Lágrima de ghast]]
[[fr:Larme de Ghast]]
[[hu:Kísértetkönny]]
[[it:Lacrima di ghast]]
[[ja:ガストの涙]]
[[ko:가스트 눈물]]
[[nl:Ghasttraan]]
[[pl:Łza ghasta]]
[[pt:Lágrima de ghast]]
[[ru:Слеза гаста]]
[[uk:Сльоза ґаста]]
[[zh:恶魂之泪]]</li><li>[[Diamond|Diamond]]<br/>{{For}}
{{redirect|Diamonds|the achievement|Achievements#DIAMONDS!|the advancement|Advancements#Diamonds!}}
{{Item
| image = Diamond.png
| renewable = No
| stackable = Yes (64)
| rarity = Common}}
A '''diamond''' is a mineral that can only be obtained from [[Diamond Ore|diamond ore]], [[chest loot|loot chests]] and [[Suspicious Block|suspicious blocks]]. It is required to craft diamond [[tool]]s and [[armor]] (and therefore obtain [[obsidian]] to access the [[The Nether|Nether]]), [[enchanting table]]s, [[jukebox]]es and duplicate [[smithing template]]s.

== Obtaining ==
{{see also|Tutorials/Diamonds}}
=== Mining ===
{{see also|Diamond Ore#Natural generation}}
[[Diamond ore]] can be mined using an iron [[pickaxe]] or stronger. An ore drops a single diamond. If mined by any other tool, it drops nothing. If the pickaxe is enchanted with [[Fortune]], it can drop an extra diamond per level of Fortune, allowing for a maximum of 4 diamonds with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops an ore block rather than a diamond. The ore is found at level 15 or lower, most commonly between -50 and -64; levels -58 and -59 are the preferred levels to mine at since they don't contain [[bedrock]], as it starts spawning at -60.

=== Chest loot ===
{{LootChestItem|diamond}}

=== Suspicious sand ===

When brushing [[suspicious sand]] in [[desert pyramid]]s, they have a {{frac|1|7}} chance to drop a diamond.

=== Crafting ===
{{Crafting
|Block of Diamond
|Output= Diamond,9
|type= Material
}}

=== Smelting ===
{{Smelting
|showname=1
|Diamond Ore; Deepslate Diamond Ore
|Diamond
|1
}}

== Usage ==

Diamonds are mainly used to craft high-tier armor and equipment, which in turn are also used in making [[netherite]] armor and equipment. 

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===

{{IN|bedrock}}, expert-level armorer, toolsmith, and weaponsmith villagers buy one diamond for an emerald as part of their trades.

{{IN|java}}, journeyman-level armorer villagers have a 40% chance of offering to buy one diamond for one emerald. Expert-level toolsmith villagers have {{frac|2|3}} chance of offering to buy one diamond for one emerald. Expert-level weaponsmith villagers always offer to buy one diamond for one emerald.

=== Repairing ===

Diamonds are the repair items for the diamond [[tier]] and [[armor material]], and thus can be used to [[item repair|repair]] the following items in an [[anvil]] or [[grindstone]]:
* {{ItemLink|Diamond Helmet}}
* {{ItemLink|Diamond Chestplate}}
* {{ItemLink|Diamond Leggings}}
* {{ItemLink|Diamond Boots}}
* {{ItemLink|Diamond Sword}}
* {{ItemLink|Diamond Pickaxe}}
* {{ItemLink|Diamond Axe}}
* {{ItemLink|Diamond Shovel}}
* {{ItemLink|Diamond Hoe}}

=== Beacons ===

Diamonds can be used to select powers from a [[beacon]]. The player must select one of the available powers then insert a diamond into the item slot. 

A diamond can be substituted for an [[iron ingot]], a [[gold ingot]], an [[emerald]] or a [[netherite ingot]].

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Diamond
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Diamond
|Diamond Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.<br/>
|tail=1
}}

;Trim color palette
The following color palettes are shown on the designs on trimmed armor:
*{{TrimPalette|diamond}}
*{{TrimPalette|diamond|darker=1}} (a darker color palette is used when a diamond armor piece is trimmed using a diamond).

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Diamond
|spritetype=item
|nameid=diamond
|itemtags=beacon_payment_items
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Diamond
|spritetype=item
|nameid=diamond
|id=304
|form=item
|foot=1}}

== Achievements ==

{{load achievements|DIAMONDS!;Diamonds to you!;Enchanter}}

== Advancements ==

{{load advancements|Diamonds!}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100128|[[File:Diamond JE1 BE1.png|32px]] Added diamonds. Initially, they were referred to as "emeralds".
|A stack of 100 diamonds can be found inside the  [[Indev house]] [[chest]]s.}}
{{History|||snap=20100129|Diamond can be used to craft [[diamond block]]s and diamond [[sword]]s, [[shovel]]s, [[pickaxe]]s and [[axe]]s.
|Diamonds can no longer be found inside the Indev House due to all items having been removed from its chests.
|Diamond can be obtained by smelting diamond blocks.}}
{{History|||snap=20100130|[[Emerald]]s from the previous version are now officially known as "diamonds", though this has no actual effect as item names are not yet displayed in-game.
|[[Diamond block]]s now require 9 diamonds (3×3) instead of 4 (2×2) to be [[crafting|crafted]], making them much more expensive.}}
{{History||20100206|Diamonds are now used to craft diamond [[hoe]]s.}}
{{History||20100212-1|Diamonds are now used to craft diamond [[helmet]]s, [[chestplate]]s, [[leggings]] and [[boots]].}}
{{History|java alpha}}
{{History||v1.0.14|Diamonds are now used to craft [[jukebox]]es.}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|Diamonds are now found in [[mineshaft]] [[chest]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[Diamond ore]] can now be [[smelting|smelted]] into diamonds.}}
{{History|||snap=Beta 1.9 Prerelease 3|Diamonds are now used to craft [[enchantment table]]s.
|Diamonds are now found in [[stronghold]] altar [[chest]]s.}}
{{History||1.1|snap=12w01a|Diamonds are now found in [[village]] [[villager|blacksmith]] [[chest]]s.}}
{{History||1.3.1|snap=12w21a|Diamonds can now be [[trading|traded]] to blacksmith [[villager]]s in quantities of 3–5 for 1 [[emerald]].
|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing diamonds.}}
{{History|||snap=12w21b|Diamonds have been changed in the game code from "emerald" to "diamond", due to actual [[emerald]]s being added. Diamond's original name during [[Indev]], as stated above, was emerald in the code, and was kept this way until this snapshot.}}
{{History|||snap=12w22a|Added [[jungle temple]]s, which contain loot [[chest]]s with diamonds.}}
{{History|||snap=1.3|[[File:Diamond JE2 BE2.png|32px]] The texture of diamonds has been changed.}}
{{History||1.4.6|snap=12w49a|Diamonds can now be used to [[crafting|craft]] a [[firework star]] with a trail.}}
{{History||1.6.1|snap=13w16a|Diamond is now used to craft diamond [[horse armor]].}}
{{History|||snap=13w18a|Diamond is no longer used to craft diamond [[horse armor]].|Diamonds are now found in [[nether fortress]] [[chest]]s.}}
{{History||1.8|snap=14w02a|Diamonds can now be [[traded]] to any black apron [[villager]] in quantities of 3–4 for 1 [[emerald]], as their tier III trade.}}
{{History||1.9|snap=15w31a|Diamonds now generate in [[end city]] [[chest]]s.}}
{{History|||snap=15w43a|The average yield of diamonds have been slightly decreased in [[nether fortress]] chests.}}
{{History|||snap=15w44a|The average yield of diamonds in [[desert temple]] and [[mineshaft]] chests have been decreased.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 264.}}
{{History|||snap=18w10a|Diamonds now generate in [[buried treasure]] [[chest]]s.}}
{{History|||snap=18w11a|Diamonds now generate in [[shipwreck]] treasure chests.}}
{{History||1.14|snap=18w43a|[[File:Diamond JE3 BE3.png|32px]] The texture of diamonds has been changed.}}
{{History|||snap=18w50a|Diamonds can now be found in [[chest]]s in [[village]] toolsmith houses.}}
{{History||1.16|snap=20w16a|Diamonds now generate in bastion remnants chests.}}
{{History||1.16.2|snap=20w30a|The chance of finding diamonds in bastion remnant chests is increased from 8.6% to 15.8%.}}
{{History||1.17|snap=21w08a|Diamonds can now drop and be smelted from [[deepslate diamond ore]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Diamonds can now be used to craft [[smithing template]]s.
|Diamonds can now be used as an armor trim material.}}
{{History|||snap=23w07a|Diamonds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s.}}
{{History||1.20|snap=23w12a|The probability for the diamond to generate in the [[suspicious sand]] in [[desert temple]] has been changed from 1/7 to 1/8.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Diamond JE1 BE1.png|32px]] Added diamonds. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.2|Diamonds can be collected and used to craft [[blocks of diamond]] and diamond [[axe]]s, [[pickaxe]]s, [[sword]]s and [[shovel]]s.}}
{{History||v0.4.0|Diamonds are now used to [[crafting|craft]] diamond [[hoe]]s.}}
{{History||v0.5.0|Diamonds are now used to craft [[nether reactor core]]s.}}
{{History||v0.6.0|Diamonds are now used to craft diamond [[armor]].}}
{{History||v0.8.0|snap=build 1|[[File:Diamond JE2 BE2.png|32px]] The texture of diamonds has been changed.}}
{{History||v0.12.1|snap=build 1|Diamonds are now used to craft [[enchanting table]]s.
|Diamonds are no longer used to craft [[nether reactor core]]s and are now instead dropped by it.
|Diamonds now generate in [[nether fortress]] [[chest]]s.}}
{{History||v0.13.0|snap=build 1|Diamonds now have a chance to generate in [[desert temple]] chests.}}
{{History||v0.14.0|snap=build 1|Diamonds are now found in [[minecart with chest]]s in [[mineshaft]]s.}}
{{History||v0.15.0|snap=build 1|Diamonds can now be found in [[jungle temple]] [[chest]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Diamonds can now be found in altar [[chest]]s in [[stronghold]]s, [[dungeon]] chests and [[end city]] chests.}}
{{History|||snap=alpha 1.0.0.0|Diamonds can now be found in [[villager|blacksmith]] [[chest]]s in [[village]]s.}}
{{History||1.0.4|snap=alpha 1.0.4.0|3-4 diamonds can now be traded to blacksmith [[villager]]s for an [[emerald]] as part of their third tier trades.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Diamonds can now be used to [[crafting|craft]] a [[firework star]] with a trail. 
|Diamonds can now be used to craft [[jukebox]]es.}}
{{History||1.4.0|snap=beta 1.2.14.2|Diamonds can now be found inside [[buried treasure]] [[chest]]s and [[shipwreck]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Diamonds can now be found in [[plains]] [[village]] weaponsmith chests.
|[[File:Diamond JE3 BE3.png|32px]] The texture of diamonds has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Diamonds can now be found in village toolsmith chests and in [[savanna]], [[desert]], [[taiga]], and [[snowy taiga]] village weaponsmith chests.}}
{{History|||snap=beta 1.11.0.4|Armorer, toolsmith, and weaponsmith [[villager]]s now [[trading|buy]] one diamond for an [[emerald]] as part of their fourth tier [[trading|trades]].}}
{{History||1.16.0|snap=beta 1.16.0.57|Diamonds can now be found in [[bastion remnant]] chests.}}
{{History||1.17.0|snap=beta 1.16.230.52|Diamonds can now drop and be smelted from [[deepslate diamond ore]].}}
{{History||1.20.0<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Diamonds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s.}}
{{History||1.20.0<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.21|Diamonds can now be used to craft [[smithing template]]s.
|Diamonds can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Diamond JE1 BE1.png|32px]] Added diamonds.}}
{{History||xbox=TU5|Diamonds are now found in the new [[mineshaft]] [[chest]]s.}}
{{History||xbox=TU7|Diamonds are now used to craft [[enchantment table]]s.}}
{{History||xbox=TU9|Diamonds are now found in [[village]] [[villager|blacksmith]] [[chest]]s.}}
{{History||xbox=TU14|ps=1.04|Diamonds can now be [[trading|traded]] to blacksmith [[villager]]s in quantities of 3–5 for 1 [[emerald]].
|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing diamonds.|Added [[jungle temple]]s, which contain loot [[chest]]s with diamonds.|[[File:Diamond JE2 BE2.png|32px]] The texture of diamonds has been changed.}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|Diamonds can now be used to [[crafting|craft]] a [[firework star]] with a trail|Diamonds are now found in the new [[nether fortress]] [[chest]]s.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Diamonds can now be [[traded]] to any black apron [[villager]] in quantities of 3–4 for 1 [[emerald]], as their tier III trade.}}
{{History||xbox=TU46|xbone=CU36|ps=1.36|wiiu=Patch 15|Diamonds now generate in [[end city]] [[chest]]s.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|Diamonds now generate in [[buried treasure]] [[chest]]s.|Diamonds now generate in [[shipwreck]] treasure chests.}}
{{History||xbox=none|ps=1.90|wiiu=none|[[File:Diamond JE3 BE3.png|32px]] The texture of diamonds has been changed.}}

{{History|new3DS}}
{{History||0.1.0|[[File:Diamond JE2 BE2.png|32px]] Added diamonds.}}
{{History|foot}}

==Issues==
{{issue list}}

==Trivia==
*Unlike in ''Minecraft'', newly mined [[Wikipedia:Diamond|diamond]]s in real life are rough, cloudy stones. The largest, purest ones are polished into crystal-clear gemstones, while the rest are used in industry for cutting and grinding.
*Although diamonds themselves are not renewable, all tools, weapons, and armor made from diamonds can be acquired through [[trading]], and are therefore renewable. Other items crafted from diamonds are not renewable.
*In the April fools version [[Java Edition 2.0]], [[Diamond Chicken|diamond chickens]] can lay diamonds. This does not exist in newer versions, as this was a joke.
*The item forms of diamonds and [[Turtle Egg|turtle eggs]] have the same shape.

==Gallery==
<gallery>
File:DiamondOre.png|Naturally occurring diamonds.
File:MultipleOreBlobs.png|Multiple ore blobs.
File:Lava Diamond.png|Diamond ore near Lava.
File:Diamond ore blob.png|Another Diamond ore blob near Lava.
File:10 ore diamond blob.png|10 ore diamond blob.
File:Trading a diamond for an emerald.png|A blacksmith offering an [[emerald]] for a diamond.
File:Diamond Pendant Necklace JINX.jpg|Official diamond pendant made by [https://www.jinx.com JINX].
File:All Mine JINX.jpg|Official t-shirt artwork "All Mine" which features a diamond. Made by JINX
File:4 ways of viewing 12 diamonds in stone form.png|4 ways of viewing 12 diamonds in stone form
</gallery>

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--diamond Taking Inventory: Diamond] – Minecraft.net on February 20, 2019

{{items}}

[[cs:Diamant]]
[[de:Diamant]]
[[el:Διαμάντι]]
[[es:Diamante]]
[[fr:Diamant]]
[[hu:Gyémánt]]
[[it:Diamante]]
[[ja:ダイヤモンド]]
[[ko:다이아몬드]]
[[nl:Diamant]]
[[pl:Diament]]
[[pt:Diamante]]
[[ru:Алмаз]]
[[th:เพชร]]
[[tr:Elmas]]
[[uk:Діамант]]
[[zh:钻石]]
[[Category:Non-renewable resources]]</li></ul>
Coordinates now appear on the debug screen.
Java Edition
1.13
{{Extension DPL}}<ul><li>[[Glass Bottle|Glass Bottle]]<br/>{{about|the empty bottle||Bottle}}

{{Item
| image = Glass Bottle.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''glass bottle''' is an [[item]] that can hold [[water]], [[potion]]s, [[Honey Bottle|honey]], or [[dragon's breath]].

== Obtaining ==

Glass bottles can be obtained by crafting, drinking from bottles, [[fishing]], or from [[witch]] drops.

=== Crafting ===

{{Crafting
|A2= Glass
|C2= Glass
|B3= Glass
|Output= Glass Bottle,3
|type= Brewing
}}

=== Drinking ===

Drinking a [[potion]] or [[Honey Bottle|honey bottle]] returns the empty glass bottle. Throwing a splash potion or a lingering potion does not return a glass bottle, but brewing a lingering potion gives back a glass bottle.

=== Mob loot ===

[[Witch]]es have a chance of dropping 0–6 glass bottles upon death. This is increased by 3 per level of [[Looting]], for a maximum of 0–15 glass bottles.

=== Mud ===

{{control|Using}} a [[water bottle]], [[splash water bottle]] or [[lingering water bottle]] on [[dirt]], [[coarse dirt]] or [[rooted dirt]] will transforming it into a [[mud]] block, at the same time leaving the player with an empty glass bottle.

=== Cauldrons ===

{{control|Using}} a water bottle (or, {{in|bedrock}}, a potion, splash potion, or lingering potion) on a [[cauldron]] that is not yet full adds that liquid to the cauldron, leaving the player with an empty glass bottle.

== Usage ==

Glass bottles can be filled to make [[water bottle]]s, which can then be used to [[brew]] items with a [[brewing stand]]. Glass bottles are also used to hold the resulting [[potion]].

=== Collecting liquids ===

==== Water ====
A bottle may be filled with water by holding it in the hand and {{control|using}} it on a [[water]] source block or a [[cauldron]] that has water in it. It can also be filled using a waterlogged block.{{only|java}}<ref>{{bug|MCPE-83420}}</ref>

Also, a bottle may be filled by powering a [[dispenser]] containing a bottle and pointed at a water source block. This does not work with cauldrons.<ref>{{bug|MC-165196|||Invalid}}</ref>

If filled via a water source, the water is unaffected. If filled via a cauldron, {{frac|1|3}} of the water in the cauldron is removed. Therefore, using a cauldron to fill water bottles is inefficient, except in [[the Nether]] where it is normally the only way to fill bottles.

==== Potion ====
{{IN|bedrock}}, a bottle may be filled with potion by {{control|using}} it on a [[cauldron]] containing potion. When the bottle is filled, {{frac|1|3}} of the cauldron's potion is removed.

==== Honey ====
If a [[beehive|bee nest]] or [[beehive]] is full, the player can {{control|use}} a glass bottle on the block, or may power a [[dispenser]] that contains a bottle and is pointed at the block, which empties the block and creates a [[honey bottle]]. Honey bottles can also be emptied by using them in crafting recipes (such as [[sugar]] or [[honey block]]). However, a lingering potion use on tipped arrow recipe does not give the bottle back.

==== Dragon's breath ====
{{control|Using}} a glass bottle in clouds emitted when the [[ender dragon]] breathes or shoots a [[dragon fireball]] fills the bottle with [[dragon's breath]].

When put 2 or more dragon's breath in the brewing stand, after the brewing process, a glass bottle will drop as an [[Item (entity)|entity]]. However, if put only 1 dragon's breath in the brewing stand, after the brewing process, the glass bottle is consumed and cannot be retrieved.<ref>{{bug|MC-259583}}</ref>

=== Trading ===

Expert-level cleric [[villager]]s have a 50% chance to buy 9 glass bottles for one [[emerald]] as part of their trade.{{only|bedrock}}

Expert-level cleric villagers have a {{frac|2|3}} chance to buy 9 glass bottles for one emerald.{{only|java}}

=== Crafting ingredients ===
{{Crafting usage|Glass Bottle}}

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|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 bottle is filled with a liquid from a cauldron, or honey from a bee nest or beehive
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with water from a water source
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=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 dragon breath1.ogg
|sound2=Bottle fill dragon breath2.ogg
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with dragon's breath
|id=item.bottle.fill_dragonbreath
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|java}}:
{{Sound table
|type=bedrock
|rowspan=4
|sound=Water Splash Old.ogg
|source=block
|description=When water from a bottle is placed in a cauldron<wbr><ref group=sound name=potionsplash>{{Bug|MCPE-174867}}</ref>
|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
|source=block
|description=When a bottle is filled with a potion from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.fillpotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a potion bottle is emptied into a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takepotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|source=sound<!--bottle-->
|description=When a bottle 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 bottle is filled<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.fill
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|source=block
|description=When a bottle is filled with honey from a bee nest or beehive<wbr><ref group=sound>{{Bug|MCPE-53881}}</ref>
|id=bucket.fill_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bottle fill dragon breath1.ogg
|sound2=Bottle fill dragon breath2.ogg
|source=sound
|description=When a bottle is filled with dragon's breath
|id=bottle.dragonbreath
|volume=0.7<wbr>{{Until|BE 1.20.40}}<br>1.0<wbr>{{Upcoming|BE 1.20.40}}
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Glass Bottle
|spritetype=item
|id=427
|nameid=glass_bottle
|form=item
|foot=1}}

== Achievements ==

{{Load achievements|You Need a Mint;Local Brewery;Bee Our guest}}

== Advancements ==
{{load advancements|Local Brewery;You Need a Mint;Bee Our Guest}}

== History ==
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History|||snap=Beta 1.9 Prerelease 3|[[File:Water Bottle JE1 BE1.png|32px]] Glass bottles have been given their sole function of picking up [[water]] for the [[brewing]] of [[potion]]s.}}
{{History||1.4.2|snap=12w38b|[[Witch]]es now have a chance of [[drops|dropping]] glass bottles upon [[death]].}}
{{history||1.9|snap=15w33a|[[File:Dragon's Breath JE1 BE1.png|32px]] Glass bottles can now be used to obtain [[dragon's breath]].}}
{{history|||snap=15w43a|A glass bottle can be found in the [[brewing stand]] in an [[igloo]] basement.}}
{{history|||snap=15w43c|The glass bottle has been removed from igloo basements.}}
{{History|||snap=15w50a|Added [[sound]]s: <code>item.bottle.fill</code> and <code>item.bottle.fill_dragonbreath</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 374.}}
{{History||1.14|snap=18w43a|[[File:Glass Bottle JE2 BE2.png|32px]] [[File:Water Bottle JE2 BE2.png|32px]] [[File:Dragon's Breath JE2 BE2.png|32px]] The textures of glass bottles, [[water bottle]]s and [[dragon's breath]] have been changed.}}
{{History|||snap=19w11a|Cleric [[villager]]s now [[trading|buy]] glass bottles.}}
{{History||1.15|snap=19w34a|[[File:Honey Bottle JE1.png|32px]] Glass bottles can now be used to collect [[Honey Bottle|honey]].
|[[Dispenser]]s may now use glass bottles to collect [[water]] and honey.}}
{{History|||snap=19w46a|Using glass bottles to collect honey now unlocks the [[Bee Our Guest]] advancement.}}
{{History||1.19|snap=22w11a|Converting [[dirt]], [[coarse dirt]] or [[rooted dirt]] into [[mud]] using a [[water bottle]], [[splash water bottle]] or [[lingering water bottle]] now leaves the player with an empty glass bottle.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History||v0.14.0|snap=build 1|Glass bottles can now be used to empty [[cauldron]]s filled with [[water]] or [[potion]]s.
|Glass bottles can now be dropped by [[witch]]es.
|Potions and [[splash potion]]s can now be used to fill cauldrons, which turns them into glass bottles.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Dragon's Breath JE1 BE1.png|32px]] Glass bottles can now be used to obtain [[dragon's breath]].
|[[Lingering potion]]s can now be used to fill [[cauldron]]s, which turns them into glass bottles.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Glass Bottle JE2 BE2.png|32px]] The texture of glass bottles has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Glass bottles can now be [[trading|sold]] to cleric [[villager]]s.}}
{{History||1.14.0|snap=beta 1.14.0.1|[[File:Honey Bottle BE1.png|32px]] Glass bottles can now be used to collect [[Honey Bottle|honey]].
|[[Dispenser]]s may now use glass bottles to collect [[water]] and honey.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History|PS4}}
{{History||1.90|[[File:Glass Bottle JE2 BE2.png|32px]] The texture of glass bottles has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History||1.7.10|[[File:Dragon's Breath JE1 BE1.png|32px]]  Glass bottles can now be used to obtain [[dragon's breath]].}}
{{history|foot}}

== Issues ==
{{issue list}}

==References==
{{Reflist}}

{{Items}}

[[cs:Lahvička]]
[[de:Glasflasche]]
[[es:Frasco de cristal]]
[[fr:Fiole]]
[[hu:Üvegpalack]]
[[it:Ampolla]]
[[ja:ガラス瓶]]
[[ko:유리병]]
[[nl:Glazen fles]]
[[pl:Szklana butelka]]
[[pt:Frasco]]
[[ru:Колба]]
[[zh:玻璃瓶]]
[[Category:Renewable resources]]</li><li>[[Dye|Dye]]<br/>{{Item
| title = Dyes
| image = White Dye.png
| extratext = View [[#Gallery|all renders]]
| renewable = Yes
| stackable = Yes (64)
}}
'''Dyes''' are a set of sixteen items used to change the color of [[wool]], [[carpet]]s, [[terracotta]], [[concrete powder]], [[glass]], [[shulker box]]es, [[bed]]s, [[candle]]s, the patterns on [[banner]]s, [[firework star]]s, certain mobs, and text on [[sign]]s and [[hanging sign]]s. {{IN|bedrock}} they can also be used to dye water in a [[cauldron]] (which is thereafter used to dye leather [[armor]]); {{in|java}} leather armor can be dyed directly. {{IN|education}} dyes can also be used to dye [[balloon]]s and [[glow stick]]s.

{{IN|bedrock|education}}, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa bean]]s can generally substitute for [[white dye]], [[black dye]], [[blue dye]], and [[brown dye]], respectively, in crafting recipes and for use in dyeing items or mobs. However, they have other important uses that aren't related to color, and are therefore not considered true dyes. They are mentioned in this article only in regard to their use as dyeing agents; see their individual articles for complete information about them.

[[File:Dye Recipes.png|400px|thumb|A guide for creating all the dyes]]

== Obtaining ==
<!--[[File:Dye Chart.png|350px|thumb|A guide to crafting all the dyes.{{until|java 1.14}}]]-->

Dyes can be produced by crafting them from plants (mainly flowers), by crafting dyes of different colors together, by smelting plants, or by trading with a [[wandering trader]].

{{loadPage|Crafting/Dye|Crafting|h3}}

=== Smelting ===
{{smelting|head=1|Sea Pickle|Lime Dye|0,2}}
{{smelting|foot=1|Cactus|Green Dye|1||b=Lapis Lazuli|c=Any fuel|d=1}}

=== Trading ===

[[Wandering trader]]s can sell 3 dyes for an [[emerald]]. {{IN|bedrock}}, they can also sell 3 lapis lazuli, bone meal, cocoa beans, or ink sacs for one emerald.

Apprentice-level cleric [[villager]]s sell one lapis lazuli per emerald.

=== Chest loot ===

{{#invoke:LootChest|base3|blue-dye,green-dye,orange-dye,light-blue-dye,yellow-dye,white-dye}}

=== Other ===

Ink sacs can also be created using 1 iron, 1 sulfur, and 4 oxygen in the [[compound creator]]. {{only|bedrock|education}}

== Usage ==

Similar to their use in crafting, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa beans]] can be substituted for the corresponding dye in any of the following usages unless otherwise specified.{{only|bedrock}} <!--- sections are ordered by craftable dyeable blocks, dyeable items, version exclusive sections, and non-crafting miscellaneous uses--->

=== Dyeing wool and mobs ===

Players can dye wool by placing [[wool]] and any dye in a crafting grid.

{{Crafting
|nocat=1
|Any Wool
|Matching Dye
|Output=Any Wool
}}

Dyes can be {{control|use|text=used}} on sheep to change the color of the wool. Shearing a colored sheep drops the corresponding color of the wool, and the sheep retains the color when the wool regenerates. [[Breeding]] colored sheep produces a lamb colored as one of the parent sheep, or a color resulting from the combination of both parents' color. The color combining follows the same rules that dyes use – red and yellow sheep produce an orange lamb, but a blue and yellow sheep cannot create a green lamb. The unlimited reproduction of colored sheep makes dyeing and shearing sheep infinitely more efficient than just dyeing wool directly.
 
Dye can also be used on a tamed [[wolf]] or [[cat]] to change the color of its collar from the default red to the color of the dye.

=== Dyeing carpets ===

Carpets can be dyed.

{{Crafting
 |Any Carpet
 |Matching Dye
 |Output= Matching Carpet
 |type= Building block
}}

=== Dyeing terracotta ===

[[Terracotta]] can be dyed by placing 8 blocks around a dye on a crafting table.

{{Crafting
|nocat=1
|A1=Terracotta |B1=Terracotta |C1=Terracotta
|A2=Terracotta |B2=Matching Dye  |C2=Terracotta
|A3=Terracotta |B3=Terracotta |C3=Terracotta
|Output=Matching Dyed Terracotta,8
}}

=== Creating concrete powder ===

Dyes can also be used to craft [[concrete powder]], which can then be set into their respective [[concrete]] blocks (they cannot be dyed directly).

{{Crafting
|nocat=1
|Sand |Gravel |Sand
|Gravel |Matching Dye |Gravel
|Sand |Gravel |Sand
|Output=Matching Concrete Powder,8
}}

=== Staining glass ===

[[Stained glass]] can be stained by placing 8 blocks of glass around a dye on a [[crafting table]]. Just like regular glass, stained glass can be crafted into stained glass panes. The recipe for this is the same as with regular glass.

{{Crafting
|nocat=1
|A1=Glass |B1=Glass        |C1=Glass
|A2=Glass |B2=Matching Dye |C2=Glass
|A3=Glass |B3=Glass        |C3=Glass
|Output=Matching Stained Glass,8
|head=1
}}
{{Crafting
|nocat=1
|A1= Glass Pane
|B1= Glass Pane
|C1= Glass Pane
|A2= Glass Pane
|B2= Matching Dye
|C2= Glass Pane
|A3= Glass Pane
|B3= Glass Pane
|C3= Glass Pane
|Output= Matching Stained Glass Pane,8
|type= Decoration block
|foot=1
}}

=== Dyeing shulker boxes ===

[[Shulker box]]es are generated in a light shade of purple (like the [[purpur block]]), but can be dyed any color. They can also be re-dyed as often as desired.

{{Crafting
  |ignoreusage=1
  |showname=1
  |Any Shulker Box
  |Matching Dye
  |Output=Matching Shulker Box
}}

=== Dyeing beds ===

Players can dye beds by placing a [[bed]] and any color dye in a crafting grid.

{{Crafting
|nocat=1
|Any Bed
|Matching Dye
|Output=Matching Bed
}}

=== Dyeing candles ===

Players can dye [[candles]] by placing an undyed candle and any color dye in a crafting grid.

{{Crafting
|ignoreusage=1
|Candle
|Matching Dye
|Output=Matching Dyed Candle
}}

=== Banner patterns ===
{{main|Banner#Patterns}}

Dyes are used in most banner patterns to determine the pattern and color displayed.

=== Dyeing armor ===

[[File:DyeGraph2.png|200px|thumb|A graph showing all combinations of two dyes on a [[tunic]].]]

Leather [[armor]] can be dyed by:
* Crafting dyes with a piece of leather armor or leather [[horse armor]].{{Only|java}}
* Dousing the leather armor or leather [[horse armor]] in a [[cauldron]] to which dyes have been added.{{Only|bedrock}}

There are 5,713,438<ref>https://anrar4.github.io/DyeLeatherArmor/</ref> (34.1% of sRGB) colors leather armor can be, as it is possible to put more than one dye on the crafting bench alongside the leather armor. Armor can be dyed multiple times with previous colors affecting the final outcome. Colored armor can be reverted to their original color using a [[cauldron]] with undyed water.

The game has a specific formula for calculating the color of dyed armor: each color, in the RGB color model, has a red value, green value, and blue value. For each dye in the crafting grid, and the armor itself (if it is already dyed), the red, green, and blue values are added to running totals. In addition, a running total of the highest value (be it red, green, or blue) is also kept. After this, each total is divided by the number of colors used. This effectively produces the average red, green, blue, and maximum values. The maximum value of the average RGB values is also calculated. Finally, each average RGB value is multiplied by the average maximum value and divided by the maximum of the average RGB values. The modified average RGB values are then used as the final color. This procedure can be summed up with the following equations:
 for each color (all "total" variables start at 0 before counting):
  totalRed = totalRed + redValue
  totalGreen = totalGreen + greenValue
  totalBlue = totalBlue + blueValue
  totalMaximum = totalMaximum + max(redValue, greenValue, blueValue)
  numberOfColors = numberOfColors + 1
 
 averageRed = totalRed / numberOfColors
 averageGreen = totalGreen / numberOfColors
 averageBlue = totalBlue / numberOfColors
 averageMaximum = totalMaximum / numberOfColors
 
 maximumOfAverage = max(averageRed, averageGreen, averageBlue)
 gainFactor = averageMaximum / maximumOfAverage
 
 resultRed = averageRed * gainFactor
 resultGreen = averageGreen * gainFactor
 resultBlue = averageBlue * gainFactor

Due to the way this formula works, the resulting color can never be darker than the average of the input colors and is often lighter and more saturated. Of course, the resulting color can never be lighter or more saturated than the lightest or most saturated input color. In addition, this formula never creates an RGB value higher than 255 (which would be invalid in the 8-bit RGB color model).

If leather armor is renamed on an [[anvil]], it retains its name when dyed or undyed.

;Mixing Samples
: {{ItemSprite|Yellow Dye}} + {{ItemSprite|Yellow Dye}} = {{Tint|leather-chestplate| #{{CalcDye| yellow=2 }} | code=1}}
: {{ItemSprite|Red Dye}} + {{ItemSprite|Blue Dye}} + {{ItemSprite|White Dye}} = {{Tint|leather-chestplate| #{{CalcDye| red=1 | blue=1 | white=1}} | code=1}}
: {{ItemSprite|Green Dye}} + {{ItemSprite|Red Dye}} + {{ItemSprite|Pink Dye}} = {{Tint|leather-chestplate| #{{CalcDye| green=1 | red=1 | pink=1}} | code=1}}

=== Dyeing firework stars ===

A [[firework star]] can have a single color or a combination of up to eight colors when crafted with dyes. Adding one or more dyes to a crafted firework star adds a "fade to color" effect to it, overwriting any existing fade colors.

{{Crafting
  |head=1
  |ignoreusage=1
  |ingredients=[[Gunpowder]] +<br>Any Dye (1–8) +<br>Extra ingredient (optional)
  |Gunpowder
  |Matching Dye
  |Diamond;Glowstone Dust;Head;Gold Nugget;Feather;Fire Charge;
  |Output=Matching Firework Star
}}
{{Crafting
  |ignoreusage=1
  |Matching Firework Star
  |Any Dye
  |Output=Matching Firework Star
  |foot=1
}}

=== Creating balloons ===

Dye can be used to craft balloons.{{only|education}}

{{Crafting
|nocat=1
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
}}

=== Creating glow sticks ===

Dye can also be used to craft glow sticks.{{only|education}}

{{Crafting
|nocat=1
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= Matching Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
}}

=== Dyeing water inside cauldrons ===
Water can be dyed in a cauldron by holding any dye in the hand and pressing {{Ctrl|use}} on a cauldron filled with water.{{only|bedrock}}

=== Signs ===
Dye can be {{control|used}} on a [[sign]] or a [[hanging sign]] to change the text color. {{IN|bedrock}}, [[ink sac]]s cannot be used for this purpose; black dye must be used to change the text to black.

=== Trading ===
Apprentice, journeyman and expert-level shepherd [[villager]]s buy any of the 12 dyes for an [[emerald]].

== Color values ==
The "color codes" are used to determine the color imparted on sheep, wolf and cat collars, firework stars, [[beacon]] beams, and dyed leather armor. The hex value is shown in the extended tooltips of dyed leather armor; however, to set the color using an NBT data tag in a [[command]], the decimal value must be used instead. The color values for firework stars are slightly different from the ones listed below, and use [[Item colors#Firework stars|these values]] instead.

{| class="wikitable" style="margin:2px; border: 1px solid silver; text-align: left;" data-description="Data values"
! rowspan=2 | Description
! colspan=2 style="text-align:center" | Color Code
|-
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
|-
| style="text-align:center" | White || 16383998 || {{color|#F9FFFE}}
|-
| style="text-align:center" | Light gray || 10329495 || {{color|#9D9D97}}
|-
| style="text-align:center" | Gray || 4673362 || {{color|#474F52}}
|-
| style="text-align:center" | Black || 1908001|| {{color|#1D1D21}}
|-
| style="text-align:center" | Brown || 8606770 || {{color|#835432}}
|-
| style="text-align:center" | Red || 11546150 || {{color|#B02E26}}
|-
| style="text-align:center" | Orange || 16351261 || {{color|#F9801D}}
|-
| style="text-align:center" | Yellow || 16701501 || {{color|#FED83D}}
|-
| style="text-align:center" | Lime || 8439583 || {{color|#80C71F}}
|-
| style="text-align:center" | Green || 6192150 || {{color|#5E7C16}}
|-
| style="text-align:center" | Cyan || 1481884|| {{color|#169C9C}}
|-
| style="text-align:center" | Light blue || 3847130 || {{color|#3AB3DA}}
|-
| style="text-align:center" | Blue || 3949738 || {{color|#3C44AA}}
|-
| style="text-align:center" | Purple || 8991416 || {{color|#8932B8}}
|-
| style="text-align:center" | Magenta || 13061821 || {{color|#C74EBD}}
|-
| style="text-align:center" | Pink || 15961002 || {{color|#F38BAA}}
|}

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Dye.ogg
|subtitle=Dye stains
|source=block
|description=When dye is used on a [[sign]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16}}
{{Sound table
|subtitle=Dye stains
|source=player
|description=When dye is used on a [[sheep]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Dye.ogg
|source=sound
|description=When dye is used on a sign
|id=sign.dye.use
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=3
|sound=Water Splash Old.ogg
|source=block
|description=When dye is added to a cauldron
|id=cauldron.adddye
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When armor is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When dye is removed from armor using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0
|foot=1}}

== Achievements ==
{{load achievements|Rainbow Collection;Tie dye outfit}}

== Video ==

{{Video note|These videos are outdated, as it does not include details of the [[Java Edition 1.7.2|1.7.2]] update's changes to the dyeing system/production chain.}}

<div style="text-align:center">
<span style="display:inline-block">{{yt|8YD7oauNZHE}}</span>
<span style="display:inline-block">{{yt|7tETaRt7STM}}</span>
</div>

== History ==
{{History|java beta}}
{{History||January 3, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/2582321901/2011-here-we-go|Notch mentions adding a "paint" feature if he can figure out how.}}
{{History||January 10, 2011<ref group="n">Supposed time when fragment was filmed. Based on modified date of client.jar/gui/trap.png in [[Beta 1.2]].</ref>|link=https://www.youtube.com/watch?v=cBF2ugTzXqQ&t=181s|[[File:Red Dye (pre-release).png|32px]] Shown rose red in development as part of [[Minecraft: The Story of Mojang]].}}
{{History||1.2|[[File:Ink Sac JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Bone Meal JE1 BE1.png|32px]] Added dyes.
|[[File:Black Dye (Recreated).png|32px]] [[File:Red Dye (pre-release).png|32px]] [[File:Green Dye (Recreated).png|32px]] [[File:Brown Dye (Recreated).png|32px]] [[File:Blue Dye (Recreated).png|32px]] [[File:Purple Dye (Recreated).png|32px]] [[File:Cyan Dye (Recreated).png|32px]] [[File:Light Gray Dye (Recreated).png|32px]] [[File:Gray Dye (Recreated).png|32px]] [[File:Pink Dye (Recreated).png|32px]] [[File:Lime Dye (Recreated).png|32px]] [[File:Yellow Dye (Recreated).png|32px]] [[File:Light Blue Dye (Recreated).png|32px]] [[File:Magenta Dye (Recreated).png|32px]] [[File:Orange Dye (Recreated).png|32px]] [[File:White Dye (Recreated).png|32px]] Leftovers of old textures can be seen in [[items.png]] with 100% opacity. The white dye texture was reused for [[Sugar]].
| The colors were as follows:{{verify|Did the color codes remain the same between Beta 1.2 and Java 1.11.2?}}
{{:Color/Java Edition dye colors before 17w06a}}
}}
{{History|java}}
{{History||1.1|snap=11w49a|[[Sheep]] can now regrow their [[wool]] by eating [[grass block|grass]]. Dyed sheep regrow wool in their new color.}}
{{History||1.3.1|snap=12w19a|[[File:Cocoa Beans JE2.png|32px]] The texture of [[cocoa beans]] has been changed.}}
{{History|||snap=1.3|[[File:bone meal changes.gif|32px]] The textures of [[bone meal]], [[cactus green]], cocoa beans and [[rose red]] have been changed. The textures have been lowered one pixel.}}
{{History||1.4.2|snap=12w34a|Added the ability to dye leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.4|snap=1.4.3|Color codes have been changed. The colors of red, brown, blue, purple, cyan, pink, light blue, magenta and orange were adjusted a little vividly.}}
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted using dyes.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary dyes.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted using dyes.}}
{{History||1.8|snap=14w02a|As cleric [[villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
{{History|||snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.9|snap=15w34a|Added [[shield]]s, which can be dyed indirectly by applying a matching [[banner]].}}
{{History||1.11|snap=16w39b|Dyes are now used to change the color of [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Dyes are now used to craft [[concrete powder]].
|Color codes have been changed. All colors are adjusted more vividly. The changes were as follows:
{{:Color/Java Edition dye color changes in 17w06a}}
|Light blue dye, stained glass, and stained glass panes, did not change colors in this update. This means that they still use old colors.<ref name="unchanged dyes">{{Bug|MC-214643}}<br>{{Bug|MC-214641}}</ref>
}}
{{History|||snap=17w15a|Dyes can now apply color to white [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.}}
{{History||1.14|snap=18w43a|[[Bone meal]], [[ink sac]]s, [[cocoa beans]] and [[lapis lazuli]] are no longer considered dyes.
|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]] and [[blue dye]]s.
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively. 
|[[Glass pane]]s and [[carpet]]s can now be dyed.
|[[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of light gray, gray, red, orange, yellow, lime, green, cyan, light blue, purple, magenta, and pink dyes, have been changed. The color texture for light blue dye was not changed to reflect the updated colors from 1.12.<ref name="unchanged dyes"></ref>}}
{{History|||snap=18w44a|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=18w49a|Yellow dyes can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=18w50a|Green dyes can now be found in [[chest]]s in [[desert]] [[village]] houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which can sell any type of dye.}}
{{History|||snap=19w11a|All 16 types of dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.16.2|snap=Pre-release 2|Reversed the order of dyes to match other colored items in the [[Creative inventory]].<ref name="reverse dye">{{Bug|MC-136553}}</ref>
|Regrouped dyes in the Creative inventory such that white, blue, brown, and black dyes are within and not [[cocoa beans]], [[ink sacs]], [[lapis lazuli]], and [[bone meal]].<ref name="regroup dye">{{Bug|MC-177684}}</ref>}}
{{History||1.17|snap=20w45a|Added [[candle]]s, which can be dyed.}}
{{History|||snap=21w03a|Added a sound for applying dyes.}}
{{History|||snap=21w19a|Candles can no longer be dyed.}}
{{History|||snap=Pre-release 1|Candles can now once again be dyed.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|The color of the text on [[hanging sign]]s can now be changed with dye.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[Torchflower]]s can now be crafted into orange dye.|[[Pink petals]] can now be crafted into pink dye.}}
{{History||1.20|snap=23w12a|[[Pitcher plant]]s can now be crafted into cyan dye.|Blue, light blue, orange, white, and yellow dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w14a|Pitcher plants can now craft two [[cyan dye]] instead of one.}}
{{History|||snap=23w16a|Blue, light blue, orange, white, and yellow 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, light blue, orange, white, and yellow dye now are in the common loot.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes. Only [[dandelion yellow]] and [[lapis lazuli]] are currently obtainable and have functionality.}}
{{History||v0.3.2|[[Cactus green]] is now obtainable by smelting [[cacti]].}}
{{History||v0.3.3|[[Bone meal]] is now obtainable via [[crafting]].}}
{{History||v0.4.0|[[Cyan dye]], [[light blue dye]], [[lime dye]], [[magenta dye]], [[orange dye]], [[pink dye]], and [[purple dye]] are now obtainable via crafting.
|[[Rose red]] is now obtainable by smelting red [[mushroom]]s.
|All available dyes, excluding bone meal, can now be used to craft their respective [[wool]] color.}}
{{History||v0.8.0|snap=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History|||snap=build 3|[[Ink sac]]s, [[cocoa bean]]s, [[gray dye]], and [[light gray dye]] are now available in the [[creative]] [[inventory]].
|Rose red can now be obtained from [[beetroot]]s.}}
{{History||v0.9.0|snap=build 1|Cocoa beans can now be obtained from [[cocoa pod]]s.
|The [[rose]] has been removed and replaced with a new poppy [[flower]] that can be crafted into rose red.}}
{{History|||snap=build 3|All new [[flower]]s can now be [[crafting|crafted]] into dyes. Because of this, many secondary and tertiary dyes are now primary dyes.
|[[Gray dye]] and [[light gray dye]] can now be obtained in [[survival]].}}
{{History|||snap=build 11|[[Terracotta|Stained clay]] can now be crafted using dyes.}}
{{History||v0.11.0|snap=build 1|[[Ink sac]]s can now be obtained from [[squid]].
|Added the ability to dye [[wolf]] collars.}}
{{History||v0.12.1|snap=build 1|Red [[mushroom]]s can no longer be smelted to obtain [[rose red]].}}
{{History||v0.14.0|snap=build 1|[[Cauldron]]s now used for leather dyeing, by applying a dye to a [[water]]-filled cauldron.}}
{{History||v0.16.0|snap=build 1|[[Cocoa bean]]s can no longer be crafted.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added a ''Dye'' button for [[sheep]].
|Added [[shulker]]s, which can be dyed.
|Added [[stained glass]]. Stain glass cannot be [[crafting|crafted]], but purple glass generates in [[end city|end cities]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Dyes can now apply color to a white [[bed]]s.
|Dyes are now used to craft [[concrete powder]].
|The color palette has been changed.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Dyes can now be used for [[banner]] crafting.
|Dyes can now be used to craft [[firework star]]s.
|[[Stained glass]] is now [[crafting|craftable]], using dyes.}}
{{History||1.4.0|snap=beta 1.2.20.1|[[Lime dye]] can now be obtained from smelting [[sea pickle]]s.
|Dyes can now used to craft [[glow stick]]s and [[balloon]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Dyes can now be used to dye [[cat]] collars.}}
{{History|||snap=beta 1.8.0.10|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[brown dye|brown]], [[black dye|black]] and [[blue dye]]s, which can be crafted from [[lapis lazuli]], [[bone meal]], [[cocoa beans]] and [[ink sac]]s. This, however, the later four still use as dyes.<ref>{{Bug|MCPE-42473}}</ref>
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||1.9.0|snap=beta 1.9.0.0|Blue and white dye can now be obtained from [[cornflower]]s and [[lily of the valley]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Glass pane]]s and [[carpet]]s can now be dyed.
|Only a single dye is now required to apply a banner pattern in a [[loom]].
|Various dyes except black dye, white dye, brown dye and blue dye are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE3 BE3.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.210|snap=beta 1.16.210.59|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=beta 1.16.210.60|The ability to dye the color of the text on [[sign]]s was temporarily removed.}}
{{History||1.16.220|snap=beta 1.16.220.50|The color of the text on [[sign]]s can now be changed with dye again.}}
{{History||1.17.10|snap=beta 1.17.10.22|Added [[candles]], which can be dyed.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes.}}
{{History||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]], and [[blue dye|blue]] dyes, which can crafted from [[bone meal]], [[ink sac]], [[cocoa beans]], and [[lapis lazuli]].
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||ps=1.90|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History|3ds}}
{{History||0.1.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE3 BE2.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes from [[Pocket Edition v0.15.4 alpha]].}}
{{History|foot}}
<gallery>
Pre-release dyes.png|Pre-release dye textures hidden within [[Items.png]].
</gallery>
;Notes
{{reflist|group=n}}

== Gallery ==
<gallery>
White Dye.png|White Dye
Light Gray Dye.png|Light Gray Dye
Gray Dye.png|Gray Dye
Black Dye.png|Black Dye
Brown Dye.png|Brown Dye
Red Dye.png|Red Dye
Orange Dye.png|Orange Dye
Yellow Dye.png|Yellow Dye
Lime Dye.png|Lime Dye
Green Dye.png|Green Dye
Cyan Dye.png|Cyan Dye
Light Blue Dye.png|Light Blue Dye
Blue Dye.png|Blue Dye
Purple Dye.png|Purple Dye
Magenta Dye.png|Magenta Dye
Pink Dye.png|Pink Dye
</gallery>

==Issues==
{{issue list}}

== Trivia ==
* Players can obtain each one of every color with 1 cocoa bean, 2 yellow dye, 2 ink sac, 3 green dye, 4 lapis lazuli, 4 red dye, and 6 bone meal (2 bones).
* The dyed sheep breeding behavior mirrors [[wikipedia:Lamarckism|Lamarck's theory]], in which the organisms evolve inheriting the external changes and adaptations of the previous generation, transmitting them to their offspring.
* In ''Bedrock Edition'', tertiary colors, along with their regular crafting recipes, can be crafted with primary colors. E.g.: Magenta can be crafted with one rose red and two bone meals.
* The colors of the dyes match the chat colors in [[color codes]] except for brown (dye only), light aqua, and gold (color codes only).
* The texture for light blue dye still uses the color from prior to the 1.12 World of Color update.<ref name="unchanged dyes"></ref>

== References ==
{{reflist}}

== External Links ==
* Tools for calculating leather dye combination: [https://minecraft.tools/en/armor.php minecraft.tools] (webapp); [https://github.com/pudquick/pyMCdyes/ pyMCDyes] (open-source Python script, outdated); [https://anrar4.github.io/DyeLeatherArmor/ DyeLeatherArmor]: a tool for calculating an exact crafting recipe for any sRGB color

{{Items}}

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

[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li></ul>
17w50aLocal coordinates can now be specified in commands using ^.
Pocket Edition Alpha
v0.16.0
{{Extension DPL}}<ul><li>[[:Category:Minecraft Earth items|Category:Minecraft Earth items]]<br/>All items in ''[[Minecraft Earth]]''.
[[Category:Items]]
[[Category:Minecraft Earth|Items]]</li><li>[[Smithing Template|Smithing Template]]<br/>{{for|the block|Smithing Table}}
{{Item
| title = Smithing Template
| image = <gallery>
Netherite Upgrade Smithing Template.png | Netherite Upgrade
Sentry Armor Trim Smithing Template.png | Armor Trim
</gallery>
| rarity = Rare
| renewable = No<!--Smithing templates are not renewable because diamonds, their only other method of creation, are not renewable.-->
| stackable = Yes (64)
}}
'''Smithing templates''' are items used in [[Smithing Table|smithing tables]] to alter [[Tool|tools]] and [[armor]]. They are consumed when used, but can be [[Crafting|duplicated]] using an existing template, its material and [[Diamond|diamonds]].

The sixteen '''armor trim smithing templates''' are found in a variety of [[Generated structures|structures]], and are used to apply various decorative trims (dependent on the variant) to armor using certain minerals for different colors.

'''Netherite upgrade smithing templates''' are required to upgrade diamond equipment with a [[Netherite Ingot|netherite ingot]]. They are only found in [[Bastion Remnant|bastion remnants]], but are guaranteed only in [[:en:Bastion_Remnant#Treasure_room|treasure rooms]].

== Obtaining ==
Smithing templates can be found in various [[Generated structures|structures]] and can be duplicated by using seven diamonds and a block based on what the template is.

=== Crafting ===
{{Crafting
|A1=Diamond |B1=Matching Smithing Template                                                                                                                           |C1=Diamond
|A2=Diamond |B2=Netherrack;Cobblestone;Sandstone;End Stone;Terracotta;Terracotta;Netherrack;Cobblestone;Terracotta;Cobbled Deepslate;Blackstone;Purpur Block;Prismarine;Cobblestone;Cobbled Deepslate;Terracotta;Mossy Cobblestone |C2=Diamond
|A3=Diamond |B3=Diamond                                                                                                                                              |C3=Diamond
|Output=Matching Smithing Template,2
}}

{| class="article-table"
|+ Duplication 
! Item !! Material
|-
| {{ItemSprite|netherite-upgrade|text=Netherite Upgrade}} || {{BlockSprite|Netherrack|text=Netherrack}}
|-
| {{ItemSprite|sentry-armor-trim|text=Sentry Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|vex-armor-trim|text=Vex Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|wild-armor-trim|text=Wild Armor Trim}} || {{BlockSprite|Mossy Cobblestone|text=Mossy Cobblestone}}
|-
| {{ItemSprite|coast-armor-trim|text=Coast Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|dune-armor-trim|text=Dune Armor Trim}} || {{BlockSprite|Sandstone|text=Sandstone}}
|-
| {{ItemSprite|wayfinder-armor-trim|text=Wayfinder Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|raiser-armor-trim|text=Raiser Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|shaper-armor-trim|text=Shaper Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|host-armor-trim|text=Host Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|ward-armor-trim|text=Ward Armor Trim}} || {{BlockSprite|Cobbled Deepslate|text=Cobbled Deepslate}}
|-
| {{ItemSprite|silence-armor-trim|text=Silence Armor Trim}} || {{BlockSprite|Cobbled Deepslate|text=Cobbled Deepslate}}
|-
| {{ItemSprite|tide-armor-trim|text=Tide Armor Trim}} || {{BlockSprite|Prismarine|text=Prismarine}}
|-
| {{ItemSprite|snout-armor-trim|text=Snout Armor Trim}} || {{BlockSprite|Blackstone|text=Blackstone}}
|-
| {{ItemSprite|rib-armor-trim|text=Rib Armor Trim}} || {{BlockSprite|Netherrack|text=Netherrack}}
|-
| {{ItemSprite|eye-armor-trim|text=Eye Armor Trim}} || {{BlockSprite|End Stone|text=End Stone}}
|-
| {{ItemSprite|spire-armor-trim|text=Spire Armor Trim}} || {{BlockSprite|Purpur Block|text=Purpur Block}}
|}

{{IN|bedrock}}, spire, tide, and dune armor trims can be duplicated with more blocks than {{in|java}}. In addition to the normal blocks, Tide armor trims can be duplicated using Prismarine Bricks or Dark Prismarine, dune armor trims can be duplicated with smooth sandstone, cut sandstone, or chiseled sandstone, and spire armor trims can be duplicated with purpur pillars.<ref>{{bug|MCPE-172711||Tide, Spire, and Dune Armor Trims can be crafted from more blocks than in Java Edition}}</ref>

=== Mob loot ===
[[Elder guardian]]s have a 20% chance to drop 1 tide armor trim upon death. [[Looting]] doesn't affect this percentage, and the elder guardian doesn't need to be killed by a player in order for the trim to drop and can be duplicated with [[prismarine]].

=== Chest loot ===
{{#invoke:LootChest|base3|netherite-upgrade-smithing-template,sentry-armor-trim-smithing-template,vex-armor-trim-smithing-template,wild-armor-trim-smithing-template,coast-armor-trim-smithing-template,dune-armor-trim-smithing-template,ward-armor-trim-smithing-template,silence-armor-trim-smithing-template,snout-armor-trim-smithing-template,rib-armor-trim-smithing-template,eye-armor-trim-smithing-template,spire-armor-trim-smithing-template}}
Note: In Woodland Mansions, only chests with random loot have the chance to contain the Vex Smithing Template, chests in the "Allium room", "Sapling farm", "Tree-chopping room" and "Fake End portal room" always generate with the same, room specific, loot.

=== Suspicious block loot ===
Items can only be extracted from [[Suspicious Block|suspicious blocks]] using a [[brush]].{{#invoke:LootChest|base3|wayfinder-armor-trim-smithing-template,raiser-armor-trim-smithing-template,shaper-armor-trim-smithing-template,host-armor-trim-smithing-template}}

== Usage ==
=== Crafting ingredient ===
{{Crafting
|A1=Diamond |B1=Matching Smithing Template                                                                                                                           |C1=Diamond
|A2=Diamond |B2=Netherrack;Cobblestone;Sandstone;End Stone;Terracotta;Terracotta;Netherrack;Cobblestone;Terracotta;Cobbled Deepslate;Blackstone;Purpur Block;Prismarine;Cobblestone;Cobbled Deepslate;Terracotta;Mossy Cobblestone |C2=Diamond
|A3=Diamond |B3=Diamond                                                                                                                                              |C3=Diamond
|Output=Matching Smithing Template,2
}}

=== Smithing ingredient ===
Smithing templates are used at a [[smithing table]]. Netherite upgrade smithing templates are used to upgrade diamond gear into netherite gear by using a netherite upgrade, a piece of diamond gear, and a [[netherite ingot]]. 

{{Smithing
|head=1
|ingredients=Netherite Upgrade +<br>Any Diamond Gear +<br>[[Netherite Ingot]]
|Netherite Upgrade
|Diamond Helmet; Diamond Chestplate; Diamond Leggings; Diamond Boots; Diamond Sword; Diamond Pickaxe; Diamond Axe; Diamond Shovel
|Netherite Ingot
|Netherite Helmet; Netherite Chestplate; Netherite Leggings; Netherite Boots; Netherite Sword; Netherite Pickaxe; Netherite Axe; Netherite Shovel
|tail=1
}}

{{FakeImage|{{Animate|Iron_Armor_with_Iron_Shaper_Trim.png; Golden_Armor_with_Golden_Shaper_Trim.png; Diamond_Armor_with_Diamond_Shaper_Trim.png; Netherite_Armor_with_Netherite_Shaper_Trim.png|180px}}|If the armor material and the trimming material are the same, the color palette used for the armor trim is darker.}}
Armor trim smithing templates are used to customize an armor piece's appearance by using a smithing template, an armor piece, and an ingot or crystal ([[emerald]], [[redstone dust]], [[lapis lazuli]], [[amethyst shard]], [[nether quartz]], [[netherite ingot]], [[diamond]], [[gold ingot]], [[iron ingot]], or [[copper ingot]]). Including all dyed leather armor colors and regular armor, there are ≈3.679x10<sup>9</sup> different possible armor pieces<!--5713438 leather colors, plus the 4 other armor materials = 5713442. 5713442 * 161 (the 160 trim combos (16 trims, 10 materials) + untrimmed) = 919864162. 919864162 * 4 (helmet, chestplate, leggings, boots) = 3679456648 ≈ 3.679x10^9-->, and 7.16x10<sup>35</sup> <!--919864162 + 1 (no armor in that slot) = 919864163. 919864163^4 = 715969952015045562662444917041515536 ≈ 7.16x10^35 total possible armor combinations-->total possible armor combinations excluding enchantments and the player not wearing armor.

Already trimmed armor can be trimmed again by applying another template on it; the old trim pattern is overwritten in the process.<ref>{{bug|MC-262538||When combining armor trims the new trim deletes the old one|WAI}}</ref> Therefore, one piece of armor cannot possess multiple trims at the same time.

Most armor trims cover a small portion of the armor piece's surface with the trim material, except for the silence armor trim, which allows the trim material to cover a majority of the armor piece's surface.

All of the trims are purely decorative, and don't impact gameplay or strength(without the use of mods or plugins) of the armor they are applied to in any way. [[Piglin]]s do not pick up any gold-trimmed armor pieces, and they are not pacified by players wearing even a full set of gold-trimmed armor (unless, of course, the armor pieces in question are themselves golden), and netherite-trimmed armor pieces can still be burned by [[fire]].

{{Smithing
|head=1
|ingredients=Any Armor Trim +<br>Any Armor Piece +<br>Any Ingot/Crystal
|Any Armor Trim Smithing Template
|Iron Helmet; Netherite Chestplate;Golden Leggings;Diamond Boots
|Amethyst Shard; Copper Ingot; Diamond; Emerald; Gold Ingot; Iron Ingot; Lapis Lazuli; Nether Quartz; Netherite Ingot; Redstone Dust; Diamond; Emerald
|Amethyst Trim Iron Helmet; Copper Trim Netherite Chestplate; Diamond Trim Golden Leggings; Emerald Trim Diamond Boots; Gold Trim Iron Helmet; Iron Trim Netherite Chestplate; Lapis Trim Golden Leggings; Quartz Trim Diamond Boots; Netherite Trim Iron Helmet; Redstone Trim Netherite Chestplate; Diamond Trim Golden Leggings; Emerald Trim Diamond Boots
|tail=1
}}

;List of color palettes for all materials
*{{ItemSprite|emerald         }} - {{TrimPalette| emerald         }}
*{{ItemSprite|redstone dust   }} - {{TrimPalette| redstone dust   }}
*{{ItemSprite|lapis lazuli    }} - {{TrimPalette| lapis lazuli    }}
*{{ItemSprite|amethyst shard  }} - {{TrimPalette| amethyst shard  }}
*{{ItemSprite|nether quartz   }} - {{TrimPalette| nether quartz   }}
*{{ItemSprite|netherite ingot }} - {{TrimPalette| netherite ingot }} (Darker: {{TrimPalette| netherite ingot |darker=1}})
*{{ItemSprite|diamond         }} - {{TrimPalette| diamond         }} (Darker: {{TrimPalette| diamond         |darker=1}})
*{{ItemSprite|gold ingot      }} - {{TrimPalette| gold ingot      }} (Darker: {{TrimPalette| gold ingot      |darker=1}})
*{{ItemSprite|iron ingot      }} - {{TrimPalette| iron ingot      }} (Darker: {{TrimPalette| iron ingot      |darker=1}})
*{{ItemSprite|copper ingot    }} - {{TrimPalette| copper ingot    }}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Smithing Template
|showforms=y
|generatetranslationkeys=y
|displayname=Netherite Upgrade
|spritename=netherite-upgrade-smithing-template
|spritetype=item
|nameid=netherite_upgrade_smithing_template
|form=item}}
{{ID table
|displayname=Sentry Armor Trim
|spritename=sentry-armor-trim-smithing-template
|spritetype=item
|nameid=sentry_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Vex Armor Trim
|spritename=vex-armor-trim-smithing-template
|spritetype=item
|nameid=vex_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Wild Armor Trim
|spritename=wild-armor-trim-smithing-template
|spritetype=item
|nameid=wild_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Coast Armor Trim
|spritename=coast-armor-trim-smithing-template
|spritetype=item
|nameid=coast_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Dune Armor Trim
|spritename=dune-armor-trim-smithing-template
|spritetype=item
|nameid=dune_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Wayfinder Armor Trim
|spritename=wayfinder-armor-trim-smithing-template
|spritetype=item
|nameid=wayfinder_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Raiser Armor Trim
|spritename=raiser-armor-trim-smithing-template
|spritetype=item
|nameid=raiser_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Shaper Armor Trim
|spritename=shaper-armor-trim-smithing-template
|spritetype=item
|nameid=shaper_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Host Armor Trim
|spritename=host-armor-trim-smithing-template
|spritetype=item
|nameid=host_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Ward Armor Trim
|spritename=ward-armor-trim-smithing-template
|spritetype=item
|nameid=ward_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Silence Armor Trim
|spritename=silence-armor-trim-smithing-template
|spritetype=item
|nameid=silence_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Tide Armor Trim
|spritename=tide-armor-trim-smithing-template
|spritetype=item
|nameid=tide_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Snout Armor Trim
|spritename=snout-armor-trim-smithing-template
|spritetype=item
|nameid=snout_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Rib Armor Trim
|spritename=rib-armor-trim-smithing-template
|spritetype=item
|nameid=rib_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Eye Armor Trim
|spritename=eye-armor-trim-smithing-template
|spritetype=item
|nameid=eye_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Spire Armor Trim
|spritename=spire-armor-trim-smithing-template
|spritetype=item
|nameid=spire_armor_trim_smithing_template
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Smithing Template
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Netherite Upgrade
|spritename=netherite-upgrade-smithing-template
|spritetype=item
|nameid=netherite_upgrade_smithing_template
|id=685
|form=item
|translationkey=item.smithing_template.name, upgrade.netherite_upgrade.name}}
{{ID table
|displayname=Sentry Armor Trim
|spritename=sentry-armor-trim-smithing-template
|spritetype=item
|nameid=sentry_armor_trim_smithing_template
|id=686
|form=item
|translationkey=item.smithing_template.name, trim_pattern.sentry.name}}
{{ID table
|displayname=Vex Armor Trim
|spritename=vex-armor-trim-smithing-template
|spritetype=item
|nameid=vex_armor_trim_smithing_template
|id=692
|form=item
|translationkey=item.smithing_template.name, trim_pattern.vex.name}}
{{ID table
|displayname=Wild Armor Trim
|spritename=wild-armor-trim-smithing-template
|spritetype=item
|nameid=wild_armor_trim_smithing_template
|id=689
|form=item
|translationkey=item.smithing_template.name, trim_pattern.wild.name}}
{{ID table
|displayname=Coast Armor Trim
|spritename=coast-armor-trim-smithing-template
|spritetype=item
|nameid=coast_armor_trim_smithing_template
|id=688
|form=item
|translationkey=item.smithing_template.name, trim_pattern.coast.name}}
{{ID table
|displayname=Dune Armor Trim
|spritename=dune-armor-trim-smithing-template
|spritetype=item
|nameid=dune_armor_trim_smithing_template
|id=687
|form=item
|translationkey=item.smithing_template.name, trim_pattern.dune.name}}
{{ID table
|displayname=Wayfinder Armor Trim
|spritename=wayfinder-armor-trim-smithing-template
|spritetype=item
|nameid=wayfinder_armor_trim_smithing_template
|id=698
|form=item
|translationkey=item.smithing_template.name, trim_pattern.wayfinder.name}}
{{ID table
|displayname=Raiser Armor Trim
|spritename=raiser-armor-trim-smithing-template
|spritetype=item
|nameid=raiser_armor_trim_smithing_template
|id=699
|form=item
|translationkey=item.smithing_template.name, trim_pattern.raiser.name}}
{{ID table
|displayname=Shaper Armor Trim
|spritename=shaper-armor-trim-smithing-template
|spritetype=item
|nameid=shaper_armor_trim_smithing_template
|id=700
|form=item
|translationkey=item.smithing_template.name, trim_pattern.shaper.name}}
{{ID table
|displayname=Host Armor Trim
|spritename=host-armor-trim-smithing-template
|spritetype=item
|nameid=host_armor_trim_smithing_template
|id=701
|form=item
|translationkey=item.smithing_template.name, trim_pattern.host.name}}
{{ID table
|displayname=Ward Armor Trim
|spritename=ward-armor-trim-smithing-template
|spritetype=item
|nameid=ward_armor_trim_smithing_template
|id=690
|form=item
|translationkey=item.smithing_template.name, trim_pattern.ward.name}}
{{ID table
|displayname=Silence Armor Trim
|spritename=silence-armor-trim-smithing-template
|spritetype=item
|nameid=silence_armor_trim_smithing_template
|id=697
|form=item
|translationkey=item.smithing_template.name, trim_pattern.silence.name}}
{{ID table
|displayname=Tide Armor Trim
|spritename=tide-armor-trim-smithing-template
|spritetype=item
|nameid=tide_armor_trim_smithing_template
|id=693
|form=item
|translationkey=item.smithing_template.name, trim_pattern.tide.name}}
{{ID table
|displayname=Snout Armor Trim
|spritename=snout-armor-trim-smithing-template
|spritetype=item
|nameid=snout_armor_trim_smithing_template
|id=694
|form=item
|translationkey=item.smithing_template.name, trim_pattern.snout.name}}
{{ID table
|displayname=Rib Armor Trim
|spritename=rib-armor-trim-smithing-template
|spritetype=item
|nameid=rib_armor_trim_smithing_template
|id=695
|form=item
|translationkey=item.smithing_template.name, trim_pattern.rib.name}}
{{ID table
|displayname=Eye Armor Trim
|spritename=eye-armor-trim-smithing-template
|spritetype=item
|nameid=eye_armor_trim_smithing_template
|id=691
|form=item
|translationkey=item.smithing_template.name, trim_pattern.eye.name}}
{{ID table
|displayname=Spire Armor Trim
|spritename=spire-armor-trim-smithing-template
|spritetype=item
|nameid=spire_armor_trim_smithing_template
|id=696
|form=item
|translationkey=item.smithing_template.name, trim_pattern.spire.name
|foot=1}}

== Achievements ==
{{load achievements|Smithing with style}}

== Advancements ==
{{load advancements|Crafting a New Look;Smithing with Style}}

== Video ==
{{yt|klP9SrJFDU8}}

== History ==
{{History|java}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|[[File:Netherite Upgrade Smithing Template JE1 BE1.png|32px]] [[File:Sentry Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Vex Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Wild Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Coast Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Dune Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Ward Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Tide Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Snout Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Rib Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Eye Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Spire Armor Trim Smithing Template JE1 BE1.png|32px]] Added smithing templates behind the "Update 1.20" experimental datapack.}}
{{History|||snap=23w05a|Smithing templates can be used to trim leather armor.
|Gold, iron, diamond, and netherite armor can be trimmed with their respective material.
|The dune, coast, wild, and sentry armor trims now always generate two templates in a chest when found.
|Increased the chances for all smithing templates that generate in chest loot to spawn:
*Netherite upgrade chance to find increased from 3.2% to 10%.
*Coast chance to find increased from 11.1% to 16.7%.
*Dune chance to find increased from 11.1% to 14.3%.
*Eye chance to find increased from 4.7% to 10% in alter chests, and to 100% in library chests.
*Rib chance to find increased from 4.7% to 6.7%.
*Sentry chance to find increased from 20% to 25%.
*Snout chance to find increased from 4.7% to 8.3%.
*Spire chance to find increased from 4.7% to 6.7%.
*Vex chance to find increased from 4.7% to 50%.
*Ward chance to find increased from 4.7% to 5%.
*Wild chance to find increased from 20% to 33%.}}
{{History||1.20|snap=23w12a|Smithing templates are now available without using the "Update 1.20" experimental datapack.|[[File:Wayfinder Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Raiser Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Shaper Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Host Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Silence Armor Trim Smithing Template JE1 BE1.png|32px]] Added wayfinder, raiser, shaper, host, and silence armor trim smithing templates.
|[[File:Sentry Armor Trim Smithing Template JE2 BE2.png|32px]] [[File:Dune Armor Trim Smithing Template JE2 BE2.png|32px]] Changed the textures of the sentry and dune armor trim smithing templates.
|The pattern textures of dune and sentry armor trims are changed from [[File:Armor Trim Dune (sample model) JE1 BE1.png|24px]] [[File:Armor Trim Sentry (sample model) JE1 BE1.png|24px]] to [[File:Armor Trim Dune (sample model) JE2 BE2.png|24px]] [[File:Armor Trim Sentry (sample model) JE2 BE2.png|24px]].<br>
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}
{{History|||snap=23w16a|Wayfinder, raiser, shaper, and host armor trim 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]]; wayfinder, raiser, shaper, and host armor trim now are in the rare loot.}}
{{History|||snap=23w17a|The probability of the wayfinder, raiser, shaper, and host armor trim to generate in [[suspicious gravel]] in [[trail ruins]] has been changed from 1/11 to 1/12.|The player now get the [[advancement]] "Crafting a new look" when they craft a trimmed armor at a [[smithing table]] using a smithing template, "Smithing with style" when they apply these smithing templates at least once on their armor: Spire, Snout, Rib, Ward, Silence, Vex, Tide, and Wayfinder.}}

{{History|bedrock}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.21|[[File:Netherite Upgrade Smithing Template JE1 BE1.png|32px]] [[File:Sentry Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Vex Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Wild Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Coast Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Dune Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Ward Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Tide Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Snout Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Rib Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Eye Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Spire Armor Trim Smithing Template JE1 BE1.png|32px]] Added smithing templates behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.}}
{{History|||snap=beta 1.19.80.22|[[File:Wayfinder Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Raiser Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Shaper Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Host Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Silence Armor Trim Smithing Template JE1 BE1.png|32px]] Added wayfinder, raiser, shaper, host, and silence armor trim smithing templates.
|[[File:Sentry Armor Trim Smithing Template JE2 BE2.png|32px]] [[File:Dune Armor Trim Smithing Template JE2 BE2.png|32px]] Changed the textures of the sentry and dune armor trim smithing templates.
|The pattern textures of dune and sentry armor trims are changed from [[File:Armor Trim Dune (sample model) JE1 BE1.png|24px]] [[File:Armor Trim Sentry (sample model) JE1 BE1.png|24px]] to [[File:Armor Trim Dune (sample model) JE2 BE2.png|24px]] [[File:Armor Trim Sentry (sample model) JE2 BE2.png|24px]].<br>
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}
{{History||1.20.0|snap=beta 1.20.0.21|Smithing templates are now available without using the "Next Major Update" experimental toggle.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Smithing templates were named "Smithing Blueprints" in the prototype but was changed because the word "blueprint" sounded modern and technical.<ref>{{ytl|klP9SrJFDU8|Minecraft 1.20: Armor Trims - What Do They Mean?|Minecraft|May 4, 2023|t=98}}</ref>
* When Mojang developer Gnembon was working on armor trims, he accidentally messed up their rendering, making them jet through the player's body in a weird fashion, similar to what appears in {{w|Salvador Dalí}}'s paintings where a hand might poke through a forehead.<ref>{{ytl|ghQODkq4ITI|Mojang Dev Comes To Hermitcraft! (Mojang Developer Gnembom Interview)|GoodVodsWithScar|June 23, 2023|t=1980}}</ref>
* Some of the armor trims feature patterns based on a [[mob]] or [[block]] that is found in the same [[Generated structures|structure]] as the corresponding smithing template.<ref name=":0">"Some of the armor trims reflect the place where you found the template, for example bastions contain a piglin-inspired trim."-[[Sofia Dankis]]-{{Mcnet|armor-trims-coming-minecraft-1-20|Armor Trims Coming to Minecraft 1.20|January 24, 2023}}</ref>
** The spire armor trim resembles a [[shulker]].
** The vex armor trim resembles an [[evoker]]. As an item in the [[inventory]], it resembles the wing or the vein texture of a [[vex]].
** The wild armor trim has moss growing on 3 of its corners.
** The coast armor trim appears to have barnacles attached to it.
** The ward armor trim, as an item in the inventory, resembles the faces inside a [[warden]]'s chest.
** The silence armor trim appears to have sculk creeping onto / infecting it.
** The tide armor trim resembles [[Prismarine|prismarine bricks]].
** The snout armor trim resembles a [[piglin]]<ref name=":0" />.
** The rib armor trim resembles a [[wither skeleton]].
** The eye armor trim resembles an [[eye of ender]]. There are also two eyes on the head part of the armor trim that resemble those of an [[enderman]].
* ''Netherite upgrade smithing template'' (35 characters with "_" and 32 characters without "_") and ''sentry armor trim smithing template'' (35 characters with "_" and 31 characters without "_") are the current longest name for item ID, while ''[[polished blackstone pressure plate]]'' and ''[[cracked polished blackstone bricks]]'' have 34 characters with "_" and 31 characters without "_".
* The silence armor trim is the rarest trim, due to being found in ancient cities in the deep dark, and having only a 1.2% chance to be per chest.
* When [[lapis lazuli]] is used as trim material, it is called "Lapis" instead of its full name "Lapis Lazuli"; this is the only instance of the abbreviation "Lapis" being used in-game.<ref>{{bug|MC-262486|||WAI}}</ref>

== Gallery ==
=== Sprites ===
<gallery>
Netherite Upgrade Smithing Template.png|Netherite Upgrade
Sentry Armor Trim Smithing Template.png|Sentry Armor Trim
Vex Armor Trim Smithing Template.png|Vex Armor Trim
Wild Armor Trim Smithing Template.png|Wild Armor Trim
Coast Armor Trim Smithing Template.png|Coast Armor Trim
Dune Armor Trim Smithing Template.png|Dune Armor Trim
Wayfinder Armor Trim Smithing Template.png|Wayfinder Armor Trim
Raiser Armor Trim Smithing Template.png|Raiser Armor Trim
Shaper Armor Trim Smithing Template.png|Shaper Armor Trim
Host Armor Trim Smithing Template.png|Host Armor Trim
Ward Armor Trim Smithing Template.png|Ward Armor Trim
Silence Armor Trim Smithing Template.png|Silence Armor Trim
Tide Armor Trim Smithing Template.png|Tide Armor Trim
Snout Armor Trim Smithing Template.png|Snout Armor Trim
Rib Armor Trim Smithing Template.png|Rib Armor Trim
Eye Armor Trim Smithing Template.png|Eye Armor Trim
Spire Armor Trim Smithing Template.png|Spire Armor Trim
</gallery>

=== Armor trim patterns ===
<gallery>
Armor Trim Sentry (sample model).png|Sentry Armor Trim
Armor Trim Vex (sample model).png|Vex Armor Trim
Armor Trim Wild (sample model).png|Wild Armor Trim
Armor Trim Coast (sample model).png|Coast Armor Trim
Armor Trim Dune (sample model).png|Dune Armor Trim
Armor Trim Wayfinder (sample model).png|Wayfinder Armor Trim
Armor Trim Raiser (sample model).png|Raiser Armor Trim
Armor Trim Shaper (sample model).png|Shaper Armor Trim
Armor Trim Host (sample model).png|Host Armor Trim
Armor Trim Ward (sample model).png|Ward Armor Trim
Armor Trim Silence (sample model).png|Silence Armor Trim
Armor Trim Tide (sample model).png|Tide Armor Trim
Armor Trim Snout (sample model).png|Snout Armor Trim
Armor Trim Rib (sample model).png|Rib Armor Trim
Armor Trim Eye (sample model).png|Eye Armor Trim
Armor Trim Spire (sample model).png|Spire Armor Trim
</gallery>

=== Official Artwork ===
<gallery>
T&T Thumbnail.jpg|[[Sunny]] wearing amethyst armor trims.
Warden Chasing Alex with Silence Trim Pixel Art.png|A [[warden]] chasing Alex holding the silence armor trim.
Alex Trimming Armor in Smithing Table Pixel Art.png|Alex adding the silence armor trim and amethyst on iron armor.
Alex Wearing Iron Armor with Amethyst Pixel Art.jpg|Alex wearing the trimmed iron armor.
File:Live2023-01.jpeg|Noor working on trimmed iron armor.
</gallery>

=== Screenshots ===
<gallery>
Kingbdogz Armor Trim 1.jpg|Redstone trims on diamond armor.
Kingbdogz Armor Trim 2.jpg|Gold trims on netherite armor.
Too Many Trims.jpg|A large amount of armor trims.
Kingbdogz Armor Trim 3.jpg|Gold on netherite.
Kingbdogz Armor Trim 4.jpg|Diamond on diamond.
New Armor Trims in 23W12A.jpg|<ref>{{Tweet|kingbdogz|1638580472962850831|new trims got the drip The new "Silence" armor trim to the left is now the hardest trim to get, with only a 1% chance per chest to spawn in Ancient Cities. Definitely gonna be a challenge to get!|March 22, 2023}}</ref>
Emerald Armor.png|Emerald on gold.
Xilefian Armor Trims 1.png|[[Xilefian]] showing how armor trims work.
Xilefian Armor Trims 2.png|[[Xilefian]] showing how armor trims work.
Xilefian Armor Trims 3.png|[[Xilefian]] showing how armor trims work.
Armor Trims On Netherite Armors.png|A display of all eleven (before [[Java Edition 23w12a]]) armor trims and ten colors on netherite armors.
Armor Trim Showcase.png|A display of all eleven (before [[Java Edition 23w12a]]) armor trims, on netherite armor using emerald as the trim material.
Armor Trim Colors.png|A display of all ten armor trim colors, using the ward trim on a netherite helmet.
Silence Armor Trim on All Armors.png|A display of all ten colors of the silence armor trim on all armors.
Image 2023-06-07 154100087.png|A screenshot of every armor trim in every color(besides quartz) on leather armor.
Armor Trim Friends.jpg|Official screenshot of [[Alex]] and [[Zuri]] wearing armor trims.
LadyAgnes Armor Trims.jpg|Copper trims on netherite armor.
Trim Lineup.jpg
Fancy Delta.jpg|[[Kai]] wearing trimmed armor in a [[Basalt Delta]].
Trims & Pots.jpg
Noor Gold Armor Trim .jpeg
Noor Diamond Armor Trim.jpeg
Noor Netherite Armor Trim.jpeg
Noor Iron Armor Trim.jpeg
</gallery>

== References ==
{{Reflist}}

{{Items}}

[[Category:Bedrock Edition]]
[[Category:Non-renewable resources]]

[[de:Schmiedevorlage]]
[[es:Molde de herrería]]
[[fr:Modèle de forge]]
[[ja:鍛冶型]]
[[pl:Szablon kowalski]]
[[pt:Molde de ferraria]]
[[ru:Кузнечный шаблон]]
[[uk:Ковальський шаблон]]
[[zh:锻造模板]]</li></ul>
?Added coordinates as a world toggle.
Bedrock Edition
1.2.0
{{Extension DPL}}<ul><li>[[Gray Dye|Gray Dye]]<br/>{{Item
| image = Gray Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Gray dye'''{{fn|Known as '''Grey Dye''' in British, Canadian, Australian, and New Zealand English variants.}} is a [[Dyeing#Secondary colors|secondary color]] dye.

== Obtaining ==

=== Crafting ===

{{Crafting
  |Black Dye
  |White Dye
  |Output=Gray Dye,2
  |type=Material
  |head=1
  |showdescription=1
  |showname=0
}}
{{Crafting
  |Ink Sac;Black Dye;Ink Sac
  |Bone Meal;Bone Meal;White Dye
  |Output=Gray Dye,2
  |type=Material
  |description={{only|bedrock|education}}
  |foot=1
}}

=== Trading ===

[[Wandering trader]]s sell 3 gray dye for an [[emerald]].{{only|bedrock}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===
Journeyman-level villagers have a 20% chance to buy 12 gray dye for an emerald.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|aliasid=dye / 8
|id=403
|form=item
|translationkey=item.dye.gray.name
|foot=1}}

== Video ==
{{yt|wGalHy0_fj0}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{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|Gray dye can be now [[crafting|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|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary [[dye]]s.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|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|Gray dye is now [[crafting|crafted]] using [[black dye|black]] and [[white dye]]s, instead of [[ink sac]] and [[bone meal]].
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History|||snap=18w44a|Gray dye can now change the text color on the [[sign]]s to gray.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell gray dyes.}}
{{History|||snap=19w11a|Gray dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Gray dye can now used to craft [[gray candle]]s.}}
{{History|||snap=21w19a|Gray dye can no longer be used to craft gray candles.}}
{{History|||snap=Pre-release 1|Gray dye can once again be used to craft gray candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Gray dye can now change the text color on [[hanging sign]]s to gray.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.8.0|snap=build 1|Gray dye can be [[craft]]ed with [[bone meal]] and an [[ink sac]], despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Gray dye is now available in [[creative]] mode.}}
{{History||v0.9.0|snap=build 3|Gray dye can now be obtained in [[survival]] mode.}}
{{History|||snap=build 11|Gray dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Gray dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Gray dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gray dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gray dye can now be used to craft [[concrete powder]], colored [[bed]]s and dyed [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gray dye can now be used to craft [[firework star]]s, [[stained glass]] and patterns on [[banner]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Gray dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Gray dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Gray dye is now [[trading|sold]] by [[wandering trader]]s.
|Gray dye can now be used to dye white [[carpet]]s and undyed [[glass pane]]s.
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of gray dye has been changed from <code>dye/8</code> to <code>gray_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|PS4}}
{{History||1.90|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Notes ==
{{fnlist}}

== References ==
{{Reflist}}

{{Items}}

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

[[cs:Šedé barvivo]]
[[de:Grauer Farbstoff]]
[[es:Tinte gris]]
[[fr:Teinture grise]]
[[hu:Szürke festék]]
[[ja:灰色の染料]]
[[ko:회색 염료]]
[[nl:Grijze kleurstof]]
[[pl:Szary barwnik]]
[[pt:Corante cinza]]
[[ru:Серый краситель]]
[[zh:灰色染料]]</li><li>[[Minecart|Minecart]]<br/>{{about|the rideable minecart in Minecraft|other uses|Minecart (disambiguation)|}}
{{distinguish|Minecraft}}
{{ItemEntity
|image=Minecart.png
|renewable=Yes
|stackable=No
|size=Height: 0.7 Blocks<br>Width: 0.98 Blocks
|networkid='''[[JE]]''': 10
|drops={{ItemLink|Minecart}} (1)
|health={{hp|6}}
}}
A '''minecart''' is a train-like vehicle [[entity]] that runs on [[Rail (disambiguation)|rail]]s.

== Obtaining ==

Minecarts can be retrieved by {{control|attack|text=attacking}} them for some time. Minecarts can also be retrieved with one attack from a [[pickaxe]] provided the player's attack cooldown is reset. A minecart is also destroyed if it makes contact with a [[cactus]], or if shot with a [[bow]] and arrow.

=== Crafting ===

{{Crafting
|A2= Iron Ingot
|C2= Iron Ingot
|A3= Iron Ingot
|B3= Iron Ingot
|C3= Iron Ingot
|Output= Minecart
|type= Transportation
}}

=== Entity loot ===
[[Minecart with command block]]s can be given to the player with the {{cmd|/give}} command or through the creative inventory under certain conditions{{only|java}}; [[minecart with spawner]]s{{only|java}} are available only via the {{cmd|/summon}} command. Each drop 1 minecart when broken.

== Usage ==
[[File:RideableMinecart.png|thumb|right|A rideable minecart on rails surrounded by wood slabs]]

A minecart can be placed in the same manner as most blocks but can be placed only on top of a [[rail]]. Once placed, it may be derailed by pushing it off the end of the track. After this, it can be railed again by placing a rail directly below it or pushing it onto a track.

=== Crafting ingredient ===

{{crafting usage}}

=== Transportation ===
[[File:Steve Riding a Minecart.png|thumb|right|upright|[[Steve]] riding a minecart]]
{{see also|Transportation|Riding}}

Minecarts can be ridden by {{control|use|text=pressing the "use" control}} on them. Once inside, an external impulse may be needed to make the minecart start moving. The player can slowly move the minecart forward while riding it, by pressing {{control|forward}}. If a mob walks in front of an empty minecart, it is pulled into the cart.

After rolling off of the end of a track, a minecart can be pushed around on open blocks. If a minecart is pushed onto or falls onto tracks, it "snaps" to those tracks. When riding a minecart, if the minecart lands on a rail, the player does not take any fall damage. <!--Minecarts and arrows don't interact anymore.-->

Unlike with [[bed]]s, there is no message above the hotbar for attempting to enter a fully occupied minecart.<ref>{{Cite bug|MC|161251|Attempting to enter an occupied bed displays a message over the hotbar, but attempting to enter an occupied vehicle does not|date=September 18, 19|resolution=Works as Intended}}</ref>

=== Dismounting ===
Players can exit the minecart by pressing {{control|sneak}}. When a player or mob dismounts a minecart, either by choice, by breaking the minecart, or by passing over an [[activator rail]], the minecart tries to find a safe ejection destination one block away. First it checks the eight horizontally adjacent blocks in the following order of priority relative to direction of travel: right, left, rear right, rear left, front right, front left, rear, front. A valid destination has a block underneath with a solid (not necessarily full) top surface and a space with enough headroom and width for the passenger to fit in when standing at the center. The space can even contain liquid or have open trapdoors if the mob is slim enough, and presence of other mobs doesn't matter. If no valid destination exists on same horizontal level, the minecart then checks the blocks one above, then one below. For a player, the minecart also checks for crawlable destinations. If still none, the minecart chooses its own location. Once the minecart picks a destination, it actually ejects the passenger one block up in the air and the passenger settles down on its own. Under a low ceiling this may cause one tick of suffocation damage. The air drop exists to allow passengers to land on carpet or bottom slabs.

== Behavior ==

=== Speed ===

Minecarts have a predefined speed limit of exactly 8 blocks per second. However, this speed limit does not change the minecart's speed value but instead limits how far a minecart can travel each tick to 0.4 blocks. Therefore, a minecart moving from powered rail to normal rail will move at constant speed for some time until decelerating because its internal speed value is over its speed limit of 8.

[[Powered rail]]s powered by redstone give minecarts a boost of speed. Speed is gradually decreased (due to drag) if there are no powered rails to assist its movement, and an unpowered powered rail slows down a minecart rapidly. The speed decreases at a faster rate when going uphill, compared to when moving horizontally. A minecart does not need powered rails to assist its movement down a hill.
<!-- Is this comparison to real-life physics necessary? - One unit of kinetic energy could be defined as the energy gained by a cart going down a one-block slope and lost by a cart when it goes up a one-block slope. If a 45-degree downward slope is connected directly into an upward slope, an initial height of 60 blocks results in a final height of 40 blocks, a loss of 20 units of potential energy. But if 20 sections of flat track are inserted between the slopes, the final height is 35. This implies that one unit of energy is lost for every 4 sections of horizontal track traveled with an initial stored energy of between 60 and 40. At much lower speeds, much less energy is lost, implying that the energy lost is a percentage of the cart's current energy. The above gives about 0.5% energy loss per section of track. One implication of this is that more energy lost when the cart has more energy, so a gradual slope should allow you to travel much farther distances than a steep slope followed by a long flat section. (This is different from real-life physics, where friction does not increase with velocity. However, it may be an attempt to mirror air resistance, which ''does'' increase with velocity.) -->

Anything in the way of the minecart brings it to a stop. Once a minecart has left the track, it rapidly decelerates within one or two blocks. When mobs touch a minecart, they affect it in the same way a player would, i.e. mobs that move up against a still cart set it in motion.

If a minecart is moving fast enough, it can skip across one block without a track and reattach to track on the other side, at significantly reduced energy and speed. A minecart's hitbox can skip turns if the minecart is boosted using enough powered rails.<ref>{{Cite bug|MC|179971|Minecart skips turns if too fast|date=April 22, 2020}}</ref>

The speed and momentum of a minecart can differ depending on whether or not it is empty, and in the case where a minecart has a container, the speed can differ depending on the quantity and type of items inside.

=== Merged minecarts ===

{{IN|java}}, two or more minecarts can be merged by pushing them into each other so that they overlap. Merged minecarts move as a collective, like a train, and can be useful for long-distance transport because while moving in a straight line, they ''do not need powered rails to keep their speed''.

To summarize:
* Minecarts can also be merged by ''dropping'' a minecart on another minecart.
* Merged minecarts do not lose speed while traveling on straight rails
* ''Corners'' in the rails might cause merged minecarts to unmerge.
* Minecarts with ''chest'' (even fully filled) can also be merged and also do ''not'' require powered rails.

=== Distance traveled by empty carts starting on a downward slope ===

This table shows the distance traveled by an unoccupied minecart on a downward slope, with a boost (or no boost). The most efficient way is to use only 1 boost at the bottom of the incline on the flat surface. Using 2 increases distance by about 20% or 1.5 blocks. All distance trends based on the height seem to be logarithmic.
The carts started from rest, on a slope Height blocks up.

{| class="wikitable" data-description="Distance traveled"
|-
! Height !! No Boost !! Bottom !! Bottom and Top !! All boosts on incline and bottom
|-
| 1 || 2.77m || 8.77 || 10.8 || 10.8
|-
| 2 || 4.59m || 9.59 || 10.83 || 13.37
|-
| 3 || 5.81m || 9.81 || 11.66 || 15.12
|-
| 4 || 7.04m || 10.04 || 12.46 || 16.95
|-
| 5 || 7.87m || 10.87 || 12.29<!--(Yes, it did actually travel less)--> || 17.95
|-
| 10 || 11.65m || 13.38 || 15.12 || 21.68
|-
| 100 || 15.87m || 17.05 || 17.54 || 25.34
|}

=== Collision ===

Minecarts are about the same size as a block (1×1). Because of this, a ladder, door, or trapdoor prevents it from falling down a 1×1 hole. Carts on [[rail]]s also ignore collision in certain situations. A cart traveling uphill, downhill, or on a curve with a block placed in front of it, goes through the block.<ref>{{Cite bug|MC|8004|Minecarts glitch through the stop block of a track that ends with a turn or a downward slope|date=January 20, 2013}}</ref>

A minecart that reaches the end of a rail up against an opaque solid block bounces back, but if the block is transparent then it stops. The minecart can even bounce against an opaque block from a standstill if the rail underneath is powered. A player or mob riding in a minecart does not collide with or suffocate in any transparent blocks but suffocates inside opaque blocks.

Minecarts are completely unaffected by [[ice]], [[packed ice]], and [[blue ice]]<ref>{{Cite bug|MC|8265|Minecarts don't slide on any sort of ice|date=January 25, 2013}}</ref>; they can also be destroyed by coming in contact with [[lava]] or [[fire]].

=== Mobs ===
{{missing information|section|some other mobs that cannot be picked up by minecarts}}
[[File:Minecart shake.gif|thumb|right|Minecart shaking due to being on top of an activator rail.]]
Mobs can ride minecarts, but cannot control them. Mobs cannot exit the minecart unless the minecart is destroyed or moves onto an active [[activator rail]].<ref>{{bug|MC-3866||Endermen, Tamed Wolves and Ocelots cannot teleport when in a Minecart|WAI}}</ref> However, {{in|bedrock}}, [[endermen]] are able to teleport out of minecarts.<ref>{{bug|MCPE-31761||Endermen can still teleport out of the boats and minecarts}}</ref>

A mob can ride a minecart when pushing by a moving minecart on rails {{in|java}} or when colliding with a minecart {{in|bedrock}}. It is easier to pick up a mob when a minecart is turning. {{IN|bedrock}}, [[armor stand]]s can also be picked up.

Most mobs can be picked up by minecarts, except [[ender dragon]]s, [[warden]]s, and [[wither]]s. {{IN|java}}, [[iron golem]]s cannot be picked up either.

A [[jockey]] riding a minecart automatically accelerates the minecart.<ref>{{bug|MC-71998||Minecarts that have passengers within them riding mobs can move automatically when not on rails}}</ref> Mobs in minecarts don't despawn, and don't count towards the mob cap.{{only|java}}<ref>{{bug|MC-182897||Some passenger mobs don't count to the mob cap|WAI}}</ref>

=== Boats ===
{{exclusive|java|section=yes}}
{{UsesBug|section=yes}}
Due to the bug {{bug|MC-113871}}, [[boat]]s can be captured by minecarts. When a boat is placed in a minecart, the minecart travels faster on rails, approximately as fast as on powered rails. The movement in the boat minecart is glitchy and moving forward with the W key moves the cart backward relative to the player, and vice versa for moving backward with the S key. The minecart also moves on the rail-less ground at a crawling speed, but it does not float in the water despite being in a boat. 

Using this glitch can be far more resource-efficient since the boat minecart can move at the speed of a powered rail track on flat ground and on slopes. Another physics glitch with the boat minecart is the extreme reduction in friction when the minecart is on rails, which is similar to the lack of friction when a boat is riding on ice. This glitch can be done in Survival without cheats simply by pushing a minecart into a boat on the track. This bug is now patched.

== Sounds ==
{{Edition|Java}}:<br>
Minecarts use the Friendly Creatures sound category for entity-dependent sound events.<ref group="sound" name="oddcats" />
{{Sound table
|sound=Minecart inside.ogg
|subtitle=MC-177078
|source=Friendly Creatures <ref group="sound" name="oddcats">{{Cite bug|MC|42132|The sounds of minecarts aren't controlled by the correct sound slider|date=December 13, 2013}}</ref>
|overridesource=1
|description=While the player is inside of a moving minecart 
|id=entity.minecart.inside
|translationkey=-
|volume=0.0-0.75 <ref group=sound name=insidevolume>Based on horizontal speed; it is clamped between 0.0 and 0.75 and will not play if speed is less than 0.01</ref>
|pitch=1.0
|distance=16 (technical) / rider only (effective)}}
{{Sound table
|sound=Minecart inside underwater1.ogg
|sound2=Minecart inside underwater2.ogg
|sound3=Minecart inside underwater3.ogg
|subtitle=MC-204124
|source=Friendly Creatures <ref group="sound" name="oddcats"/>
|overridesource=1
|description=While inside of a moving minecart when the player's eye level is underwater 
|id=entity.minecart.inside.underwater
|translationkey=-
|volume=0.0-0.75 <ref group=sound name=insidevolume/>
|pitch=1.0
|distance=16 (technical) / rider only (effective)}}
{{Sound table
|sound=Minecart rolling.ogg
|subtitle=Minecart rolls <ref group="sound">Shows far less often than it should - see {{bug|MC-181831}}</ref>
|source=Friendly Creatures <ref group="sound" name="oddcats"/>
|overridesource=1
|description=While a minecart is moving
|id=entity.minecart.riding
|translationkey=subtitles.entity.minecart.riding
|volume=0.0-0.35 <ref group=sound>Relates linearly with horizontal velocity (max 0.5)</ref>
|pitch=0.0-1.0 <ref group=sound>Will increase by 0.0025 per tick if the minecart's horizontal velocity is more than 0.01</ref>
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Minecart inside.ogg
|source=neutral
|description=While the player is inside of a moving minecart
|id=minecart.inside}}
{{Sound table
|sound=Minecart rolling.ogg
|source=neutral
|description=While a minecart is moving
|id=minecart.base
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Minecart
|spritetype=item
|nameid=minecart
|form=item
|foot=1}}
{{ID table
|edition=java
|generatetranslationkeys=y
|firstcolumnname=Entity
|displayname=Minecart
|spritetype=entity
|nameid=minecart
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Minecart
|spritetype=item
|nameid=minecart
|id=370
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Minecart
|spritetype=entity
|nameid=minecart
|id=84
|foot=1}}

=== Entity data ===
Minecarts have entity data associated with them that contain various properties of the entity.

{{el|java}}:
{{main|Entity format}}
{{/ED}}

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

== Achievements ==
{{load achievements|On A Rail}}

== History ==
{{History|java infdev}}
{{History||20100618|[[File:Minecart JE1.png|32px]] [[File:Minecart (item) JE1.png|32px]] Added minecarts. 
|Minecarts are not rideable but instead are used to store things in.
|Right-clicking minecarts opens them like a [[chest]] (with the container called "Minecart". Filling them up makes the [[dirt]] layer inside them rise.}}
{{History||20100624|[[File:Minecart JE2.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] The entity model and item texture of minecarts have been changed.
|The minecart mechanics have been changed to being rideable, removing their ability to store items.
| Minecarts now render a chest inside for unknown reasons.}}
{{History|java alpha}}
{{History||v1.0.4|[[File:Minecart JE3 BE1.png|32px]] Removed the phantom chest from minecarts.
|A [[sitting]] animation for riding minecarts has been added.}}
{{History||v1.0.14|Minecarts are now used to craft [[minecart with furnace]] and [[minecart with chest]].}}
{{History||v1.2.2|Minecarts now appear to other players and can be ridden in multiplayer.
|Minecarts are no longer fully solid - they no longer block movement, and can no longer be stood on top of.}}
{{History|java beta}}
{{History||1.5|Minecarts now break faster with hands.
|[[Powered rail]]s have been introduced, which enables minecarts to move automatically, although previous methods of boosting no longer works, or does not work as effectively.
|The [[detector rail]]s have been introduced for use in detecting minecarts. Prior to this update, carts were detected by using [[pressure plate]]s in line with cart tracks. This had the often undesirable effect of dramatically slowing or even stopping the minecart, which limited the use of this design mostly to boosters.}}
{{History||1.6|snap=Test Build 3|A minecart now transfers any [[Damage#Fall damage|fall damage]] it suffers onto its rider and is not destroyed upon impact.}}
{{History||1.8|snap=Pre-release|If the [[player]] punches a minecart when descending from a jump, it shows the [[Damage#Critical hit|critical hit]] animation. This also happens if the player punches the cart while still in it.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|[[Daniel Rosenfeld|C418]] posted a [[sound]] showing the sound that minecarts make.}}
{{History|||snap=Beta 1.9 Prerelease 6|The texture of minecarts has changed slightly.}}
{{History||1.3.1|snap=12w15a|Minecarts can now be shot out from [[dispenser]]s.}}
{{History|||snap=12w21b|The [[player]] no longer spawns on top/inside of the minecart after getting out. Instead, the player gets out a few [[block]]s away. Also, the player can nudge a stationary minecart while inside it to move onto a [[Powered Rail|powered rail]], etc.}}
{{History||1.4.2|snap=12w38b|[[Sound]]s for minecarts have been added.}}
{{History||1.5|snap=13w02a|Minecarts can now be edited with a third-party program to show any [[block]] inside of it (it does not take on the characteristics of this block), as well as make it take on the characteristics of any cart.
|Minecart types no longer all share the same [[entity]] ID – <code>Minecart</code> – and are no longer distinguished by a <code>Type</code> field. They have been given separate entity IDs.
|Minecarts are now used to craft [[TNT minecart]]s.}}
{{History|||snap=13w03a|Minecarts are now used to craft [[hopper minecart]]s.}}
{{History|||snap=13w06a|Added [[minecart with spawner]].}}
{{History||1.6.2|snap=release|A [[player]] in a moving minecart no longer turns with the minecart.}}
{{History||1.7.2|snap=13w39a|Added [[minecart with command block]].}}
{{History||1.8|snap=14w11a|Minecart physics have been changed - they now go faster and further, can derail at corners if going too fast and refuse to go uphill and they can also (if going fast enough) go over 1 [[block]].
|The collision and position handling of minecarts have been improved.}}
{{History|||snap=14w17a|All changes to old minecart physics used before 14w11a have been reverted.}}
{{History||1.9.1|snap=pre2|Extreme typos in minecarts with hoppers and chests, reading "''container.minecart'''' have been fixed.}}
{{History||1.11|snap=16w32a|The [[entity]] ID has been changed from <code>MinecartRideable</code> to <code>minecart</code>.
|The player's [[hunger]] bar is now visible when riding in a minecart.}}
{{History||1.13|snap=17w47a|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 328.}}
{{History||1.14|snap=18w43a|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The textures of minecarts have been changed.}}
{{History|||snap=19w13a|Minecarts now move much slower when pushed along standard [[rail]]s using the W key, even slower on unpowered golden rails, and cannot be pushed off of unpowered golden rails without the [[player]] looking at a certain angle.}}
{{History||1.16|snap=20w09a|Minecart now checks dismount position height against entity height.}}
{{History|||snap=20w16a<!--cannot confirm due to how assets are handled - assuming this due to MC-91163 fix version-->|Minecarts no longer have subtitles for movement.}}
{{History|||snap=20w18a|Mobs in minecarts no longer [[Spawn#Despawning|despawn]].}}
{{History||1.17|snap=20w45a|Minecarts can now move in [[water]].}}
{{History||1.19|snap=22w13a|Minecarts no longer drop when breaking a [[Minecart with Chest|minecart with chest]], [[Minecart with Hopper|hopper]], [[Minecart with Furnace|furnace]], or [[Minecart with TNT|TNT]].<ref>{{bug|MC-249493|||Fixed}}</ref>}}
{{History||1.20|snap=23w16a|Sniffers can now enter [[minecart]]s.}}

{{History|pocket alpha}}
{{History||v0.8.0|snap=build 2|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] Added minecarts.}}
{{History|||snap=build 3|Minecarts now ride smoother.}}
{{History||v0.13.0|snap=build 1|[[Sound]]s for minecarts have been added.}}
{{History|||snap=build 2|Minecarts now stack on top of each other.}}
{{History||v0.14.0|snap=build 1|Minecarts can now be used to craft [[Minecart with Chest|storage]], [[Minecart with TNT|TNT]], and [[Minecart with Hopper|hopper minecart]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The textures of minecarts have been changed.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] Added minecarts.}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|Minecarts are now twice the speed than in other editions.}}
{{History||xbox=TU12|Minecarts are now slower.}}
{{History||xbox=TU13|ps=1.0|Minecarts are now faster again.}}
{{History||xbox=TU21|xbone=CU9|ps=1.14|The minecart limit has been increased.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Minecart [[sound]]s have been updated.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The texture of minecarts has been changed.}}

{{History|new 3DS}}
{{History||0.1.0|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart_(item)_JE2_BE1.png|32px]] Added minecarts.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Minecarts appear to float above the track, as their model has no wheels.
* If the player views their inventory while riding in a minecart, they appear sitting down in mid-air.
* The player can teleport to another minecart while sitting in a minecart by right-clicking a minecart in their range. This can be used as an elevator to quickly rise up when minecarts are placed on top of each other.
* If the sound is muted in the options while riding a minecart, and then turned back up, the minecart no longer makes noise in the client until the player exits the minecart.
* If a saddled pig is riding a minecart, the player can ride the pig. Doing so causes the minecart to be able to ride freely at the player's walking speed. It is unknown whether this is a glitch.
* It seems that hunger does not deplete while inactive in a minecart (at least in normal difficulty).
* A minecart (alongside rails and powered rails) are used as Steve's Side-Special in the crossover fighting game Super Smash Bros. Ultimate.

== Gallery ==
<gallery>
Minecart fire pig.png|A pig inside a burning minecart
MinecartInfdev1.png|A Minecart opened in Minecraft Infdev
MinecartInfdev2.png|A Minecart filled in Minecraft Infdev
2ed Spawner Minecart Image and 1st Dispenser cart image.jpg|An image of two [[Minecart with Spawner]]s and unimplemented Minecart with Dispensers.
Minecart with chest and head thing.png|The first image [[Jens Bergensten|Jeb]] released.<ref>{{Tweet|jeb|289000646210904064}}</ref>
Pocket Edition v0.8.0 alpha Development minecarts.png|The first image of minecarts in {{edition|PE}}.
Minecart Booster.png|Minecart booster.
MinecartStack.png|Minecarts being stacked on each other.
Villager minecart.png|Villager in a minecart.
Minecartride.jpg|Player in minecart.
Blocks in Invisible Minecarts.png|Minecarts can be edited to show any block inside, and can also be edited to be invisible.
File:Minecart (Trails and Tales Summer Event) Render.png|A wooden minecart, featured in the [[Trails & Tales Event]].
File:Minecoins 5.png|Two minecarts, as depicted on [[Minecraft Marketplace|Minecoin]] gift cards.
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--minecart Taking Inventory: Minecart] – Minecraft.net on September 6, 2019

{{Items}}
{{entities}}

[[Category:Mechanics]]

[[cs:Vozík]]
[[de:Lore]]
[[es:Vagoneta]]
[[fr:Wagonnet]]
[[hu:Csille]]
[[it:Carrello da miniera]]
[[ja:トロッコ]]
[[ko:광산 수레]]
[[nl:Mijnkar]]
[[pl:Wagonik]]
[[pt:Carrinho de mina]]
[[ru:Вагонетка]]
[[th:รถราง]]
[[uk:Вагонетка]]
[[zh:矿车]]</li></ul>
beta 1.2.0.31Coordinates can now be enabled from the command /gamerule showCoordinates and appear in the top left corner of the screen.
1.8.0
{{Extension DPL}}<ul><li>[[Pumpkin Pie|Pumpkin Pie]]<br/>{{redirect|Pie|the other craftable dessert|Cake|the terrain features|Pile}}
{{Item
| title = Pumpkin Pie
| image = Pumpkin Pie.png
| renewable = Yes
| heals = {{hunger|8}}
| stackable = Yes (64)
}}

'''Pumpkin pie''' is a [[food]] item that can be eaten by the [[player]].

== Obtaining ==
{{see also
 | Tutorials/Pumpkin and melon farming |title1= Pumpkin and melon farming
 | Tutorials/Sugar Cane farming |title2= Sugar cane farming
 | Tutorials/Egg farming |title3= Egg farming
}}

=== Crafting ===

{{Crafting
|Pumpkin
|Sugar
|Egg
|Output= Pumpkin Pie
|type=Foodstuff
}}

=== Trading ===

Apprentice-level farmer [[villager]]s have a 50%{{only|bedrock}} or {{frac|2|3}}{{only|java}} chance to sell 4 pumpkin pies for an emerald as part of their trades.

{{in|java}}, farmer villagers throw pumpkin pies at players under the [[Hero of the Village]] effect.

=== Natural generation ===

{{LootChestItem|pumpkin-pie}}

== Usage ==

=== Food ===

{{see also|Tutorials/Hunger management|title1=Hunger management}}

To eat pumpkin pie, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|8}} [[hunger]] and 4.8 [[:en:Hunger#Mechanics|saturation]].

=== Composting ===
Placing pumpkin pie into a [[composter]] raises the compost level by 1.

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Pumpkin Pie
|spritetype=item
|nameid=pumpkin_pie
|id=284
|form=item
|foot=1}}

== Video ==

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

== History ==

{{History|java}}
{{History||September 11, 2012|link=http://twitter.com/jeb_/status/245503714167750656|The first screenshot of pumpkin pie was posted on [[Jens Bergensten|Jeb's]] Twitter.<ref>{{Tweet|jeb|245503714167750656}}</ref><ref>{{Tweet|jeb|245506498099298305}}</ref>}}
{{History||1.4.2|snap=12w37a|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pies.}}
{{History||1.8|snap=14w02a|Pumpkin pie can now be [[trading|bought]] from farmer [[villager]]s, at 2–3 pumpkin pies for 1 [[emerald]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 400.}}
{{History||1.14|snap=18w43a|[[File:Pumpkin Pie JE2 BE2.png|32px]] The texture of pumpkin pie has been changed.}}
{{History|||snap=18w50a|Pumpkin pies now generate in chests in taiga [[village]] houses.}}
{{History|||snap=19w03a|Placing pumpkin pie into the new [[composter]] raises the compost level by 1.}}
{{History|||snap=19w13a|Farmer villagers now give pumpkin pies to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.8.0|snap=build 1|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pie.}}
{{History||v0.12.1|snap=build 1|Pumpkin pie now restores [[hunger]] instead of [[health]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Pumpkin Pie JE2 BE2.png|32px]] The texture of pumpkin pie has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Pumpkin pie can now be found in [[taiga]] and [[snowy taiga]] [[village]] house [[chest]]s.
|Pumpkin pie can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|Farmer [[villager]]s now have a 50% chance to [[trading|sell]] 4 pumpkin pies for an [[emerald]].}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pie.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Pumpkin Pie JE2 BE2.png|32px]] The texture of pumpkin pie has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pie.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==

<gallery>
File:Twitter Pumpkin Pie.png|The first screenshot of pumpkin pies, posted on Jeb's twitter.
</gallery>

== References ==

{{reflist}}


{{Items}}

[[cs:Dýňový koláč]]
[[de:Kürbiskuchen]]
[[es:Tarta de calabaza]]
[[fr:Tarte à la citrouille]]
[[it:Torta di zucca]]
[[ja:パンプキンパイ]]
[[ko:호박 파이]]
[[lzh:南瓜餅]]
[[nl:Pompoentaart]]
[[pl:Placek dyniowy]]
[[pt:Torta de abóbora]]
[[ru:Тыквенный пирог]]
[[zh:南瓜派]]
[[Category:Food]]
[[Category:Renewable resources]]</li><li>[[Echo Shard|Echo Shard]]<br/>{{Item
| title = Echo Shard
| image = Echo Shard.png
| renewable = No
| stackable = Yes (64)
}}
An '''echo shard''' is an item found in [[ancient cities]] which can be used to craft [[recovery compass]]es.

== Obtaining ==
=== Chest loot ===
{{LootChestItem|echo-shard}}

== Usage ==
=== Crafting ingredient ===
{{crafting usage|Echo Shard}}

== History ==
{{History|java}}
{{History||1.19|snap=22w14a|[[File:Echo Shard JE1 BE1.png|32px]] Added echo shards.}}
{{History|bedrock}}
{{History||1.19.0|snap=beta 1.19.0.24|[[File:Echo Shard JE1 BE1.png|32px]] Added echo shards.
|Currently cannot be found inside [[ancient city]] chests due to outdated structures and loot chests.}}
{{History||1.19.0|snap=beta 1.19.0.26|Echo shards now generate inside [[ancient city]] loot chests.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

[[Category:Non-renewable resources]]

[[de:Echoscherbe]]
[[es:Fragmento resonante]]
[[fr:Éclat d'écho]]
[[ja:残響の欠片]]
[[lzh:回音殘片]]
[[pt:Fragmento de eco]]
[[pl:Odłamek pogłosu]]
[[ru:Осколок эха]]
[[th:เศษเอคโค]]
[[uk:Уламок відлуння]]
[[zh:回响碎片]]</li></ul>
beta 1.8.0.8 Showing coordinates no longer requires cheats to be enabled.
Legacy Console Edition
TU1CU1 1.00 Patch 11.0.1Coordinates are displayed at the top corner of a map.
New Nintendo 3DS Edition
0.1.0
{{Extension DPL}}<ul><li>[[Rabbit's Foot|Rabbit's Foot]]<br/>{{Item
| image = Rabbit's Foot.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}
A '''rabbit's foot''' is a [[brewing]] item obtained from [[rabbit]]s.

== Obtaining ==

=== Mob loot ===
Each [[rabbit]] has a 10% chance to drop a rabbit's foot when killed by the [[player]]. This chance can be increased by 3% per level using a sword enchanted with [[Looting]].

A [[fox]] sometimes spawns with a rabbit's foot in its mouth, which always drops upon death. Alternatively, the player can drop a [[food]] item, which causes the fox to drop the rabbit's foot.

=== Cat gifts ===
{{main|Cat#Gifts}}
A tamed [[cat]] has a 70% chance of giving the player a gift when the player wakes up from a [[bed]], and the gift has a 16.13% chance to be a rabbit's foot.

== Usage ==

=== Brewing ingredient ===

{{Brewing
  |head=1
  |Rabbit's Foot
  |Mundane Potion
  |base=Water Bottle
}}
{{brewing
  |foot=1
  |showname=1
  |Rabbit's Foot
  |Potion of Leaping
}}

=== Trading ===
Journeyman-level cleric [[villager]]s buy rabbit's feet for an [[emerald]] as part of their trade: {{in|java}} they buy 2, and {{in|bedrock}} they buy 4.

== Video ==

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Rabbit's Foot
|spritetype=item
|nameid=rabbit_foot
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Rabbit's Foot
|spritetype=item
|nameid=rabbit_foot
|id=528
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.8|snap=June 30, 2014|slink=https://twitter.com/TheMogMiner/status/483636993780232192|[[Ryan Holtz]] tweeted images of a rabbit's foot with some other new [[item]]s.}}
{{History|||snap=14w27a|[[File:Rabbit's Foot JE1.png|32px]] Added rabbit's foot.
|Added the [[potion of Leaping]]; it is [[brewing|brewed]] by adding a rabbit's foot to an [[awkward potion]]. The rabbit's foot also creates the [[mundane potion]] when brewed into a [[water bottle]].}}
{{History|||snap=14w33b|[[File:Rabbit's Foot JE2 BE1.png|32px]] The texture of the rabbit's foot has been changed. The new texture was created by [[wikipedia:Reddit|Reddit]] user [http://www.reddit.com/u/zeldahuman zeldahuman].<ref>{{reddit|2bjzes/a_reminder_of_the_blocks_and_items_added_in_18_so|cj69zie|context=3}}</ref><ref>{{reddit|2c5f35/minecraft_snapshot_14w31a_has_been_released|cjct7gb}}</ref>}}
{{History||1.8.1|snap=pre1|Potions of Leaping, which use rabbit's foot, can now be extended using [[redstone]].}}
{{History||1.9|snap=15w46a|The drop rate of rabbit's foot has been quadrupled.{{more info|Before/After rates}}}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 414.}}
{{History||1.14|snap=18w43a|[[File:Rabbit's Foot JE3 BE2.png|32px]] The texture of rabbit's foot has been changed.}}
{{History|||snap=18w44a|[[Cat]]s now offer rabbit's feet as [[Cat#Gifts|gifts]].}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with rabbit's feet in their mouths.}}
{{History|||snap=19w11a|Cleric [[villager]]s now [[trading|buy]] rabbit's feet.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Rabbit's Foot JE2 BE1.png|32px]] Added rabbit's foot to the [[Creative]] mode [[inventory]].}}
{{History||v0.13.0|snap=build 1|Rabbit's foot can now be obtained as a rare [[drops|drop]] upon killing [[rabbit]]s.
|Rabbit's foot can now be [[brewing|brewed]] to make [[potions of Leaping]].}}
{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.8|Tamed [[cat]]s can now give the [[player]] rabbit's foot as a gift.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Rabbit's Foot JE3 BE2.png|32px]] The texture of rabbit's foot has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Rabbit's foot can now be [[trading|sold]] to cleric [[villager]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can [[drops|drop]] rabbit's foot.}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|[[File:Rabbit's Foot JE2 BE1.png|32px]] Added rabbit's foot.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Rabbit's Foot JE3 BE2.png|32px]] The texture of rabbit's foot has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Rabbit's Foot JE2 BE1.png|32px]] Added rabbit's foot.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* The superstition that [[wikipedia:Rabbit's_foot|a rabbit's foot is a lucky charm]] applies equally to Minecraft as it does in the real world: it does not actually increase luck.

== Gallery ==
<gallery>
Rabbit Items 4 Ryan Holtz.png|First image of the item by [[Ryan Holtz]].
Rabbit Items 5 Ryan Holtz.png|Ryan Holtz brewing the item into a potion.
Rabbit Items 6 Ryan Holtz.png|Ryan Holtz enhancing the potion.
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--rabbit-s-foot Taking Inventory: Rabbit's Foot] – Minecraft.net on May 3, 2019

{{items}}

[[de:Hasenpfote]]
[[es:Pata de conejo]]
[[fr:Patte de lapin]]
[[it:Zampa di coniglio]]
[[ja:ウサギの足]]
[[ko:토끼발]]
[[nl:Konijnenpootje]]
[[pl:Królicza łapka]]
[[pt:Pé de coelho]]
[[ru:Кроличья лапка]]
[[uk:Кроляча лапка]]
[[zh:兔子脚]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li><li>[[Cooked Rabbit|Cooked Rabbit]]<br/>{{Item
| title = Cooked Rabbit
| image = Cooked Rabbit.png
| heals = {{hunger|5}}
| renewable = Yes
| stackable = Yes (64)
}}

'''Cooked rabbit''' is a [[food]] item that can be eaten by the [[player]].

== Obtaining ==

=== Mob loot ===

{{IN|Bedrock}}, adult [[rabbit]]s drop 0–1 cooked rabbit if killed while on fire. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 0–4 with Looting III.

{{IN|Java}}, adult [[rabbit]]s drop 1 cooked rabbit if killed while on fire. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 1–4 with Looting III.

=== Cooking ===

Cooked rabbit can be obtained by cooking [[raw rabbit]] in a [[furnace]], [[smoker]], or [[campfire]].
{{Smelting
  |showname=1
  |Raw Rabbit
  |Cooked Rabbit
  |0,35
}}

=== Villagers ===
{{IN|java}}, butcher villagers may give players with the [[Hero of the Village]] effect cooked rabbit.

{{IN|bedrock}}, apprentice-level butcher villagers have 25% chance to sell 5 cooked rabbit for an emerald.

== Usage ==

=== Food ===

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

=== Crafting ingredient ===
Cooked rabbit can be used to craft rabbit stew.

{{crafting usage}}

=== Wolves ===

Cooked rabbit can be used to [[breed]] and heal tamed [[wolves]], lead them around, and make baby tamed wolves grow up faster by 10% of the remaining time.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Cooked Rabbit
|spritetype=item
|nameid=cooked_rabbit
|id=289
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Rabbit Season}}

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

== History ==

{{History|java}}
{{History||1.8|snap=June 30, 2014|slink=https://twitter.com/TheMogMiner/status/483636993780232192|[[Ryan Holtz]] tweeted images of cooked rabbits and some other new [[item]]s.}}
{{History|||snap=14w27a|[[File:Cooked Rabbit JE1.png|32px]] Added cooked rabbit. It is used to craft [[rabbit stew]].}}
{{History|||snap=14w33b|[[File:Cooked Rabbit JE2 BE1.png|32px]] The texture of cooked rabbit has been changed. The new texture was created by [[wikipedia:Reddit|Reddit]] user [http://www.reddit.com/u/zeldahuman zeldahuman].<ref>{{reddit|2bjzes/a_reminder_of_the_blocks_and_items_added_in_18_so|cj69zie|context=3}}</ref><ref>{{reddit|2c5f35/minecraft_snapshot_14w31a_has_been_released|cjct7gb}}</ref>}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 412.}}
{{History||1.14|snap=18w43a|[[File:Cooked Rabbit JE3 BE2.png|32px]] The texture of cooked rabbit has been changed.}}
{{History|||snap=19w13a|Butcher [[villager]]s now give cooked rabbit to players under the [[Hero of the Village]] effect.}}
{{History||1.19.3|snap=22w42a|Rabbits now always drop at least 1 coooked rabbit when killed while on fire.}}

{{History|pocket alpha}}
{{History||v0.13.0|snap=build 1|[[File:Cooked Rabbit JE2 BE1.png|32px]] Added cooked rabbit.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Cooked Rabbit JE3 BE2.png|32px]] The texture of cooked rabbit has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Cooked rabbit can now be [[trading|bought]] from butcher [[villager]]s.}}
{{History||1.12.0|snap=beta 1.12.0.3|The [[trading]] price of cooked rabbit has been lowered to one [[emerald]].}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Cooked Rabbit JE2 BE1.png|32px]] Added cooked rabbit.}}
{{History|PS4}}
{{History||1.90|[[File:Cooked Rabbit JE3 BE2.png|32px]] The texture of cooked rabbit has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Cooked Rabbit JE2 BE1.png|32px]] Added cooked rabbit.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==
<gallery>
File:Rabbit Items 2 Ryan Holtz.png|First image of the item by [[Ryan Holtz]].
</gallery>

== References ==
{{reflist}}

{{items}}

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

[[de:Gebratenes Kaninchen]]
[[es:Conejo asado]]
[[it:Coniglio cotto]]
[[fr:Lapin cuit]]
[[ja:焼き兎肉]]
[[ko:익힌 토끼고기]]
[[nl:Gebraden konijnenvlees]]
[[pl:Pieczony królik]]
[[pt:Coelho assado]]
[[ru:Жареная крольчатина]]
[[zh:熟兔肉]]</li></ul>
Coordinates are displayed at the bottom Touch Screen alongside the map and hotbar.
Advertisement