Minecraft Wiki
Advertisement
Dark Forest

A dark forest biome. A woodland mansion can also be seen.

A dark forest is a temperate forested biome. It is known for its thick, dense leaf canopies that block light sufficiently to allow hostile mobs to spawn during the daytime. It has two variants, the normal dark forest, and dark forest hills.

Dark Forests can be commonly found using the seed, throwlow.

Description

Dark forests feature a much higher density in trees compared to other forest biomes, which often times block direct views of the sky entirely. Oak, dark oak, and (sometimes) birch trees generate in these biomes; the only place where dark oak trees naturally generate. Additionally, both types of huge mushrooms generate among the trees, though the red variants are more common. Like normal forests, lily of the valley, rose bushes, peonies and lilacs generate in this biome family along with the usual dandelions and poppies. Grass and leaves take on a dark but vibrant green color.

Lava lakes that generate in dark forests can cause locally destructive forest fires, due to the extreme density of flammable wood and leaves; the same goes for lightning strikes that hit the trees during thunderstorms, though the fires caused by the strikes are usually quickly put out by the rain.

Unique to dark forests are woodland mansions, enormous dungeon-like structures that rarely generate within the trees. Woodland mansions are home to the dangerous Illager mobs and are one of the only places where said mobs spawn. Mansions contain various rooms and valuable loot for the player to plunder.

Although players are unlikely to run out of wood in dark forests, survival can still be far more difficult compared to other forest biomes. The dense leaf canopy can often diffuse skylight to the point that hostile mobs can spawn during the day in certain spots. Additionally, hostile mobs can spawn atop huge mushrooms and surprise the player when they suddenly fall near them. Woodland mansions are dangerous to explore without adequate preparation, due to their sheer size and the difficult Illager and other hostile mobs inside. The high density of trees can easily lead to players getting lost if they don't mark their trails using torches or other distinct markers. Using flint and steel in these biomes can help to clear out some trees due to their flammability.

In a given world, Dark Forests often have small patches of plains biomes cutting up through it. Dark forests are usually found next to other various lush biomes.

Variants

There are two different dark forest variant biomes.

Dark Forest

Dark Forest is the most common dark forest variant. The terrain can range from fairly even to hilly, with occasional lakes. This biome has a dense canopy of leaves that reduces the light sufficiently for hostile mobs to inhabit the forest during the daytime. Small patches of plains biomes can generate clearings within the forest. Woodland mansions also generate here.

In Java Edition :

MobSpawn weightGroup size
Creature category
Sheep12404
Pig10404
Chicken10404
Cow8404
Monster category
Spider1005154
Zombie955154
Zombie Villager55151
Skeleton1005154
Creeper1005154
Slime[note 1]1005154
Enderman105151–4
Witch55151
Ambient category
Bat18
  1. Spawn attempt only succeeds in slime chunks.

In Bedrock Edition :

MobSpawn weightGroup size
Creature category
Sheep12402–3
Pig10401–3
Chicken10402–4
Cow8402–3
Monster category
Spider1004951
Zombie954952–4
Zombie Villager54952–4
Skeleton804951–2
Creeper1004951
Slime[note 1]1004951
Enderman104951–2
Witch54951
Ambient category
Bat12
  1. Spawn attempt only succeeds in slime chunks.


Dark Forest Hills

Dark Forest Hills can break the leaf canopy, increasing visibility and decreasing the chance of daytime hostile mob spawning, though the hills are steep compared to other hill biomes. Hills generated near rivers can lead to cliffs, risking fall damage if players don't land in the water. Small plains-biome clearings do not generate within the dark forest hills variant. Woodland mansions may still generate here.

Dark forest hills use the same mob spawning chances as dark forests.

Data values

ID

Java Edition:

NameIdentifierTranslation key
Dark Forestdark_forestbiome.minecraft.dark_forest
Dark Forest Hillsdark_forest_hillsbiome.minecraft.dark_forest_hills

Bedrock Edition:

NameIdentifierNumeric ID
[No displayed name]roofed_forest29
[No displayed name]roofed_forest_mutated157

History

Java Edition
1.7.2
{{Extension DPL}}<ul><li>[[Reality Vision|Reality Vision]]<br/>{{Joke feature}}
{{Item
| title = Reality Vision
| image = Reality Vision.png
| renewable = No
| stackable = Yes (64)
}}

The '''Reality vision''' was a joke [[helmet]].

== Usage ==
Reality vision was equipped via the [[helmet]] slot. When equipped, it showed a [[wikipedia:Mini-map|minimap]] in the bottom-center of the screen (which moved when the [[player]]'s camera moves). The minimap showed all [[chunk]]s that were currently rendered. The player's location was represented by a green [[beacon]] beam marker on the map.

It displayed a vision overlay (similar to the [[pumpkin]] overlay). The overlay would change to a new overlay if the player went into third person (unlike the pumpkin overlay), which made the screen appear like an old [[wikipedia:Television|television]] screen. The overlay was called <code>cantseeshit<!-- Do not change this; this is that word that is actually used-->captain.png</code> in the assets folder. It activated a [[Shaders|shader]] when equipped (<code>scan_pincushion</code>).

== Sounds ==

{{Sound table
|sound=Equipvr.ogg
|subtitle=''None''
|source=player
|description=When equipped
|id=item.reality_vision.use
|translationkey=''None''
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=java
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Reality Vision
|spritetype=item
|nameid=reality_vision
|id=500
|form=item
|translationkey=item.realityVision.name
|foot=1}}

== History ==
{{History|java}}
{{History||1.RV-Pre1|[[File:Reality_Vision_(item).png|32px]] [[File:Reality Vision.png|32px]] Added reality vision.}}
{{History|foot}}

== Issues ==
Reality Vision is an unsupported item due to being an [[Wikipedia:April Fools' Day|April Fools']] joke, and therefore such issues relating to them will not be fixed.

== Trivia ==
* [[Sign]]s display the text "OBEY" while equipped, a reference to the movie [[wikipedia:They Live|''They Live'']].

== Gallery ==

<gallery>
Sign2.png|The [[sign]] texture found in the game files.
OBEY.png|OBEY seen in a sign.
OBEY sign in 1.RV-Pre1..png|OBEY seen in a sign, but seen from a better perspective. 
TechGear.png|A [[player]] wearing reality vision, featured in this [[wikipedia:April Fools' Day|April Fools']] joke version.
</gallery>

{{Items}}
{{Jokes}}

[[Category:Non-renewable resources]]
[[Category:Joke items]]

[[pt:Visão da realidade]]
[[es:Reality Vision]]</li><li>[[Obsidian Boat|Obsidian Boat]]<br/>{{for|other uses|Obsidian (disambiguation)}} {{for|other kinds of boats|Boat (disambiguation)}}
{{Joke feature}}
{{ItemEntity
|title=Obsidian Boat
|image=Obsidian Boat.png
|image2=Obsidian Boat (item).png
|stackable=No
|renewable=Yes
}}

The '''obsidian boat''' was a joke [[boat]] variant released in an April Fools' joke version.

== Obtaining ==
=== Crafting ===
{{crafting
|A2 = Obsidian                |C2 = Obsidian
|A3 = Obsidian |B3 = Obsidian |C3 = Obsidian
|Output= Obsidian Boat
|ignoreusage=1
}}

== Usage ==
Obsidian boats sank in [[water]] instead of floating. They also sank in lava like other boats but did not get destroyed in it.

== Sounds ==
Obsidian boats used the Friendly Creatures sound category for entity-dependent sound events, although did not have any sounds of their own.

== Data values ==
=== ID ===
{{ID table
|shownumericids=y
|showforms=y
|generatetranslationkeys=java
|displayname=Obsidian Boat
|spritetype=item
|nameid=obsidian_boat
|id=432
|form=item
|translationkey=item.obsidian_boat.name
|foot=1}}
{{ID table
|shownumericids=y
|generatetranslationkeys=java
|displayname=Obsidian Boat
|spritetype=entity
|nameid=boat
|id=41
|translationkey=entity.Boat.name
|foot=1}}

=== Entity data ===
{{/ED}}

== History ==
{{History|java}}
{{History||1.10|snap=15w14a|link=Java Edition 15w14a|[[File:Obsidian_Boat_(item).png|32px]] [[File:Obsidian Boat.png|32px]] Added the obsidian boat.}}
{{History|foot}}

== Issues ==
Obsidian boat is a joke feature and as such issues relating to them cannot be fixed.

{{Items}}
{{Entities}}
{{Jokes}}

[[Category:Joke items]]
[[Category:Joke entities]]

[[it:Barca di ossidiana]]
[[ja:黒曜石のボート]]
[[pt:Bote de obsidiana]]
[[uk:Обсидіановий човен]]
[[zh:15w14a]]</li></ul>
13w36aRoofed forest biome added, along with many other biomes.
1.11
{{Extension DPL}}<ul><li>[[Lime Dye|Lime Dye]]<br/>{{Item
| image = Lime_Dye_JE2_BE2.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Lime dye''' is a [[Dye#Quasi-Primary|quasi-primary dye]] obtained by combining one [[green dye]] and one [[white dye]] in a crafting square, or by smelting a [[sea pickle]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showname=0
  |showdescription=1
  |Green Dye
  |White Dye
  |Output=Lime Dye,2
  |type=Material
}}
{{Crafting
  |foot=1
  |Green Dye
  |Bone Meal
  |Output=Lime Dye,2
  |description={{only|bedrock|education}}
  |type=Material
}}

=== Smelting ===

{{Smelting
|head=1
|foot=1
|Sea Pickle
|Lime Dye
|0,2
}}

=== Trading ===

[[Wandering trader]]s sell 3 lime [[dye]] for 1 [[emerald]].

== Usage  ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===

Journeyman-level shepherd villagers have a 20% chance to buy 12 lime dye for an emerald as part of their trades.‌

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lime Dye
|spritetype=item
|nameid=lime_dye
|aliasid=dye / 10
|id=405
|form=item
|translationkey=item.dye.lime.name
|foot=1}}

== Video ==

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

== History ==

{{History|java beta}}
{{History||1.2|[[File:Lime Dye JE1 BE1.png|32px]] Added lime 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|Lime dye can now be [[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=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|||snap=18w14b|Lime dye can now be smelted from [[sea pickle]]s.}}
{{History||1.14|snap=18w43a|Lime dye is now crafted using [[white dye]], instead of [[bone meal]].
|[[File:Lime_Dye_JE2_BE2.png|32px]] The texture of lime dye has now been changed.}}
{{History|||snap=18w44a|Lime dye can now change the text color on [[sign]]s to lime.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells lime dye.}}
{{History|||snap=19w11a|Lime dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Lime dye can now be used to craft [[lime candle]]s.}}
{{History|||snap=21w19a|Lime dye can no longer be used to craft lime candles.}}
{{History|||snap=Pre-release 1|Lime dye can now once again be used to craft lime candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Lime dye can now change the text color on [[hanging sign]]s to lime.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Lime Dye JE1 BE1.png|32px]] Added lime dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Lime dye is now craftable with [[cactus green]] and [[bone meal]].
|Lime dye can now be used to craft lime wool.}}
{{History||v0.6.0|Lime dye can now be used to dye [[sheep]].}}
{{History||v0.9.0|snap=build 11|Lime dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Lime dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Lime dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Lime dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Lime 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|Lime 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|Lime dye can now be used to craft [[balloon]]s and [[glow stick]]s.
|Lime dye can now be obtained from smelting [[sea pickle]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Lime dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Lime dye is now [[trading|sold]] by [[wandering trader]]s.
|Lime dye can now be used to dye white [[carpet]]s and undyed [[glass pane]]s.
|[[File:Lime_Dye_JE2_BE2.png|32px]] The texture of lime dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Lime dye can now be [[trading|sold]] to shepherd [[villager]]s.‌}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of lime dye has been changed from <code>dye/10</code> to <code>lime_dye</code>.}}

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

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

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

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

[[cs:Světle zelené barvivo]]
[[de:Hellgrüner Farbstoff]]
[[es:Tinte verde lima]]
[[fr:Teinture vert clair]]
[[hu:Neonzöld festék]]
[[ja:黄緑色の染料]]
[[ko:연두색 염료]]
[[nl:Lichtgroene kleurstof]]
[[pl:Jasnozielony barwnik]]
[[pt:Corante verde-limão]]
[[ru:Лаймовый краситель]]
[[zh:黄绿色染料]]</li><li>[[Raw Gold|Raw Gold]]<br/>{{Item
| image = Raw Gold.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw gold''' is a raw metal resource obtained from mining [[gold ore]].

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

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

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

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

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

=== Piglins ===
If a {{EntityLink|Piglin}} see a raw gold, it will set off to reach it, then stare at it for 120 — 160 ticks, putting it in their inventory, and continue to perform the action it was taking before being attracted by the raw gold.

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

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

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

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

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

== Issues ==
{{Issue list}}

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

{{Items}}

[[Category:Non-renewable resources]]

[[de:Rohgold]]
[[es:Oro en bruto]]
[[fr:Or brut]]
[[ja:金の原石]]
[[pl:Surowe złoto]]
[[pt:Ouro bruto]]
[[ru:Необработанное золото]]
[[uk:Необроблене золото]]
[[zh:粗金]]</li></ul>
16w39aAdded woodland mansions, which can rarely generate in roofed forests.
1.13
{{Extension DPL}}<ul><li>[[Le Tricolore|Le Tricolore]]<br/>{{Exclusive|Java}}
{{Joke feature}}
{{Item
| image = 
| renewable = Yes
| stackable = Yes (64)
}}

'''Le Tricolore''' (French for ''The Tricolour'') is a joke item from [[Java Edition 23w13a_or_b]].

== Obtaining ==
One le tricolore and one [[la baguette]] is given to all players when [[French mode]] gets activated. Deactivating the mode will remove le tricolore from the player's inventory (but not la baguette; [[container]]s such as [[chest]]s are not affected).

Le Tricolore is not available in the creative inventory, but can be obtained by using the {{cmd|give}} command.

== Data values ==

=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=Le Tricolore
|spritetype=item
|nameid=le_tricolore
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||23w13a or b|[[File:Le Tricolore.png|32px]] Added Le Tricolore.}}
{{History|foot}}

{{Items}}
{{Jokes}}

[[Category:Joke items]]

[[ja:Le Tricolore]]
[[pt:Le Tricolore]]</li><li>[[Sword|Sword]]<br/>{{For|the item in ''Minecraft Dungeons''|MCD:Sword|MCD:Diamond Sword}}
{{Item
| image = <gallery>
Wooden Sword.png | Wooden
Stone Sword.png | Stone
Iron Sword.png | Iron
Golden Sword.png | Golden
Diamond Sword.png | Diamond
Netherite Sword.png | Netherite
</gallery>
| rarity = Common
| renewable = 
* '''Netherite''': No
* '''All others''': Yes
| durability = 
'''Java Edition'''<br>
Golden: 32<br>
Wood: 59<br>
Stone: 131<br>
Iron: 250<br>
Diamond: 1561<br>
Netherite: 2031<br>
'''Bedrock Edition'''<br>
Golden: 33<br>
Wood: 60<br> 
Stone: 132<br>
Iron: 251<br>
Diamond: 1562<br>
Netherite: 2032
| stackable = No
}}
The '''sword''' is a melee [[weapon]] that is mainly used to deal [[damage]] to [[entity|entities]] or for breaking certain blocks faster than by hand. A sword is made from one of six materials, in order of increasing quality and expense: wood, gold, stone, iron, diamond and netherite.

== Obtaining ==
=== Crafting ===
{{Crafting
  |showname=0
  |showdescription=1
  |head=1
  |name=[[Swords]]
  |B1={Any Planks}; Iron Ingot; Gold Ingot; Diamond
  |B2={Any Planks}; Iron Ingot; Gold Ingot; Diamond
  |B3=Stick
  |Output=Wooden Sword; Iron Sword; Golden Sword; Diamond Sword
  |type=Combat
}}
{{Crafting
  |name=Stone Sword
  |B1=Any stone-tier block
  |B2=Any stone-tier block
  |B3=Stick
  |Output=Stone Sword
  |description=Can use cobblestone and its other variants interchangeably.
  |type=Combat
}}
{{Crafting
  |foot=1
  |ignoreusage=1
  |name=[[Swords]]
  |ingredients=Damaged Matching [[Swords]]
  |Damaged Wooden Sword; Damaged Stone Sword; Damaged Iron Sword; Damaged Golden Sword; Damaged Diamond Sword; Damaged Netherite Sword
  |Damaged Wooden Sword; Damaged Stone Sword; Damaged Iron Sword; Damaged Golden Sword; Damaged Diamond Sword; Damaged Netherite Sword
  |description= The durability of the two swords is added together, plus an extra 5% of the tool type's total durability. Enchantments are removed unless combined on an [[anvil]].<br>'''Example:''' Two wooden swords, each with remaining durability of 20, combine into a wooden sword having 43 durability (20 + 20 + 5% of 60).
  |Output=Wooden Sword; Stone Sword; Iron Sword; Golden Sword; Diamond Sword; Netherite Sword
  |type=Combat
}}

=== Upgrading ===
{{Smithing
|Netherite Upgrade
|Diamond Sword
|Netherite Ingot
|Netherite Sword
|description=
|tail=1
}}

=== Repairing ===
==== Grinding ====
{{Grinding
|showdescription=1
|ingredients=2x Damaged Wooden Sword or<br>2x Damaged Stone Sword or<br>2x Damaged Iron Sword or<br>2x Damaged Golden Sword or<br>2x Damaged Diamond Sword or <br>2x Damaged Netherite Sword
|Damaged Wooden Sword; Damaged Stone Sword; Damaged Iron Sword; Damaged Golden Sword; Damaged Diamond Sword; Damaged Netherite Sword
|Damaged Wooden Sword; Damaged Stone Sword; Damaged Iron Sword; Damaged Golden Sword; Damaged Diamond Sword; Damaged Netherite Sword
|Wooden Sword; Stone Sword; Iron Sword; Golden Sword; Diamond Sword; Netherite Sword
|description=The durability of the two swords is added together, plus an extra 5% durability. Any enchantments, besides curses, would be removed.
}}

==== Unit repair ====
{{main|Anvil mechanics#Unit repair}}
{{/Repairing with Anvils}}
A sword can be repaired in an [[anvil]] by adding units of the [[tiers]]' repair material, with each repair material restoring 25% of the sword's maximum durability, rounded down.

=== Mob loot ===
{{Main|Drops#Equipped items}}

Some [[mobs]] can spawn with a sword and have an 8.5% chance of dropping them upon death caused by player. This chance is increased by 1% per level of [[Looting]], up to a maximum of 11.5% with Looting III. [[Zombie]]s and [[husk]]s can drop iron swords, [[zombified piglin]]s and [[piglin]]s can drop golden swords, and [[wither skeleton]]s can drop stone swords. The dropped sword is usually badly damaged and may be enchanted. Stone swords dropped by wither skeletons are never enchanted.

A [[vex]] wields an iron sword that normally has a 0% chance of dropping, because their main hand's <code>HandDropChances</code> is 0. However, this chance increases by 1 percentage point per level of Looting. It is never damaged{{only|java}} and may be enchanted.

{{IN|be}}, [[pillager]]s and [[vindicator]]s that spawn from raids have a 4.1% chance (5.12% chance on hard mode) of dropping a damaged iron sword. This sword has a 50% chance of being enchanted.

=== Trading ===
[[File:Weaponsmith Diamond Sword Trade.png|thumb|right|The diamond sword trade of a weaponsmith.]]

{{IN|bedrock}}, an apprentice-level weaponsmith villagers sells enchanted iron swords for at least 7-21 emeralds, and a master-level weaponsmith sells enchanted diamond swords for at least 13-27 emeralds.

{{IN|java}}, a novice-level weaponsmith villager has a {{frac|2|3}} chance of selling an enchanted iron sword for at least 7-22 emeralds. A master-level weaponsmith offers to sell an enchanted diamond sword for at least 11–27 emeralds.

The enchantments of the swords offered by villagers are the same as the ones obtained from an [[enchantment table]] at levels 5–19.

=== Chest loot ===
{{LootChestItem|iron-sword,level-enchanted-iron-sword,damaged-random-enchanted-iron-sword,golden-sword,random-enchanted-golden-sword,diamond-sword,damaged-diamond-sword,level-enchanted-diamond-sword,damaged-random-enchanted-diamond-sword,damaged-random-enchanted-diamond-sword-2}}

== Usage ==
=== Attacking ===
Pressing {{control|attack}} while holding a sword inflicts damage on both mobs and other players. Upon damaging a mob or player, the sword's [[Item Durability|durability]] decreases by 1.

Attacking a [[boat]] or a [[minecart]] with a sword stone tier or higher instantly destroys it {{only|java}}, without decreasing the sword's durability. Otherwise, it requires 2 hits, with neither decreasing durability.

==== Sweeping ====
{{exclusive|Java|section=1}}
If the attack recharge meter is 84.8% or above and the player is on the ground standing or moving slower than the [[sprinting]] speed in a straight line, the sword performs a sweeping attack indicated by a gale [[particle]] that reaches nearby enemies for {{hp|1}} and knocks them back; the amount of knockback is 80% that of the basal knockback and does not benefit from the [[knockback]] enchantment. As result, the player can perform a sweep attack while they are sprinting diagonally but it is impossible to perform a sweep attack at the same time as a critical hit or while riding some [[entity]]. All enemies within an 1 by 0.25 by 1 block area of any part of the attacked mob and whose feet are 3 or less blocks away from player's feet are affected. The [[sweeping edge]] enchantment increases the damage dealt by 50% of the normal hit damage for level I, 67% for level II and 75% for level III.

=== Damage ===
{{Main|Damage}}

==== Java Edition ====
Swords have an attack speed of 1.6 and take 0.625 seconds to [[Damage#Attack cooldown|recover]]. 

{| class="wikitable" style="text-align:center" data-description="Sword attack damage by type"
! Material
! {{ItemSprite|Wooden Sword|text=Wooden}}
! {{ItemSprite|Golden Sword|text=Gold}}
! {{ItemSprite|Stone Sword|text=Stone}}
! {{ItemSprite|Iron Sword|text=Iron}}
! {{ItemSprite|Diamond Sword|text=Diamond}}
! {{ItemSprite|Netherite Sword|text=Netherite}}
|-
! Attack Damage
| {{hp|4}}
| {{hp|4}}
| {{hp|5}}
| {{hp|6}}
| {{hp|7}}
| {{hp|8}}
|-
! Attack Speed
| 1.6
| 1.6
| 1.6
| 1.6
| 1.6
| 1.6
|-
! Damage/Second (DPS)
| 6.4
| 6.4
| 8
| 9.6
| 11.2
| 12.8
|-
! Durability
| 59
| 32
| 131
| 250
| 1561
| 2031
|-
! Lifetime damage inflicted<ref group="note">The formula to find the total lifetime damage is ''Lifetime damage minimum = Durability × Damage per hit''. It ignores enchantments and [[Damage#Critical_hit|critical hits]], and assumes the sword is at maximum charge</ref>
| {{hp|236}}
| {{hp|128}}
| {{hp|655}}
| {{hp|1500}}
| {{hp|10927}}
| {{hp|16248}}
|}
{{notelist}}

==== Bedrock Edition ====
{{IN|bedrock}}, swords have no attack cooldown or sweep attack, and deal the following damage:

{| class="wikitable" style="text-align:center" data-description="Sword attack damage by type"
! Material
! {{ItemSprite|Wooden Sword|text=Wooden}}
! {{ItemSprite|Golden Sword|text=Gold}}
! {{ItemSprite|Stone Sword|text=Stone}}
! {{ItemSprite|Iron Sword|text=Iron}}
! {{ItemSprite|Diamond Sword|text=Diamond}}
! {{ItemSprite|Netherite Sword|text=Netherite}}
|-
! Attack Damage
| {{hp|5}} <!-- DO NOT CHANGE THESE! The values are correct, '+4 Attack Damage' means 5 total attack damage. -->
| {{hp|5}}
| {{hp|6}}
| {{hp|7}}
| {{hp|8}}
| {{hp|9}}
|-
! Durability
| 60
| 33
| 132
| 251
| 1562
| 2032
|-
! Lifetime damage inflicted<ref group="note">The formula to find the total lifetime damage is ''Durability × Damage per hit = Lifetime damage minimum''. It excludes enchantments and critical hits</ref>
| {{hp|300}}
| {{hp|165}}
| {{hp|792}}
| {{hp|1757}}
| {{hp|12496}}
| {{hp|18288}}
|}
{{notelist}}

The most amount of damage that a sword enchanted with [[Sharpness]] V can do is 11 {{in|java}} and 15.25 {{in|bedrock}}, without critical hits.

=== Sword breaking times ===
{{main|Breaking}}

A sword can also be used to destroy certain blocks 50% quicker, sometimes much quicker than with fists. Using a sword to destroy any block that doesn't break instantly by hand decreases its durability by 2; this includes bamboo, despite that the sword is the fastest tool for breaking it.<ref>{{bug|MC-195168||Swords consume double durability than they normally would when destroying bamboo saplings, bamboo, or cobwebs}}</ref>

If a sword is enchanted with [[Silk Touch]], either using [[Creative]] or [[commands]], cobwebs the sword destroys will drop the cobwebs themselves instead of the usual string. This is due to the sword being classified as the proper tool for cobwebs.

The following table shows the time it takes to break blocks on which swords have any effect. Colors indicate what gets dropped:
* White: an original block.
* Blue: block's normal drop (e.g. seeds, sapling, apple).
* Red: nothing.

{| class="wikitable" style="text-align:center" data-description="Blocks affected by swords"
! Block
! Fists
! Sword
! colspan="2" | Proper/fastest tool
|-
!style="text-align:left"| {{BlockLink|Bamboo}}
| {{tc|no|{{breaking time|Bamboo}} s }} || 0.05 s (instant) <!-- this doesn't work: {{tc|planned|{{breaking time|Bamboo|Sword}} s}} -->
| {{ItemSprite|sword|link=Sword}}
| 0.05 s (instant) <!-- this doesn't work: {{breaking time|Bamboo|Sword}} s -->
|-
!style="text-align:left"| {{BlockLink|Cobweb}}
| {{tc|no|{{breaking time|Cobweb|drop=None}} s}} || {{tc|planned|{{breaking time|Cobweb|Sword}} s}}
| {{ItemSprite|shears|link=Shears}}
| {{breaking time|Cobweb|Shears}} s
|-
!style="text-align:left"| {{BlockLink|Cocoa}}
| {{tc|planned|{{breaking time|Cocoa}}s}} || {{tc|planned|{{breaking time|Cocoa|Sword}}s}}
| {{ItemSprite|wooden-axe|link=Axe}}
| {{tc|planned|{{breaking time|Cocoa|Golden}} – {{breaking time|Cocoa|Wooden}} s}}
|-
! style="text-align:left"|{{BlockLink|Hay Bale}}
| 1s
| 0.8s{{only|bedrock}}
| {{ItemSprite|wooden-hoe|link=Hoe}}
| {{breaking time|Hay Bale|Golden}} – {{breaking time|Hay Bale|Wooden}} s
|-
!style="text-align:left" rowspan="2"| {{BlockLink|Leaves}}
!rowspan="2" {{tc|planned|{{breaking time|Leaves}} s}}
!rowspan="2" {{tc|planned|{{breaking time|Leaves|Sword}} s}}
| {{ItemSprite|shears|link=Shears}}
| {{breaking time|Leaves|Shears}}s
|-
| {{ItemSprite|wooden-hoe|link=Hoe}}
| {{tc|planned|{{breaking time|Leaves|Golden}} – {{breaking time|Leaves|Wooden}} s}}
|-
!style="text-align:left"| {{BlockLink|Jack o'Lantern}}
| {{breaking time|Jack o'Lantern}} s || {{breaking time|Jack o'Lantern|Sword}} s
| {{ItemSprite|wooden-axe|link=Axe}}
| {{breaking time|Jack o'Lantern|Golden}} – {{breaking time|Jack o'Lantern|Wooden}} s
|-
!style="text-align:left"| {{BlockLink|Melon}}
| {{tc|planned|{{breaking time|Melon}} s}} || {{tc|planned|{{breaking time|Melon|Sword}} s}}
| {{ItemSprite|wooden-axe|link=Axe}}
| {{tc|planned|{{breaking time|Melon|Golden}} – {{breaking time|Melon|Wooden}} s}}
|-
!style="text-align:left"| {{BlockLink|Pumpkin}}
| {{breaking time|Pumpkin}}s || {{breaking time|Pumpkin|Sword}} s
| {{ItemSprite|wooden-axe|link=Axe}}
| {{breaking time|Pumpkin|Golden}} – {{breaking time|Pumpkin|Wooden}} s
|-
!style="text-align:left" rowspan="2"| {{BlockLink|Vines}} 
| rowspan="2" {{tc|no|{{breaking time|Vines}} s}} || rowspan="2" {{tc|no|{{breaking time|Vines|Sword}} s}}
| {{ItemSprite|wooden-axe|link=Axe}}
| {{tc|no|{{breaking time|Vines|Golden}} – {{breaking time|Vines|Wooden}} s}}
|-
| {{ItemSprite|shears|link=Shears}}
| {{breaking time|Vines|Shears}} s
|}

==== Safety around constructions ====
In Creative mode, swords are unable to break blocks. However, care must still be taken around [[minecart]]s, [[painting]]s, [[item frame]]s,{{only|java}} and [[armor stand]]s; these are entities, thus can be broken with swords in Creative.<ref>{{bug|MC-27140}}</ref><ref>{{bug|MC-18463}}</ref>

=== Enchantments ===
Swords can receive, gathered from mob drops/villager trades or be found in various loot chests (example: End City, Bastion Remnant)with the following [[enchantment]]s:

{| class="wikitable sortable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
!Weight
|-
|[[Fire Aspect]]
|II
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|2
|-
|[[Looting]]
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|2
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|5
|-
|[[Sharpness]]<ref group=note name=note1>Sharpness, Smite, and Bane of Arthropods are mutually exclusive.</ref>
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|10
|-
|[[Smite]]<ref group=note name=note1/>
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|5
|-
|[[Bane of Arthropods]]<ref group="note" name=note1/>
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|5
|-
|[[Knockback]]
|II
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|5
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|2
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|1
|-
|[[Sweeping Edge]]{{Only|java|short=1}}
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|2
|}
Golden swords have the highest enchantability, yet the least durability{{Notelist}}

=== Fuel ===
Wooden swords can be used as fuel in [[furnace]]s, smelting 1 item per sword.

=== Smelting ingredient ===
{{Smelting|showname=1|Iron Sword;Golden Sword|Iron Nugget;Gold Nugget|0,1}}

=== Piglins ===
If a {{EntityLink|Piglin}} see a golden sword, it will set off to reach it, then stare at it for 120 — 160 ticks, putting it in their inventory, and continue to perform the action it was taking before being attracted by the golden sword.

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Strong attack1.ogg
|sound2=Strong attack2.ogg
|sound3=Strong attack3.ogg
|sound4=Strong attack4.ogg
|sound5=Strong attack5.ogg
|sound6=Strong attack6.ogg
|subtitle=Strong attack
|source=player
|description=When a player deals an attack that does not trigger any other attack sounds
|id=entity.player.attack.strong
|translationkey=subtitles.entity.player.attack.strong
|volume=''varies'' <ref group=sound>0.6 for <code>strong1</code> through <code>strong4</code>, and 0.7 for <code>strong5</code> and <code>strong6</code></ref>
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Critical attack1.ogg
|sound2=Critical attack2.ogg
|sound3=Critical attack3.ogg
|subtitle=Critical attack
|source=player
|description=When a player deals a critical hit
|id=entity.player.attack.crit
|translationkey=subtitles.entity.player.attack.crit
|volume=0.7
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Knockback attack1.ogg
|sound2=Knockback attack2.ogg
|sound3=Knockback attack3.ogg
|sound4=Knockback attack4.ogg
|subtitle=Knockback attack
|source=player
|description=When a player deals a sprinting attack
|id=entity.player.attack.knockback
|translationkey=subtitles.entity.player.attack.knockback
|volume=0.7
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Sweep attack1.ogg
|sound2=Sweep attack2.ogg
|sound3=Sweep attack3.ogg
|sound4=Sweep attack4.ogg
|sound5=Sweep attack5.ogg
|sound6=Sweep attack6.ogg
|sound7=Sweep attack7.ogg
|subtitle=Sweeping attack
|source=player
|description=When a player deals a sweep attack
|id=entity.player.attack.sweep
|translationkey=subtitles.entity.player.attack.sweep
|volume=0.7
|pitch=1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Weak attack1.ogg
|sound2=Weak attack2.ogg
|sound3=Weak attack3.ogg
|sound4=Weak attack4.ogg
|subtitle=Weak attack
|source=player
|description=When a player deals an attack with no damage
|id=entity.player.attack.nodamage
|translationkey=subtitles.entity.player.attack.weak
|volume=0.7
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Weak attack
|source=player
|description=When a player attempts to attack without sufficient cooldown
|id=entity.player.attack.weak
|translationkey=subtitles.entity.player.attack.weak
|volume=0.7
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a sword's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Strong attack1.ogg
|sound2=Strong attack2.ogg
|sound3=Strong attack3.ogg
|sound4=Strong attack4.ogg
|sound5=Strong attack5.ogg
|sound6=Strong attack6.ogg
|source=player
|description=When a player deals an attack with damage
|id=game.player.attack.strong
|volume=0.2
|pitch=0.8-1.2}}
{{Sound table
|sound=Weak attack1.ogg
|sound2=Weak attack2.ogg
|sound3=Weak attack3.ogg
|sound4=Weak attack4.ogg
|source=player
|description=When a player deals an attack with no damage
|id=game.player.attack.nodamage
|volume=0.2
|pitch=0.8-1.2}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When an sword's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Wooden Sword
|spritetype=item
|nameid=wooden_sword
|form=item}}
{{ID table
|displayname=Stone Sword
|spritetype=item
|nameid=stone_sword
|form=item}}
{{ID table
|displayname=Iron Sword
|spritetype=item
|nameid=iron_sword
|form=item}}
{{ID table
|displayname=Diamond Sword
|spritetype=item
|nameid=diamond_sword
|form=item}}
{{ID table
|displayname=Golden Sword
|spritetype=item
|nameid=golden_sword
|form=item}}
{{ID table
|displayname=Netherite Sword
|spritetype=item
|nameid=netherite_sword
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wooden Sword
|spritetype=item
|nameid=wooden_sword
|id=308
|form=item}}
{{ID table
|displayname=Stone Sword
|spritetype=item
|nameid=stone_sword
|id=312
|form=item}}
{{ID table
|displayname=Iron Sword
|spritetype=item
|nameid=iron_sword
|id=307
|form=item}}
{{ID table
|displayname=Diamond Sword
|spritetype=item
|nameid=diamond_sword
|id=316
|form=item}}
{{ID table
|displayname=Golden Sword
|spritetype=item
|nameid=golden_sword
|id=322
|form=item}}
{{ID table
|displayname=Netherite Sword
|spritetype=item
|nameid=netherite_sword
|id=604
|form=item
|foot=1}}

== Achievements ==
{{load achievements|Time to Strike!;Overkill;Oooh, shiny!}}

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

== History == 
=== Blocking ===
{{main|Blocking}}
[[File:Parrying.png|thumb|right|The blocking animation using a sword before and after [[Java Edition 14w30a]] (from the [[Adventure Update|Adventure]] to the [[Bountiful Update|Bountiful]] updates).]]
 
Previously, since the [[Adventure Update]], all types of swords could be used to parry to block some forms of damage. If the player is blocking with a sword when attacked, the sword deflects 50% of incoming damage from melee, non-magical projectiles like arrows, and explosions, along with minimizing airborne knockback. The sword is held in front of the player and its durability is not reduced by blocking. The player moves at a slower rate than [[sneaking]] if blocking with a sword. Sword blocks could be engaged and disengaged instantly, with no delay between the input and damage mitigation nor cooldown between lowering a block and raising a new one.
 
After the [[Combat Update]], the sword blocking functionality was replaced by blocking with [[shield]]s and to accommodate the [[dual wield]] system. Shields negate more damage and knockback than sword blocking from "blockable" attacks (they block 100% damage and knockback after [[Java Edition 1.11]]), but, unlike swords, they lose durability, have a 0.25 second startup period before damage can be mitigated and can be temporarily disabled by attacks with an [[axe]].

=== Knockback ===
The knockback dealt by swords used to be higher than while the players are using another melee [[item]]s, like an axe or with the hands. This feature was removed in [[Java Edition 1.9]] and is also no longer used in ''[[Bedrock Edition]]''.

=== Historical changes per version ===
{{History|java indev}}
{{History||0.31|snap=20091231-2|[[File:Iron Sword JE1 BE1.png|32px]] Added iron swords.
|Iron swords cannot be [[craft]]ed yet, but can be added to the [[player]]'s [[inventory]] during world creation.}}
{{History||0.31|snap=?|The iron sword is no longer added to the player's inventory during world creation.}}
{{History||0.31|snap=20100128|[[File:Wooden Sword JE1 BE1.png|32px]] [[File:Stone Sword JE1 BE1.png|32px]] [[File:Diamond Sword JE1 BE1.png|32px]] Swords made from wood, stone, and diamond have been added.
|Swords cannot be crafted yet, but have been added to the [[item]] [[chest]] in the Indev house.|A sword held by the player is now rendered to appear more 3D.}}
{{History||0.31|snap=20100129|Wood, stone, iron, and diamond swords can now be [[craft]]ed.}}
{{History|||snap=20100130|[[File:Golden Sword JE1.png|32px]] Swords can now be made out of gold.}}
{{History|||snap=20100131|Swords now have [[durability]]. 
|Better swords now last longer.
|Swords now cost 1 durability per hit, and 2 points per block broken.}}
{{History||20100206|[[File:Golden Sword JE2 BE1.png|32px]] The texture of gold swords has been slightly changed.}}
{{History|java alpha}}
{{History||v1.2.0|snap=release|[[Zombie pigmen]] now hold golden swords.}}
{{History|java beta}}
{{History||1.2|Swords, like all [[tool]]s, now have more [[item durability|durability]].
|Prior, diamond swords had 1024 durability, iron swords had 128, stone swords 64 and wood and gold had 32 durability.}}
{{History||1.5|The damages of all swords have increased by 1, due to the player's barehand damage increasing from {{hp|1}} to {{hp|2}}.
|As a result, wooden and golden swords now dealt {{hp|5}}, stone swords {{hp|7}}, iron swords {{hp|9}}, and diamond swords {{hp|11}}.}}
{{History||1.8|snap=Pre-release|Added the ability to block with a sword, giving the [[player]] more options in combat.
|Swords deflect 50% of incoming melee damage, non-magical projectiles like arrows and explosion damage, and a bit of knockback.
|The sword is held in front of the player and its durability is not reduced by blocking.|The player moves at a slower rate than [[sneaking]] when blocking with a sword.
|As barehand damage has been reduced from {{hp|2}} to {{hp|1}}, the damages of all swords have been reduced to their pre Beta 1.5 values.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Sword [[damage]] has been reduced to make way for [[enchanting]]. A diamond sword's damage has been reduced from {{hp|10}} to {{hp|7}}, iron has been reduced from {{hp|8}} to {{hp|6}} and stone has been reduced from {{hp|6}} to {{hp|5}}. Wooden and golden swords still deal {{hp|4}} damage.|Iron swords are now found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=Beta 1.9 Prerelease 4|Swords can now be enchanted in the [[enchantment table]].}}
{{History||1.1|snap=12w01a|Iron swords are now found in [[village]] blacksmith chests.}}
{{History||1.2.1|snap=12w06a|The [[player]] now has a rare chance of obtaining iron swords by killing [[zombie]]s and golden swords from [[zombie pigmen]] from the addition of [[rare drops]]. These swords have a 20% chance of being enchanted.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden swords.}}
{{History||1.3.1|snap=12w18a|Wooden swords can now be used as [[fuel]] in a [[furnace]].}}
{{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] diamond swords for 12–13 [[emerald]]s, and iron swords for 7–10 emeralds.
|With the [[trading]] implementation, renewable [[item]]s such as [[wheat]] can now be [[trading|sold]] to buy a diamond sword. This has now made all swords [[Renewable Resource|renewable]].}}
{{History||1.4.2|snap=12w32a|[[Zombie]]s may sometimes wield iron swords, dealing extra [[damage]].}}
{{History|||snap=12w34a|If a [[player]] has dyed leather armor equipped and selected a sword of any kind, it appears in the color of the dye applied to the armor, when switching to second or third person view.}}
{{History|||snap=12w36a|Added [[wither skeleton]]s, which hold stone swords.}}
{{History||1.4.6|snap=12w49a|[[Unbreaking]] can now be applied to a sword with an [[enchanted book]].}}
{{History||1.6.1|snap=13w18a|Golden swords are now found in the new [[chest]]s in [[nether fortress]]es.}}
{{History|||snap=13w21a|Instead of replacing the barehanded [[damage]] ({{hp|1}}), swords now add their damage onto the barehanded damage, which results in all swords doing {{hp|1}} more damage than before.}}
{{History|||snap=13w25b|In [[Creative]] mode, swords are no longer able to break [[block]]s, and no [[sound]] plays when they're hit with one.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden swords.}}
{{History||1.8|snap=14w02a|Weaponsmith [[villager]]s now [[trading|sell]] enchanted diamond swords for 12–15 [[emerald]]s, and iron swords for 9–10 emeralds. Unenchanted swords are no longer sold.}}
{{History|||snap=14w30a|Sword holding position have been tweaked, and the blocking animation has changed. Blocking while mining was made impossible. Blocking immediately after attacking no longer continues the swing animation.}}
{{History||1.9|snap=15w31a|[[Enchanting|Enchanted]] iron and diamond swords can now be found in [[end city]] ship [[chest]]s.}}
{{History|||snap=15w33c|Swords no longer block attacks. Instead, [[shield]]s are used.}}
{{History|||snap=15w34b|Swords now use the attack speed [[attribute]]. The attack speed of a sword is 1.25 or 0.8 seconds.}}
{{History|||snap=15w34c|Nerfed swords, they now do {{hp|1}} less [[damage]] and have an attack speed of 1.45, or 0.69 seconds.
|Swords can now do a sweep attack when moving at walking speed or slower, which knock back [[mob]]s near the one hit. The attack speed meter must be filled for it to work.}}
{{History|||snap=15w36a|Each [[Sharpness]] level now adds {{hp|1}} damage to the base damage at level I and an additional {{hp|0.5}} for each additional level, down from a flat {{hp|1.25}} per level.}}
{{History|||snap=15w37a|Swords now have an attack speed of 1.6, or 0.63 seconds.}}
{{History|||snap=15w43a|The average yield of golden swords in [[nether fortress]] chests has been decreased.}}
{{History|||snap=15w49a|Sweep attack now does {{hp|1}} damage to affected [[mob]]s and players.}}
{{History||1.11.1|snap=16w50a|Golden and iron swords now [[smelt]] down into one of their respective [[nugget]]s.
|Added [[Sweeping Edge]] enchantment.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 268, 272, 267, 276 and 283.}}
{{History|||snap=18w10a|Swords can now generate in [[buried treasure]] chests.}}
{{History||September 10, 2018|link={{tweet|JasperBoerstra|1039167196801458176}}|[[File:Wooden Sword JE2 BE2.png|32px]] [[File:Stone Sword JE2 BE2.png|32px]] [[File:Iron Sword JE2 BE2.png|32px]] [[File:Golden Sword JE3 BE2.png|32px]] [[File:Diamond Sword JE2 BE2.png|32px]] [[Jasper Boerstra]] tweets an image of updated sword textures.}}
{{History||1.14|snap=18w43a|[[File:Wooden Sword JE2 BE2.png|32px]] [[File:Stone Sword JE2 BE2.png|32px]] [[File:Iron Sword JE2 BE2.png|32px]] [[File:Golden Sword JE3 BE2.png|32px]] [[File:Diamond Sword JE2 BE2.png|32px]] The textures of all swords have been changed.
|Swords now break [[bamboo]] instantly.}}
{{History||1.16|snap=20w06a|[[File:Netherite Sword JE1.png|32px]] Added netherite swords.
|Netherite swords are obtained by combining one diamond sword and one [[netherite ingot]] in a [[crafting table]].
|[[Crimson planks]] and [[warped planks]] can now be used to craft wooden swords.}}
{{History|||snap=20w09a|[[File:Diamond Sword JE3 BE3.png|32px]] The texture of diamond swords has been changed.}}
{{History|||snap=20w10a|[[File:Netherite Sword JE2 BE2.png|32px]] The texture of netherite swords has been changed.
|Netherite swords can no longer be [[crafted]].
|Netherite swords are now obtained by combining one diamond sword and one [[netherite ingot]] in a [[smithing table]].}}
{{History|||snap=20w15a|Stone swords can now be crafted using [[blackstone]].}}
{{History|||snap=20w16a|Golden and netherite swords now generate in [[bastion remnants]] chests.
|Golden swords now generate randomly enchanted in [[ruined portal]] chests.}}
{{History|||snap=20w17a|Diamonds swords now generate in place of netherite swords in bastion remnant [[chest]]s.}}
{{History||1.16.2|snap=20w30a|Damaged enchanted iron swords can now be found in [[bastion remnant]] chests.}}
{{History||1.17|snap=21w08a|Stone swords can now be crafted using [[cobbled deepslate]].}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden swords.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond swords to netherite swords now requires the netherite upgrade [[smithing template]].}}
{{History|upcoming java}}
{{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed for all swords has been increased to 3.
|The base [[damage]] is now {{Hp|2}}, meaning that all swords now do {{Hp|1}} more damage than before}.
|The attack reach of swords has been increased to 3.5 [[block]]s.}}
{{History|||snap=Combat Test 2|The attack speed of all swords has been decreased to 2.5.}}
{{History|||snap=Combat Test 3|The attack speed of all swords has been changed from 2.5 back to 3.0.
|The attack key can now again be held down to automatically attack when the attack meter is full.
|Attacks now happen only when the sword is at 120% charge, slower than if attacks were timed.}}
{{History|||snap=Combat Test 4|Sword can now perform critical, knockback ([[sprint]]) hits on 100% charge.
|The attack reach of all weapons was decreased by 0.5 [[block]]. Sword now have a 3 [[block]]s reach.
|The 200% attack now gives a bonus reach of 1 [[block]].}}
{{History|||snap=Combat Test 5|Weapons have been nerfed. All material tiers have been nerfed by {{Hp|1}} except wood and gold, and the sword tier have been nerfed by {{Hp|1}}. This means that the wooden/stone/golden sword now does {{Hp|4}} damage, the iron sword now does {{Hp|5}} damage and the diamond sword now does {{Hp|6}} damage.}}
{{History|||snap=Combat Test 6|All weapons' attack reach have been buffed by 0.5 [[block]].
|200% attacks have been removed.
|Swords now always do sweep attack, even in the air.
|The cooldown for missed hit is a 4-tick cooldown instead of using the attack speed attribute.}}
{{History|||snap=Combat Test 7c|All weapons' attack reach have been nerfed by 0.5 [[block]]. The sword's attack reach is now 3 [[block]]s again.
|200% attacks have been re-added.
|Swords no longer sweep without [[Sweeping Edge]] and 200% charge again.
|Adjusted the netherite tier value to match the weapon nerf in Combat Test 5}}
{{History|||snap=Combat Test 8b|Enchantment bonus attack damage are now included in the base damage when calculating critical hits (they were excluded before). Due to this change, enchanted swords critical attacks are now way more powerful (especially with high enchantments)}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Stone Sword JE1 BE1.png|32px]] Added stone swords.}}
{{History||v0.3.0|[[File:Wooden Sword JE1 BE1.png|32px]] Added wooden swords.
|Survival players no longer start out with an infinite durability stone sword in the inventory.}}
{{History||v0.3.2|[[File:Iron Sword JE1 BE1.png|32px]] [[File:Golden Sword JE2 BE1.png|32px]] [[File:Diamond Sword JE1 BE1.png|32px]] Added iron, gold, and diamond swords.}}
{{History||v0.4.0|Iron swords have replaced stone swords in the creative inventory.}}
{{History||v0.9.0|snap=build 1|Iron swords can now be found in [[stronghold]] altar [[chest]]s and inside blacksmith chests.}}
{{History||v0.11.0|snap=build 11|Wooden, stone, golden and diamond swords are now available in the [[creative]] [[inventory]].}}
{{History||v0.11.0|snap=build 12|Wooden, stone, golden and diamond swords have been removed from creative.}}
{{History||v0.11.0|snap=build 13|All swords are available in creative mode again.}}
{{History||v0.12.1|snap=build 1|Instead of replacing the barehanded [[damage]] ({{hp|1}}), swords now add their damage onto the barehanded damage, which results in all swords doing {{hp|1}} more damage than before.|In [[creative]] mode, swords are no longer able to break [[block]]s, and no [[sound]] plays when they're hit with one.|Golden swords can now be found in [[nether fortress]] chests.
|[[Zombie]]s now rarely spawn holding an iron sword that have a chance to [[drops|dropped]].
|Golden swords are now rarely dropped by [[zombie pigmen]].
|Stone swords are now rarely dropped by [[wither skeleton]]s.}}
{{History||v0.15.0|snap=build 1|Iron swords are now sometimes dropped by [[husk]]s that spawn holding an iron sword.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Enchanted iron and diamond swords can now be found in [[end city]] [[chest]]s.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Iron swords and enchanted diamond swords are now sold by weaponsmith [[villager]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden swords are now [[smelting|smeltable]].
|Added [[vex]]es, which rarely drop an iron sword if killed using [[Looting]] enchantment.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Wooden Sword JE2 BE2.png|32px]] [[File:Stone Sword JE2 BE2.png|32px]] [[File:Iron Sword JE2 BE2.png|32px]] [[File:Golden Sword JE3 BE2.png|32px]] [[File:Diamond Sword JE2 BE2.png|32px]] The textures of all swords have been changed.
|Iron swords are now found in [[plains]] [[village]] weaponsmiths.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron swords can now be found in [[savanna]], [[snowy taiga]], [[taiga]] and [[desert]] village weaponsmiths.}}
{{History|||snap=beta 1.11.0.4|[[Pillager]]s and [[vindicator]]s that spawn in [[raid]]s can now drop iron swords upon [[death]].
|[[Trading]] has been changed. Iron swords [[trading|sold]] by weaponsmith [[villager]]s now cost 2 [[emerald]]s while diamond swords cost 8 emeralds as part of their fourth tier trades.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Sword BE1.png|32px]] Added netherite swords.
|Netherite swords are obtained by combining one diamond sword and one [[netherite ingot]] in a [[crafting table]].
|[[File:Diamond Sword JE3 BE3.png|32px]] The texture of diamond swords has been changed.
|Golden swords are now sometimes [[drops|dropped]] by [[piglin]]s that spawn holding a golden sword.}}
{{History|||snap=beta 1.16.0.57|Netherite swords can no longer be [[crafting|crafted]].
|Netherite swords are now obtained by combining one diamond sword and one [[netherite ingot]] in a [[smithing table]].
|Stone swords can now be crafted using [[blackstone]].
|Golden and netherite swords now generate in [[bastion remnant]] chests.
|Golden swords now generate randomly enchanted in [[ruined portal]] chests.}}
{{History|||snap=beta 1.16.0.63|Diamonds swords now generate in place of netherite swords in bastion remnant [[chest]]s.}}
{{History||1.17.30|snap=beta 1.17.20.20|Swords now break [[bamboo]] instantly.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wooden Sword JE1 BE1.png|32px]] [[File:Stone Sword JE1 BE1.png|32px]] [[File:Iron Sword JE1 BE1.png|32px]] [[File:Golden Sword JE2 BE1.png|32px]] [[File:Diamond Sword JE1 BE1.png|32px]] Added swords (all five types).}}
{{History||xbox=TU5|The ability to block with swords has been added, giving the [[player]] more options in combat.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden swords are now [[smelting|smeltable]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wooden Sword JE2 BE2.png|32px]] [[File:Stone Sword JE2 BE2.png|32px]] [[File:Iron Sword JE2 BE2.png|32px]] [[File:Golden Sword JE3 BE2.png|32px]] [[File:Diamond Sword JE2 BE2.png|32px]] The textures of all swords have been changed.}}
{{History||ps=1.92|The ability to block with swords has been removed.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Wooden Sword JE1 BE1.png|32px]] [[File:Stone Sword JE1 BE1.png|32px]] [[File:Iron Sword JE1 BE1.png|32px]] [[File:Golden Sword JE2 BE1.png|32px]] [[File:Diamond Sword JE1 BE1.png|32px]] Added swords.
|Swords cannot block attacks.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*The sword's traditional [[texture]] came from [[Notch]]'s abandoned RPG, ''[[Legend of the Chambered]]''. The iron sword's texture was created first, as it was from the game, and the other swords followed.
*In ''Java Edition'', with the introduction of netherite swords, it is possible to one-hit kill undead [[mob]]s in the game (except [[wither]]s and [[zombie]]s/[[skeleton]]s with random armor) using a sword with the [[Smite]] V enchantment, without the need to perform a critical hit (this was previously possible only with a [[Smite]] V stone, iron, or diamond axe).
*Plastic diamond and enchanted swords are official ''[[Minecraft]]'' merchandise.<ref>https://shop.minecraft.net/products/minecraft-sword?_pos=1&_psq=sword&_ss=e&_v=1.0</ref><ref>https://shop.minecraft.net/products/minecraft-enchanted-purple-sword?_pos=4&_psq=sword&_ss=e&_v=1.0</ref>
*In the game [[wikipedia:Transformice|''Transformice'']], a diamond sword can be found in the shop.

== Gallery ==
=== Enchanted swords ===
<gallery>
Enchanted Wooden Sword.gif|Enchanted wooden sword.
Enchanted Stone Sword.gif|Enchanted stone sword.
Enchanted Iron Sword.gif|Enchanted iron sword.
Enchanted Golden Sword.gif|Enchanted golden sword.
Enchanted Diamond Sword.gif|Enchanted diamond sword.
Enchanted Netherite Sword.gif|Enchanted netherite sword.
</gallery>

=== Texture packs ===
<gallery>
File:Wood sword TP.png|Wooden sword in the [[Texture Pack DLC|Plastic Pack]].
Stone Sword SDGP.png|Stone sword in the [[Super Duper Graphics Pack]].
File:Gold sword Natural.png|Gold sword in the [[Texture Pack DLC|Natural Pack]].
</gallery>

=== In other media ===
<gallery>
File:Alex Fighting in Nether.jpeg|Pixel art of [[Alex]] fighting with a diamond sword in the [[Nether]].
File:Alex Retrieving Diamond Sword.jpeg|Alex retrieving another diamond sword from a [[chest]].
File:Sinister Sword Sprite MCD.png|The [[MCD:Sinister Sword|Sinister Sword]], a unique sword featured in ''Minecraft Dungeons''.
File:Sword GUI.png|A nondescript [[MCD:Sword|sword]] as it appears in ''[[Minecraft Dungeons]]''.
File:Sword (item).png|A sword as it appears in ''[[Legend of the Chambered]]''.
File:Sword Shirt.png|Officially licensed T-Shirt of a diamond sword.
File:IronSword replica.jpg|Foam replica of an iron sword.
</gallery>

== References ==
{{reflist}}

{{Items}} 
[[Category:Tools]]
[[Category:Combat]]

[[de:Schwert]]
[[es:Espada]]
[[fr:Épée]]
[[hu:Kard]]
[[ja:剣]]
[[ko:검]]
[[nl:Zwaard]]
[[pl:Miecz]]
[[pt:Espada]]
[[ru:Меч]]
[[tr:Kılıç]]
[[uk:Меч]]
[[zh:剑]]</li></ul>
18w16aRenamed Roofed Forest M to Mutated Roofed Forest.
18w19aRenamed Roofed Forest to Dark Forest.
Renamed Mutated Roofed Forest to Dark Forest Hills
pre5Changed the ID roofed_forest to dark_forest.
Changed the ID mutated_roofed_forest to dark_forest_hills.
1.14
{{Extension DPL}}<ul><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}
'''Sugar cane''' is a block found as 1–4-block-tall. It plants near water in the [[Overworld]]. As an item, it is an important crafting ingredient.

== Obtaining ==
Sugar cane can be mined instantly with anything.

When the spot a sugar cane block is placed in becomes unsuitable, such as when the supporting block is removed, the sugar cane block uproots and drops as an item. {{IN|be}}, sugar cane uproots immediately after all adjacent water is removed. {{IN|je}}, sugar cane uproots on the next block update or [[Tick#Random tick|random tick]].

A sugar cane block drops itself as an item if a piston tries to push it (trying to pull it does nothing) or moves a block into its space.

=== Natural generation ===
[[File:Sugar Canez.png|thumb|250px|Naturally-occurring sugar cane near a river.]]
Sugar cane can generate naturally near [[water]], as two ({{frac|11|18}} chance), three ({{frac|5|18}} chance), or four ({{frac|2|18}} chance) blocks tall. Rare taller sugar canes can be found if the world generator places two smaller canes on top of each other. It generates in approximately 0.8 sugar cane per chunk seeing as how they only generate near bodies of water.

Sugar canes attempt to generate 10 times in any Overworld biome, which requires water. An extra 10 attempts are made in [[swamp]] biomes, and 50 in [[desert]] biomes, which makes sugar cane twice as frequent in swamps and six times as frequent in desert biomes, making the banks of [[river]]s that cut through deserts lined with sugar canes.

Sugar cane cannot generate in caves {{in|je}}.<ref>{{bug|MC-214959||Sugar cane generated in cave|Fixed}}</ref>

=== Trading ===
[[Wandering trader]]s can sell sugar cane for an [[emerald]].

== Usage ==
Due to its water-displacing properties, sugar cane can interestingly be used to create underwater paths, allowing [[player]]s to move at normal speed and breathe if it is two blocks in height.{{only|java}}<ref>{{bug|MC-929||Sugar cane can be placed underwater|WAI}}</ref>

Sugar cane takes on a different shade of green depending on the biome in which it is placed.

=== Crafting ingredient ===
{{crafting usage}}

=== Farming ===
{{main|Tutorials/Sugar cane farming}}
[[File:Underground Sugar Farm.png|200px|thumb|An underground sugar cane farm.]]

Sugar cane can generate naturally up to any number of blocks tall, but ''grow'' only to a height of three blocks, adding a block of height when the top sugar cane block has received 16 random [[Tick#Block tick|block tick]]s (i.e. on average every 18 minutes on ''Java Edition''<!-- Average 68.27 seconds/tick * 16 ticks/growth = 18.2 minutes --> or 54 minutes on Bedrock Edition, but the actual rate can vary widely). 
Sugar cane must be planted on a [[grass block]], [[dirt]], [[coarse dirt]], [[rooted dirt]], [[podzol]], [[mycelium]], [[sand]], [[red sand]], [[suspicious sand]], [[moss block]], or [[mud]] that is directly adjacent to [[water]], [[waterlogged]] block, or [[frosted ice]] (not merely above or diagonal to water), or on top of another sugar cane block. The adjacent water block can be covered with another block, whether [[opacity|opaque or transparent]], and sugar cane can still be placed and grow next to it. Sugar cane grows regardless of light level, even in complete darkness.
[[File:4blockcane.png|thumb|A natural 4-block-high sugar cane plant.]]
{{IN|bedrock}}, [[bone meal]] can be used to instantly grow sugar cane to three blocks. Only one bone meal is consumed. {{IN|java}}, bone meal cannot be used on sugar cane.<ref>{{bug|MC-73963||Can't use bonemeal on cacti or sugar cane|WAI}}</ref>

On average, it takes [[Tutorials/Sugar_cane_farming#Mechanics|18 minutes]] for a single block of sugar cane to grow 3 blocks tall.

=== Composting ===
Placing sugar cane into a [[composter]] has a 50% chance of raising the compost level by 1.

== List of colors ==
{{Missing information|Bedrock Edition colors (see [[Water#Color]]{{verify|it's there?}})}}

=== ''Java Edition'' ===
These values are generated by the biome dyeing algorithm. See [[Color#Biome colors|Biome colors]] for more information.
<div class="mw-collapsible mw-collapsed" style="float: left">
{| class="wikitable sortable" style="text-align:center" data-description="Java edition biome colors"
!Biome !! Category !! Rainfall !! Sugarcane Color !! Temperature Affects !! Render
|-
| {{BiomeLink|Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Beach}} || Beach || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Birch Forest}} || Forest || Rain || #88bb67 || || [[File:Birch Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Cold Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Dark Forest}} || Forest || Rain || #507a32 || || [[File:Dark Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Cold Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Frozen Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Lukewarm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Desert}} || Desert || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Barrens}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Highlands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Midlands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Eroded Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Flower Forest}} || Forest || Rain || #79c05a || || [[File:Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Forest}} || Forest || Rain || #79c05a || || [[File:Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Frozen Ocean}} || Ocean || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Frozen River}} || River || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Spruce Taiga}} || Taiga || Rain || #86b783 || || [[File:Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Pine Taiga}} || Taiga || Rain || #86b87f || || [[File:Old Growth Pine Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Ice Spikes}} || Icy || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Jungle}} || Jungle || Rain || #59c93c || || [[File:Jungle Sugar Cane.png|32px]]
|-
| {{BiomeLink|Sparse Jungle}} || Jungle || Rain || #64c73f || || [[File:Sparse Jungle Sugar Cane.png|32px]]
|-
| {{BiomeLink|Lukewarm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Hills}} || Extreme Hills || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|-
| {{BiomeLink|Mushroom Fields}} || Mushroom || Rain || #55c93f || || [[File:Mushroom Fields Sugar Cane.png|32px]]
|-
| {{BiomeLink|Nether}} || Nether || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Plains}} || Plains || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|River}} || River || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Savanna}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Savanna Plateau}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Savanna}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Small End Islands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Beach}} || Beach || Snow || #83b593 || || [[File:Snowy Beach Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Taiga}} || Taiga || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Plains}} || Icy || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Stony Shore}} || None || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|-
| {{BiomeLink|Sunflower Plains}} || Plains || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Swamp}} || Swamp || Rain || #6A7039 || If temperature below -0.1, used #4C763C. || [[File:Swamp Sugar Cane.png|32px]] / [[File:Swamp Sugar Cane (Cold).png|32px]]
|-
| {{BiomeLink|Taiga}} || Taiga || Rain || #86b783 || || [[File:Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Birch Forest}} || Forest || Rain || #88bb67 || || [[File:Birch Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|The End}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|The Void}} || None || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Warm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Wooded Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Forest}} || Extreme Hills || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|}
</div>
{{clear}}
=== Bedrock Edition ===
{{empty section}}

== Sounds ==
{{Sound table/Block/Grass}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Sugar Cane
|spritetype=block
|nameid=sugar_cane
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Sugar Cane
|shownumericids=y
|showforms=y
|showaliasids=y
|generatetranslationkeys=y
|displayname=Block
|spritename=sugar-cane
|spritetype=block
|nameid=reeds
|id=83
|form=block
|itemform=item.reeds}}
{{ID table
|displayname=Item
|spritename=sugar-cane
|spritetype=item
|nameid=sugar_cane
|id=385
|form=item
|aliasid=reeds
|translationkey=item.reeds.name
|foot=1}}

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

{{/BS}}

== Video ==
{{Video note|This video was made before sugar cane had a different shade of green depending on the biome.|minor}}
<div style="text-align:center">{{yt|zlOnwn3PH5o}}</div>

== History ==
{{more images|Appearance when affected by {{bug|MC-48831}}}}
{{History|java alpha}}
{{History||v1.0.11|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added reeds in the [[Seecret Updates|Seecret Friday Update 6]].
|Reeds are informally referred to as "bamboo" or "papyrus" by many [[player]]s. 
|Since reeds can be washed away with [[water]] currents or instantly destroyed by removing the water adjacent to them, automated reed farms can be made. 
|Reeds can be used to craft [[paper]].}}
{{History|java beta}}
{{History||1.2|[[Notch]] has [[wikipedia:Retroactive continuity|retconned]] reeds into sugar cane so that it can now be [[crafting|crafted]] into [[sugar]], included in the recipe for the [[cake]]s.}}
{{History||1.6|snap=Test Build 3|[[Arrow]]s no longer stick to sugar cane, and instead, they pass through. However, [[snowball]]s still come into contact with any sugar cane blocks, as if they are solid.}}
{{History||1.8|snap=Pre-release|Sugar cane can now grow and be placed onto [[sand]] as long as they are adjacent to [[water]]. This update allows sugar canes to appear next to [[water]] ponds in [[desert]] biomes.
|Sugar cane is now available in the [[creative]] [[inventory]] in both block and item forms.}}
{{History|java}}
{{History||1.0.0|snap=?|The sugar cane block has been removed from the creative inventory.}}
{{History||1.7.2|snap=13w36a|[[File:Sugar Cane JE2 BE2.png|32px]] Sugar cane is now [[tint]]ed depending on the [[biome]] it's in.
|The item texture remained unchanged, however, and still used the color palette from Alpha to 1.6.4.<ref name="Bug">{{bug|MC-216227}}</ref>}}
{{History||1.9|snap=15w43a|Sugar cane no longer breaks if its adjacent [[water]] is turned to [[frosted ice]].}}
{{History||1.13|snap=17w47a|The ID of sugar cane has now been changed from <code>reeds</code> to <code>sugar_cane</code>.
|"Sugar Canes" have now been renamed to "Sugar Cane".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 83, and the [[item]]'s 338.}}
{{History||1.14|snap=18w43a|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane item has been changed.}}
{{History|||snap=19w03a|Placing sugar cane into a [[composter]] has a 20% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Sugar cane now has a 50% chance of increasing the compost level in a composter by 1.
|Added [[wandering trader]]s, which sell sugar cane.}}
{{History||1.16|snap=20w13a|Sugar cane has been moved from the Miscellaneous tab to the Decoration Blocks tab in the [[Creative inventory]].<ref name="misc decoration">https://bugs.mojang.com/browse/MC-174434</ref>}}
{{History||1.17|snap=21w11a|[[File:Sugar Cane (item) JE3.png|32px]] The texture of the sugar cane item has been changed, so that it actually matches the color it uses when placed again.<ref name="Bug"/>}}
{{History|||snap=Pre-release 1|Sugar cane now generates in mushroom fields.<ref>{{bug|MC-226683}}</ref>}}
{{History||1.19|snap=22w15a|Sugar cane can now be planted on mud.}}
{{History||1.20|snap=23w14a|Sugar cane can now be planted on [[suspicious sand]].}}

{{History|pocket alpha}}
{{History||Pre-release|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar cane.}}
{{History||v0.2.0|Despite being visible in the inventory, sugar cane does not drop anything when mined, making it unobtainable in Survival mode.}}
{{History||v0.2.1|Survival players now start with an infinite stack of sugar cane in the inventory.}}
{{History||v0.3.0|Sugar cane now drops its item form when mined.
|Survival players no longer start with an infinite stack of sugar cane in the inventory.}}
{{History||v0.5.0|Sugar cane can now be grown on [[sand]].
|Sugar cane can now be obtained after activating the [[nether reactor]].}}
{{History||v0.8.0|snap=build 5|[[Bone meal]] can now grow sugar cane to maximum height.}}
{{History||v0.9.0|snap=build 1|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar cane now changes depending on the [[biome]] they are in.
|Using bone meal on sugar cane is no longer able to break blocks above it.}}
{{History||v0.12.1|snap=build 1|Sugar cane is no longer available from the [[nether reactor]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Sugar Cane JE1 BE1.png|32px]] Due to a bug, sugar canes no longer change color depending on the [[biome]].}}
{{History|bedrock}}
{{History||1.2.13|snap=beta 1.2.13.5|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar canes now changes depending on the [[biome]], once again.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane [[item]] has been changed.
|Sugar cane can now be [[trading|bought]] from [[wandering trader]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Sugar canes can now be used to fill up [[composter]]s.}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Sugar Cane (item) JE3.png|32px]] The texture of the sugar cane item has been changed, so that it actually matches the color it uses when placed again.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar canes.
|Sugar canes are solid, making it useful for growable walls. Unlike on Java Edition, they were never renamed to Sugar Cane.}}
{{History||xbox=TU2|Sugar canes are no longer solid, and arrows pass through them.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar cane now changes depending on the [[biome]] they're in.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|Sugar cane can now be grown with [[bonemeal]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane [[item]] has been changed.}}
{{History||xbox=none|xbone=none|ps=1.91|wiiu=none|switch=none|Sugar cane can now be [[trading|bought]] from [[wandering trader]]s.
|Sugar canes can now be used to fill up [[composter]]s.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar cane.}}
{{History|foot}}

=== Sugar cane "item" ===
{{:Technical blocks/Sugar Cane}}

== Issues ==
{{Issue list}}

== Trivia ==
*When a sugar cane is broken at the second level, the time resets (for example, if a two-block high sugar cane is broken, but is just about to grow to the third stage, it would reset that time).
*By placing more sugar canes on top of a sugar cane plant, it is possible to create tall sugar canes (up to y=319, the maximum height for building), although they do not naturally grow this high.
*Before sugar cane received an official name, they were sometimes referred to as [[bamboo]], a block added 9 years later. Other names were "reeds" and "papyrus".

== Gallery ==
=== Renders ===
<gallery>
Plains Sugar Cane.png|Plains
Taiga Sugar Cane.png|Taiga
Snowy Plains Sugar Cane.png|Snowy plains
Jungle Sugar Cane.png|Jungle
Desert Sugar Cane.png|Desert
Swamp Sugar Cane (Cold).png|Swamp (cold)
Swamp Sugar Cane.png|Swamp
Badlands Sugar Cane.png|Badlands
</gallery>

=== In-game ===
<gallery>
Huge Sugar Farm.png|A large sugar cane farm using 2×2 [[water]] holes.
Sugar Cane Waterfall.png|Water flowing over sugar cane.
UnderwaterSugarCane.png|Naturally generated sugar cane found underwater.
Sugar and Cactus.png|A [[cactus]] and sugar cane stalk generated next to each other.
SugarCaneRavine.png|Sugar cane found in the [[ravine]].
Reeds in Winter mode.png|Reeds generated in the [[winter mode]].
Sugar Cane Naturally Growing.png|Sugar cane growing between [[biome]]s.
Mesa Sugar Cane.jpg|Sugar cane growing on [[red sand]] in a [[badlands]] biome.
Sugarcanenowaterglitch.png|Sugar cane generated without a water source.
SwampCane.png|Sugar cane generated in a [[swamp]] biome.
Sugar cane savanna.png|Sugar cane growing in a [[savanna]] biome.
ForestSugarcane.png|Sugar cane growing in a [[forest]] biome.
Lava cane.png|Sugar cane growing with lava flowing around it.
Before breaking.png|Sugar canes few seconds before breaking because the water is frozen.
Undergroundreed.png|A sugar cane plant that generated in an underground [[water lake]].
Cave Sugar.png|Another example.
</gallery>

=== Heights ===
<gallery>
Tall Sugar Cane.png|Four-block tall sugar cane.
4RiverCane.png|Four-block tall sugar cane.
4-block tall sugar cane.png|Four-block tall sugar cane in a [[plains]] biome.
</gallery>

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

[[Category:Plants]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li><li>[[Spyglass|Spyglass]]<br/>{{Item
| title = Spyglass
| image = Spyglass.png
| durability = 
| rarity = Common
| renewable = Yes
| stackable = No
}}
 
A '''spyglass''' is a [[tool]] used to zoom in on distant objects.

== Obtaining ==
=== Crafting ===
{{Crafting
  |B1=Amethyst Shard
  |B2=Copper Ingot
  |B3=Copper Ingot
  |Output=Spyglass
  |type=Tool
}}

== Usage ==
[[File:Steve scoping Spyglass.png|right|100px]] [[File:Alex scoping Spyglass.png|right|100px]]

To use a spyglass, the player selects it from the hotbar and clicks {{control|use}} while looking in the desired direction.

Spyglasses are used to zoom in on a specific location in the player's field of view (FOV). The spyglass changes the FOV to {{frac|1|10}} of the FOV set in [[options]]. By default, the FOV is set to 70° in ''Java Edition'' and 60° in Bedrock Edition, resulting in an FOV of 7° in ''Java Edition'' and 6° in Bedrock Edition through the spyglass. The player's FOV can be set from 30° to 110°, so the spyglass FOV can  range from 3° to 11°. Regardless of the situation, or status effects the player has, using the Spyglass always shows a FOV {{frac|1|10}} of the FOV set in [[options]].

A square vignette is applied when in use, similar to the effect when wearing a [[carved pumpkin]]. Pressing {{key|F1}} removes the vignette,{{only|java}}<ref>{{bug|MC-203575||The spyglass overlay goes away when pressing F1|WAI}}</ref><ref>{{bug|MCPE-125869||Spyglass's overlay don't go away even if the player toggles Hide GUI on/ Pressing F1|}}</ref> similar to a carved pumpkin. 

Hazy distant objects remain hazy when viewed in the spyglass. Mobs too distant to render also do not render in the spyglass. The spyglass shows a magnified view of what the player already sees.

The player is slowed down while watching through the spyglass. When the player uses the spyglass continuously for {{convert|1|minute|game tick}}, the interface is automatically closed.

If the player has a certain effect on their screen like [[fire]], the spyglass does not remove that effect on the player's screen.

[[File:Spyglass Zooming.gif|thumb|center|A spyglass being used to zoom in on a [[block of gold]] starting from normal FOV (70°).]]

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Spyglass use.ogg
|subtitle=Spyglass expands
|source=player
|description=When a player uses a spyglass
|id=item.spyglass.use
|translationkey=subtitles.item.spyglass.use
|volume=0.5
|pitch=''varies'' <ref group=sound>Can be 1.15, 1.33, 1.4, or 1.55</ref>
|distance=16}}
{{Sound table
|sound=Spyglass stop.ogg
|subtitle=Spyglass retracts
|source=player
|description=When a player stops using a spyglass
|id=item.spyglass.stop_using
|translationkey=subtitles.item.spyglass.stop_using
|volume=0.5
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 0.9</ref>
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Spyglass use.ogg
|source=player
|description=When a player uses a spyglass
|id=item.spyglass.use
|volume=0.5
|pitch=1.15-1.55}}
{{Sound table
|sound=Spyglass stop.ogg
|source=player
|description=When a player stops using a spyglass
|id=item.spyglass.stop_using
|volume=0.5
|pitch=0.8-1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Spyglass
|spritetype=item
|nameid=spyglass
|form=item
|foot=1|id=626}}

== Advancements ==
{{load advancements|Is it a Bird?;Is it a Balloon?;Is it a Plane?}}

== History ==
{{History||October 3, 2020|link={{ytl|DBvZ2Iqmm3M|t=25m21s}}|[[File:Spyglass JE1.png|32px]]<!-- [[File:Spyglass scope (pre-release).png|32px]]--> Spyglasses are revealed at [[Minecraft Live 2020]]. They were originally named "telescopes" and had an oval vignette.}}
{{History|java}}
{{History||1.17|snap=20w45a|[[File:Spyglass JE1.png|32px]] Added spyglasses.
|[[File:Spyglass scope JE1.png|32px]] The scope texture is currently a circle with glare spots.}}
{{History|||snap=20w46a|[[File:Spyglass scope JE2.png|32px]] The scope texture is now a [[glass]] square with a [[copper]] border.}}
{{History|||snap=20w48a|[[File:Spyglass JE2 BE1.png|32px]] The spyglass is now a 3D model instead of a flat sprite.
|[[File:Spyglass (texture) JE2.png|32px]] The texture of the spyglass has changed.
|A spyglass in use is anchored better to the player's "eye" when viewed in 3rd person.}}
{{History|||snap=21w05a|Copper ingots are now renewable via [[drowned]], making spyglasses renewable.}}
{{History|||snap=21w10a|[[File:Spyglass (item) JE3 BE1.png|32px]] Spyglasses have a new texture in the inventory. The 3D model is still used in the hand, similar to [[tridents]].}}
{{History||1.17.1|snap=Pre-release 1|[[File:Spyglass (texture) JE3.png|32px]] The texture of the spyglass model has changed.}}
{{History|bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Spyglass JE2 BE1.png|32px]] [[File:Spyglass (item) JE3 BE1.png|32px]] Added spyglasses.}}
{{History|||snap=beta 1.17.0.52|Spyglasses are now available without enabling [[experimental gameplay]].}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
*If {{command|item replace}} is used to place a spyglass on a player's head, the item appears stuck to the center of the player's face.

== Gallery ==
<gallery>
Villager Spyglass.png|Spying on [[villager]]s through a spyglass.
After using the spyglass at FOV 30 F1.png|Hiding the HUD removes the spyglass overlay.
Panda eating a spyglass.png|When eaten by a [[panda]], spyglasses cause [[missing texture]] particles to be produced.<ref>{{bug|MC-206684}}</ref>
JE 1.17 Development Telescope.jpg|The spyglass was originally called the telescope.
JE 1.17 Development Telescope 2.jpg|The telescope's overlay was originally round instead of square.
File:Ari Spyglass.jpg|How the spyglass looks in the third person.
Steve scoping Spyglass JE1.png|Steve using a spyglass before its 3D model was added.
Alex scoping Spyglass JE1.png|Alex using a spyglass before its 3D model was added.
File:Mangrove Portal.jpg|An [[allay]] peeking into view of [[Noor]]’s spyglass.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--spyglass Taking Inventory: Spyglass] – Minecraft.net on February 17, 2022

{{Items}}

[[Category:Renewable resources]]

[[de:Fernrohr]]
[[es:Catalejo]]
[[fr:Longue-vue]]
[[it:Cannocchiale]]
[[ja:望遠鏡]]
[[pl:Luneta]]
[[pt:Luneta]]
[[ru:Подзорная труба]]
[[zh:望远镜]]</li></ul>
18w43aAdded lily of the valley that can generate in dark forests.
Pocket Edition Alpha
0.9.0
{{Extension DPL}}<ul><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.

== 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|}}

=== 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><li>[[Bookshelf|Bookshelf]]<br/>{{About|the bookshelf used with an enchanting table|the bookshelf that can hold books|Chiseled Bookshelf}}
{{Block
|image=Bookshelf.png
|transparent=No
|light=No
|tool=Axe
|renewable=Yes
|stackable=Yes (64)
|flammable=Yes (30)
|lavasusceptible=Yes
}}
'''Bookshelves''' are [[blocks]] that improve [[enchanting|enchantments]] applied with an [[enchanting table]] when placed around one, up to a maximum of fifteen bookshelves, at the expense of [[Enchanting/Levels|level]] requirement.

== Obtaining ==
=== Natural generation ===
Bookshelves can generate in village libraries and sometimes village houses.

[[Stronghold]]s may contain up to two libraries, each of which may be single-level or have an upper balcony. These feature some bookshelves arranged in pillars, and more bookshelves arranged in pillars in the walls. Single-level libraries contain 161 bookshelves, while libraries with balconies contain 233.

Bookshelves also naturally generate in certain [[woodland mansion]] rooms.

=== Breaking ===
Bookshelves can be broken fairly easily by hand, but can be broken faster by using an [[axe]]. In either case, they drop 3 books when broken, allowing the reconstruction of the bookshelf with the addition of six wood planks. When broken by an item that is [[enchanted]] with [[Silk Touch]], a bookshelf drops itself.
{{breaking row|horizontal=1|Bookshelf|Axe}}

=== Crafting ===
{{Crafting
|A1=Any Planks
|B1=Any Planks
|C1=Any Planks
|A2=Book
|B2=Book
|C2=Book
|A3=Any Planks
|B3=Any Planks
|C3=Any Planks
|Output=Bookshelf
|type=Building block
}}

=== Trading ===
Novice-level librarian [[Villager|villagers]] have a 50% chance to sell 1 bookshelf for 9 [[Emerald|emeralds]] as part of their trades.{{only|bedrock}}

Novice-level librarian villagers have a {{frac|2|3}} chance to sell 1 bookshelf for 9 emeralds.{{only|java}}

== Usage ==
=== Enchanting ===
{{main|Enchantment mechanics#Bookshelf placement}}

If an [[enchanting table]] is placed near a bookshelf, glyph [[particles]] fly from the bookshelf toward the enchanting table. Having bookshelves in the proper position near the table allows the table to apply higher-level enchantments.

=== Crafting ingredient ===
{{crafting usage}}

=== Fuel ===
Bookshelves can be used as a [[fuel]] in [[furnace]]s, smelting 1.5 items per block.

=== Villager ===
Librarian [[villager]]s can interact with bookshelves.

=== Note Blocks ===
Bookshelf can be placed under [[note block]]s to produce "bass" sounds.

== Sounds ==
{{Sound table/Block/Wood}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Bookshelf
|spritetype=block
|nameid=bookshelf
|showblocktags=y|blocktags=mineable/axe
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bookshelf
|spritetype=block
|nameid=bookshelf
|id=47
|foot=1}}

== Achievements ==
{{load achievements|Librarian}}

== History ==
{{History|java classic}}
{{History||October 24, 2009|link=https://notch.tumblr.com/post/221308991/the-new-block-types-and-new-graphics-for-the-gold|Bookshelves were teased by [[Notch]].}}
{{History||0.26 SURVIVAL TEST|[[File:Bookshelf JE1.png|32px]] Added bookshelves.
|Bookshelves are currently impossible to obtain without loading a pre-edited map.
|Bookshelves are currently destroyed in [[explosion]]s.
|When bookshelves are broken, they currently do not drop anything.}}
{{History||0.28|Bookshelves can now be freely placed.}}
{{History|java alpha}}
{{History||v1.0.11|Bookshelves can now be [[crafting|crafted]] from 3 [[book]]s and 6 [[planks]].}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|Bookshelves can now be found generated in libraries in [[village]]s, and libraries in [[stronghold]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Bookshelves now drop 3 [[book]]s when broken by a non-[[Silk Touch]] [[item]].
|They are now necessary to [[enchanting|enchant]] with higher levels for better enchanted items.
|The number of bookshelves required to reach the maximum enchantment level is 30.}}
{{History|||snap=Beta 1.9 Prerelease 5|[[File:Bookshelf JE2 BE1.png|32px]] The top texture of bookshelves have now been updated as a result of the [[planks]] texture update.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft bookshelves.}}
{{History||1.3.1|snap=12w21a|Librarian [[villager]]s now [[trading|sell]] 1 bookshelf for 3 [[emerald]]s.}}
{{History|||snap=12w22a|The number of bookshelves required to reach the maximum enchantment level has been now decreased to 15.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft bookshelves.}}
{{History||1.8|snap=14w02a|Librarian villagers now sell 1 bookshelf for 3–4 [[emerald]]s.}}
{{History||1.11|snap=16w39a|Bookshelves now generate in [[woodland mansion]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 47.}}
{{History||1.14|snap=18w43a|[[File:Bookshelf JE3.png|32px]] The texture of bookshelves has now been changed.}}
{{History|||snap=18w47a|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has now been changed, once again.}}
{{History|||snap=19w02a|Bookshelves can now be used to craft [[lectern]]s.}}
{{History||1.16|snap=20w06a|[[Crimson planks]] and [[warped planks]] can now be used to craft bookshelves.}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft bookshelves.}}

{{History|pocket alpha}}
{{History||v0.2.1|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves.|Bookshelves are currently obtainable only in [[Creative]] mode.}}
{{History||v0.3.0|Bookshelves are now obtainable in [[Survival]] mode.}}
{{History||v0.9.0|snap=build 1|Bookshelves now naturally spawn in [[stronghold]]s and [[village]]s.}}
{{History||v0.12.1|snap=build 1|Bookshelves can now be used to increase [[enchantment table]] levels.|Bookshelves can now be obtained by using a [[tool]] with the [[Silk Touch]] enchantment.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Librarian [[villager]]s now [[trading|sell]] 1 bookshelf for 3-4 [[emerald]]s as their second tier trade.}} 
{{History||1.1.0|snap=alpha 1.1.0.0|Bookshelves now generate in [[woodland mansion]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|Bookshelves can now be used to craft [[lectern]]s.|Bookshelves now get inspected by librarian [[villager]]s.|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed, librarian villagers now have a 50% chance to sell a bookshelf for 6 [[emerald]]s as part of their first trade.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves. Whether they actually used this texture is unknown.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Bookshelves' top and bottom textures by default use the same texture as [[oak planks]].
* It takes 90 planks, 45 [[leather]] and 135 [[paper]] to make 15 bookshelves in order to get a level 30 [[enchantment]].
* A bookshelf is the icon for [[Education Edition]].

== Gallery ==
<gallery>
File:Library in Village.png|Naturally occurring bookshelves in a [[village]]. (Before Village & Pillage).
File:Large Stronghold Library.png|Naturally occurring bookshelves in a [[stronghold]].
File:Achievement get! Trading emeralds for bookshelves.png|Bookshelves obtained by [[trading]] with a [[villager]].
File:Enchanting-Table.png|Bookshelves powering an [[enchanting table]].
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/block-week-bookshelf Block of the Week: Bookshelf] – Minecraft.net on December 16, 2016

{{Blocks|Building}}

[[Category:Manufactured blocks]]
[[Category:Natural blocks]]
[[Category:Generated structure blocks]]
[[Category:Utility blocks]]
[[Category:Bedrock Edition]]
[[Category:Java Edition]]
[[Category:Items]]
[[Category:Flammable blocks]]

[[cs:Knihovna]]
[[de:Bücherregal]]
[[es:Librería]]
[[fr:Bibliothèque]]
[[hu:Könyvespolc]]
[[it:Libreria]]
[[ja:本棚]]
[[ko:책장]]
[[nl:Boekenkast]]
[[pl:Biblioteczka]]
[[pt:Estante de livros]]
[[ru:Книжные полки]]
[[th:ชั้นหนังสือ]]
[[uk:Книжкова полиця]]
[[zh:书架]]</li></ul>
build 1Added roofed forests, along with many other biomes.
Pocket Edition
1.1.0
{{Extension DPL}}<ul><li>[[Armor Stand|Armor Stand]]<br/>{{ItemEntity
| image = Armor Stand.png
| image2 = Armor Stand BE.png
| extratext = View [[#Gallery|all renders]]
| stackable =
* '''[[JE]]:''' Yes (16)
* '''[[BE]]:''' Yes (64)
| renewable = Yes
| flammable = Yes
| size = '''Normal:'''<br>
Width: 0.5 Blocks<br>
Height: 1.975 Blocks<br>
'''Small:'''<br>
Width: 0.25 Blocks<br>
Height: 0.9875 Blocks<br>
| health = {{hp|20}}
}}
An '''armor stand''' is an inanimate [[entity]] that can wear [[armor]]. It can also hold [[Item|items]] and be posed (but these are not possible in [[Survival]] in [[Java Edition]]).

== Obtaining ==
An armor stand can be broken by quickly {{control|attack|text=attacking}} it twice, dropping itself and any armor placed onto it.

=== Crafting ===
{{Crafting
|A1= Stick
|B1= Stick
|C1= Stick  
|B2= Stick
|A3= Stick
|B3= Smooth Stone Slab
|C3= Stick
|Output= Armor Stand
|type=Decoration block
}}

=== Natural generation ===
Two armor stands are found in each taiga [[village]] outdoor armory, one equipped with an [[iron helmet]], the other with an [[iron chestplate]].

== Usage ==
[[Player]]s can use armor stands to hold [[armor]], [[mob head]]s, [[carved pumpkin]]s, and [[elytra]]. [[Commands]] can be used to give them other [[item]]s. The stand does not have a GUI, so players interact with it directly. Armor stands are also able to be placed in different orientations, similar to [[banner]]s or [[sign]]s. Armor stands are [[entity|entities]], allowing them to be pushed by [[piston]]s, moved by flowing [[water]], pulled with [[fishing rod]]s, pushed by players (with knockback), and bounced by [[slime block]]s. 

{{Control|use|text=Using}} armor on the stand places the armor if done on a bare spot. Conversely, clicking on armor with a bare hand removes the armor and places it in the highlighted hotbar slot. It is not possible to take or place items from the armor stand's hands unless playing on Bedrock Edition.

Armor, mob heads, or carved pumpkins can be automatically placed on armor stands with a [[dispenser]].

Armor stands can be customized further to have arms, pose, disobey gravity, dual wield and other things by summoning them using {{cmd|summon}} with [[Chunk format#ArmorStand|NBT tags]].

In maps heavily using [[command blocks]], armor stands can be used to keep [[scoreboard]] objectives that are 'global' to the map, run [[commands]], etc. 

{{IN|bedrock}}, the pose of the armor stand can be changed by interacting with the armor stand (or pressing the {{btn|Pose|be=1}} button on mobile devices) while sneaking, or by using a redstone signal. There are 13 possible poses. Armor stands can also hold items by interacting with the armor stand (or pressing the {{btn|Equip|be=1}} button on mobile devices) while holding an item that cannot be worn.

;<nowiki>Below are the poses:
{| class="wikitable collapsible collapsed"
! No. !! Namespace ID !! Redstone power 
!
! !! Image
|-
| 0
| {{cd|animation.armor_stand.default_pose}}
| 0
|
|
| [[File:Armor Stand Default Pose.png|128px]]
|-
| 1
| {{cd|animation.armor_stand.no_pose}}
| 1
|
|
| [[File:Armor Stand No Pose.png|128px]]
|-
| 2
| {{cd|animation.armor_stand.solemn_pose}}
| 2
|
|
| [[File:Armor Stand Solemn Pose.png|128px]]
|-
| 3
| {{cd|animation.armor_stand.athena_pose}}
| 3
|
|
| [[File:Armor Stand Athena Pose.png|128px]]
|-
| 4
| {{cd|animation.armor_stand.brandish_pose}}
| 4
|
|
| [[File:Armor Stand Brandish Pose.png|128px]]
|-
| 5
| {{cd|animation.armor_stand.honor_pose}}
| 5
|
|
| [[File:Armor Stand Honor Pose.png|128px]]
|-
| 6
| {{cd|animation.armor_stand.entertain_pose}}
| 6
|
|
| [[File:Armor Stand Entertain Pose.png|128px]]
|-
| 7
| {{cd|animation.armor_stand.salute_pose}}
| 7
|
|
| [[File:Armor Stand Salute Pose.png|128px]]
|-
| 8
| {{cd|animation.armor_stand.hero_pose}}
| 8, 13 or more
|
|
| [[File:Armor Stand Hero Pose.png|128px]]
|-
| 9
| {{cd|animation.armor_stand.riposte_pose}}
| 9
|
|
| [[File:Armor Stand Riposte Pose.png|128px]]
|-
| 10
| {{cd|animation.armor_stand.zombie_pose}}
| 10
|
|
| [[File:Armor Stand Zombie Pose.png|128px]]
|-
| 11
| {{cd|animation.armor_stand.cancan_a_pose}}
| 11
|
|
| [[File:Armor Stand Cancan A Pose.png|128px]]
|-
| 12
| {{cd|animation.armor_stand.cancan_b_pose}}
| 12
|
|
| [[File:Armor Stand Cancan B Pose.png|128px]]
|}

== Behavior ==

Because armor stands are entities, they obey gravity, allowing them to fall and rest on non-full [[block]]s such as [[enchanting table]]s, [[snow layer]]s and [[slab]]s.

Any [[armor]] on the stand drops when the stand is broken. Armor stands can display [[enchanting|enchanted]] and all forms of [[dye]]d armor. The effects of most enchanted armor have no effect when on an armor stand, with three exceptions: 
* [[Frost Walker]] creates [[frosted ice]] blocks on [[water]] as usual if an armor stand is pushed with a [[piston]].
* [[Depth Strider]] slows the movement of the armor stand when being pushed with water. 
* A [[player]] may take damage from hitting an armor stand that holds armor enchanted with [[Thorns]].

Armor stands are not damaged by [[cacti]] but can be broken by [[arrow]]s. An armor stand destroyed by an explosion or a firework does not drop as an [[item (entity)|item]]. Armor stands in water and [[lava]] at the same time are not consumed by the lava.

{{IN|be}}, armor stands can be affected by [[status effect]]s. They can be 'killed' by [[Harming]] and [[Decay]] [[splash potion|splash]]/[[lingering potion]]s, lava, [[fire]], and [[campfire]]s, and they play the player death sound and fall to their side and disappear, yielding no armor stand item. If an armor stand is equipped with an item or armor, that item or armor is considered as "naturally-spawned equipment" with an 8.5% chance of dropping when the armor stand "dies" from the [[Instant Damage]] or the [[Wither (status effect)|Wither]] status effect. If the dropped item is any form of [[weapon]], [[tool]] or armor, it drops in a badly damaged state because the game considers it as "naturally-spawned equipment".<ref>{{Bug|MCPE-24341}}</ref>

The stand wobbles slightly when being hit by the player.

{{IN|java}}, it is possible to create an armor stand with arms using the {{cmd|summon}} [[command]]. It is also possible to change an armor stand without arms into a stand with arms by using the {{cmd|data}} command. The commands are as follows:

* <code>/data merge entity @e[type=armor_stand,sort=nearest,limit=1] {ShowArms:1}</code>, which changes the nearest armor stand into an armor stand with arms.
* <code>/summon minecraft:armor_stand ~ ~ ~ {ShowArms:1}</code>, which summons a new armor stand with arms shown.
*<code>/summon armor_stand ~ ~ ~ {Rotation:[0.0f]}</code>, which summons a new armor stand that faces a desired direction (dependent on changing "0.0f" to other numbers like "90.0f" or "180.0f", otherwise it faces the same way as a default armor stand).

== Sounds ==
{{edition|java}}:<br>
Armor stands use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Armor Stand hit1.ogg
|sound2=Armor Stand hit2.ogg
|sound3=Armor Stand hit3.ogg
|sound4=Armor Stand hit4.ogg
|subtitle=Block breaking
|source=Friendly Creatures
|description=When an armor stand is damaged
|id=entity.armor_stand.hit
|translationkey=subtitles.block.generic.hit
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Armor Stand break1.ogg
|sound2=Armor Stand break2.ogg
|sound3=Armor Stand break3.ogg
|sound4=Armor Stand break4.ogg
|subtitle=Block broken
|source=Friendly Creatures
|description=When an armor stand is destroyed
|id=entity.armor_stand.break
|translationkey=subtitles.block.generic.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Stone dig1.ogg
|sound2=Stone dig2.ogg
|sound3=Stone dig3.ogg
|sound4=Stone dig4.ogg
|subtitle=Block placed
|source=Blocks
|description=When an armor stand is placed
|id=entity.armor_stand.place
|translationkey=subtitles.block.generic.place
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Wood dig1.ogg
|sound2=Wood dig2.ogg
|sound3=Wood dig3.ogg
|sound4=Wood dig4.ogg
|subtitle=Block placed
|source=Friendly Creatures
|description=When an armor stand falls onto a block at a high speed{{Info needed}}
|id=entity.armor_stand.fall
|translationkey=subtitles.entity.armorstand.fall
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Armor Stand hit1.ogg
|sound2=Armor Stand hit2.ogg
|sound3=Armor Stand hit3.ogg
|sound4=Armor Stand hit4.ogg
|source=neutral
|description=When an armor stand is damaged
|id=mob.armor_stand.hit
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Armor Stand break1.ogg
|sound2=Armor Stand break2.ogg
|sound3=Armor Stand break3.ogg
|sound4=Armor Stand break4.ogg
|source=neutral
|description=When an armor stand is destroyed
|id=mob.armor_stand.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Stone dig1.ogg
|sound2=Stone dig2.ogg
|sound3=Stone dig3.ogg
|sound4=Stone dig4.ogg
|source=neutral
|description=When an armor stand is placed
|id=mob.armor_stand.place
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Wood dig1.ogg
|sound2=Wood dig2.ogg
|sound3=Wood dig3.ogg
|sound4=Wood dig4.ogg
|source=neutral
|description=When an armor stand falls onto a block at a high speed{{Info needed}}
|id=mob.armor_stand.land
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Armor Stand
|showforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=armor-stand
|spritetype=item
|nameid=armor_stand
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Armor Stand
|generatetranslationkeys=y
|displayname=Entity
|spritename=armor-stand
|spritetype=entity
|nameid=armor_stand
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Armor Stand
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=armor-stand
|spritetype=item
|nameid=armor_stand
|id=552
|form=item
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Armor Stand
|shownumericids=y
|generatetranslationkeys=y
|displayname=Entity
|spritename=armor-stand
|spritetype=entity
|nameid=armor_stand
|id=61
|foot=1}}

=== Item data ===

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

{{el|bedrock}}:
: {{IN|bedrock}}, armor stands have no additional item tag.
: See [[Bedrock Edition level format/Item format]].

=== Entity data ===
Armor stands 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]].

== Video ==
Note: This video is outdated as Zoglins now attack armor stands
<div style="text-align:center">{{yt|tCFkdTfCleQ}}</div>

== History ==
{{History|java}}
{{History||1.8|snap=August 5, 2014|slink={{Tweet|SeargeDP|496666952530538498}}|[[File:Armor Stand (pre-release).png|32px]] [[File:Armor Stand (item) (pre-release).png|32px]] [[Searge]] tweeted a image of an armor stand. The appearance was changed before release.}}
{{History|||snap=August 5, 2014|slink={{Tweet|SeargeDP|496673890148823040}}|Showed crafting recipe and name "[Armor Stand]", both were changed before release.}}
{{History|||snap=14w32a|[[File:Armor Stand JE1.png|32px]] Added armor stands.}}
{{History|||snap=14w32b|[[File:Armor Stand (item) JE1 BE1.png|32px]] The item texture has changed.
|Pick-block can now be used on armor stands.
|Armor stands can now no longer be crafted using [[slabs]] other than stone slabs.}}
{{History|||snap=14w32c|Added a <code>NoBasePlate</code> tag for the armor stand.}}
{{History|||snap=14w33a|Breaking [[particles]] have been added for the armor stand.}}
{{History||1.8.1|snap=pre1|Added <code>Marker</code> tag for armor stands.}}
{{History||1.9|snap=15w31a|Armor stands can now dual wield.
|<code>HandItems</code> and <code>ArmorItems</code> tags added for armor stands, which is intended to replace the <code>Equipment</code> tag.}}
{{History|||snap=15w33a|The <code>Equipment</code> tag has been removed from armor stands.}}
{{History|||snap=15w47a|The armor stand now wobbles when hit by the [[player]].}}
{{History|||snap=16w02a|Marker <code>ArmorStand</code>s now outline their equipment only when glowing.}}
{{History||1.11|snap=16w32a|The entity ID of the armor stand has been changed from <code>ArmorStand</code> to <code>armor_stand</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 416.}}
{{History||1.14|snap=18w43a|[[File:Armor Stand JE2.png|32px]] The texture of armor stands has been changed to the new [[planks|oak planks]] texture.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly changed. (Comparison: [[File:Armor Stand (item) Texture Change 1.13 to 18w43a.gif|32px]])}}
{{History|||snap=18w50a|[[File:Armor Stand JE3.png|32px]] The texture of armor stands has been changed again.
|Armor stands now generate in taiga [[village]]s.}}
{{History||1.15|snap=19w42a|Armor stands can now be placed by [[dispenser]]s.}}
{{History||1.16|snap=20w07a|Armor stands no longer fall through fences and walls when placed.<ref>{{bug|MC-65951}}</ref>}}
{{History|||snap=20w14a|[[Zoglin]]s now attack armor stands.}}
{{History||1.17|snap=20w45a|[[File:Armor Stand 20w45a.png|32px]] The model of the armor stand has been changed.}}
{{History|||snap=20w46a|[[File:Armor Stand JE3.png|32px]] The model of the armor stand has been changed back to how it was in 1.16.}}
{{History||1.18|snap=Pre-release 5|[[File:Armor Stand JE4.png|32px]] Changed smooth stone texture on armor stand.}}
{{History||1.19.4|snap=23w03a|Armor stands now preserve custom names when placed and broken.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|An armor stand now appears in the smithing table GUI; arms are displayed as in Bedrock Edition.
|When an armor stand is placed, its model now changes in effect of the player's facing direction<ref>{{bug|MC-93533}}</ref>.}}
{{History|||snap=23w06a|The model no longer changes when the armory is placed. Also, the head, which tilted slightly to the lower right in the version from 1.8 up to 1.19.3, now faces forward from [[File:Armor Stand JE4.png|32px]] to [[File:Armor Stand JE5.png|32px]].}}
{{History||?|Armor can now be swapped in [[armor stand]]s by {{ctrl|using}} them in the armor stand's slot.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Armor Stand BE1.png|32px]] [[File:Armor Stand (item) JE1 BE1.png|32px]] Added armor stands.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Armor Stand BE2.png|32px]] The texture of armor stands has been changed.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly changed.}}
{{History||1.12.0|snap=beta 1.12.0.2|[[File:Armor Stand with Leather Armor MCPE-44669.png|32px]] Leather [[armor]] no longer shows as being [[dye]]d properly when worn by armor stands.}}
{{History|||snap=beta 1.12.0.3|[[File:Armor Stand wear Chicken.png|x73px]][[File:Armor Stand wear Rabbit.png|x73px]] [[File:Armor Stand wear Salmon.gif|x73px]] [[File:Armor Stand wear Pufferfish.gif|x73px]] [[File:Armor Stand wear Slime.png|x73px]] When armor stands hold a [[raw chicken]], [[raw rabbit]], [[raw salmon]], [[pufferfish]] or a [[slime block]], they now wear these [[mob]] counterparts.<ref>{{bug|mcpe-48629}}</ref>}}
{{History||1.13.0|snap=beta 1.13.0.1|Leather armor now shows as being dyed properly when worn by armor stands.}}
{{History|||snap=beta 1.13.0.4|Armor stands no longer hold certain [[mob]]s if they are holding a [[item]] related to them.
|Armor stands now have a smoother animation when changing poses.}}
{{History||1.16.0|snap=?|Armor stands are now targeted by zoglins.}}
{{History||1.16.210|snap=beta 1.16.210.51|Armor stands are no longer attacked by [[goat]]s.}}
{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|[[File:Armor Stand JE1.png|32px]] [[File:Armor Stand (item) JE1 BE1.png|32px]] Added armor stands.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for armor stands.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|[[File:Armor Stand BE1.png|32px]] Armor stands now have arms and the [[player]] can now change the pose of the armor stand.}}	
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Armor Stand BE2.png|32px]] The texture of armor stands has been changed.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly changed.}}
{{History|foot}}

<gallery>
Armour stand 1.png|The first image of the armor stand.
JE 1.8 Dev Armor Stand crafting.png|The first image of armor stand crafting recipe.
The Bountiful Update.png|Armor stands in the [[Java Edition 1.8|1.8]] poster.
Dual Wielding Armor Stand.png|A dual wielding armor stand.
Glowing Armor Stands.png|Armor stands with the [[glowing]] effect.
Armor Stand Chess.jpg|Chess with armor stands.
</gallery>

== Issues ==
{{issue list}}

== Trivia ==
* Equipping armor stands with certain [[block]]s and [[item]]s can cause rendering glitches. According to [[Searge]] this is due to transparent rendering on entities not yet being supported.<ref>{{bug|MC-67415||"Armor Stands with Slime Block rendering entities behind them"}} resolved as "Won't Fix"</ref><ref>{{bug|MC-67674||"Armor Stand wearing a Skull and Holding Stained Glass causes Graphical issues"}} resolved as "Won't Fix"</ref>
* Bedrock Edition has a version exclusive armor stand [[model]], which includes posable arms.
*Using [[redstone]] to change the stands reverse the poses, starting with the can-can pose first.
*Placing the stand within three powered [[redstone dust]] always changes its pose to the honor pose. [[Redstone Repeater|Repeaters]] also switch the stand to the honor pose if not set four blocks from one.
*Using external tools, armor stand spawners can be placed.
*Secret signatures for [[Jasper Boerstra|JAPPA]], Chi Wong, and [[Michael Stoyke|Searge]] can be found at the bottom of the armor stand texture.

== Gallery ==
=== Renders ===
; Armor (Java Edition)
<gallery>
Armor Stand Leather.png
Armor Stand Golden.png
Armor Stand Chainmail.png
Armor Stand Iron.png
Armor Stand Diamond.png
Armor Stand Netherite.png
</gallery>

; Armor (Bedrock Edition)
<gallery>
Armor Stand with Leather Armor BE.png
Armor Stand with Golden Armor BE.png
Armor Stand with Chain Armor BE.png
Armor Stand with Iron Armor BE.png
Armor Stand with Diamond Armor BE.png
Armor Stand with Netherite Armor BE.png
</gallery>

; Poses
<gallery>
Armor Stand Pose 0.png| 
Armor Stand Pose 1.png| 
Armor Stand Pose 2.png| 
Armor Stand Pose 3.png| 
Armor Stand Pose 4.png| 
Armor Stand Pose 5.png| 
Armor Stand Pose 6.png| 
Armor Stand Pose 7.png| 
Armor Stand Pose 8.png| 
Armor Stand Pose 9.png| 
Armor Stand Pose 10.png| 
Armor Stand Pose 11.png| 
Armor Stand Pose 12.png|
</gallery>

=== Screenshots ===
<gallery>
Armor Stand Demo.png|Armor stands in various positions with various [[armor]].
Armor Stand glass and sword.png|Armor stands can wear [[block]]s on their heads. This is accessible with [[command]]s such as {{cmd|item}}.
Bedrock edition armor stand poses.png|All armor stand poses as seen in {{el|be}}.
Netherite to the rescue!.png|An entire set of netherite [[armor]] on an armor stand.
Armor Stand Garage.png|An armor stand in a garage.
</gallery>

== References ==
{{reflist}}

==External Links==
*[https://www.minecraft.net/en-us/article/taking-inventory--armor-stand Taking Inventory: Armor Stand] – Minecraft.net on March 16, 2023

{{Items}}
{{Entities}}

[[Category:Storage]]

[[de:Rüstungsständer]]
[[es:Soporte para armadura]]
[[fr:Porte-armure]]
[[ja:防具立て]]
[[ko:갑옷 거치대]]
[[pl:Stojak na zbroję]]
[[pt:Suporte de armaduras]]
[[ru:Стойка для брони]]
[[th:แท่นวางชุดเกราะ]]
[[uk:Стійка для обладунків]]
[[zh:盔甲架]]</li><li>[[Raw Copper|Raw Copper]]<br/>{{Item
| image = Raw Copper.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw copper''' is a raw metal resource obtained from mining [[copper ore]].

== Obtaining ==

=== Mining ===
Copper ore and deepslate copper ore mined with a [[stone pickaxe]] or better drops 2–5 units of raw copper. If the pickaxe is enchanted with [[Fortune]], it can drop extra raw copper, allowing for a maximum of 20 units per ore block with Fortune III, or an average of 7.7 units of raw copper per ore block. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops the ore block instead.

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

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

=== Crafting ===
{{crafting usage}}

=== Smelting ingredient ===
{{Smelting
|showname=2
|Raw Copper
|Copper Ingot
|0.7
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Copper
|spritetype=item
|nameid=raw_copper
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Copper
|spritetype=item
|nameid=raw_copper
|form=item
|id=507
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=21w14a|[[File:Raw Copper JE1.png|32px]] Added raw copper.}}
{{History|||snap=April 13, 2021|slink={{Tweet|JasperBoerstra|1381991999952277513}}|[[File:Raw Copper JE2.png|32px]] [[JAPPA]] shows a new raw copper texture.}}
{{History|||snap=21w15a|[[File:Raw Copper JE2.png|32px]] The texture of raw copper has been changed.
|Raw copper can now be used to craft [[block of raw copper]].}}
{{History|||snap=April 16, 2021|slink={{Tweet|JasperBoerstra|1383047666037325829}}|[[File:Raw Copper (pre-release).png|32px]] [[JAPPA]] shows a new raw copper texture again.}}
{{History|||snap=21w16a|[[File:Raw Copper JE3.png|32px]] The texture of raw copper has been changed.}}
{{History|||snap=21w17a|[[Copper ore]] now drops 2-3 raw copper when mined instead of a single unit.}}
{{History||1.18|snap=21w40a|[[Copper ore]] now drops 2-5 raw copper when mined.}}

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

== Issues ==
{{Issue list}}

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

{{Items}}

[[Category:Non-renewable resources]]

[[de:Rohkupfer]]
[[es:Cobre en bruto]]
[[fr:Cuivre brut]]
[[it:Rame grezzo]]
[[ja:銅の原石]]
[[pl:Surowa miedź]]
[[pt:Cobre bruto]]
[[ru:Необработанная медь]]
[[tr:Ham Bakır]]
[[uk:Необроблена мідь]]
[[zh:粗铜]]</li></ul></nowiki>
alpha 1.1.0.0Added woodland mansions, which generate in roofed forests.
Bedrock Edition
1.9.0
{{Extension DPL}}<ul><li>[[Gold Ingot|Gold Ingot]]<br/>{{About|the item|the ore|Gold Ore|the mineral block|Block of Gold|the nugget|Gold Nugget}}
{{Item
| image = Gold Ingot.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''gold ingot''' is a [[metal]] ingot used to craft various [[item]]s, and also used as currency for [[bartering]] with [[piglin]]s.

== Obtaining ==
Gold ingots are mainly obtained by smelting [[raw gold]], [[gold ore]] and [[nether gold ore]], or just mining nether gold ore, dropping gold nuggets. Gold generates more frequently in [[badlands]] biomes.

=== Crafting ===
{{Crafting
|head=1
|showname=0
|Block of Gold
|Output=Gold Ingot,9
|type=Material
}}

{{Crafting
|A1= Gold Nugget
|B1= Gold Nugget
|C1= Gold Nugget 
|A2= Gold Nugget
|B2= Gold Nugget
|C2= Gold Nugget 
|A3= Gold Nugget
|B3= Gold Nugget
|C3= Gold Nugget 
|Output= Gold Ingot
|type= Material
|foot=1
}}

=== Smelting ===
{{see also|Gold Ore#Natural generation}}

{{Smelting
|head=1
|Gold Ore;Nether Gold Ore;Deepslate Gold Ore
|Gold Ingot
|1
}}

{{Smelting
|foot=1
|Raw Gold
|Gold Ingot
|1
}}

=== Mob loot ===

[[Zombified piglin]]s have a 2.5% ({{frac|1|40}}) chance of dropping a gold ingot if killed by a player or tamed wolf. The chance is increased by 1% per level of [[Looting]], for a maximum of 5.5% with Looting III.

=== Chest loot ===
{{LootChestItem|gold-ingot}}

== Usage ==

=== Crafting ingredient===

As a material for weapons, tools, and armor, gold is not a straight upgrade from iron (except in the case of [[Horse Armor|horse armor]]). Gold has a higher mining speed and enchantability than any other material, but attack power and durability is less.

{{crafting usage}}

=== Trading ===

Apprentice-level cleric [[Villager|villagers]] buy 3 gold ingots for an [[emerald]] as part of their trade.

=== Repairing ===

Golden [[helmet]]s, [[chestplate]]s, [[leggings]], [[boots]], [[sword]]s, [[pickaxe]]s, [[axe]]s, [[hoe]]s and [[shovel]]s can be [[item repair|repaired]] with gold ingots in an [[anvil]].

=== Bartering ===
{{main|Bartering}}
[[Piglin]]s throw the player [[Bartering#Mechanics|item(s)]] if the player throws or {{ctrl|uses}} a gold ingot on them.

=== Beacons ===

Gold ingots can be used to select powers from a [[beacon]]. The player must select one of the available powers, and then insert an ingot in the item slot. 

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

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Gold Ingot
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Gold Ingot
|Gold 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|gold ingot}}
*{{TrimPalette|gold ingot|darker=1}} (a darker color palette is used when a golden armor piece is trimmed using a gold ingot).

== Achievements ==
{{load achievements|Oooh, shiny!}}

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gold Ingot
|spritetype=item
|nameid=gold_ingot
|id=306
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100128|[[File:Gold Ingot JE1.png|32px]] Added gold ingots.}}
{{History|||snap=20100129|[[File:Gold Ingot JE2 BE1.png|32px]] The texture of gold ingots has been changed.
|Gold ingots can be [[smelting|smelted]] from [[gold ore]] with [[flint and steel]] and [[drops|drop]] 3-5 gold ingots.
|Gold ingots can be used to craft [[gold block]]s.
|[[Gold block]]s now require 9 gold ingots (3×3) instead of 4 (2×2) to be [[crafting|crafted]], making them much more expensive.}}
{{History|||snap=20100130|Gold ingots can now be used to craft gold [[sword]]s, [[shovel]]s, [[pickaxe]]s and [[axe]]s.}}
{{History||20100206|Gold ingots are now used to [[crafting|craft]] gold [[hoe]]s.}}
{{History||?|Smelting gold ore now drops 1 gold ingot (down from 3-5).}}
{{History||20100218|Gold ingots are now used to craft gold [[helmet]]s, [[chestplate]]s, [[leggings]] and [[boots]].}}
{{history|java alpha}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|Gold ingots are now used to craft [[clock]]s.}}
{{History|java beta}}
{{History||1.5|Gold ingots are now used to craft [[powered rail]]s.}}
{{History||1.8|snap=Pre-release|Gold ingots can now be found in the new [[stronghold]] storerooms and [[mineshaft]] [[chest]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Gold ingots can be crafted from [[gold nuggets]], which are dropped by [[Zombified Piglin|zombie pigmen]], making gold a [[renewable resource]].}}
{{History|||snap=Beta 1.9 Prerelease 3|Gold ingots can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=Beta 1.9 Prerelease 4|Gold ingots are now used to craft [[gold nugget]]s.}}
{{History||1.1|snap=12w01a|Gold ingots can now be found in [[village]] blacksmith chests.}}
{{History||1.2.1|snap=12w06a|Zombie pigmen now rarely drop gold ingots.}}
{{History||1.3.1|snap=12w21a|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing gold ingots.
|All types of [[villager]]s now [[trading|buy]] 8–9 gold ingots for 1 [[emerald]], as a fallback trade in case no trades were generated for that villager.}}
{{History|||snap=12w22a|Added [[jungle temple]]s, which contain loot chests with gold ingots.}}
{{History||1.5|snap=13w01a|Gold ingots are now used to craft light [[weighted pressure plate]]s.}}
{{History||1.6.1|snap=13w16a|Gold ingot is now used to craft golden [[horse armor]].}}
{{History|||snap=13w18a|Gold ingot is no longer used to craft golden [[horse armor]].|Gold ingots are now found in [[nether fortress]] [[chest]]s.}}
{{History|||snap=13w23a|Gold ingots are now used to craft normal [[golden apple]]s.}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: only cleric [[villager]]s now [[trading|buy]] 8–10 gold ingots for 1 [[emerald]], as a legitimate trade.}}
{{History||1.9|snap=15w31a|Gold ingots can now be found in [[end city]] [[chest]]s.}}
{{History|||snap=15w43a|The average yield of gold ingots in [[nether fortress]] chest has been decreased.}}
{{History|||snap=15w44a|The average yield of gold ingots in [[mineshaft]] and [[desert temple]] chests has been decreased.
|Gold ingots have been added to [[dungeon]] [[chest]]s.}}
{{History||1.11|snap=16w39a|Gold ingots are now found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 266.}}
{{History|||snap=18w10a|Gold ingots now generate in [[buried treasure]] chests.}}
{{History|||snap=18w11a|Gold ingots can now be obtained as a [[drops|drop]] from [[drowned]].
|Gold ingots now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Gold Ingot JE3.png|32px]] The texture of gold ingots has been changed.}}
{{History|||snap=18w44a|[[File:Gold Ingot JE4 BE2.png|32px]] The texture of gold ingots has been changed, once again.}}
{{History|||snap=18w50a|Gold ingots now generate in chests in [[village]] toolsmith houses and temples.}}
{{History||1.16|snap=20w06a|Gold ingots are now used to craft [[netherite ingot]]s.}}
{{History|||snap=20w07a|Gold ingots can now be used to [[bartering|barter]] with [[piglin]]s.}}
{{History|||snap=20w11a|Gold ingots can now be [[smelting|smelted]] from [[nether gold ore]].}}
{{History|||snap=20w16a|Gold ingots now generate in [[bastion remnants]] and [[ruined portal]] chests.}}
{{History||1.16.2|snap=20w30a|The average yield of gold ingots from bastion remnant chests has been slightly increased.}}
{{History||1.17|snap=21w05a|Drowneds no longer drop gold ingots, and instead drop [[copper ingot]]s.}}
{{History|||snap=21w08a|Gold ingots can now be smelted from [[deepslate gold ore]].}}
{{History|||snap=21w14a|Gold ingots can now be smelted from [[raw gold]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Gold ingots can now be used as an armor trim material.}}
{{History|||snap=23w05a|Gold ingots can now be trimmed with gold [[armor]].}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Gold Ingot JE2 BE1.png|32px]] Added gold ingots. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.2|Gold ingots are now obtainable by [[smelting]] gold ore in a [[furnace]].
|Gold ingots can be used to craft [[blocks of gold]], gold [[pickaxe]]s, [[axe]]s, [[sword]]s and [[shovel]]s.}}
{{History||v0.4.0|Gold ingots are now used to [[crafting|craft]] gold [[hoe]]s.}}
{{History||v0.6.0|Gold ingots are now used to craft gold [[armor]].}}
{{History||v0.8.0|snap=build 1|Gold ingots are now used to craft [[clock]]s.}}
{{History|||snap=build 2|Gold ingots are now used to craft [[powered rail]]s.}}
{{History||v0.9.0|snap=build 1|Gold ingots can now be found in blacksmith [[chest]]s in [[village]]s, [[stronghold]] altar chests and [[dungeon]] chests.}}
{{History||v0.12.1|snap=build 1|Gold ingots are now used to craft [[gold nugget]]s and [[golden apple]]s.
|Gold ingots are now found in [[nether fortress]] chests.}}
{{History||v0.13.0|snap=build 1|Gold ingots are now used to [[crafting|craft]] light [[weighted pressure plate]]s.
|Gold ingots now generate inside of hidden chest rooms in [[desert temple]]s.}}
{{History||v0.14.0|snap=build 1|Gold ingots are now found in [[minecart with chest]]s that generate in [[mineshaft]]s.}}
{{History||v0.15.0|snap=build 1|Gold ingots can now be found in [[jungle temple]] [[chest]]s.}}
{{History||v0.16.0|snap=build 4|Gold ingots can now be used to power [[beacon]]s.}}
{{History|pocket edition}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gold ingots can now be found in [[end city]] ship chests and [[stronghold]] storerooms.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Added [[trading]], cleric [[villager]]s now [[trading|buy]] 8–10 gold ingots for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gold ingots are now found in [[woodland mansion]] [[chest]]s.}}
{{history|bedrock}}
{{History||1.4.0|snap=beta 1.2.13.8|Added [[drowned]], which rarely [[drops|drop]] gold ingots.}}
{{History|||snap=beta 1.2.14.2|Gold ingots can now be found inside [[buried treasure]] [[chest]]s and [[shipwreck]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Gold ingots can now be found in [[plains]] [[village]] weaponsmith chests.
|[[File:Gold Ingot JE4 BE2.png|32px]] The texture of gold ingots has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gold ingots can now be found in [[desert]] village temple [[chest]]s and village toolsmith chests.
|Gold ingots can now be found in [[savanna]], [[taiga]], [[snowy taiga]], [[snowy tundra]] and desert village weaponsmith chests.}}
{{History|||snap=beta 1.11.0.4|Cleric [[villager]]s now [[trading|buy]] 3 gold ingots for one [[emerald]].}}
{{History||1.16.0|snap=beta 1.16.0.51|Gold ingots are now used to craft [[netherite ingot]]s.
|Gold ingots can now be used to [[bartering|barter]] with [[piglin]]s.}}
{{History|||snap=beta 1.16.0.57|Gold ingots can now be [[smelting|smelted]] from [[nether gold ore]].
|Gold ingots now be found in [[ruined portal]] and [[bastion remnants]] chests.}}
{{History||1.16.210|snap=beta 1.16.210.57|Gold ingots can no longer be obtained as a [[drops|drop]] from [[drowned]].}}
{{History||1.17.0|snap=beta 1.16.230.52|Gold ingots can now be smelted from [[deepslate gold ore]].}}
{{History|||snap=beta 1.17.0.50|Gold ingots can now be smelted from [[raw gold]].}}
{{History||1.19.80|snap=beta 1.19.80.21|Gold ingots 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:Gold Ingot JE2 BE1.png|32px]] Added gold ingots.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Gold Ingot JE4 BE2.png|32px]] The texture of gold ingots has been changed.}}

{{History|new3DS}}
{{History||0.1.0|[[File:Gold Ingot JE2 BE1.png|32px]] Added gold ingots.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==

*Gold ingots are the only ingots in the game used alongside another [[item]] to [[crafting|craft]] another type of ingot; in this case, it is used with [[netherite scrap]] to craft a [[netherite ingot]].

== See also ==

*{{BlockLink|Block of Gold}}
*{{ItemSprite|Golden Chestplate}} [[Golden Armor]]
*{{ItemLink|Gold Nugget}}
*{{BlockLink|Gold Ore}}
*[[Ore]]s

{{Items}}

[[cs:Zlatý ingot]]
[[de:Goldbarren]]
[[es:Lingote de oro]]
[[fr:Lingot d'or]]
[[hu:Aranyrúd]]
[[ja:金インゴット]]
[[ko:금괴]]
[[nl:Goudstaaf]]
[[pl:Sztabka złota]]
[[pt:Barra de ouro]]
[[ru:Золотой слиток]]
[[uk:Золотий зливок]]
[[zh:金锭]]
[[Category:Renewable resources]]</li><li>[[Footprint|Footprint]]<br/>{{about|the joke item|the unused particle|Java Edition unused features#Footprint particle}}
{{Joke feature}}
{{Item
| image = Footprint (item).png
| renewable = No
| stackable = Yes (64)
}}

The '''Footprint''' was a joke item from [[Java Edition 20w14∞]], found only in the {{code|missing}} dimension.

== Appearance ==
This item is semi-transparent with a grey colour scheme.

== Obtaining ==

=== Dimension ===
Footprints were obtained only from a chest in the {{Code|missing}} dimension. Only existing in 2020 April fools snapshot 20w14∞, it cannot exist in any non-April Fool's joke versions and April Fool's joke versions before or after 20w14∞. There is a maximum of 2 footprints that can be obtained legitimately in any given world.

=== Cheats/Creative Mode ===
Despite these footprints not being available in the creative inventory, it is still possible to acquire them via the command {{Code|code=give <target> minecraft:footprint <amount>}} or duplicating them by holding down middle-click whilst in creative mode.

== Usage ==
As of snapshot 20w14∞, this item cannot be placed or used in any way other than a trophy. This item can be inserted and/or rotated inside of an item frame, and it has a stack limit of 64.

== Data values ==
=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=Footprint
|spritetype=item
|nameid=footprint
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||20w14∞|[[File:Footprint (item).png|32px]] Added the footprint item.}}
{{History|foot}}

== Gallery ==
<gallery>
File:Missing biome.png|The Easter Egg dimension that the item spawns in.
</gallery>

== Trivia ==
* This is a reference to the removed "Footstep" particle, hence in the "missing" dimension.
** This item is intended as a joke directed towards the commands' community where the "Footstep" particle is commonly requested.<ref>https://gist.github.com/boq/8e65cb85badc75765eeb8956af78aaa5</ref>

== References ==
{{reflist}}

{{Items}}
{{Jokes}}

[[Category:Non-renewable resources]]
[[Category:Joke items]]

[[es:Footprint]]
[[pt:Pegada]]</li></ul></nowiki>
beta 1.9.0.0Added lily of the valley that can generate in dark forests.
Legacy Console Edition
TU54CU44 1.52 Patch 241.0.4Added woodland mansions, which generate in roofed forests.

Trivia

  • The trees and leaves are so thick that it is possible to ride a horse across the leaves.

Gallery

See also

Advertisement