Minecraft Wiki
Advertisement
This article is about the mob in Minecraft 1.19. For the mob in Minecraft Dungeons that inspired the allay, see MCD:Wisp.
Clock JE3
This article needs to be updated. 
Please update this page to reflect recent updates or newly available information.
Reason: The sound for bedrock edition has changed. Please add it
This article is missing information about the chance of finding allays in pillager outposts and woodland mansions. 
Please expand the article to include this information. Further details may exist on the talk page.

The allay is a small flying wisp-like passive mob. It collects and delivers items for any player that gives it something, or any note block it hears repeatedly playing.

Spawning

Natural generation

Pillager outposts

Two Allays Pillager Outpost

Two allays in a cage near a pillager outpost.

Allays can be found surrounding pillager outposts, confined inside dark oak cages. One to three allays can spawn in each cage.

Woodland mansion

Two allays

Two allays inside a woodland mansion cell.

Allays can also spawn inside jail cells within woodland mansions. one to three allays can spawn in each cell.

Post-generation

Crafting Table
This section describes content that may be included in Java Edition and Bedrock Edition. 
This content has appeared in Java Edition 1.19.1 and Bedrock Edition 1.19.10 development versions, but the full update containing it has not been released yet.

If the allay is given an amethyst shard while dancing, it will play a small amethyst sound, make a heart, and duplicate into another allay. After duplication, both allays will have a 2.5-minute cooldown before being able to duplicate again.

Behavior

The allay's luminous texture allows it to be seen clearly in the dark, although it doesn't illuminate its surroundings.

The allay wanders around until a player gives it an item with their use key. The allay starts following the player, seeking out dropped versions of the same item and delivering them to its player. The allay returns to wandering around if any player takes its item back by using an empty hand on it.

The allay locks onto the player that last gave it an item. It follows the player from up to 64 blocks away even if it can't see them, and it seeks items up to 32 blocks away from the player. After delivering items, it has a delay of 3 seconds until it can seek items again. The allay has a single inventory slot to hold a stack of items (usually 64 items) in addition to the item it got from the player. While the allay does not discern enchantments, special item names, or items in Shulkers when it seeks, it still carries such items in separate trips.

If the allay hears a note block play, it spends 30 seconds around that particular note block, seeking items around it and returning them to it instead of its player. A vibration particle reaches the allay to show this.


When an allay hears a jukebox playing, it will do a dance animation. If the jukebox stops playing, or if the allay gets too far away from the jukebox, it will stop dancing.‌[upcoming: JE 1.19.1 & BE 1.19.10]

The allay cannot enter water, although it attempts to gather items that are under water.

Allays cannot be harmed by their owners. If they are harmed by another source, they go into a panic state and start moving wildly in random directions. When killed, allays drop the items they were holding. If an allay would die while holding a totem of undying, it instead returns to full health and the totem is destroyed, as with any mob holding a totem of undying.

Allays naturally regenerate 2♥ per second if damaged.

Using a lead or a named name tag performs the item's normal function, instead of giving it to the allay.

Sounds

SoundSubtitlesSourceDescriptionResource locationTranslation keyVolumePitchAttenuation
distance
Allay seeksFriendly CreaturesIdle while holding an itementity.allay.ambient_with_itemsubtitles.entity.allay.ambient_with_item0.31.2516
Allay yearnsFriendly CreaturesIdle while not holding an itementity.allay.ambient_without_itemsubtitles.entity.allay.ambient_without_item0.251.016
Allay diesFriendly CreaturesAllay dyingentity.allay.deathsubtitles.entity.allay.death0.61.016
Allay hurtsFriendly CreaturesAllay gets hurtentity.allay.hurtsubtitles.entity.allay.hurt0.81.516
Allay chortlesFriendly CreaturesAllay receives an item from the playerentity.allay.item_givensubtitles.entity.allay.item_given0.11.016
Allay allaysFriendly CreaturesAllay picks up an itementity.allay.item_takensubtitles.entity.allay.item_taken0.11.2516
Allay tossesFriendly CreaturesAllay throws itementity.allay.item_thrownsubtitles.entity.allay.item_thrown0.251.016

Bedrock Edition:

SoundSourceDescriptionResource locationVolumePitch
PlayersAllay dying[sound 1]game.player.die1.00.8 - 1.2
PlayersAllay gets hurt[sound 1]game.player.hurt1.00.8 - 1.2

Data values

ID

Java Edition:

NameIdentifierTranslation key
Allayallayentity.minecraft.allay

Bedrock Edition:

NameIdentifierNumeric ID Translation key
Allayallay134entity.allay.name

Entity data

Allays have entity data associated with them that contain various properties.

Java Edition:

Main article: Entity format
  • Entity data
    • Tags common to all entities
    • Tags common to all mobs
    •  CanDuplicate: 1 or 0 (true/false) – true if the allay can duplicate. This is set to false when the allay duplicates, and true when DuplicationCooldown reaches 0.
    •  DuplicationCooldown: The allay's duplication cooldown in ticks. This is set to 6000 game ticks (5 minutes) when the allay duplicates.
    •  Inventory: List of items the allay has picked up. This list can contain at most one compound tag. The item given by the player to the allay is stored in its HandItems[0] tag, not here.
      • Tags common to all items
    •  listener: The vibration event listener of this allay.
      •  distance: Nonnegative integer.
      •  event: Optional.
        •  distance: Nonnegative integer.
        •  game_event: A resource location of the game event.
        •  pos: Three doubles representing the X, Y, and Z coordinates.
        •  projectile_owner: Optional. The projectile owner's UUID. The 128-bit UUID is stored as four 32-bit integers, ordered from most to least significant.
        •  source: Optional. The source entity's UUID. The 128-bit UUID is stored as four 32-bit integers, ordered from most to least significant.
      •  event_delay: Nonnegative integer.
      •  event_distance: Nonnegative integer.
      •  range: Nonnegative integer.
      •  source: Position source.
        •  type: A resource location of the position source type.
        • For type block
          •  pos: X, Y, and Z coordinates.
        • For type entity
          •  source_entity: The entity's UUID. The 128-bit UUID is stored as four 32-bit integers, ordered from most to least significant.
          •  y_offset:

Bedrock Edition:

See Bedrock Edition level format/Entity format.

Advancements

Icon Advancement In-game description Parent Actual requirements (if different) Resource location
Advancement-plain-rawYou've Got a Friend in Me
Have an Allay deliver items to you HusbandryGive an allay an item and then have it return to the player with more of that item.
This is a hidden advancement, meaning that it can be viewed by the player only after completing it, regardless of if its child advancement(s), if any, have been completed.
husbandry/allay_deliver_item_to_player
Advancement-plain-rawBirthday Song
Have an Allay drop a Cake at a Note Block You've Got a Friend in MeGive an allay a cake and then use a note block to make the allay drop the cake at a note block.
This is a hidden advancement, meaning that it can be viewed by the player only after completing it, regardless of if its child advancement(s), if any, have been completed.
husbandry/allay_deliver_cake_to_note_block

History

October 12, 2021AllayPixelThe allay is announced as part of the mob vote for Minecraft Live 2021.
Clarifications on the allay's behavior were made, revealing that they don't actually duplicate items or take items from chests.[1][2]
October 16, 2021The allay wins the mob vote at Minecraft Live 2021.
Java Edition
1.19
{{Extension DPL}}<ul><li>[[Raw Cod|Raw Cod]]<br/>{{about|the item|the mob|Cod}}
{{redirect|Raw Fish|raw salmon|Raw Salmon|pufferfish|Pufferfish (item)|tropical fish/clownfish|Tropical fish (item)}}
{{Item
| image = Raw Cod.png
| renewable = Yes
| heals = {{hunger|2}}
| stackable = Yes (64)
}}

'''Raw cod''' is a [[food]] item that can be eaten by the player or cooked to make [[cooked cod]].

== Obtaining ==

=== Mob loot ===

==== Cod ====
[[Cod]] always drops 1 raw cod when killed, unaffected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref> If it is killed while on [[fire]], it drops 1 [[cooked cod]] instead.

==== Dolphins ====
When killed, [[Dolphin|dolphins]] drop 0–1 raw cod. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 0-4 with Looting III. If killed while on fire, they drop cooked cod instead.

==== Guardians and elder guardians ====

[[Guardian]]s and [[elder guardian]]s have a 40% and 50% chance, respectively, to drop raw cod when killed. {{IN|java}}, cooked cod is dropped if a guardian is on fire when killed.

Guardians and elder guardians also have a 2.5% chance to drop a random fish, with 60% of them being raw cod, which drops as cooked if the guardian was on fire. The chance of getting the fish drop is increased by 1% per level with [[Looting]] (for a maximum of 5.5% with Looting III), but the type of fish is not affected.

==== Polar bears ====

[[Polar bear]]s have a 75% chance of dropping 0–2 raw cod when killed. The maximum amount can be increased by 1 per level of Looting, for a maximum of 0-5 with Looting III. If killed while on fire, they drop cooked cod instead.

=== Fishing ===
{{main|Fishing}}

Raw cod can be obtained from fishing. The wait time of one being caught is decreased with the [[Lure]] enchantment and the chance of one being caught is slightly decreased with the [[Luck of the Sea]] enchantment (named as such because it increases treasure, not fish).

Catching cod awards 1-6 experience.

=== Natural generation ===
{{el|java}}{{LootChestItem|raw-cod}}

=== Villager gifts ===
{{in|java}}, fisherman [[villager]]<nowiki/>s throw raw cod at [[player]]s under the [[Hero of the Village]] effect.

== Usage ==

=== Smelting ingredient ===

{{smelting
|Raw Cod
|Cooked Cod
|0.35
}}

=== Food ===

Raw cod restores {{hunger|2}} [[hunger]] and 0.4 [[Hunger#Mechanics|saturation]].

=== Cats ===

Raw cod can be used to tame [[cat]]s with {{frac|1|3}} chance of success, get cats off of [[chest]]s, and [[bed]]s, [[breed]] cats, and make baby cats grow up faster by 10% of the remaining time. Additionally, raw cod can be used to heal cats by {{hp|2|mob=1}}.

Raw cod can be used to gain [[ocelot]] trust, breed ocelots, and make baby ocelots grow up by 10%. 

=== Dolphins ===

[[Dolphin]]s can be fed raw cod. Doing this improves their trust and interaction with the player. However, unlike most animals, feeding dolphins does not allow them to breed.

When a player feeds raw cod to a dolphin, it swims toward the nearest chest in an [[underwater ruins]] or [[shipwreck]]. If the chest in the nearest structure is broken, they swim to the next nearest structure that has a chest.

===Trading===

Fisherman villagers have 50% chance to sell 6 cooked cod for 6 raw cod and 1 [[emerald]] as part of their first tier trade.

Apprentice-level fisherman villagers have a {{frac|2|3}} chance to buy 15 raw cod for an emerald in Java Edition, and always offer the same trade in Bedrock Edition.

=== Wolves ===
{{IN|bedrock}}, raw cod can be used to feed [[wolves]], to heal them by {{hp|2|mob=1}}. However, unlike other meat items, raw cod cannot be used to speed up the growth of baby wolves nor used to breed them, thus making it only feedable when wolves are not at full health.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Cod
|spritetype=item
|nameid=cod
|aliasid=fish
|id=264
|form=item
|translationkey=item.fish.name
|foot=1}}

== Achievements ==

{{load achievements|Delicious Fish;Lion Tamer;Echolocation}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet;Fishy Business;A Complete Catalogue}}

== History ==
{{History|java alpha}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish, which restores {{hp|2}}.}}
{{History|java beta}}
{{History||1.5|Cooking raw fish now gives the '''Delicious Fish''' [[achievement]].}}
{{History||1.8|snap=Pre-release|Raw fish is now stackable to 64 and fills {{hunger|2}} instead of {{hp|2}}.}}
{{History|java}}
{{History||1.2.1|snap=12w04a|Raw fish can now be fed to [[ocelot]]s to tame them into cats.}}
{{History||1.8|snap=14w02a|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|||snap=14w25a|Raw fish is now obtainable as a rare [[drops|drop]] from [[guardian]]s and [[elder guardian]]s.}}
{{History||1.10|snap=16w20a|Raw fish is now dropped from [[polar bear]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>fish</code> and <code>cooked_fish</code> IDs have been split up into their own IDs.
|"Raw Fish" has been renamed to "Raw Cod".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 349.}}
{{History|||snap=18w07a|Raw cod is now used to breed [[turtle]]s.}}
{{History|||snap=18w07b|Raw cod is no longer used to [[breeding|breed]] turtles. [[Seagrass]] is used instead.}}
{{History|||snap=18w08b|Cod, and other [[fish]], have been added as [[mob]]s, which drop their (raw) item form when killed.
|[[File:Raw Cod JE2 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w15a|Raw cod can now be used to feed [[dolphin]]s.
|Raw cod can now be obtained as a [[drops|drop]] from [[dolphin]]s.}}
{{History||1.14|snap=18w43a|[[File:Raw Cod JE3.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w47b|[[File:Raw Cod JE4 BE2.png|32px]] The previous texture change to raw cod has been reverted.}}
{{History|||snap=18w48a|Raw cod can now be found in chests in [[village]] fisher cottages.}}
{{History|||snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] raw cod.}}
{{History|||snap=19w13a|Fisherman villagers now give raw cod to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||v0.12.1|snap=build 1|Raw fish now restore [[hunger]] instead of [[health]].
|Raw fish can now be used to feed [[ocelot]]s to tame them into [[cat]]s.}}
{{History||v0.16.0|snap=build 1|Raw fish is now [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added [[polar bear]]s, which [[drops|drop]] raw fish.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[Cod]] and other [[fish]] have been added as [[mob]]s, which [[drops|drop]] their (raw) [[item]] form when killed.
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=beta 1.2.20.2|Raw cod is now [[drops|dropped]] by [[dolphin]]s and can be used to feed them.}}
{{History||1.5.0|snap=beta 1.5.0.0|Giving raw cod to [[dolphin]]s lead the [[player]] to the nearest [[underwater ruins]] or [[shipwreck]].}}
{{History||1.7.0|snap=beta 1.7.0.2|"Raw Fish" has been renamed to "Raw Cod".}}
{{History||1.8.0|snap=beta 1.8.0.8|Raw cod can no longer can be used to tame [[ocelot]]s.
|Raw cod can now be used to [[breeding|breed]] ocelots and increase baby ocelot growth speed.
|Added [[stray cat]]s, which can be tamed using raw cod.}}
{{History||1.11.0|snap=beta 1.11.0.4|Raw cod can be [[trading|sold]] to fisherman [[villager]]s.
|Fisherman villagers now have 50% chance to [[trading|sell]] 6 cooked cod for 6 raw cod and an [[emerald]] as part of their first tier [[trading|trade]].}} 

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||xbox=TU5|Raw fish is now stackable to 64.
|Raw fish now fills [[hunger]] instead of [[health]].}}
{{History||xbox=TU12|Raw fish can now be fed to [[ocelot]]s to tame them into [[cat]]s.}}
{{History||xbox=TU13|ps=1.0|Raw fish is no longer removed from the [[player]]'s [[inventory]] when trying to tame an [[ocelot]] in [[creative]] mode.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|"Raw Fish" has been renamed to "Raw Cod".
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}

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

== Issues ==

{{issue list}}
== Trivia ==
[[File:Steve wearing Raw Cod.png|75px]] [[File:Alex wearing Raw Cod.png|75px]]

* While a raw cod cannot be equipped in the head slot in Survival mode, equipping it using the {{cmd|item}} command causes it to appear at the side of the player's head.

== See also ==
* [[Fishing]]

== References ==
{{reflist}}

{{items}}

[[de:Roher Kabeljau]]
[[es:Bacalao crudo]]
[[ja:生鱈]]
[[ko:생대구]]
[[pt:Bacalhau cru]]
[[ru:Сырая треска]]
[[zh:生鳕鱼]]
[[Category:Food]]
[[Category:Renewable resources]]</li><li>[[Dye|Dye]]<br/>{{Item
| title = Dyes
| image = White Dye.png
| extratext = View [[#Gallery|all renders]]
| renewable = Yes
| stackable = Yes (64)
}}
'''Dyes''' are a set of sixteen items used to change the color of [[wool]], [[carpet]]s, [[terracotta]], [[concrete powder]], [[glass]], [[shulker box]]es, [[bed]]s, [[candle]]s, the patterns on [[banner]]s, [[firework star]]s, certain mobs, and text on [[sign]]s and [[hanging sign]]s. {{IN|bedrock}} they can also be used to dye water in a [[cauldron]] (which is thereafter used to dye leather [[armor]]); {{in|java}} leather armor can be dyed directly. {{IN|education}} dyes can also be used to dye [[balloon]]s and [[glow stick]]s.

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

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

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

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

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

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

=== Trading ===

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

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

=== Chest loot ===

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

=== Other ===

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

== Usage ==

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

=== Dyeing wool and mobs ===

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

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

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

=== Dyeing carpets ===

Carpets can be dyed.

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

=== Dyeing terracotta ===

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

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

=== Creating concrete powder ===

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

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

=== Staining glass ===

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

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

=== Dyeing shulker boxes ===

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

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

=== Dyeing beds ===

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

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

=== Dyeing candles ===

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

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

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

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

=== Dyeing armor ===

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

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

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

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

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

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

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

=== Dyeing firework stars ===

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

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

=== Creating balloons ===

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

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

=== Creating glow sticks ===

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

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

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

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

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

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

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

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

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

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

== Video ==

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

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

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

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

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

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

==Issues==
{{issue list}}

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

== References ==
{{reflist}}

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

{{Items}}

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

[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li></ul></nowiki>
22w13aAllayAdded allays.
22w15aAllays now have natural regeneration, going at a rate of 2 HP per second.
22w16aIncreased the health of allays from 10♥♥♥♥♥ to 20♥ × 10.
Allays now drop the item they are holding upon death.
Upcoming Java Edition
1.19.1
{{Extension DPL}}<ul><li>[[Cocoa Beans|Cocoa Beans]]<br/>{{Block
|image=<gallery>
Cocoa Age 0.png|Age 0 JE
Cocoa Age 1.png|Age 1 JE
Cocoa Age 2.png|Age 2 JE
</gallery>
|image2=<gallery>
Cocoa Age 0 BE.png|Age 0 BE
Cocoa Age 1 BE.png|Age 1 BE
Cocoa Age 2 BE.png|Age 2 BE
</gallery>
|transparent=Yes
|light=No
|tool=axe
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}} '''Cocoa beans''' are items obtained from cocoa pods and are used to plant them, as well as to craft [[dye|brown dye]] and [[cookie|cookies]].

'''Cocoa pods''' are [[Bone Meal|bonemealable]] [[plant]]s placed on [[Log|jungle log]] sides that grow cocoa beans, and can be found naturally in [[Jungle|jungles]].

==Obtaining==
In ''Java Edition'', cocoa beans are only obtained through the natural generation of cocoa pods, while in ''Bedrock Edition'', they can also be gotten in bonus chests, from [[fishing]] inside the jungle, bamboo jungle and sparse jungle biomes and during a [[trading]] with a wandering trader.

Cocoa beans come from cocoa pods, which are found on the trunks of normal-sized naturally-generated [[jungle tree]]s in [[jungle]], [[bamboo jungle]]s and [[sparse jungle]] temperate [[biome]]s.

Cocoa pods can be mined with any item, but [[axe]]s are the quickest. Fully grown cocoa pods drop 3 cocoa beans. Using a tool enchanted with Fortune does not increase the amount of cocoa beans dropped.
{{breaking row|horizontal=1|Cocoa|Axe|sword=1|link=none}}
The block itself can be obtained by inventory editing or [[add-on]]s {{in|bedrock}}.

From one to two cocoa beans can be found in 40% of bonus [[chest]]s {{in|bedrock}}.
{{LootChestItem|cocoa-beans}}

Cocoa beans can be obtained from [[fishing]] in a jungle {{in|bedrock}}.

[[Wandering trader]]s may sell 3 cocoa beans for an [[emerald]] during a [[trading]] {{in|bedrock}}.

==Usage==
===Farming===
{{main|Tutorials/Cocoa bean farming}}
Placing cocoa beans on the side of a jungle [[log]] plants a new cocoa pod. The log does not need to be attached to a tree. A cocoa pod can be placed on jungle logs, jungle [[wood]], stripped jungle logs and stripped jungle wood.
[[File:Cocoaplant farm.png|thumb|left|A somewhat efficient cocoa pod farm, minimizing space and wood use.]]
Cocoa has three stages of growth. During its first stage, the pod is small and green. In the second stage, the plant is bigger and colored tan. In its last stage, the pod is even larger and orange. The cocoa block has a 20% chance to grow a stage when receiving a [[Tick#Random tick|random tick]], giving it an average time of 5 minutes and 41 seconds per stage. When destroyed in the first two stages, the pod yields only one cocoa bean. When destroyed in the third stage, it gives 3 cocoa beans. [[Bone meal]] can be used to force the cocoa pod forward by one growth stage. Cocoa pods burst and drop their beans when struck by flowing water, pushed by a piston or if their [[log]] or wood are removed by any means.

===Composting===
Placing cocoa beans into a [[composter]] has a 65% chance of raising the compost level by 1. {{IN|bedrock}}, cocoa beans are accepted as a direct substitute of brown dye in many recipes.

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

{{Dye usage}}

{{IN|bedrock}}, cocoa beans can be also used in banner patterns:
{{banner crafting usage}}

{{Banner loom usage|Cocoa Beans}}

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

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Cocoa
|spritetype=block
|nameid=cocoa
|form=block}}
{{ID table
|displayname=Cocoa Beans
|spritetype=item
|nameid=cocoa_beans
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showforms=y
|showaliasids=y
|shownumericids=y
|generatetranslationkeys=y
|displayname=Cocoa
|spritetype=block
|nameid=cocoa
|id=127
|form=block}}
{{ID table
|displayname=Cocoa Beans
|spritetype=item
|nameid=cocoa_beans
|aliasid=dye / 3
|id=412
|form=item
|translationkey=item.dye.brown.name
|foot=1}}

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

==History==
''For a more in-depth breakdown of changes to textures and models, including a set of renders for each state combination, see [[/Asset history]]''
{{History|java beta}}
{{History||1.2|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans.
|Cocoa beans are currently obtainable only through an inventory editor.}}
{{History||1.2_02|Prior to this, Cocoa Beans were misspelled as 'Coco Beans'.}}
{{History||1.4|Cocoa beans have been formally brought into the game as a reward found in [[dungeon]] chests.<ref>{{tweet|notch|53161729990987776}}</ref> (53% chance) Also, brown [[sheep]] now naturally spawn, making brown [[wool]] obtainable without hacking the game.
|Cocoa beans can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||May 8, 2012|link={{tweet|jeb|199867730927697920}}|[[Jeb]] revealed cocoa with a screenshot.}}
{{History||1.3.1|snap=12w18a|For only this snapshot, cocoa beans have been given a small (0.5%) chance of dropping from destroyed [[jungle tree]] [[leaves]] in a similar fashion to [[apple]]s from oak leaves, which makes cocoa beans [[renewable resource|renewable]] for the first time.}}
{{History|||snap=12w19a|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]]  Added cocoa. The top textures of cocoa always keep a completely constant rotation, regardless of what direction they face. They also not shaded.
|[[File:Cocoa Beans JE2.png|32px]] The texture of cocoa beans has been changed.
|Cocoa has replaced jungle [[leaves]] as the main method of finding cocoa beans.
|[[File:Cocoa Age 3 (S) JE1.png|32px]] Cocoa with values 12–15 is inaccessible normally, and use the texture of the [[dragon egg]]. This is due to the dragon egg texture being to the left of the ripe cocoa texture in <samp>[[terrain.png]]</samp>, as cocoa textures are arranged with the oldest on the left and the youngest on the right, resulting in the unusually ripe cocoa reading the dragon egg texture.}}
{{History|||snap=1.3|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||1.4.2|snap=12w34a|Cocoa beans have been given the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Cocoa beans can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.5|snap=13w02a|Due to textures being stored in individual files, cocoa beans with data 12–15 no longer have a texture to use, and now crash the game if a [[chunk]] containing one is loaded.}}
{{History|||snap=13w03a|Cocoa with data values 12–15 now only crash the game if one is directly in the field of view.}}
{{History|||snap=13w04a|[[Bone meal]] now grows cocoa by only one stage.}}
{{History|||snap=13w10a|[[File:Cocoa Age 3 (S) JE2.png|32px]] Cocoa with data 12–15 now use the age 2 texture, resulting in a broken appearance, preventing previously mentioned crashes.}}
{{History||1.6.1|snap=13w18a|Cocoa beans have been removed from [[dungeon]] [[chest]]s.}}
{{History|||snap=13w19a|Brown [[Terracotta|stained clay]] can now be [[crafting|crafted]] using cocoa beans.}}
{{History||1.7.2|snap=13w41a|Brown [[stained glass]] can now be crafted using cocoa beans.}}
{{History||1.8|snap=14w07a|[[File:Cocoa Age 0 (S) JE2.png|32px]] [[File:Cocoa Age 1 (S) JE2.png|32px]] [[File:Cocoa Age 2 (S) JE2.png|32px]] [[File:Missing Model JE1.png|32px]] The top textures of cocoa now rotate with the blocks themselves (cocoa facing north remaining visually unaffected), and cocoa of age 3 has [[Missing model|no model]].}}
{{History|||snap=14w10a|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]] [[File:Missing Model JE2.png|32px]] The large section of cocoa is shaded, and the missing model (which age 3 cocoa uses) has changed.}}
{{History|||snap=14w25a|[[File:Cocoa Age 0 (S) JE4.png|32px]] [[File:Cocoa Age 1 (S) JE4.png|32px]] [[File:Cocoa Age 2 (S) JE4.png|32px]] The connecting region of cocoa is now shaded.}}
{{History|||snap=14w26a|Cocoa with data 12–15 has been effectively removed from the game, as such blocks now convert to a proper value with {{cmd|setblock}}. Loading worlds with existing out of range cocoa crash the game.}}
{{History|||snap=14w30a|Cocoa beans can now be used to dye [[banner]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this block's and item's numeral ID were respectively 127 and 351.}}
{{History||1.14|snap=18w43a|Cocoa beans can now be used to craft [[brown dye]].
|Cocoa beans can no longer be used as a [[dye]].
|All of the dye-related functions and crafting recipes of cocoa beans (except cookies) have been transferred to brown dye.
|"Cocoa Beans" item has been renamed to "Cocoa".
|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa has been changed.
|[[File:Cocoa Age 0 (S) JE5.png|32px]] [[File:Cocoa Age 1 (S) JE5.png|32px]] [[File:Cocoa Age 2 (S) JE5.png|32px]] The textures of cocoa have been changed.
|[[File:Cocoa Age 0 (texture) JE2 BE2.png|32px]] [[File:Cocoa Age 1 (texture) JE2 BE2.png|32px]] Textures for cocoa age 0 and 1 has palette left, visible only on particles.
|Cocoa now has a placement [[sound]].}}
{{History|||snap=19w03a|Placing cocoa into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Cocoa now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w11b|"Cocoa" item has been renamed back to "Cocoa Beans".{{verify|was this not just one bug that affected other crops as well? if so cite the ticket and add to all other affected pages}}}}
{{History||1.18|snap=Pre-release 5|[[File:Cocoa Age 0 (texture) JE3 BE3.png|32px]] [[File:Cocoa Age 1 (texture) JE3 BE3.png|32px]] Textures for cocoa age 0 and 1 were changed. This visually changes only particles.}}
{{History||1.19|snap=22w11a|[[File:Cocoa Age 2 (S) JE6.png|32px]] The texture and model of cocoa age 2 have been changed.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans. They are currently unobtainable and serve no purpose.}}
{{History||v0.8.0|snap=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.
|Cocoa beans can be [[crafted]] from an [[orange dye]] and an [[ink sac]], or from [[dandelion yellow]], [[rose red]], and an ink sac, despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Cocoa beans are now available in [[creative]].}}
{{History||v0.9.0|snap=build 1|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]] {{info needed|How did 12-16 appear?}} Added cocoa.
|Cocoa provides an additional way of obtaining cocoa beans.
|Cocoa beans are now used to craft [[cookie]]s.}}
{{History||v0.11.0|snap=build 14|Cocoa now grows over time.<ref>{{bug|MCPE-7887}}</ref>}}
{{History||?|[[File:Cocoa Age 0 (S) BE4.png|32px]] [[File:Cocoa Age 1 (S) BE4.png|32px]] [[File:Cocoa Age 2 (S) BE2.png|32px]] Cocoa no longer has a stem connecting it to the log.}}
{{History||v0.15.0|snap=Realms build 4|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]] Cocoa stems now render again.<ref>{{bug|MCPE-13579}}</ref>}}
{{History||v0.16.0|snap=build 1|Cocoa beans can no longer be crafted from [[orange dye]] and an ink sac.
|Cocoa beans can no longer be crafted from rose red, dandelion yellow and ink sacs.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Cocoa beans can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Cocoa beans can now be used to dye [[shulker box]]es and [[bed]]s.
|Cocoa beans can now be used to craft [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Cocoa beans can now be used to dye [[banner]]s, [[firework star]]s, and [[glass]].
|Cocoa beans can now be found in [[bonus chest]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Cocoa beans can now be used to craft brown [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.10|Cocoa beans can now be used to craft [[brown dye]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Cocoa beans are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa beans has been changed.
|[[File:Cocoa Age 0 (S) BE4.png|32px]] [[File:Cocoa Age 1 (S) BE4.png|32px]] [[File:Cocoa Age 2 (S) BE4.png|32px]] The textures of cocoa have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Cocoa beans can now be used to fill up [[composter]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of cocoa beans has been changed from <code>dye/3</code> to <code>cocoa_beans</code>.}}
{{History||1.18.10|snap=beta 1.18.10.22|[[File:Cocoa Age 0 (texture) JE3 BE3.png|32px]] [[File:Cocoa Age 1 (texture) JE3 BE3.png|32px]] Textures for cocoa age 0 and 1 were changed. This visually changes only particles.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans.}}
{{History||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||xbox=TU12|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]]{{verify|Were these the models used?}} Added cocoa.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa beans has been changed once again.
|[[File:Cocoa Age 0 (S) JE5.png|32px]] [[File:Cocoa Age 1 (S) JE5.png|32px]] [[File:Cocoa Age 2 (S) JE5.png|32px]]{{verify|Were these the models used?}} The textures of cocoa have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Cocoa Beans JE3 BE2.png|32px]] Added cocoa beans.
|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]]{{verify|Were these the models used?}} Added cocoa.}}
{{History|foot}}

=== Cocoa "item" ===
{{:Technical blocks/Cocoa}}

== Issues ==
{{issue list|Cocoa Beans|Cocoa Pod}}

== Trivia ==
*Cocoa pods have a different hitbox for each size; however, the top is always 0.25 blocks below the top of the [[log]] it is on.
*If a cocoa pod grows while the player is standing next to it, the player is forced into the appropriate form of [[suffocation prevention]] depending on available space.
*{{IN|be}}, the pixels on top of the fully grown pod are 8/7 the size of those on the side.<ref>{{bug|MC-109055||Fixed}}</ref><ref>{{bug|MCPE-152862}}</ref>

== Gallery ==
<gallery>
CocoaReveal.png|The first screenshot of cocoa pods tweeted by [[Jens Bergensten]], which revealed the plants.
CocoaPlant.png|A screenshot tweeted by Jens Bergensten, showing the pod.
Cocoa Plants in a Jungle Biome (12w19a).png|Naturally generated cocoa pods.
CPlantsJWood.png|A cocoa pod farm.
Cocoa2.jpg|A cocoa farm.
Cocoa beans phases.png|Three growing phases of the cocoa pod.
AreaOptimizedBeanPods.gif|A log and pod layout for optimizing an example area of 14×14 (including walls).
File:CocoaBean15.png|Cocoa beans with values greater than 12 appeared this way
</gallery>

==Literature==
===References===
{{reflist}}

===External Links===
*[https://www.minecraft.net/en-us/article/taking-inventory--cocoa-beans Taking Inventory: Cocoa Beans] – Minecraft.net on December 5, 2019

{{Items}}
{{Blocks|vegetation}}

[[Category:Dyes]]
[[Category:Food]]
[[Category:Plants]]
[[Category:Renewable resources]]
[[Category:Non-solid blocks]]
[[Category:Natural blocks]]

[[cs:Kakaové boby]]
[[de:Kakaobohnen]]
[[es:Semillas de cacao]]
[[fr:Fèves de cacao]]
[[hu:Kakaóbab]]
[[ja:カカオ豆]]
[[ko:코코아 콩]]
[[nl:Cacaobonen]]
[[pl:Ziarna kakaowe]]
[[pt:Sementes de cacau]]
[[ru:Какао-бобы]]
[[uk:Какао-боби]]
[[zh:可可豆]]</li><li>[[Map|Map]]<br/>{{about|the craftable map|maps showing the locations of certain structures|Explorer Map|other uses|Map (disambiguation)}}
{{distinguish|World}}
{{Item
| image = Map Zoom 4.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''map''' is an [[item]] used to view explored [[Chunk|terrain]] and mark landmarks.

==Obtaining==
===Crafting===
{{crafting
|head=1
|showname=0
|showdescription=1
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Compass
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description=This variation is called an "empty locator map" {{in|bedrock}}, or an "empty map" {{in|java}}.

When the player first creates a map, it is blank. It needs to be activated by holding it and pressing ''{{Control|use item}}''. after which it records terrain and location markers as the player travels within (or close to) the area it maps.
}}
{{crafting
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Paper
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description={{only|bedrock}}

This variation is called an "empty map". It does not show location markers. It is intended for cloning and zooming locator maps without having to consume an additional [[compass]] (thereby saving [[iron ingot]]s and [[redstone dust]]), but it can also be {{Control|use|text=activated}} and later converted to a locator map by combining it with a compass on an [[anvil]], [[crafting table]], or [[cartography table]].
|foot=1
}}

=== Natural generation ===
==== Chest loot ====
{{LootChestItem|empty-map,map 
}}

=== Cartography table ===
A map can also be created using a single paper on a [[cartography table]] to create an empty map, or a paper with a compass for an empty locator map.{{only|bedrock}}

=== Starting map ===
{{exclusive|bedrock|section=1}}
When creating a new world {{in|bedrock}}, the player can enable the "Starting Map" option to spawn with an empty locator map in the hotbar. The map's zoom scale is 1:8. The map is updated only while the player holds it.

=== Trading ===
Novice-level cartographer [[Villager|villagers]] sell a single empty map for 7 [[Emerald|emeralds]] as their trades.

{{IN|java}}, cartographer villagers may give players with the [[Hero of the Village]] effect an empty map.

== Usage ==
{{See also|Tutorials/Mapping}}

=== Mapping ===

Crafting a map creates an empty map. The map is drawn for the first time when it is held and used (with ''{{control|use item}}''). This map can then be adjusted to different zoom levels. After conversion to a drawn map item, it starts to draw a top-down view of the player's surroundings, with North pointing to the top of the map. A pointed oval pointer indicates the player's position on the map, and moves in real-time as the player moves across the terrain shown on the map. The map does ''not'' center on the player when created, rather, the world is broken up into large invisible grid squares, and the map displays the area of whichever grid square it is in when it is first used. For example, if a player uses a new map in a certain grid square, and then moves a distance away and uses another fresh map but is still within the same grid square, both maps appear identical. To make a map that is not identical to the first one, the player would have to move outside of the edges of the first map (because then they would be in a new grid square). This way, no two maps of the same size can ever partially overlap and every map can display only a fixed area.

To record the world on a map, that specific map must be held in the player's hands while the player moves around the world. The world is recorded as-is during exploration, meaning that if the world is modified, a player must revisit the area while holding the map to update the map's view. Maps can also be [[Map#Cloning|cloned]]. If a player holds a map whose clone is on display in an item frame, then that map updates while holding its clone. 

Other players are displayed on the map only if they have a map in their inventory cloned from the one being looked at. When placing a map into an [[item frame]], the map displays with a green pointer shown at the location of the item frame. This is to help the player see where they are in relation to the area that the map is showing. If the player leaves a map in an item frame and views a clone of it, the green pointer remains in the spot of the framed copy. This can be used to set up waypoints. Unexplored areas are transparent, making the item frame visible.

When the player leaves the area shown on a specific map, the player pointer transforms into a white dot on that map. The marker shrinks to a smaller white dot if the player is far from the map's center: the area is 320 by 320 blocks per scale factor. The dot moves along the edge of the map to show the relative location of the player. However {{in|bedrock}}, the pointer remains as an arrow but shrinks until the player is near the area shown on the map.

While maps in [[the Nether]] work, they show only the red-and-gray pattern, regardless of the blocks placed. The only useful function is finding where the player is in relation to placed framed maps, which show as green pointers.  Additionally, the player pointer rapidly spins and is not a good indicator of direction. Placing a [[banner]] in [[the Nether]] still shows it on the map as usual.  Having a smaller map image while riding a [[strider]] in the Nether can help one to see one's footing while traveling over [[lava]].

{{IN|java}}, when using a map from another dimension, the map shows the player's position and direction when they were last in the dimension of the map. {{IN|bedrock}}, however, the player can use maps from one dimension while in another dimension. For locator maps, the place marker changes color depending on the dimension that the player is currently in (white for the Overworld, red for [[the Nether]], and magenta for [[the End]]). An Overworld map in the Nether shows the player's corresponding location and direction in the Overworld.<ref name=multiverse>{{ytl|EpP1diZdEdI}}</ref> Similarly, a Nether Map in the Overworld shows the player's corresponding location in the Overworld, but the place marker spins, just like a Nether map in the Nether. An Overworld map in the End shows the world spawn.<ref name=multiverse/> A Nether map cannot be used in the End — the map appears, but the place marker is not shown anywhere — and similarly, an End map cannot be used in the Overworld or the Nether.

A player can make a large piece of pixel art (128×128) facing upward, center a map on it, and place that map in an [[item frame]] to create a custom picture. Locking is recommended. See [[Map item format#Map Pixel Art]] for details on the techniques.

Maps display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the map is full-sized only when held in the dominant hand with both hands free.

=== Map content ===
{{Main|Map item format}}

Maps consist of square pixels arranged like pixels in a 128×128 square pattern, with each pixel representing a square portion of land. {{IN|java}}, the [[Map item format#Color table|color of a map pixel]] generally matches the color of the most common [[opaque]] block in the corresponding area, as seen from the sky. 'Minority blocks' in the target area have no effect on the color of the pixel, thus small features tend to be undetectable on zoomed-out maps.

{{IN|bedrock}}, the [[Map item format#Color table|color of a map pixel]] instead matches the single top-most opaque block in a grid sized by the map magnification pixel size (see the table in the "Player marker and pointer" section below). For example, a 3/4 magnification map has a pixel size of 8x8 blocks; this means the map will read only the top-most opaque blocks at the 0,0 coordinate, the 8,0 coordinate, the 0,8 coordinate, etcetera, ignoring all other blocks in the area. This means that {{in|bedrock}}, map pixel art requires only one block per pixel regardless of map magnification.

{{IN|bedrock}}, grass, foliage and water colors that are biome-dependent are represented accurately on a map.

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Map Zoom 4.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Map item BE.png|216px]]
|-
| Biome colors on ''Java Edition''.
| Biome colors on ''Bedrock Edition''.
|-
|}

Maps also show ground up to about 15 blocks below the surface of the water in oceans as slightly lighter blue, to show where the ground rises. This is not true with land above water. Higher elevations in the world mean lighter colors on the map. The map records the surface even as the player moves below the surface.

A standard map represents 128x128 blocks (1 block per pixel, 8x8 [[chunks]]) but maps can be zoomed-out to represent up to 2048x2048 blocks (16 square blocks per pixel, 128x128 [[chunks]]).

Some relevant distances: 64 blocks (4 chunks) is the update radius from a player in the Overworld and the End. However, it is half this (32 blocks) in the Nether. Also, 1024 blocks is the minimum Overworld distance from a [[nether portal]], at which players can build another portal and expect to reach a new location in the Nether. This is the distance across a 1:8 map, and also from a 1:16 map's center to its edge.

=== Player marker and pointer ===
{{IN|java}}, every map contains a marker that marks the position of the player, and points in the same direction as the player. When a player moves out of a map, a big white dot appears and moves relative to the player's position. The pointer either disappears when the player moves away a certain distance from the border of the map or, in case of [[explorer map]]s, the big white dot changes to a smaller white dot. The distance required for the small white dot to appear(explorer maps) or for the big dot to vanish (normal maps) changes with the scaling of the map.
* '''Level 0/4 :''' 128×128 blocks (each map pixel represents 1 block)
* '''Level 1/4 :''' 256×256 blocks (2×2 blocks per map pixel)
* '''Level 2/4 :''' 512×512 blocks (4×4 blocks per map pixel)
* '''Level 3/4 :''' 1024×1024 blocks (8×8 blocks per map pixel)
* '''Level 4/4 :'''  2048×2048 blocks  (16×16 blocks per map pixel)
{{IN|bedrock}}, a map can be crafted with or without this marker, and a map without a position marker can add one later by adding a compass to the map.  When a map is crafted without a compass, it's simply called an "empty map", but when crafted with a compass, it's called an "empty locator map". The marker also turns red if the player enters the Nether with an Overworld map and shows the player's Overworld location relative to the Nether location. A map created in the End has a purple marker showing the player's location. If an Overworld map is used in the End, a magenta dot appears on the player's spawn point.{{/BE|position}}
{{crafting
|name=Map<br>(with marker)
|ingredients=[[Map]] or Empty Map +<br>[[Compass]]
|showdescription=1
|Map (no markers);Empty Map 
|Compass
|Output= Locator Map;Empty Locator Map
|type= Miscellaneous
|description={{el|be}} only.
Maps crafted from only paper do not show the location marker; to add it, a compass must be added to the map.
|foot=1
}}

{{IN|bedrock}}, a cartography table can also be used to add a pointer to create a locator map or empty locator map. This can be done by adding a compass to paper, or to an empty map or map.

=== Zooming out ===
[[File:Cartography table UI zoom.png|thumb|300px|{{IN|java}}, cartography table's UI, showing the map is being zoomed out.]]

A [[cartography table]] can also be used to zoom out, taking only one piece of paper per zoom level.

A blank map can not be zoomed out. A map has to have something already marked on it for the zooming to be possible.

{{Crafting
  |A1= Paper |B1= Paper |C1= Paper
  |A2= Paper |B2= Map;Locator Map   |C2= Paper
  |A3= Paper |B3= Paper |C3= Paper
  |Output= Map;Locator Map
  |showdescription=1
  |description=Locator Map {{el|be}} only.
}}
{{/BE|zoom}}

==== Zoom details ====
The zooming function starts from when the map is created (zoom level 0) up to its fourth zoom step (zoom level 4).

{| class="wikitable" style="text-align: center" data-description="Zoom levels"
! colspan="2" | 
! Zoom step 0  
! Zoom step 1  
! Zoom step 2  
! Zoom step 3  
! Zoom step 4
|-
! colspan="2" |
| [[File:Map Zoom 0.png|116px|Zoom step 0, 1:1]]
| [[File:Map Zoom 1.png|116px|Zoom step 1, 1:2]]
| [[File:Map Zoom 2.png|116px|Zoom step 2, 1:4]]
| [[File:Map Zoom 3.png|116px|Zoom step 3, 1:8]]
| [[File:Map Zoom 4.png|116px|Zoom step 4, 1:16]]
|-
! colspan="2" | Zoom level
| 0/4
| 1/4
| 2/4
| 3/4
| 4/4
|-
! colspan="2" | 1 map pixel represents
| 1 block
| 2×2 blocks
| 4×4 blocks
| 8×8 blocks
| 16×16 blocks<br>(1×1 chunk)
|-
! colspan="2" | Scaling ratio
| 1:1
| 1:2
| 1:4
| 1:8
| 1:16
|-
! rowspan="2" colspan="2" | Map covers an area of
| 128×128 blocks
| 256×256 blocks
| 512×512 blocks
| 1024×1024 blocks
| 2048×2048 blocks
|-
| 8×8 chunks
| 16×16 chunks
| 32×32 chunks
| 64×64 chunks
| 128×128 chunks
|-
! colspan="2" | Smallest discernible features
| Blocks
| Trees, Paths
| Lakes, Buildings
| Mountains, Rivers
| Biomes, Mountain Ranges
|-
! colspan="2" | Use cases
| Pixel art, Base plans
| Base surroundings
| Structure mapping
| Landscape mapping
| Biome mapping
|-
! rowspan="2" | Total paper needed to zoom out from Level 0
! in anvil{{only|bedrock|short=1}} or crafting table
| -
| {{ItemSprite|Paper}} 8
| {{ItemSprite|Paper}} 16
| {{ItemSprite|Paper}} 24
| {{ItemSprite|Paper}} 32
|-
! in cartography table
| -
| {{ItemSprite|Paper}} 1
| {{ItemSprite|Paper}} 2
| {{ItemSprite|Paper}} 3
| {{ItemSprite|Paper}} 4
|}

Maps are always aligned to a grid at all zoom levels. That means zooming out any different map in a specific area covered by that map always has the same center. As such, maps are aligned by map width (1024 blocks for a level 3 maps) minus 64. A level 3 map generated at spawn covers X and Z coordinates from -64 to 959. All maps generated in this area zoom out to the same coordinates, guaranteeing that they are always 'aligned' on a map wall. For a zoomed-out map to cover a new area, it must start with a base (level 0) map that is in that area.

At zoom level 0, a map created on the point (0,0) has (0,0) at the center of the map. At higher zoom levels of the same map, the coordinate (0,0) is in the top left square of the map.

{{IN|java}}, zoom level can be seen on a map by turning on Advanced Tooltips (a [[Debug screen#More debug keys|debug screen]] option that can be toggled by using the key combination {{key|F3+H}}). The tooltip of the map then shows the zoom level, scaling factors, and map ID.

=== Cloning ===
[[File:Cartography table UI clone.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being cloned.]]

A mix of empty maps and empty locator maps may be used. Whether the cloned maps show position markers is dependent only on the input map.

A [[cartography table]] can also be used to clone a map.

The parts of the world that have already been explored and mapped are copied, and newly explored areas appear on both instances. If one of the maps is later zoomed out, then the maps lose their connection to each other and function as completely separate maps that have to be individually filled by exploring.

In Creative mode, a map in an item frame may be cloned by using {{control|pick block}} on it, as long as that map is not also in the player's inventory.

It doesn't matter if the map to be cloned is at a higher zoom level (made of more paper) than the blank map. Upon copying the map, both resulting maps have the same magnification as the starting map.

{{/BE|clone}}

=== Crafting ingredient ===

{{crafting usage|Map, Empty Map}}

=== Marking points ===
{{IN|java}} the player has the ability to mark spots on a map. To do this, {{control|use}} a map on a placed-down [[banner]], and the spot of the banner gets marked on the map. The mark takes the color of whatever the base color is for the banner, and if the banner has a name, the mark shows that name. Banner marks on a map are always oriented with their top facing north, regardless of the banner's actual orientation. If the banner is destroyed, the mark of the banner remains at first, but if the player gets closer to where the banner previously was, it disappears as the area is updated on the map.

If a map is mounted on an item frame and is within the area it depicts, the mounted map displays its current location with a green indicator rotated to match its orientation.

[[File:Map Marker Bedrock on Item frame.png|thumb|181x181px|{{IN|bedrock}} this is what a map lying on an item frame looks like, while showing markers.]]
{{IN|bedrock}} the player can place copies of locator maps in [[item frame]]s in order to create a land mark. The marker is a green dot that resembles the shape of the player's marker, but in green color. The position the marker points at depends on the direction the item frame is facing. It is worth noting that the markers work only on copies of the same map. Other maps of the same area do not show the existing markers that the player(s) had placed.

If a player has a cloned map in their inventory, their pointer appears white when viewed on the same map held by another player. Hence, if all players have the same cloned map in their inventory, all markers would appear white when the clone map is viewed. 

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Tracking map with markers bedrock.png|216px]]
|-
| How every banner appears {{IN|java}} on a map, including named banners.
| {{IN|bedrock}} this is how a locator map shows map markers while held by a player.
|-
|}

===Locking===
[[File:Cartography table UI lock.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being locked.]]

Maps can be locked when using a [[glass pane]] in a [[cartography table]]. This creates a new map containing the same data and locks it. All copies of this new map are also locked. A locked map never changes, even when the depicted terrain changes. {{IN|Be}}, locked maps have a unique texture.

{| class="wikitable" style="text-align: center;"
|-
! Condition
! style="width: 200px;" | Newly created map
! style="width: 200px;" | Map after terrain alteration
|-
! Unlocked map
| [[File:Map Zoom 0.png|174px]] || [[File:Unlocked Map.png|174px]]
|-
! Locked map
| [[File:Map Zoom 0.png|174px]] || [[File:Map Zoom 0.png|174px]]
|-
|}

{{-}}

== Sounds ==
{{Edition|Java}}:
{{Sound table
|rowspan=2
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|subtitle=Map drawn
|source=player
|description=When a map is drawn
|id=ui.cartography_table.take_result
|translationkey=subtitles.ui.cartography_table.take_result
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Map drawn
|source=block
|description=When a map is edited using a cartography table
|id=ui.cartography_table.take_result
|translationkey=subtitles.ui.cartography_table.take_result
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|rowspan=2
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|source=block
|description=When a map is drawn<wbr>{{Upcoming|BE 1.20.20.20}}
|id=ui.cartography_table.take_result|idnote={{Verify|Could be block.cartography_table.use}}
|volume=0.8
|pitch=1.0}}
{{Sound table
|type=bedrock
|source=block
|description=When a map is edited using a cartography table
|id=ui.cartography_table.take_result
|volume=0.8
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=map
|form=item}}
{{ID table
|displayname=Map
|spritetype=item
|nameid=filled_map
|form=item
|translationkey=item.minecraft.filled_map, filled_map.buried_treasure, filled_map.explorer_jungle{{upcoming|java 1.20.2}}, filled_map.explorer_swamp{{upcoming|java 1.20.2}}, filled_map.mansion, filled_map.monument, filled_map.unknown, filled_map.village_desert{{upcoming|java 1.20.2}}, filled_map.village_plains{{upcoming|java 1.20.2}}, filled_map.village_savanna{{upcoming|java 1.20.2}}, filled_map.village_snowy{{upcoming|java 1.20.2}}, filled_map.village_taiga{{upcoming|java 1.20.2}}
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=empty_map
|aliasid=emptymap
|id=515
|form=item
|translationkey=item.emptyMap.name, item.emptyLocatorMap.name}}
{{ID table
|displayname=Map
|spritetype=item
|spritename=map-be
|nameid=filled_map
|aliasid=map
|id=420
|form=item
|translationkey=item.map.name, item.map.exploration.mansion.name, item.map.exploration.monument.name, item.map.exploration.treasure.name
|foot=1}}

=== Metadata ===
{{see also|Bedrock Edition data values}}
{{IN|bedrock}}, maps use the following data values:

{{/DV}}

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

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

=== Map icons ===
{{see also|Player.dat format|Map item format|map_icons.png}}
Map icons are 8×8 in ''Java Edition'', but 16×16 in Bedrock Edition. As such, there are minor misalignment issues in ''Java Edition''.<ref>{{bug|MC-214649|||WF}}</ref>
[[File:Map icons.png|thumb|128px|Map icons texture {{in|Java}}]]
[[File:Map icons BE.png|thumb|128px|Map icons texture {{in|Bedrock}}]]

{| class="wikitable"
|-
! Java ID !! Bedrock ID !! Text ID !! Appearance !! Purpose !! Shown in item frames?
|-
| 0 ||  ||<code>player</code> || [[File:Player (texture) JE1 BE1.png|16px]] [[File:Player (texture) BE2.png|16px]] White marker || Players (on map) || No
|-
| 1 || 1 ||<code>frame</code> || [[File:Green Marker (texture) JE1 BE1.png|16px]] [[File:Green Marker (texture) BE2.png|16px]] Green marker || The current map in an item frame || Yes
|-
| 2 ||  ||<code>red_marker</code> || [[File:Red Marker (texture) JE1 BE1.png|16px]] [[File:Red Marker (texture) BE2.png|16px]] Red marker || Position converted to Overworld when opening Overworld map in the Nether{{Only|bedrock}} || No
|-
| 3 ||  ||<code>blue_marker</code> || [[File:Blue Marker (texture) JE1 BE1.png|16px]] [[File:Blue Marker (texture) BE2.png|16px]] Blue marker || Other players || No
|-
| 4 ||  ||<code>target_x</code> || [[File:Target X (texture) JE1 BE1.png|16px]] White X || Unused || Yes
|-
| 5 ||5
|<code>target_point</code> || [[File:Target Point (texture) JE1 BE1.png|16px]] [[File:Target Point (texture) BE2.png|16px]] Red triangle || Unused || Yes
|-
| 6 || 6 ||<code>player_off_map</code> || [[File:Player Off Map (texture) JE1 BE1.png|16px]] Large white dot || Players off map, nearby{{only|java}} || No
|-
| 7 || 13 ||<code>player_off_limits</code> || [[File:Player Off Limits (texture) JE1.png|16px]] [[File:Player Off Limits (texture) BE.png|16px]] Small white dot || Players off map, far away{{only|java}} || No
|-
| 8 ||14
|<code>mansion</code> || [[File:Mansion (texture) JE1.png|16px]] [[File:Mansion (Texture) BE2.png|frameless|16x16px]] Woodland mansion || Woodland mansion || Yes
|-
| 9 || 15 ||<code>monument</code> || [[File:Monument (texture) JE1.png|16px]] [[File:Monument Texture BE2.png|frameless|16x16px]] Ocean monument || Ocean monument || Yes
|-
| 10 - 25 ||  ||<code>{{tooltip|banner_*|banner_white, banner_orange, banner_magenta, banner_light_blue, banner_yellow, banner_lime, banner_pink, banner_gray, banner_light_gray, banner_cyan, banner_purple, banner_blue, banner_brown, banner_green, banner_red, banner_black}}</code> || [[File:Banner White (texture) JE1.png|16px]] [[File:Banner Light Gray (texture) JE1.png|16px]] [[File:Banner Gray (texture) JE1.png|16px]] [[File:Banner Black (texture) JE1.png|16px]] [[File:Banner Brown (texture) JE1.png|16px]] [[File:Banner Red (texture) JE1.png|16px]] [[File:Banner Orange (texture) JE1.png|16px]] [[File:Banner Yellow (texture) JE1.png|16px]] [[File:Banner Lime (texture) JE1.png|16px]] [[File:Banner Green (texture) JE1.png|16px]] [[File:Banner Cyan (texture) JE1.png|16px]] [[File:Banner Light Blue (texture) JE1.png|16px]] [[File:Banner Blue (texture) JE1.png|16px]] [[File:Banner Magenta (texture) JE1.png|16px]] [[File:Banner Purple (texture) JE1.png|16px]] [[File:Banner Pink (texture) JE1.png|16px]]<br>Banners in all 16 wool colors{{only|java}}|| Banner markers || Yes
|-
| 26 ||4
|<code>red_x</code> || [[File:Red X (texture) JE1.png|16px]] [[File:Target X (texture) BE2.png|16px]] Red X || Buried treasure || Yes
|-
| || 8 || || [[File:Magenta Marker (texture) BE1.png|16px]] Magenta marker
| Position converted to Overworld when opening Overworld map in the End{{Only|bedrock}} || No 
|-
| || 9 || || [[File:Orange Marker (texture) BE1.png|16px]] Orange marker{{more info}}
|Other players
|Yes
|-
| || 10 || || [[File:Yellow Marker (texture) BE1.png|16px]] Yellow marker
| Other players || No
|-
| || 11 || || [[File:Cyan Marker (texture) BE1.png|16px]] Cyan marker
| Other players || No
|- 
| -
|12
| || [[File:Green Point (texture) BE1.png|16px]] Green Triangle
| Other structure such as stronghold, fortress, end city, etc. when used as explorer map destination{{Only|bedrock}} || Yes
|}
It should be noted that even if the player used a NBT editor to add an additional icon on the map, ''Minecraft'' shows only the first one listed when the player loads up their world.

== Achievements ==
{{load achievements|Map Room}}

== History ==
{{see also|section=24|map_icons.png|Java Edition history of textures#Map icons}}
{{more images|section=24|{{bug|MC-72962}}}}
{{History||April 27, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps|[[Notch]] unveiled screenshots of the map.}}
{{History||April 28, 2011|link={{tweet|notch|63500114005721088}}|[[Notch]] said that he would try to make maps place-able on [[wall]]s.}}
{{History|java beta}}
{{History||1.6|snap=Test Build 3|[[File:Map (item) JE1 BE1.png|32px]] Added maps.}}
{{History||1.6.6|The ability to auto-craft maps using shift-click has been disabled.}}
{{History||1.8|snap=Pre-release|Maps can now be found in library chests in the brand-new [[stronghold]]s.
|Auto crafting maps has been restored. Map cloning, therefore, is unavailable for a period of time.}}
{{History||1.8.1|Maps now work both while walking and flying.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 5|Prior to this update, the [[sun]] in ''[[Minecraft]]'' rose in the North, which threw off many [[player]]s and led to a common misconception that ''Minecraft'' maps/[[world]]s were oriented with East at the top. The sun now rises in the east and sets in the west, making navigation much more intuitive.
|Before the change in sun position, it was commonly said that ''Minecraft'' maps/worlds are oriented with East at the top; sunrise, by definition, occurs at the East, which means it is certainly true that the maps were oriented "East" since the Sun rose from the top (North). However, [[Jeb]] asserted (and [[Notch]] agreed) that the sun rose in the north.<ref>{{Tweet|jeb|87815841160237056}}</ref><ref>{{Tweet|notch|88155424880201728}}</ref> Most mods and map-making tools, however, used the terms East and North consistent with their actual definitions (e.g. a [[Programs and editors/Cartograph|Cartograph]]-generated map with North at the top is rotated 90 degrees from the in-game map).}}
{{History||1.4.2|snap=12w34a|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now creates an empty map. The map is drawn for the first time when it is held and right clicked, and is centered near the location of the [[player]] when clicked (not as before where it was centered on the location it was crafted.)
|Previously, in order to map a new area, the map had to be ''crafted'' in that area (rather than carrying a previously-crafted map to the new area). The point where a map is crafted becomes its permanent center, and could never be changed. 
|The pointer no longer disappears when leaving the map, but transforms into a white dot, indicating on what side of the map the player is located.
|Maps now align to a grid, making it easier to create adjacent maps.
|Maps can now be zoomed out (but not zoomed in).
|Maps can now be cloned and scaled.}}
{{History||1.4.2|snap=12w34b|Maps now have a ''zoom level'', which was fixed at 1:8 prior to snapshot [[Java Edition 12w34a|12w34a]],<ref name="mapinfo">https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps</ref> but  now starts at 1:1 and can be increased up to 1:16 by re-crafting an existing map.
|Maps are no longer numbered on the top-left corner and is labeled through the tooltip.}}
{{History|||snap=12w36a|New maps are now crafted at a scale factor of 1:1. A zoomed in map can be zoomed out by re-crafting it with another 8 sheets of [[paper]] on a [[crafting table]]. Each time this is done, the scale increases - 1:1, 1:2, 1:4, 1:8, 1:16 with a map scale of 1:16 being the current maximum.}}
{{History||1.7.2|snap=13w38a|The map size has been increased when placed on a [[wall]] using the [[item frame]].
|More colors have been added to maps for different [[block]]s.<ref name="infodump2">https://web.archive.org/web/0/https://www.mojang.com/2013/10/minecraft-1-7-the-update-that-changed-the-world</ref>}}
{{History||1.8|snap=14w31a|Zoomed maps now conform to an expanded grid based on their zoom level. Previously, careful considerations would need to be taken to creating a wall of adjoining maps.}}
{{History||1.8.1|snap=pre1|Some colors have been changed on maps to more accurately represent their respective [[block]].}}
{{History||1.9|snap=15w31a|Maps now display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the (old) large version is visible only when held in the dominant hand with the secondary hand free.}}
{{History|||snap=15w34a|New maps can now be [[crafting|crafted]] at a scale factor of 1:4.
|A crafting recipe has been added for zooming in maps.}}
{{History|||snap=15w43a|The average yield of empty maps from [[stronghold]] library [[chest]]s has been doubled.}}
{{History|||snap=15w45a|New maps are once again [[crafting|crafted]] at a scale factor of 1:1, as they had been before snapshot [[15w34a]].
|The [[crafting]] recipe, that was introduced in 15w34a, for zooming in maps has been removed.}}
{{History|||snap=15w49a|Map making now uses armor equipping sounds.}}
{{History||1.11|snap=16w39a|Maps now work in [[the End]].
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s as their tier 3 [[trading|trade]].
|Added [[explorer map]]s, sold by cartographers as their tier 4 trades.}}
{{History||1.12|snap=17w17a|Maps now have separate colors for colored [[terracotta]] blocks from other colored blocks.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 358 and 395.
|Maps now use additional NBT to specify which map they contain. Prior to this version, they used the [[damage]] value instead.
|Map IDs are no longer limited to 32,768.}}
{{History|||snap=17w50a|Maps can now be placed on floor and ceiling [[item frame]]s.}}
{{History|||snap=18w10a|Spots on maps can now be marked using [[banner]]s.}}
{{History|||snap=18w11a|Empty maps can now generate in [[shipwreck]] [[chest]]s.}}
{{History|||snap=pre7|Maps have been changed slightly, in regard to which [[block]]s are shown and which blocks are not.}}
{{History||1.14|snap=18w43a|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History|||snap=18w48a|Empty maps can now be found in chests in [[village]] cartographer houses.}}
{{History|||snap=19w02a|Maps can now be cloned and zoomed out (extended) by using a [[cartography table]].
|Maps can now be locked by using a [[glass pane]] with a cartography table.
|The recipes for cloning and zooming out maps have been removed.}}
{{History|||snap=19w06a|Map making is now silent again.}}
{{History|||snap=19w13a|Cartographer villagers now give empty maps to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w21a|Map making sounds are now the same as when using a cartography table.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Empty Map JE1 BE1.png|32px]] [[File:Map (item) JE1 BE1.png|32px]] Added maps.
|Maps are crafted using nine [[paper]], one for every slot of the [[crafting]] grid.
|Maps must be combined with a [[compass]] using an [[anvil]] in order to show the [[player]]'s position.
|Maps can be zoomed using an anvil.}}
{{History|||snap=build 3|New maps are now [[crafting|crafted]] at full zoom.
|Empty maps now have a "Create Map" button to initialize them.}}
{{History|||snap=build 7|New maps are now crafted at a scale factor of 1:1.}}
{{History||v0.15.0|snap=unknown|Maps can now be crafted either with 8 pieces of [[paper]] and a [[compass]] ''or'' 9 pieces of paper, to get a map with or without a position marker.}}
{{History||v0.16.0|snap=build 1|Different colors have been added to maps for different [[biome]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=?|[[Windows 10 Edition]] can now use the [[anvil]] as well as the [[crafting table]] to clone, zoom and apply markers, just as [[Pocket Edition]] in general could.
|Maps can now be found inside [[stronghold]] library [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Empty maps with direction markers built-in are now called "locator maps".}}
{{History|||snap=alpha 1.1.0.3|"Locator maps" are now called "empty locator maps".
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s for 7-11 [[emerald]]s as their tier 3 [[trading|trade]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Maps can now be found inside map room [[chest]]s in [[shipwreck]]s.}}
{{History||?|The texture of the filled map overlay has been changed.}}
{{History||?|Maps now function in dimensions other than the dimension in which they were created.}}
{{History||1.10.0|snap=beta 1.10.0.3|Maps can now be found in cartographer house [[chest]]s in [[village]]s.
|[[File:Empty Map JE2 BE2.png|32px]] The texture of empty maps has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Empty maps can now be created from 1 [[paper]] in [[cartography table]]s.
|Maps can now be zoomed, cloned, renamed, and have pointers added in cartography tables.}}
{{History|||snap=beta 1.11.0.4|Cartographer [[villager]]s now [[trading|sell]] empty map for an [[emerald]] as their first tier [[trading|trades]].
|Empty locator maps can now be [[trading|bought]] from cartographer villagers.}}
{{History||1.13.0|snap=beta 1.13.0.1|[[File:Map (item) BE3.png|32px]] [[File:Locked Map (item) BE2.png|32px]] Filled maps and locked maps now have unique inventory icons.}}
{{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed, novice-level cartographer now sell an empty map for 7 emeralds. Cartographer villager no longer sell empty locator map.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of maps have been changed from <code>emptymap</code> to <code>empty_map</code> and <code>map</code> to <code>filled_map</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Map (item) JE1 BE1.png|32px]] Added maps. 
|The [[player]] spawns with a free map. 
|Maps are available only as zoom step 3 maps centered at coordinates 0,0. Biome colors do not appear on maps.}}
{{History||xbox=none|xbone=CU1|ps=1.0|wiiu=none|Larger sized worlds on Xbox One, Playstation 4, and Nintendo Switch have zoom step 3 maps aligned to a grid with maps centered at 0, 1024, or 2048 on the X or Z coordinates.}}
{{History||xbox=TU21|xbone=CU9|ps=1.14|wiiu=Patch 1|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now produces an empty map.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The outer end islands appear on different maps; even on Xbox 360, Playstation 3, Vita, and Wii U editions.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History||ps=1.91|Maps can now be created and used in [[cartography table]]s.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Use of the {{key|F1}} key can allow the player to hold a map without blocking their view at all.
* In ''Java Edition'', a map created using {{cmd|give}} can be any map by using the Map parameter to specify the map number desired. E.g. {{cmd|give [player] minecraft:filled_map{map:5<nowiki>}}} gives the specified player map_5. If no data value is supplied it defaults to map_0. If map_0 has not ever been crafted, it is centered on x=0, z=0.
* The maps are stored separately as their own data (<code>.dat</code>) file as <code>map_x.dat</code> with (x) being the map number, see [[map item format]] for more info. By manipulating this number, players can organize their maps to suit them, or if they accidentally create a map in the same location, they can delete their extra map so as to save the number they make.
* Certain programs can be used to make customized maps with images or text on them instead of actual maps, many people use these in adventure maps to show pictures or to tell a story.
* Since all copies of a map are links to the same file, copying an unfinished map keeps it synchronized with the copy as the player fills it in. Thus, a copy stored in a chest can act as a remote backup.
* A map that is in an item frame does not update itself until a player picks it up, lets it reload, and places it back again. However, if a player holds a clone of the map, both maps update.
* Filled maps are the only items that make 90 degree rotations in item frames, and also the only items that can expand the item frame into full block wide.
* On [[Legacy Console Edition]], the player always spawns with a map in their inventory after creating a world. This was later added to Bedrock Edition as an optional feature in the world creation menu.
* Maps on Legacy Console Edition always show the player's current coordinates, as a substitute for the optional [[Coordinates|coordinate display]] in other editions.
* A map cannot be created on [[New Nintendo 3DS Edition]]. Instead, the map is always displayed on the bottom screen along with the coordinates. Biome colors do not appear on maps.

== Gallery ==
<gallery>
MapItem1.png|A fully zoomed map.
MapRotation.png|Having a map in hand does not stop the ability to see ahead.
MapItem3.png|A world being recorded onto a map.
Mcmap4.png|Nearly fully explored map.
Zoomed Map.png|A map edited to the scale of 1.
Sky Map.png|A map mapping the [[Sky Dimension]].
MapOfVillage.png|A village and how it is represented on a map.
Pumpkin map.png|A map containing a custom image made by placing a large number of blocks.
Complete Map.png|A completely explored map.
MapZooms.png|A diagram showing how maps zoomed out before [[Java Edition 1.8]]. Notice how the larger maps have borders made of half and quarter small maps.
Map18zooms.png|From 1.8, zoomed maps are aligned to this grid exactly.
Large Biome Map.png|A map of a [[Large Biomes]] world.
Map0140-0160.png|A comparison of maps between versions in Pocket Edition Alpha [[Pocket Edition Alpha 0.14.0|0.14.0]] and [[Pocket Edition Alpha 0.16.0|0.16.0]].
Mycelium Map.png|A map view of a mushroom biome, showing that mycelium appears purple on a map.
MiniMap.png|Maps held in the off-hand or in either hand while [[dual wielding]] appear as mini-maps.
Partly filled treasure map.png|Partly filled treasure map with an odd area at the bottom left. Normally a partly filled map would look striped (as in the top left), but this map seems to be bugged and is possibly showing caves, or something, in the bottom left.
Partly filled ocean explorer map.png|Partly filled ocean explorer map. Updating the game from an older version (in this case the area was first generated before 1.18) and buying a map after updating (in this case in 1.19.4) can result in the map displaying rivers and terrain where there is really a frozen sea.
Map Stained Glass 1.png|Stained glasses' appearances on maps before and after 1.13.
Map Stained Glass 2.png|Stained glasses' appearances on maps before and after 1.13.
Map Various Blocks 1.png|Various blocks' appearances on maps before and after 1.13.
Map Various Blocks 2.png|Various blocks' appearances on maps before and after 1.13.
Better Together Map.jpg|Holding a map in the offhand in ''Bedrock Edition''.
Better Together Map Icon.jpg|Holding a map in both hands in ''Bedrock Edition''.
</gallery>

=== The Nether ===
<gallery>
Nethermap.png|A map in [[the Nether]].
Maponnether.png|A map in the Nether; the arrow turns around itself, like in [[compass]].
</gallery>

=== The End ===
<gallery>
Jeb End Map.png|The first image of a map in [[the End]].
Endmap.png|A map in the End.
</gallery>

=== Maps in item frames ===
<gallery>
FramedMap.png|A map displayed on an item frame, as it looked before [[Java Edition 1.7.2]].
Structure Map Collection.png|Multiple maps in item frames. Notice a [[village]], two [[desert temple]]s and a lava lake.
Minecraft maps 3by3.png|A collection of 9 connected full maps.
Full Map.png|A combination of 25 maps pasted together as one map.
Map wall BE.png|A map wall on ''Bedrock Edition'', showing large areas of biome colors for each biome.
Map's in item frames.png|Maps can be placed into [[item frame]]s so they can be viewed together.
Comparing Maps.png|The comparison between 3 zooms of maps.
SuperflatMap.png|A map in a [[Superflat]] world, with some [[village]]s.
MapWallWithMarkers.png|A 3x3 map wall with banner markers.
HEYYEYAAEYAAAEYAEYAA.png|He-Man map art.
Map Player Icons 1.png|First image of player icons on maps.
Map Player Icons 2.png|Second image of player icons on maps.
</gallery>

== See also ==
* [[Explorer Map]]
* [[Clock]]
* [[Tutorials/Navigation|Navigation]]

== References ==
{{Reflist}}

{{Items}}

[[cs:Mapa]]
[[de:Karte]]
[[es:Mapa]]
[[fr:Carte (objet)]]
[[hu:Térkép (tárgy)]]
[[ja:地図]]
[[ko:지도]]
[[nl:Kaart]]
[[pl:Mapa]]
[[pt:Mapa]]
[[ru:Карта]]
[[tr:Harita]]
[[th:แผนที่]]
[[uk:Мапа]]
[[zh:地图]]
[[Category:Renewable resources]]</li></ul></nowiki>
22w24aAllays now dance near jukeboxes that are playing music.
Allays can now be duplicated using an amethyst shard by giving an allay with no item an amethyst shard.
Bedrock Edition
1.18.10
{{Extension DPL}}<ul><li>[[Dried Kelp|Dried Kelp]]<br/>{{about|the item|the block|Dried Kelp Block}}
{{Item
| title = Dried Kelp
| image = Dried Kelp.png
| renewable = Yes
| heals = {{hunger|1}}
| stackable = Yes (64)
}}

'''Dried kelp''' is a [[food]] item that can be quickly eaten by the [[player]]. It can also be crafted into [[Dried Kelp Block|dried kelp blocks]].

== Obtaining ==

=== Cooking ===
[[Kelp]] can be cooked in a [[furnace]], [[smoker]], or [[campfire]]. Each piece of dried kelp removed from a furnace output slot gives 0.1 [[experience]] (6.4 experience per stack).
{{Smelting
|Kelp
|Dried Kelp
|0,1
}}

=== Crafting ===
{{Crafting
 |Dried Kelp Block
 |Output= Dried Kelp,9
 |type= Foodstuff
}}

== Usage ==

=== Food ===
[[File:Eating dried kelp.png|thumb|A player eating dried kelp.]]
To eat dried kelp, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|1}} [[hunger]] and 0.6{{only|je|short=1}} / 0.2{{only|be|short=1}} hunger [[Hunger#Mechanics|saturation]].

A player can consume dried kelp about twice as fast as any other food item in the game.

=== Crafting ingredient ===

{{Crafting usage}}

=== Composting ===
Dried kelp placed into a [[composter]] has a 30% chance of raising the compost level by 1.

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

== Achievements ==

{{load achievements|Castaway}}

== Advancements ==

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Dried Kelp
|spritetype=item
|nameid=dried_kelp
|id=270
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.13|snap=18w07a|[[File:Dried Kelp JE1.png|32px]] Added dried kelp.}}
{{History|||snap=18w08b|Dried kelp can now be used to craft [[dried kelp block]]s.}}
{{History||1.14|snap=19w03a|Placing dried kelp into the new [[composter]] has a 10% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Dried kelp now has a 30% chance of increasing the compost level in a composter.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[File:Dried Kelp BE1.png|32px]] Added dried kelp.}}
{{H||1.11.0|snap=beta 1.11.0.1|Dried kelp can now be used to fill up [[composter]]s.}}
{{History||1.17.10|snap=beta 1.17.10.20|[[FIle:Dried Kelp JE1.png|32px]] The texture of dried kelp has been changed to match ''Java Edition''.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Dried Kelp BE1.png|32px]] Added dried kelp.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

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

[[de:Getrockneter Seetang]]
[[es:Algas secas]]
[[fr:Algue séchée]]
[[ja:乾燥した昆布]]
[[ko:말린 켈프]]
[[lzh:乾海帶]]
[[nl:Gedroogde kelp]]
[[pl:Suszone wodorosty]]
[[pt:Algas secas]]
[[ru:Сушёная ламинария]]
[[th:สาหร่ายทะเลแห้ง]]
[[zh:干海带]]</li><li>[[Enchanted Golden Apple|Enchanted Golden Apple]]<br/>{{Item
| image = Enchanted Golden Apple.png
| rarity = Epic
| heals = {{hunger|4}}
| effects = 
* {{EffectLink|Absorption}} IV (2:00)
* {{EffectLink|Regeneration}} II (0:20){{only|java|short=yes}}/V (0:30){{only|bedrock|short=yes}}
* {{EffectLink|Fire Resistance}} (5:00)
* {{EffectLink|Resistance}} (5:00)
| renewable = No
| stackable = Yes (64)
}}

An '''enchanted golden apple''' ({{in|je}}), notch apple, or '''enchanted apple''' ({{in|be}}), is a rare, uncraftable variant of the [[golden apple]] that grants much more powerful effects when consumed.

== Obtaining ==
=== Chest loot ===
{{LootChestItem|enchanted-golden-apple}}

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

To eat an enchanted golden apple, press and hold {{control|use}} while it is selected in the hotbar. It restores {{hunger|4}} points of hunger and 9.6 [[Hunger#Mechanics|saturation]].

The enchanted golden apple provides: 
* [[Absorption]] IV for 2 minutes (providing {{hp|16|absorption=1}} points of absorption health)
* [[Regeneration]] level II {{in|java}} or V {{in|bedrock}} for 30 seconds ({{in|java}}, {{hp|1}} is restored every 25 ticks, {{hp|2|notag=1}} × 0.4 per second) for 20 seconds (long enough to heal {{hp|16}} points of damage; {{in|bedrock}}, {{hp|1}} is restored every 6 ticks, {{hp|2|notag=1}} × 1.66 per second for 30 seconds, which is long enough to heal up to {{hp|100}} points of damage.
* [[Fire Resistance]] I for 5 minutes
* [[Resistance]] I (20% reduced damage from all sources except the [[void]]) for 5 minutes

=== Horses ===
Enchanted golden apples can be used for improving the chances of taming a [[horse]] by 10%, for [[breeding]] and leading horses, and for speeding up the growth of [[baby]] horses by 4 minutes.

=== Crafting ingredient ===
{{crafting usage|Enchanted Golden Apple|match=start}}
===Piglins===
{{EntityLink|Piglin|Piglins}} are attracted to enchanted golden apples and run toward any enchanted golden apples on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory. However, piglins do not eat enchanted golden apples (or any [[food]]).

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Enchanted Golden Apple
|spritetype=item
|nameid=enchanted_golden_apple
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Enchanted Golden Apple
|spritetype=item
|nameid=enchanted_golden_apple
|aliasid=appleenchanted
|id=259
|form=item
|translationkey=item.appleEnchanted.name
|foot=1}}

== Achievements ==
{{load achievements|Overpowered;Fruit on the Loom;Oooh, shiny!}}

== Advancements ==
{{load advancements|Oh Shiny;A Furious Cocktail;How Did We Get Here;Husbandry;A Balanced Diet}}

== History ==
{{History|java}}
{{History||1.3.1|snap=12w21a|[[File:Enchanted Golden Apple JE1 BE1.gif|32px]] Added enchanted golden apples.
|Enchanted golden apples highly resemble the golden apple prior to [[Java Edition 1.1|1.1]]. 
|Enchanted golden apples have [[Regeneration]] IV (30 seconds), [[Resistance]] (5 minutes) and [[Fire Resistance]] (5 minutes). 
|Enchanted golden apples can be [[crafted]] with 8 [[blocks of gold]] and one apple, making them [[renewable]]. 
|Enchanted golden apples shine like an [[enchanting|enchanted]] [[item]] and have a purple tooltip while the standard golden apple's tooltip changed to blue. However, the standard golden apple's effects remain unchanged.}}
{{History|||snap=12w21b|Added Enchanted Golden Apples to the Creative inventory.}}
{{History||1.6.1|snap=13w24b|Enchanted golden apples now give the player Absorption as well, and Regeneration IV has been increased to Regeneration V.}}
{{History|||snap=?|Enchanted golden apples can now be used to tame, breed and heal horses and donkeys.}}
{{History||1.8|snap=14w06a|[[Crafting]] an enchanted golden apple now gives the [[player]] the [[Achievements/Java_Edition|''achievement'']] "Overpowered."}}
{{History||1.9|snap=15w37a|Enchanted golden apples now give Regeneration II (down from V) and [[Absorption]] IV (up from I), in addition to the unchanged [[Resistance]] and [[Fire Resistance]] effects. The duration of the Regeneration effect has now also been decreased to 20 seconds.}}
{{History|||snap=15w44a|Enchanted golden apples are now uncraftable, making them no longer renewable.
|Enchanted golden apples have been added to [[dungeon]], [[desert temple]] and [[mineshaft]] chests.}}
{{History||1.11|snap=16w39a|Enchanted golden apples are now found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|The names and IDs have been split into golden apple and enchanted golden apple.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 322.}}
{{History||1.14|snap=18w43a|[[File:Enchanted Golden Apple JE2 BE2.gif|32px]] The texture for enchanted golden apples has been changed.}}
{{History||1.16|snap=20w16a|Enchanted golden apples can now be found inside [[ruined portal]] chests.}}
{{History||1.16.2|snap=20w30a|Enchanted golden apples can now be found inside [[bastion remnant]] chests.}}
{{History||1.18|snap=experimental snapshot 6|Horses, donkeys and mules now follow players holding enchanted golden apples.}}
{{History||1.19|snap=22w13a|Enchanted golden apples may now be found in [[ancient city]] [[chest]]s.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Enchanted Golden Apple JE1 BE1.gif|32px]] Added enchanted golden apples.}}
{{History|||snap=build 4|A crafting recipe has been added for enchanted golden apples.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Enchanted golden apples are now known as "Enchanted Apple."}}
{{History|bedrock}}
{{History||1.2.0|snap=?|Enchanted apples now give [[Absorption]] IV rather than Absorption I.}}
{{History||1.2.13|snap=?|Enchanted golden apples are now uncraftable, making them no longer [[renewable resource|renewable]].}}
{{History||?|Enchanted apples now give [[Regeneration]] V rather than IV.}}
{{History||1.10.0|snap=beta 1.10.0.3|Enchanted apples are no longer used to [[crafting|craft]] patterns on [[banner]]s directly, but are now used to craft Thing [[banner pattern]]s.
|[[File:Enchanted Golden Apple JE2 BE2.gif|32px]] The texture for the enchanted golden apple has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.57|Enchanted golden apples can now be found inside [[ruined portal]] chests.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of enchanted apples has been changed from <code>appleenchanted</code> to <code>enchanted_golden_apple</code>.}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Enchanted Golden Apple JE1 BE1.gif|32px]] Added enchanted golden apples.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Enchanted Golden Apple JE2 BE2.gif|32px]] The texture for the enchanted golden apple has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Enchanted Golden Apple JE1 BE1.gif|32px]] Added enchanted golden apples.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* The damage tag of an enchanted apple obtained {{in|be}} is 1, although setting it to 0 makes no difference.

== Gallery ==
<gallery>
GoldenAppleComparison.png|A comparison of the two golden apple variations.
EnchantedGoldenAppleEffects.png|The effects of consuming an enchanted golden apple.
Notch Apple In Mansion Chest.png|An extremely rare occasion where a regular golden apple and an enchanted apple being found in the same woodland mansion chest {{in|ee}}.
GoldenAppleDungeonChest.png|Golden apple in a [[dungeon]] chest, prior to 1.3.1. It resembles the enchanted golden apple.
GodPortal.png|An enchanted golden apple found in a ruined portal chest.
GodSpawner.png|An enchanted golden apple found in a monster room chest.
</gallery>

{{Items}}

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

[[de:Verzauberter goldener Apfel]]
[[es:Manzana dorada encantada]]
[[fr:pomme dorée enchantée]]
[[ja:エンチャントされた金のリンゴ]]
[[pt:Maçã dourada encantada]]
[[th:แอปเปิ้ลทองร่ายมนตร์]]
[[zh:附魔金苹果]]</li></ul>
beta 1.18.10.26allay and allay_spawn_egg IDs are added to the game and referenced in the Bedrock Beta Addons Documentation.
1.18.30
{{Extension DPL}}<ul><li>[[Minecart with Hopper|Minecart with Hopper]]<br/>{{ItemEntity
|image=Minecart with Hopper.png
|renewable=Yes
|stackable=No
|size=Height: 0.7 Blocks<br>Width: 0.98 Blocks
|networkid='''[[JE]]''': 10
|drops=1 {{ItemLink|Minecart with Hopper}}<br>plus contents
|health={{hp|6}}
}}
A '''minecart with hopper''' is a [[minecart]] with a [[hopper]] inside. Unlike a normal hopper, it pulls items from containers much more quickly, cannot push items into containers, can collect [[Item (entity)|item entities]] through a single layer of [[solid block]]s and is locked and unlocked via [[Activator Rail|activator rails]].

== Obtaining ==

=== Crafting ===

{{Crafting
|Output= Minecart with Hopper
|type= Transportation
|Hopper|Minecart}}

Minecarts with hoppers can be retrieved by attacking them. By doing so it drop as an [[item (entity)|item]] and any other contents of the hopper are dropped as well.

== Usage ==
[[File:Minecart with Hopper GUI.png|thumb|176px|The GUI of a minecart with hopper.]]
Minecarts with hoppers are placed similarly to other [[minecart]]s.

A minecart with hopper pulls in items lying nearby (within a range slightly larger than the cart itself), or inside a container directly above the minecart, at a rate of 1 item every [[game tick]] (20 items per second), eight times as fast as a normal hopper. It also picks up items that are lying on a block directly above the track. It does not push items into containers, but a hopper underneath the track can remove items from a minecart with hopper on the track. Ordinary hoppers can also drop items into a minecart with hopper like other containers, at the normal speed of 2.5 items per second. In Bedrock Edition, a minecart with hopper on curved rail pulls in items in a hopper lying in front of its moving direction and 1 block above if hopper's output funnel is pointed downward and no block is below that hopper.<ref>{{bug|MCPE-94293}}</ref>

The hopper can be disabled by passing over a powered [[activator rail]], and can be reenabled by an inactive activator rail.

An empty minecart with hopper can travel more than 85 blocks without stopping (as opposed to a normal cart going less than 12 blocks) from a dead stop using a 2 powered track starter even with another cart in front of them. However, the distance traveled by a minecart with hopper depends on the hopper's load. Using a 1 powered rail starter track, a minecart with an empty hopper travels 64 blocks until it stops (as opposed to an empty normal minecart going 8 blocks). The distance traveled diminishes non-linearly with increased hopper load; a minecart with a full hopper can travel only 16 blocks in this setup.

{{See also|Tutorials/Storage minecarts}}

== Sounds ==
{{Edition|Java}}:<br>
Minecarts with hoppers use the Friendly Creatures sound category for entity-dependent sound events.<ref group=sound name=rollsource>{{bug|MC-42132}}</ref>
{{Sound table
|sound=Minecart rolling.ogg
|subtitle=Minecart rolls
|source=Friendly Creatures <ref group=sound name=rollsource/>
|overridesource=1
|description=While a minecart with hopper is moving
|id=entity.minecart.riding
|translationkey=subtitles.entity.minecart.riding
|volume=0.0-0.35 <ref group=sound>Relates linearly with horizontal velocity (max 0.5)</ref>
|pitch=0.0-1.0 <ref group=sound>Will increase by 0.0025 per tick if the minecart's horizontal velocity is more than 0.01</ref>
|distance=16
|foot=1}}

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Minecart with Hopper
|spritetype=item
|nameid=hopper_minecart
|id=526
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Minecart with Hopper
|spritetype=entity
|nameid=hopper_minecart
|id=96
|foot=1}}

=== Entity data ===
Minecarts with hoppers 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 ==

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

== History ==

{{History|java}}
{{History||1.5|snap=13w03a|[[File:Minecart with Hopper JE1 BE1.png|32px]] [[File:Minecart with Hopper (item) JE1 BE1.png|32px]] Added minecart with hopper.}}
{{History||1.9|snap=15w43a|Loot tables are added; minecarts with hopper now can use loot tables.}}
{{History||1.9.1|snap=pre2|The title of the [[inventory]] is changed from 'Hopper minecart' to 'Minecart with Hopper'.}}
{{History||1.11|snap=16w32a|The entity ID of the minecart with hopper has now been changed from <code>MinecartHopper</code> to <code>hopper_minecart</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 408.}}
{{History||1.14|snap=18w43a|[[File:Minecart with Hopper JE2 BE2.png|32px]] [[File:Minecart with Hopper (item) JE2 BE2.png|32px]] The textures of the minecart with hopper have now been changed.}}
{{History||1.15|snap=19w38a|[[File:Minecart with Hopper 19w38a.png|32px]] The hopper now appears dark, same as suffocating mobs.}}
{{History|||snap=19w39a|The hopper now renders correctly.}}
{{History||1.16.2|snap=Pre-release 1|Opening or destroying a minecart with hopper now angers nearby [[piglin]]s.}}
{{History||1.19|snap=22w13a|The crafting recipe for a minecart with hopper is now shapeless.|Breaking a minecart with hopper will now drop the item instead of the minecart and hopper separately, though the contents of the hopper are still dropped.<ref>{{bug|MC-249493|||Fixed}}</ref>}}
{{History||1.19.4|snap=23w06a|Minecart with hopper now no longer aggravates [[piglin]]s when opened.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Minecart with Hopper JE1 BE1.png|32px]] [[File:Minecart with Hopper (item) JE1 BE1.png|32px]] Added minecart with hopper.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|The entity ID of the minecart with hopper has now been changed from <code>minecarthopper</code> to <code>hopper_minecart</code>.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Minecart with Hopper JE2 BE2.png|32px]] [[File:Minecart with Hopper (item) JE2 BE2.png|32px]] The textures of the minecart with hopper have now been changed.}}
{{History||1.19.0|snap=beta 1.19.0.30|Breaking a minecart with hopper will now drop the item instead of the minecart and hopper separately, though the contents of the hopper are still dropped.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Minecart with Hopper JE1 BE1.png|32px]] [[File:Minecart with Hopper (item) JE1 BE1.png|32px]] Added minecart with hopper.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Minecart with Hopper JE2 BE2.png|32px]] [[File:Minecart with Hopper (item) JE2 BE2.png|32px]] The textures of the minecart with hopper have now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Minecart with Hopper JE1 BE1.png|32px]]  [[File:Minecart with Hopper (item) JE1 BE1.png|32px]] Added minecart with hopper.
|Minecarts with hopper emit smoke [[particles]] when destroyed.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==

<gallery>
File:First hopper Minecart Image.png|The first image of hopper carts released by Dinnerbone.<ref>{{Tweet|Dinnerbone|291215700213772289|Well you guys got that quick. The letters in the hotbar were for <nowiki>[imgur link]|January 15, 2013}}</ref>
File:13w03a Banner.png|The 13w03a banner showing a minecart with hopper and a [[dropper]].
</gallery>

== References ==

{{reflist}}


{{items}}
{{entities}}

[[Category:Mechanics]]
[[Category:Storage]]

[[cs:Vozík s násypkou]]
[[de:Trichterlore]]
[[es:Vagoneta con tolva]]
[[fr:Wagonnet à entonnoir]]
[[hu:Tölcsér csille]]
[[it:Carrello da miniera]]
[[ja:ホッパー付きのトロッコ]]
[[ko:호퍼가 실린 광산 수레]]
[[nl:Mijnkar met trechter]]
[[pl:Wagonik z lejem]]
[[pt:Carrinho de mina com funil]]
[[ru:Вагонетка с воронкой]]
[[uk:Вагонетка з лійкою]]
[[zh:漏斗矿车]]</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 ===
[[Piglin]]s are attracted to golden swords, run toward any golden swords on the ground and inspect it for 6 to 8 seconds before putting it in their [[inventory]] slot.

== 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></nowiki>
beta 1.18.30.20Added feature_cage_with_allays and updated 2x2_a1 structure components to pillager outposts and woodland mansions respectively. They do not yet generate.
Wild Update (experimental)beta 1.18.30.22AllayAdded allays. Currently, allays make no idle sounds.
When they are hit, they make the same sound as the player.
beta 1.18.30.28Allays are now immune to damage from their owner.
Allays no longer pick up item variants, although they do pick up identical items with different NBT data.
1.19.0
{{Extension DPL}}<ul><li>[[Drinks|Drinks]]<br/>[[File:Drinking Steve.png|150px|right]] [[File:Drinking Alex.png|150px|right]]

'''Drinks''' are a narrow class of consumable [[item]]s that can be ingested by the player in an extremely similar manner to [[food]]. However, drinks are not encountered quite as commonly as food is, and they are not nearly as integral to survival gameplay. Drinks can generally be distinguished from food from the sounds they make upon consumption, the lack of particles emitted by them, and the fact that they leave behind an empty container after consumption. They also do not require the hunger bar to be depleted, and do not affect hunger or saturation values upon use (with the exception of [[honey bottle]]s).

Drinks are drunk by holding {{control|use item}} while having the drink [[item]] selected in the hotbar or in the off hand.

== Drinks ==

{{/table}}

== History ==
{{main|Milk#History|Potion#History|Honey Bottle#History}}
{{History|java alpha}}
{{History||v1.0.11|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Added water bottles and potions.}}
{{History||1.15|snap=19w34a|[[File:Honey Bottle JE1.png|32px]] Added honey bottles.}}

{{History|pocket alpha}}
{{History||v0.7.0|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk buckets.}} 
{{History||v0.12.1|snap=build 1|Added water bottles and potions.}}
{{History|bedrock}}
{{History||1.14.0|snap=beta 1.14.0.1|[[File:Honey Bottle BE1.png|32px]] Added honey bottles.}} 
{{History|foot}}
{{Items}}

[[ja:飲み物]]
[[pt:Bebidas]]
[[Category:Food]]</li><li>[[Sugar|Sugar]]<br/>{{Item
| image = Sugar.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Sugar''' is a [[food]] ingredient and [[brewing]] ingredient made from [[sugar canes]].

== Obtaining ==

=== Mob loot ===

[[Witch]]es have a chance of dropping 0–2 sugar upon death. This is increased by 1 per level of [[Looting]], for a maximum of 0–5 sugar.

=== Crafting ===
{{Crafting
 |head= 1
 |Sugar Cane
 |Output= Sugar
 |type= Material

}}
{{Crafting
 |Honey Bottle
 |Output= Sugar, 3
 |type= Material
 |foot= 1
}}

=== Compound creation ===

Sugar can be created from its base [[element]]s, using the [[compound creator]].{{only|bedrock|education}}

{| class="wikitable"
!Name
!Elements
!Example recipe
|- <!-- Temporarily using crafting grid as a substitute for the compound creator (template not yet available), since the layout is the same, even if the appearance is different -->
!Sugar
|6 Carbon<br>12 Hydrogen<br>6 Oxygen
|{{Crafting Table
|shapeless= 1
|A2=Carbon,6 |B2=Hydrogen,12 |C2=Oxygen,6
|Output=Sugar}}
|}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Brewing ingredient ===

{{Brewing
  |head=1
  |Sugar
  |Mundane Potion
  |base=Water Bottle
}}
{{brewing
  |foot=1
  |showname=1
  |Sugar
  |Potion of Swiftness
}}

=== Horses ===

Sugar can be fed to [[horse]]s to heal {{hp|1}}, speed growth by 30 seconds, and increase taming probability by 3%.

== Achievements ==
{{load achievements|The Lie}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|notshowbeitemforms=y
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Sugar
|spritetype=item
|nameid=sugar
|id=416
|form=item
|foot=1}}

== Video ==

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

== History ==

{{History|java beta}}
{{History||1.2|[[File:Sugar JE1 BE1.png|32px]] Sugar has been introduced as an ingredient for [[cake]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Sugar is now used to craft [[fermented spider eye]]s.}}
{{History|||snap=Beta 1.9 Prerelease 3|Sugar can now be [[brewing|brewed]] in a [[water bottle]] to create a [[Mundane Potion]], or in an [[Awkward Potion]] to create a [[Potion of Swiftness]].}}
{{History||1.4.2|snap=12w37a|Sugar is now used to make [[pumpkin pie]].}}
{{History|||snap=12w38b|[[Witch]]es can now [[drops|drop]] sugar.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 353.}}
{{History||1.14|snap=18w43a|[[File:Sugar JE2 BE2.png|32px]] The texture of sugar has been changed.}}
{{History||1.15|snap=19w34a|Sugar can now can be created using 1 [[honey bottle]].}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Sugar JE1 BE1.png|32px]] Added sugar. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.0|Sugar is now [[craft]]able using [[sugar cane]].}}
{{History||v0.7.0|Sugar is now used to craft [[cake]].}}
{{History||v0.8.0|snap=build 1|Sugar is now used to craft [[pumpkin pie]].}}
{{History||v0.12.1|snap=build 1|Sugar has been added to the [[creative]] [[inventory]].|Sugar is now used to craft [[fermented spider eye]]s.
|Sugar can now be used for [[brewing]], to get mundane [[potion]]s and potions of [[Swiftness]].}}
{{History||v0.14.0|snap=build 1|Added [[witch]]es, which can [[drops|drop]] sugar upon [[death]].}}
{{History||v0.15.0|snap=build 1|Sugar can now be used to feed [[horse]]s, which can increase their temper, heal them, and speed up the growth of foals.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|Sugar can now be created using 6 Carbon, 12 Hydrogen, and 6 Oxygen in the [[compound creator]].}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Sugar JE2 BE2.png|32px]] The texture of sugar has been changed.}}
{{History||1.14.0|snap=beta 1.14.0.1|Sugar can now be created using 1 [[honey bottle]].}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Sugar JE1 BE1.png|32px]] Added sugar.
|Sugar is used to craft [[cake]].}}
{{History||xbox=TU7|Sugar is now used to craft [[fermented spider eye]]s.|Sugar can now be [[brewing|brewed]] in a [[water bottle]] to create a [[Mundane Potion]], or in an [[Awkward Potion]] to create a [[Potion of Swiftness]].}}
{{History||xbox=TU14|ps=1.04|Sugar is now used to make [[pumpkin pie]].}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[Witch]]es can now [[drops|drop]] sugar.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Sugar JE2 BE2.png|32px]] The texture of sugar has been changed.}}

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

== Issues ==
{{issue list}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--sugar Taking Inventory: Sugar] – Minecraft.net on January 27, 2022

{{Items}}

[[cs:Cukr]]
[[de:Zucker]]
[[es:Azúcar]]
[[fr:Sucre]]
[[hu:Cukor]]
[[it:Zucchero]]
[[ja:砂糖]]
[[ko:설탕]]
[[nl:Suiker]]
[[pl:Cukier]]
[[pt:Açúcar]]
[[ru:Сахар]]
[[th:น้ำตาล]]
[[uk:Цукор]]
[[zh:糖]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li></ul>
beta 1.19.0.20Allays are now available without enabling experimental gameplay.
Allays can now be leashed with a lead and nametagged with a name tag while holding an item.
beta 1.19.0.24Increased the health of allays from 16♥ × 8 to 20♥ × 10.
Allays now have natural regeneration, going at a rate of 2 HP per second.
Upcoming Bedrock Edition
1.19.10
{{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>[[Shovel|Shovel]]<br/>{{Item
| image = <gallery>
Wooden Shovel.png | Wooden
Stone Shovel.png | Stone
Iron Shovel.png | Iron
Golden Shovel.png | Golden
Diamond Shovel.png | Diamond
Netherite Shovel.png | Netherite
</gallery>
| rarity = Common
| renewable = '''Netherite''': No<br>'''All others''': Yes
| durability = 
* Wood: 59
* Stone: 131
* Iron: 250
* Golden: 32
* Diamond: 1561
* Netherite: 2031
| stackable = No
}}

'''Shovels''' are [[tool]]s used to hasten the process of breaking [[dirt]], [[sand]], [[gravel]] and other soil blocks, as well as to convert [[Dirt (disambiguation)|dirt]] blocks into [[Dirt Path|dirt paths]].

== Obtaining ==

=== Crafting ===
{{Crafting
  |head=1
  |showname=0
  |showdescription=1
  |name=[[Shovel]]s
  |B1= {Any Planks}; Iron Ingot; Gold Ingot; Diamond
  |B2= Stick
  |B3= Stick
|Output= Wooden Shovel; Iron Shovel; Golden Shovel; Diamond Shovel
|type= Tool
}}
{{Crafting
  |name=[[Stone Shovel]]
  |B1=Any stone-tier block
  |B2=Stick
  |B3=Stick
  |Output=Stone Shovel
  |description=Can use any variant of cobblestone
  |type=Tool
}}
{{Crafting
  |foot=1
  |ignoreusage=1
  |name=[[Shovel]]
  |ingredients=Damaged Matching [[Shovel]]
  |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel
  |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel
  |Output=Wooden Shovel; Stone Shovel; Iron Shovel; Golden Shovel; Diamond Shovel; Netherite Shovel
  |description= The durability of the two shovels is added together, plus an extra 5% durability.
  |type= Tool
}}

=== Upgrading ===
Like other diamond tools, a diamond shovel can be upgraded to a netherite shovel, although increased durability and resistance to fire/lava in item form are the only benefits. The shovel's performance as a digging tool or a weapon is unchanged by the upgrade.

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

=== Repairing ===
==== Grinding ====
{{Grinding
|showdescription=1
|ingredients=2x Damaged [[Wooden Shovel]] or<br>2x Damaged [[Stone Shovel]] or<br>2x Damaged [[Iron Shovel]] or<br>2x Damaged [[Golden Shovel]] or<br>2x Damaged [[Diamond Shovel]] or<br>2x Damaged [[Netherite Shovel]]
|Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel
|Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel
|Wooden Shovel; Stone Shovel; Iron Shovel; Golden Shovel; Diamond Shovel; Netherite Shovel
|description=The durability of the two shovels is added together, plus an extra 5% durability.
}}

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

=== Chest loot ===
On <code>ancient_city/city_center/city_center_2</code>, they generate a furnace with a wooden shovel inside of it.
{{LootChestItem|iron-shovel,level-enchanted-iron-shovel,random-enchanted-golden-shovel,diamond-shovel,level-enchanted-diamond-shovel,damaged-random-enchanted-diamond-shovel,damaged-random-enchanted-diamond-shovel-2}}

=== Mob loot ===

==== Equipment ====
{{Main|Drops#Equipped items}}

[[Zombie]]s and [[husk]]s have a 0.67% (3.33% in Hard [[difficulty]]) chance of spawning with an iron shovel. They have an 8.5% (9.5% with [[Looting]] I, 10.5% with Looting II and 11.5% with Looting III) chance of dropping that shovel if they are killed by the player. The dropped shovel is usually badly damaged, and may be enchanted: 0%–25% on Normal difficulty and 3.125%–25% on Hard difficulty, varying with [[regional difficulty]], and enchanted as if on an enchanting table at level 5–22.

==== Raids ====

Vindicators and pillagers that spawn from raids have a 4.1% chance(5.12% on hard) to drop a badly-damaged iron shovel that is sometimes enchanted with a random enchantment.{{only|bedrock}}

=== Trading ===

Novice-level toolsmith villagers have a 25% chance to sell stone shovels for one emerald, journeyman-level toolsmith villagers have a 25% chance to sell enchanted iron shovels for 2 emeralds, and expert-level toolsmith villagers have a 50% chance to sell enchanted diamond shovels for 5 emeralds as part of their trades.{{only|bedrock}}

Novice-level toolsmith villagers have a 40% chance to sell stone shovels for one emerald, journeyman-level tool smiths have a 40% chance to sell an enchanted iron shovel for 7-22 emeralds, and expert-level tool smiths have a {{frac|2|3}} chance to sell an enchanted diamond shovel for 11-27 emeralds.{{only|java}}

The enchantments are the same as the ones obtained from an [[enchanting table]] at levels 5–19.

=== Villager gifts ===

{{in|java}}, toolsmith [[villager]]s occasionally throw stone shovels at players with the [[Hero of the Village]] effect.

== Usage ==

=== Digging ===

A shovel can be used to break some materials faster. When breaking a block, it uses 1 durability. For blocks that break instantly, it uses 0 durability.

==== Durability ====

Each different tier of shovel has a different durability:

{| class="wikitable sortable"
! Material
! [[Durability]]
|-
| {{itemLink|Wooden Shovel|Wood|link=Shovel}}
| 59
|-
| {{itemLink|Stone Shovel|Stone|link=Shovel}}
| 131
|-
| {{itemLink|Iron Shovel|Iron|link=Shovel}}
| 250
|-
| {{itemLink|Diamond Shovel|Diamond|link=Shovel}}
| 1561
|-
| {{itemLink|Golden Shovel|Golden|link=Shovel}}
| 32
|-
| {{itemLink|Netherite Shovel|Netherite|link=Shovel}}
| 2031
|}

==== Speed ====

The following table summarizes the speed at which different quality shovels perform on different block types. Values with a red background indicate that no resource is dropped when the block is destroyed without a shovel. 
{{breaking row|Clay|simple=1}}
{{breaking row|Coarse Dirt}}
{{Breaking row|Concrete Powder}}
{{breaking row|Dirt}}
{{breaking row|Dirt Path}}
{{breaking row|Farmland}}
{{breaking row|Grass Block}}
{{breaking row|Gravel}}
{{breaking row|Mud}}
{{breaking row|Muddy Mangrove Roots}}
{{breaking row|Mycelium}}
{{breaking row|Podzol}}
{{breaking row|Red Sand}}
{{breaking row|Rooted Dirt}}
{{breaking row|Sand}}
{{breaking row|Snow|Wooden}}
{{breaking row|Snow Block|Wooden}}
{{breaking row|Soul Sand}}
{{breaking row|Soul Soil}}
{{breaking row|Suspicious Gravel}}
{{breaking row|Suspicious Sand|foot=1}}

=== Dirt paths ===

A shovel can be used to create a [[dirt path]] by {{control|using}} (not digging) the shovel on any one of the following blocks, losing one durability point:
* {{BlockLink|Grass Block}}
* {{BlockLink|Dirt}}
* {{BlockLink|Coarse Dirt}}
* {{BlockLink|Rooted Dirt}}
* {{BlockLink|Podzol}}
* {{BlockLink|Mycelium}}

=== Campfire ===

A shovel can be used to extinguish a [[campfire]].

===Weapon===

Hitting a mob while holding a shovel is a stronger attack than barehanded. Shovels take 2 damage when used as a weapon.

====Java Edition====

[[Category:Java Edition specific information]]
Shovels have an attack speed modifier of -3, meaning they take 1 second to [[Damage#Attack cooldown|recover]]. Shovels deal different damage based on the type:

{| class="wikitable" style="text-align:center" data-description="Attack damage"
!Shovel type
! Attack damage
! Attack speed
!Damage per<br>second (DPS)
|-
|{{ItemLink|Wooden Shovel}}<br>{{ItemLink|Golden Shovel}}||{{hp|2.5}}|| rowspan="5" |1||2.5
|-
|{{ItemLink|Stone Shovel}}||{{hp|3.5}}||3.5
|-
|{{ItemLink|Iron Shovel}}||{{hp|4.5}}||4.5
|-
|{{ItemLink|Diamond Shovel}}||{{hp|5.5}}||5.5
|-
|{{ItemLink|Netherite Shovel}}||{{hp|6.5}}||6.5
|}

====Bedrock Edition====

{{IN|bedrock}}, shovels always attack instantly and do the following damage:

{| class="wikitable" style="text-align:center" data-description="Attack damage"
! colspan="5" |Attack damage
|-
|{{ItemSprite|Wooden Shovel}}{{ItemSprite|Golden Shovel}} {{hp|2}}
|{{ItemSprite|Stone Shovel}} {{hp|3}}
|{{ItemSprite|Iron Shovel}} {{hp|4}}
|{{ItemSprite|Diamond Shovel}} {{hp|5}}
|{{ItemSprite|Netherite Shovel}} {{hp|6}}
|}

===Enchantments===

A shovel can receive, or be found in an [[End City]] with the following [[enchantment]]s:

{| class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Fortune]]<ref group="note" name="exc">Silk Touch and Fortune are mutually exclusive</ref>
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Silk Touch]]<ref group="note" name="exc" />
|I
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Efficiency]]
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|}

{{notelist}}

=== Fuel===

Wooden shovels can be used as a fuel in [[furnace]]s, smelting 1 item per shovel.

===Smelting ingredient===

{{Smelting|showname=1|Iron Shovel;Golden Shovel|Iron Nugget;Gold Nugget|0,1}}
===Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to golden shovels and run toward any golden shovels on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Shovel flatten1.ogg
|sound2=Shovel flatten2.ogg
|sound3=Shovel flatten3.ogg
|sound4=Shovel flatten4.ogg
|subtitle=Shovel flattens
|source=block
|description=When a shovel creates a [[dirt path]]
|id=item.shovel.flatten
|translationkey=subtitles.item.shovel.flatten
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a shovel'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=Grass hit1.ogg
|sound2=Grass hit2.ogg
|sound3=Grass hit3.ogg
|sound4=Grass hit4.ogg
|sound5=Grass hit5.ogg
|sound6=Grass hit6.ogg
|source=block
|description=When a shovel creates a dirt path <ref group=sound>{{Bug|MCPE-114390}}</ref>
|id=use.grass
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a shovel'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 Shovel
|spritetype=item
|nameid=wooden_shovel
|form=item}}
{{ID table
|displayname=Stone Shovel
|spritetype=item
|nameid=stone_shovel
|form=item}}
{{ID table
|displayname=Iron Shovel
|spritetype=item
|nameid=iron_shovel
|form=item}}
{{ID table
|displayname=Diamond Shovel
|spritetype=item
|nameid=diamond_shovel
|form=item}}
{{ID table
|displayname=Golden Shovel
|spritetype=item
|nameid=golden_shovel
|form=item}}
{{ID table
|displayname=Netherite Shovel
|spritetype=item
|nameid=netherite_shovel
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wooden Shovel
|spritetype=item
|nameid=wooden_shovel
|id=309
|form=item}}
{{ID table
|displayname=Stone Shovel
|spritetype=item
|nameid=stone_shovel
|id=313
|form=item}}
{{ID table
|displayname=Iron Shovel
|spritetype=item
|nameid=iron_shovel
|id=296
|form=item}}
{{ID table
|displayname=Diamond Shovel
|spritetype=item
|nameid=diamond_shovel
|id=317
|form=item}}
{{ID table
|displayname=Golden Shovel
|spritetype=item
|nameid=golden_shovel
|id=323
|form=item}}
{{ID table
|displayname=Netherite Shovel
|spritetype=item
|nameid=netherite_shovel
|id=605
|form=item
|foot=1}}

==Achievements==

{{load achievements|MOAR Tools ;Oooh, shiny!}}

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

== Video==

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

==History==
{{Missing information|there are so many missing blocks that need shovel to break}}
{{History|java indev}}
{{History||0.31|snap=20091231-2|[[File:Iron Shovel JE1.png|32px]] Added iron shovels which are located in the player's [[inventory]].
|Shovels cannot be crafted yet and are not functional in this version.}}
{{History|||snap=20100110|Shovels are now functional and can now be used to gather [[material]]s like [[dirt]], [[sand]] and [[gravel]] 400% faster than by hand.}}
{{History|||snap=20100124|A complete [[tool]] set is no longer given to the [[player]] on starting a new world. Instead, there are multiple [[chest]]s in the later called "[[Indev House]]" containing a stack of most accessible [[blocks]]/[[items]] including [[tools]].}}
{{History|||snap=20100128|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] [[Tools]] now have tiers. Shovels made from wood, stone, and diamond have been added.
|[[File:Iron Shovel JE2 BE1.png|32px]] The texture of iron shovels has been changed.
|A shovel held by the player is now rendered to appear more 3D.|They cannot be crafted yet, but have been added to the item chest in the Indev house.}}
{{History|||snap=20100129|Wood, stone, iron, and diamond shovels can now be [[craft]]ed.}}
{{History|||snap=20100130|[[File:Golden Shovel JE1.png|32px]] Shovels can now be made out of gold.}}
{{History|||snap=20100201-1|[[Tools]], including shovels, now take [[damage]] when being used.
|Better tools, including shovels, now last longer.}}
{{History||20100206|[[File:Golden Shovel JE2 BE1.png|32px]] The texture of golden shovels has been changed.}}
{{History|java alpha}}
{{History||1.0.5_01|Shovels are now used to get snowballs out of snow layers.}}
{{History|java beta}}
{{History||April 9, 2011|link=https://www.youtube.com/watch?v=qy882ILYJMM&t=154s|[[File:Iron Shovel (pre-release).png|32px]] Alternate iron shovel texture was shown in [[Mojang]] test video.}}
{{History|java}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden shovels.}}
{{History||1.3.1|snap=12w18a|Wooden shovels can now be used as [[fuel]] in a [[furnace]].}}
{{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] diamond shovels for 7 [[emerald]]s, and iron shovels for 4–5 emeralds.}}
{{History||1.6.1|snap=13w21a|Instead of replacing the barehanded [[damage]] ({{hp|1}}), shovels now add their damage onto the barehanded damage, which results in all shovels doing {{hp|1}} more damage than before.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden shovels.}}
{{History||1.8|snap=14w02a|Tool smith villagers now [[trading|sell]] enchanted iron shovels for 5–7 emeralds. The previous trades are now unavailable, making diamond shovels [[non-renewable resource|non-renewable]].}}
{{History||1.9|snap=15w31a|A shovel can now be used on a [[grass block]] to create [[grass path]] blocks.
|[[Enchanting|Enchanted]] iron or diamond shovels can now be found in [[end city]] chests.}}
{{History|||snap=15w34a|Shovels now use the "attack strength" combat mechanic meter. The time it takes for the meter to fill up for a shovel is 0.8 seconds.}}
{{History|||snap=15w34c|Shovels now do more [[damage]] and take longer to recover.}}
{{History|||snap=15w35a|The damage of shovels has been reduced.}}
{{History|||snap=15w41a|Wooden shovels are now used to craft [[boat]]s.}}
{{History|||snap=15w50a|The [[sound]] <code>item.shovel.flatten</code> has been added to shovels.}}
{{History|||snap=16w04a|Wooden shovels are no longer used to [[crafting|craft]] boats.}}
{{History||1.11.1|snap=16w50a|Golden and iron shovels now [[smelting|smelt]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 269, 273, 256, 277 and 284.}}
{{History||1.14|snap=18w43a|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}}
{{History|||snap=18w50a|Iron shovels can now be found in chests in [[village]] toolsmith houses.}}
{{History|||snap=19w11a|Toolsmith [[villager]]s now [[trading|sell]] stone shovels and enchanted diamond shovels, making diamond shovels [[renewable resource|renewable]] again.}}
{{History|||snap=19w13a|Toolsmith villagers now give stone shovels to players under the [[Hero of the Village]] effect.}}
{{History||1.15|snap=19w37a|Shovels can now be used to extinguish [[campfire]]s.}}
{{History||1.16|snap=20w06a|[[File:Netherite Shovel JE1.png|32px]] Added netherite shovels.
|Netherite shovels are obtained by combining one diamond shovel and one netherite ingot in a crafting table.
|[[Crimson planks]] and [[warped planks]] can now be used to craft wooden shovels.}}
{{History|||snap=20w09a|[[File:Diamond Shovel JE3 BE3.png|32px]] The texture of diamond shovels has been changed.
|Shovels can now break soul soil quickly.}}
{{History|||snap=20w10a|[[File:Netherite Shovel JE2 BE1.png|32px]] The texture of netherite shovels has been changed.
|Netherite shovels can no longer be crafted.
|Netherite shovels are now obtained by combining one diamond shovel and one netherite ingot in a smithing table.}}
{{History|||snap=20w15a|Stone shovels can now be crafted using [[blackstone]].}}
{{History|||snap=20w16a|Netherite shovels now generate randomly enchanted in [[bastion remnants]] chests.
|Golden shovels now generate randomly enchanted in [[ruined portal]] chests.}}
{{History|||snap=20w17a|Diamonds shovels now generate in place of netherite shovels in bastion remnant chests.}}
{{History||1.16.2|snap=20w30a|Increases the chance of finding randomly enchanted diamond shovels in bastion remnant chests.
|Unenchanted, undamaged diamond shovels can also be found in bastion remnant chests.}}
{{History||1.17|snap=21w08a|Stone shovels can now be crafted using [[cobbled deepslate]].}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden shovels.}}
{{History|||snap=22w13a|Wooden shovels may now be found in [[ancient city]] [[furnace]]s.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond shovels to netherite shovels now requires the netherite upgrade [[smithing template]].}}
{{History||1.20|snap=23w14a|Shovel now breaks [[suspicious sand]] and [[suspicious gravel]] quickly.}}
{{History|upcoming java}}
{{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed for all shovels has been increased to 2.|The [[damage]] for all shovels has been decreased by {{hp|1}}.}}


{{History|pocket alpha}}
{{History||v0.2.0|[[File:Stone Shovel JE1 BE1.png|32px]] Added stone shovels.}}
{{History||v0.3.0|[[File:Wooden Shovel JE1 BE1.png|32px]] Added wooden shovels.
|Survival players no longer start out with an infinite durability stone shovel in the inventory.}}
{{History||v0.3.2|[[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added iron, gold, and diamond shovels.}}
{{History||v0.4.0|Removed stone shovels from the creative inventory.}}
{{History||v0.11.0|snap=build 1|Wooden shovels are now used to craft [[boat]]s.
|Iron shovels are now available in the [[creative]] [[inventory]].
|A shovel can now be used on a [[grass block]] to create [[grass path]] blocks.}}
{{History|||snap=build 11|Wooden, stone, golden, and diamond shovels are now available in the [[creative]] inventory.}}
{{History|||snap=build 12|All shovels have been removed from creative.}}
{{History|||snap=build 13|Shovel have been re-added to creative mode.}}
{{History||v0.12.1|snap=build 1|Shovels can now be [[enchanting|enchanted]].
|[[Zombie]]s now have a small chance to spawn holding an iron shovel.}}
{{History||v0.15.0|snap=build 1|Added [[husk]]s, which have a small chance to spawn holding an iron shovel.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron and diamond shovels can now be found inside [[end city]] chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Enchanted iron shovels are now [[trading|sold]] by toolsmith [[villager]]s for 4-5 [[emerald]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden shovels are now [[smelting|smeltable]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron shovels can now be found in [[village]] toolsmith houses.}}
{{History|||snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn in [[raid]]s can now drop iron shovels upon [[death]].
|[[Trading]] has been changed, toolsmith [[villager]]s now have a 25% chance to [[trading|sell]] enchanted iron shovels for 2 [[emerald]]s as part of their third tier trades.
|Stone shovels and [[enchanting|enchanted]] diamond shovels can now be [[trading|bought]] from toolsmith villagers.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Shovel JE2 BE1.png|32px]] Added netherite shovels.|Netherite shovels are obtained by combining one diamond shovel and one netherite ingot in a crafting table.
|[[File:Diamond Shovel JE3 BE3.png|32px]] The texture of diamond shovels has been changed.}}
{{History|||snap=beta 1.16.0.57|Netherite shovels can no longer be crafted.
|Netherite shovels are now obtained by combining one diamond shovel and one netherite ingot in a smithing table.
|Stone shovels can now be crafted using [[blackstone]].
|Netherite shovels now generate randomly enchanted in [[bastion remnants]] chests.
|Golden shovels now generate randomly enchanted in [[ruined portal]] chests.}}
{{History|||snap=beta 1.16.0.63|Diamonds shovels now generate in place of netherite shovels in bastion remnant chests.}}
{{History||1.20.10|snap=beta 1.20.10.20|The [[wooden shovel]] in the crafting recipe has been removed for all boat types except the bamboo raft.}}
{{History|||snap=beta 1.20.10.21|The bamboo raft recipe no longer needs a wooden shovel.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added shovels (all five types).}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden shovels are now [[smelting|smeltable]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added shovels.}}
{{History|foot}}

==Issues==
{{issue list}}

==Gallery==
<gallery>
Shovel JINX.jpg|Official shovel T-shirt made by JINX.
Stone Shovel SDGP.png|Stone shovel in the [[Super Duper Graphics Pack]].
Adventure Shovel.png|An "adventure shovel" that can break blocks in [[adventure mode]].
</gallery>

===Enchanted shovels===
<gallery>
Enchanted_Wooden_Shovel.gif
Enchanted_Stone_Shovel.gif
Enchanted_Iron_Shovel.gif
Enchanted_Golden_Shovel.gif
Enchanted_Diamond_Shovel.gif
Enchanted_Netherite_Shovel.gif
</gallery>

==References==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-shovel Taking Inventory: Shovel] – Minecraft.net on November 16, 2018

{{items}}

[[Category:Combat]]

[[cs:Lopata]]
[[de:Schaufel]]
[[es:Pala]]
[[fr:Pelle]]
[[hu:Ásó]]
[[ja:シャベル]]
[[ko:삽]]
[[nl:Schep]]
[[pl:Łopata]]
[[pt:Pá]]
[[ru:Лопата]]
[[uk:Лопата]]
[[zh:锹]]</li></ul></nowiki>
beta 1.19.10.20Pickup range is changed from 64 to 32 blocks.
beta 1.19.10.22Added allay duplication, making it possible to duplicate an allay with an amethyst shard and a jukebox.

Issues

Issues relating to "Allay" are maintained on the bug tracker. Report issues there.

Trivia

  • The word "allay" means "to relieve or alleviate", contrasting the word "vex", which means "to anger or worry".
  • The allay was originally planned for the Nether Update.[3]
  • Some previous names considered for the allay were the wisp and the pixie.[3]
  • The reason why allay duplication uses amethyst shards is because the item is renewable, has a musical sound that fits with the allay, and it adds more value to amethyst geodes.[4][5]

Gallery

Animations

Screenshots

Concept artworks and prototypes

Video

See also

References

Advertisement