Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 
Crafting Table
This article describes content that may be included in a future update. 
This content has appeared in development versions, but the full update containing it has not been released yet.
Gear (item)
This article is a work in progress. 
Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.
This article is about the world type. For the Easter egg dimension in 20w14∞, see Java Edition 20w14∞ § World generation.
For the world type before Java Edition 1.13, see Old Customized.

Custom is a world type that allow users to change the generation of the Overworld, Nether, and End dimensions as well as the ability to create custom dimensions. It is edited using a JSON file that is imported on the world creation screen.

Access

Custom world generation works using JSON files, which need to be imported before world creation.

In the world creation menu, go to more options and select the "Import World" option. Then, select a world generation JSON file. A screen will pop up, warning users that custom worlds are experimental. Click "Yes" to continue.

The only way to access added dimensions is through commands, such as /execute in <dimension name> run tp @s ~ ~ ~, which will teleport the player to the specified dimension (see § JSON format).

JSON format

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: Needs expansion. Useful sources: [1], [2]

Custom generation files take the following format:

  • The root tag.
    •  bonus_chest (Boolean): Whether the world has a bonus chest or not (equivalent to the "Bonus chest" option).
    •  generate_features (Boolean): Whether structures should be generated or not (equivalent to the "Generate structures" option).
    •  seed (integer): The numerical seed of the world.
    •  legacy_custom_options (string): The custom world preset that was used to generate the world when it was an old customized world. Only exists for old customized worlds.
    •  dimensions: A list of the dimensions in this world where the key is the namespace ID of the dimension.
      • A dimension. The dimensions minecraft:overworld, minecraft:the_nether and minecraft:the_end are required for a well functioning world. Any other namespaced ID is allowed for custom dimensions.
        •  generator: Generation settings used for that dimension.
          •  type (string): The ID of the generator. minecraft: followed by flat, noise or debug.
          • Other compounds (see below)'
        •  type: This can be a list of options for the dimensions or the namespaced ID of one of the default dimensions as a string, the dimensions will the use the settings of the specified dimension. Note: if the same namespace ID of a default dimension is used in multiple dimensions, the game will crash upon generation.
          • Dimension/Data

Generator types

Dimension/Generator

Defaults

Noise generator preset defaults

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

Property minecraft:overworld minecraft:amplified minecraft:nether minecraft:caves minecraft:end minecraft:floating_islands
bedrock_roof_position -10 0 -10
bedrock_floor_position 0 0 -10
sea_level 63 32 0
disable_mob_generation false false true false
default_block minecraft:stone minecraft:netherrack minecraft:stone minecraft:end_stone minecraft:stone
default_fluid minecraft:water minecraft:lava minecraft:water minecraft:air minecraft:water
structures See below
noise top_slide target -10 120 -3000
size 3 3 64
offset 0 0 -46
bottom_slide target -30 320 -30
size 0 4 7
offset 0 -1 1
sampling xz_scale 0.9999999814507745 1 2
xz_factor 80 80 80
y_scale 0.9999999814507745 3 1
y_factor 160 60 160
size_vertical 2 2 1
size_horizontal 1 1 2
height 256 128 128
density_factor 1 0 0
density_offset -0.46875 0.019921875 0
random_density_offset true false false
simplex_surface_noise true false true
island_noise_override false false true false
amplified false true false false

Structure defaults

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

Structure Spacing Separation Salt
village 32 8 10387312
desert_pyramid 32 8 14357617
igloo 32 8 14357618
jungle_pyramid 32 8 14357619
swamp_hut 32 8 14357620
pillager_outpost 32 8 165745296
stronghold 1 0 0
monument 32 5 10387313
endcity 20 11 10387313
mansion 80 20 10387319
buried_treasure 1 0 0
mineshaft 1 0 0
ruined_portal nether and caves 25 10 34222645
All other presets 40 15 34222645
shipwreck 24 4 165745295
ocean_ruin 20 8 14357621
bastion_remnant 27 4 30084232
fortress 27 4 30084232
nether_fossil 2 1 14357921

Biome parameter defaults

These are the default values used for each biome in the multi_noise biome_source. Interestingly, although only the values for nether biomes are accessible through a preset, several overworld biomes have default values as well.

Biome Temperature Humidity Altitude Weirdness Offset
badlands -0.25 -0.5 0.5 0.2 1
badlands_plateau -0.25 -0.5 0.65 0.2 1
bamboo_jungle 0.5 0.5 0 0.2 1
bamboo_jungle_hills 0.5 0.5 0.25 0.2 1
basalt_deltas -0.5 0 0 0 0.175
beach 0 0 -0.1 0 0.9935
birch_forest -0.1 0.2 0 0 1
birch_forest_hills -0.1 0.2 0.25 0 1
crimson_forest 0.4 0 0 0 0
desert 0.5 -0.5 0 0 1
jungle 0.5 0.5 0 0 1
nether_wastes 0 0 0 0 0
ocean 0 0 -0.5 0 1
plains 0 0 0 0 1
snowy_tundra -0.5 -0.5 0 0 1
soul_sand_valley 0 -0.5 0 0 0
warm_ocean 0 0 -0.25 0 1
warped_forest 0 0.5 0 0 0.375

Type defaults

Dimension/Defaults

Examples

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: Add more examples. Also add the actual info for what the default generator uses.

Default settings

The following is the settings for an exported default Minecraft world.

Custom superflat dimension

Custom superflat dimension

An overview of a world made with the adjacent settings.

This dimension is a Superflat world with a layer of grass on four layers of coarse dirt on top of five layers of basalt. The entire world is full of village houses as spacing is set to 3 (default: 32) and separation is set to 1 (default: 8). The words starts by default at time 1000.

History

Upcoming Java Edition
1.16
{{Extension DPL}}<ul><li>[[Dye|Dye]]<br/>{{Item
| title = Dyes
| image = White Dye.png
| extratext = View [[#Gallery|all renders]]
| renewable = Yes
| stackable = Yes (64)
}}
'''Dyes''' are a set of sixteen items used to change the color of [[wool]], [[carpet]]s, [[terracotta]], [[concrete powder]], [[glass]], [[shulker box]]es, [[bed]]s, [[candle]]s, the patterns on [[banner]]s, [[firework star]]s, certain mobs, and text on [[sign]]s and [[hanging sign]]s. {{IN|bedrock}} they can also be used to dye water in a [[cauldron]] (which is thereafter used to dye leather [[armor]]); {{in|java}} leather armor can be dyed directly. {{IN|education}} dyes can also be used to dye [[balloon]]s and [[glow stick]]s.

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

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

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

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

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

=== Trading ===

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

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

=== Chest loot ===

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

=== Other ===

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

== Usage ==

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

=== Dyeing wool and mobs ===

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

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

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

=== Dyeing carpets ===

Carpets can be dyed.

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

=== Dyeing terracotta ===

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

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

=== Creating concrete powder ===

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

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

=== Staining glass ===

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

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

=== Dyeing shulker boxes ===

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

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

=== Dyeing beds ===

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

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

=== Dyeing candles ===

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

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

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

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

=== Dyeing armor ===

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

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

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

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

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

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

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

=== Dyeing firework stars ===

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

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

=== Creating balloons ===

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

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

=== Creating glow sticks ===

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

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

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

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

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

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

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

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

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

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

== Video ==

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

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

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

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

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

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

==Issues==
{{issue list}}

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

== References ==
{{reflist}}

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

{{Items}}

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

[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li><li>[[Hoe|Hoe]]<br/>{{Item
| image = <gallery>
Wooden Hoe.png | Wooden
Stone Hoe.png | Stone
Iron Hoe.png | Iron
Golden Hoe.png | Golden
Diamond Hoe.png | Diamond
Netherite Hoe.png | Netherite
</gallery>
|rarity = Common
|renewable = 
* '''Netherite''': No 
* '''All others''': Yes
| durability = 
* Wood: 59
* Stone: 131
* Iron: 250
* Golden: 32
* Diamond: 1561
* Netherite: 2031
| stackable = No
}}

A '''hoe''' is a [[tool]] used to harvest certain plant-based or organic blocks more quickly, as well as to till most types of [[Dirt (disambiguation)|dirt]] into [[farmland]] and convert [[Coarse Dirt|coarse dirt]] and [[Rooted Dirt|rooted dirt]] to regular [[dirt]].

== Obtaining ==

=== Crafting ===

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

=== Upgrading ===
Like other diamond tools, a diamond hoe can be upgraded to a netherite hoe, increasing its durability and slightly increasing its mining speed.

{{Smithing
|head=1
|Netherite Upgrade
|Diamond Hoe
|Netherite Ingot
|Netherite Hoe
|tail=1
}}

=== Repairing ===

==== Grinding ====

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

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

=== Chest loot ===
{{LootChestItem|wooden-hoe,diamond-hoe,golden-hoe,random-enchanted-golden-hoe,damaged-level-enchanted-diamond-hoe}}

=== Trading ===
Novice-level toolsmith [[villager]]s have a chance to sell a stone hoe for one [[emerald]], and journeyman-level toolsmiths have a chance to sell a diamond hoe for 4 emeralds. {{IN|bedrock}}, these are 25% chances, and {{in|java}}, these are 40% chances.

=== Villager gifts ===
Toolsmith [[Villager|villagers]] occasionally throw stone hoes at players with the [[Hero of the Village]] status effect.{{Only|java}}

== Usage ==

=== Harvesting ===

Hoes are used to harvest certain plant-based or organic blocks more quickly. Breaking one of these blocks takes 1 [[durability]].

{{breaking row|Sculk Catalyst|sort=1|simple=1}}
{{breaking row|Sculk Shrieker|sort=1|simple=1}}
{{breaking row|Sculk Sensor|sort=1|simple=1}}
{{breaking row|Calibrated Sculk Sensor|sort=1|simple=1}}
{{breaking row|Nether Wart Block,Warped Wart Block|sort=1|simple=1}}
{{breaking row|Shroomlight|sort=1|simple=1}}
{{breaking row|Hay Bale|sort=1|simple=1}}
{{breaking row|Target|sort=1|simple=1}}
{{breaking row|Dried Kelp Block|sort=1|simple=1}}
{{breaking row|Sponge,Wet Sponge|sort=1|simple=1}}
{{breaking row|Leaves|sort=1|simple=1}}
{{breaking row|Sculk|sort=1|simple=1}}
{{breaking row|Sculk Vein|sort=1|simple=1}}
{{breaking row|Moss Block|foot=1}}

Breaking any other block takes 0 durability if the block breaks instantly when broken by hand, or 1 otherwise.

=== Tilling ===

Hoes are used to turn dirt, grass blocks, and dirt paths into [[farmland]]. To till, press {{control|use}} on a grass or dirt block while holding a hoe. This does not work on [[mycelium]] or [[podzol]],<ref>{{bug|MC-8231||Mycelium and podzol cannot be tilled with hoes}}</ref> nor does it work if there are other blocks on top of the targeted blocks, including snow layers or torches. However, mycelium and podzol can be first converted to dirt paths with a shovel, then tilled into farmland with a hoe.

Hoes can be used to convert [[coarse dirt]] into regular dirt by pressing {{control|use}} on the coarse dirt. Similar to tilling dirt, the space above the coarse dirt must be empty for it to be tilled.

Hoes can also be used on [[rooted dirt]], which turns it into normal dirt, and yields a [[hanging roots]] item.

Tilling is effectively instantaneous, regardless of material, and uses 1 durability. Breaking blocks with a hoe uses 0 or 1 durability, depending on the block.

Hoes are unable to work on blocks with a plant on top, even if that plant could normally be placed on top of farmland without reverting it to dirt.<ref>{{bug|MC-167846||Hoe cannot be used on blocks with certain blocks on top even if said blocks can normally exist on farmland|WAI}}</ref>

=== Weapon ===

Hoes may be used as a weapon, although they deal only {{hp|1}} damage {{in|java}}. {{IN|bedrock}}, hoes can do as much as a pickaxe in terms of damage. Hoes use 1 durability when used as a weapon.

{{IN|java}}, hoes have an attack speed modifier depending on the material: wood and gold have a modifier of -3 (refill in 1s), stone has a modifier of -2 (refill in 0.5s), iron has a modifier of -1 (refill in 0.33s), and diamond and netherite have a modifier of 0 (refill in 0.25s).

{| class="wikitable" style="text-align:center" data-description="Attack damage"
! Attack damage
! colspan="4" | Attack speed
! colspan="4" | Damage/Second (DPS)
|-
| {{hp|1}}
| {{ItemSprite|Wooden Hoe}}{{ItemSprite|Golden Hoe}} 1
| {{ItemSprite|Stone Hoe}} 2
| {{ItemSprite|Iron Hoe}} 3
| {{ItemSprite|Diamond Hoe}}{{ItemSprite|Netherite Hoe}} 4
| {{ItemSprite|Wooden Hoe}}{{ItemSprite|Golden Hoe}} 1
| {{ItemSprite|Stone Hoe}} 2
| {{ItemSprite|Iron Hoe}} 3
| {{ItemSprite|Diamond Hoe}}{{ItemSprite|Netherite Hoe}} 4
|}
Hoes always attack instantly {{in|bedrock}}.

=== Enchantments ===

A hoe can receive the following enchantments and curses:

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

=== Fuel ===

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

=== Smelting ingredient ===

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

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Hoe till1.ogg
|sound2=Hoe till2.ogg
|sound3=Hoe till3.ogg
|sound4=Hoe till4.ogg
|subtitle=Hoe tills
|source=block
|description=When a block is tilled into farmland
|id=item.hoe.till
|translationkey=subtitles.item.hoe.till
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a hoe'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=Gravel hit1.ogg
|sound2=Gravel hit2.ogg
|sound3=Gravel hit3.ogg
|sound4=Gravel hit4.ogg
|source=block
|description=When a block is tilled into farmland
|id=use.gravel
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a hoe'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 Hoe
|spritetype=item
|nameid=wooden_hoe
|form=item}}
{{ID table
|displayname=Stone Hoe
|spritetype=item
|nameid=stone_hoe
|form=item}}
{{ID table
|displayname=Iron Hoe
|spritetype=item
|nameid=iron_hoe
|form=item}}
{{ID table
|displayname=Diamond Hoe
|spritetype=item
|nameid=diamond_hoe
|form=item}}
{{ID table
|displayname=Golden Hoe
|spritetype=item
|nameid=golden_hoe
|form=item}}
{{ID table
|displayname=Netherite Hoe
|spritetype=item
|nameid=netherite_hoe
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wooden hoe
|spritetype=item
|nameid=wooden_hoe
|id=329
|form=item}}
{{ID table
|displayname=Stone hoe
|spritetype=item
|nameid=stone_hoe
|id=330
|form=item}}
{{ID table
|displayname=Iron hoe
|spritetype=item
|nameid=iron_hoe
|id=331
|form=item}}
{{ID table
|displayname=Diamond hoe
|spritetype=item
|nameid=diamond_hoe
|id=332
|form=item}}
{{ID table
|displayname=Golden hoe
|spritetype=item
|nameid=golden_hoe
|id=333
|form=item}}
{{ID table
|displayname=Netherite hoe
|spritetype=item
|nameid=netherite_hoe
|id=608
|form=item
|foot=1}}

== Achievements ==

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

== Advancements ==
{{load advancements|Oh Shiny;Serious Dedication;A Seedy Place}}

== Video ==

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

== History ==

{{History|java indev}}
{{History||20100206|[[File:Wooden Hoe JE1 BE1.png|32px]] [[File:Stone Hoe JE1 BE1.png|32px]] [[File:Iron Hoe JE1 BE1.png|32px]] [[File:Golden Hoe JE1 BE1.png|32px]] [[File:Diamond Hoe JE1 BE1.png|32px]] Added hoes.
|Compared to other golden tools, golden hoes had much higher durability, which was 513 instead of 33.}}
{{History|java alpha}}
{{History||v1.0.17|Golden hoes' durability has been decreased from 513 to 65, matching the stone tools.}}
{{History|java beta}}
{{History||1.2|Golden hoes now have the same durability as the other gold tools.}}
{{History||1.6|snap=Test Build 3|Before, using a hoe on [[grass block]]s was the only way to collect [[Wheat Seeds|seeds]] for planting. As [[tall grass]] has been introduced, this feature has been removed.}}
{{History|java}}
{{History||1.2.1|snap=12w07a|Player is now unable to till [[dirt]] or [[grass block]] when there is block on top of them.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden hoes.}}
{{History||1.3.1|snap=12w18a|Wooden hoes can now be used as [[Smelting#Fuel|fuel]] in a [[furnace]].}}
{{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] 1 diamond hoe for 7 [[emerald]]s, and 1 iron hoe for 4–5 emeralds.}}
{{History||1.4.2|snap=12w38a|Hoes now have a [[sound]] when tilling [[dirt]].}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden hoes.}}
{{History||1.8|snap=14w02a|Villagers no longer trade iron or diamond hoes, making diamond hoes [[non-renewable resource|non-renewable]].}}
{{History|||snap=14w32a|Hoes can now be used to convert [[coarse dirt]] into regular [[dirt]].}}
{{History||1.9|snap=15w34c|Stone, iron and diamond hoes now do slightly more [[damage]] than an unarmed attack.}}
{{History|||snap=15w34d|All hoes now lose 1 [[durability]] when used as a [[weapon]].}}
{{History|||snap=15w35a|Hoes now all do the same damage, but better materials have higher speeds.}}
{{History|||snap=15w50a|Added a [[sound]] for hoes: <code>item.hoe.till</code>.}}
{{History||1.11|snap=16w39a|Diamond hoes are now found in the new [[woodland mansion]] [[chest]]s.}}
{{History||1.11.1|snap=16w50a|Golden and iron hoes can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to ''[[1.13/Flattening|The Flattening]]'', these items' numeral IDs were 290 (wooden), 291 (stone), 292 (iron), 293 (diamond) and 294 (golden).}}
{{History||1.14|snap=18w43a|[[File:Wooden Hoe JE2 BE2.png|32px]] [[File:Stone Hoe JE2 BE2.png|32px]] [[File:Iron Hoe JE2 BE2.png|32px]] [[File:Golden Hoe JE2 BE2.png|32px]] [[File:Diamond Hoe JE2 BE2.png|32px]] The textures of all hoes have been changed.}}
{{History|||snap=19w11a|Toolsmith villagers now sell stone hoes and diamond hoes, making diamond hoes [[renewable resource|renewable]] again.}}
{{History|||snap=19w13a|Toolsmith villagers now give stone hoes to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Hoe JE1.png|32px]] Added netherite hoes.
|Netherite hoes are obtained by combining one diamond hoe and one netherite ingot in a crafting table.
|[[Crimson planks]] and [[warped planks]] can now be used to craft wooden hoes.}}
{{History|||snap=20w09a|Hoes can now break [[Nether Wart Block|nether wart and warped wart block]]s quickly.
|Netherite hoes can now be obtained through [[bartering]] with [[piglin]]s.
|[[File:Wooden Hoe JE3 BE3.png|32px]] [[File:Golden Hoe JE3 BE3.png|32px]] [[File:Diamond Hoe JE3 BE3.png|32px]] The textures of wooden, golden, and diamond hoes have been changed.}}
{{History|||snap=20w10a|Each tier of hoes now has different a speed while [[breaking|mining]] blocks they are effective against.
|Hoes can now be enchanted with [[Efficiency]], [[Fortune]] and [[Silk Touch]].
|Hoes now mine [[hay bale]]s faster than other tools.
|Netherite hoes are now less common when bartering with piglins.
|[[File:Netherite Hoe JE2.png|32px]] The texture of netherite hoes has been changed.
|Netherite hoes can no longer be [[crafted]].
|Netherite hoes are now obtained by combining one diamond hoe and one [[netherite ingot]] in a [[smithing table]].}}
{{History|||snap=20w11a|Hoes can now mine [[dried kelp block]]s, [[target]]s, and [[shroomlight]]s faster than other [[tool]]s.}}
{{History|||snap=20w12a|Hoes can now mine [[sponge]]s faster than other tools.}}
{{History|||snap=20w15a|Hoes can now mine [[leaves]] faster.
|Stone hoes can now be crafted using [[blackstone]].}}
{{History|||snap=20w16a|Golden hoes now generate randomly enchanted in [[bastion remnant]]s and [[ruined portal]] chests.}}
{{History|||snap=20w20a|Netherite hoes can no longer be obtained through bartering with piglins, making them no longer renewable.}}
{{History||1.17|snap=20w49a|Hoes can now mine [[sculk sensor]]s faster than other tools.}}
{{History|||snap=21w11a|Hoes are now the appropriate tool for breaking [[moss block]]s.}}
{{History|||snap=21w08a|Stone hoes can now be crafted using [[cobbled deepslate]].}}
{{History|||snap=21w20a|Hoes can now be used on [[rooted dirt]], turning it into normal dirt, yielding a [[hanging roots]] item.}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden hoes.}}
{{History|||snap=22w12a|Hoes can now mine mangrove [[leaves]] faster.<ref>{{Cite bug|MC|249270|Mangrove leaves do not have a hoe as their preferred tool|date=March 19, 2022}}</ref>}}
{{History|||snap=22w13a|Diamond hoes may now be found in [[ancient city]] [[chest]]s.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond hoes to netherite hoes now requires the netherite upgrade [[smithing template]].}}
{{History||1.20|snap=23w12a|Wooden hoes may now be found when brushing [[suspicious sand]] and [[suspicious gravel]] in cold and warm [[ocean ruins]] and [[trail ruins]].}}
{{History|||snap=23w16a|Wooden hoe 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]]; wooden hoe now is in the common loot.}}
{{History|upcoming java}}
{{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed of wooden hoes has been changed to 2, stone to 2.5, and diamond and gold to 3.5.
|The [[damage]] dealt for wooden, stone, and gold hoes have been changed to {{hp|2}} and iron and diamond hoes to {{hp|3}}.
|The attack reach of hoes has been increased to 4 [[block]]s.}}

{{History|pocket alpha}}
{{History||v0.4.0|[[File:Wooden Hoe JE1 BE1.png|32px]] [[File:Stone Hoe JE1 BE1.png|32px]] [[File:Iron Hoe JE1 BE1.png|32px]] [[File:Golden Hoe JE1 BE1.png|32px]] [[File:Diamond Hoe JE1 BE1.png|32px]] Added hoes. 
|Only iron hoes are available in the Creative inventory.
|[[Wheat seed]]s are now obtained by using a hoe on [[grass]] blocks.}}
{{History||v0.8.0|snap=build 3|[[Beetroot seeds]], [[carrot]]s, and [[potato]]es are now obtained by using a hoe on [[grass]] blocks.}}
{{History|||snap=build 4|[[Carrot]]s and [[potato]]es no longer spawn from tilling [[grass]] blocks with a hoe.}}
{{History||v0.11.0|snap=build 11|Wooden, stone, golden, and diamond hoes are now available in the [[creative]] [[inventory]].}}
{{History|||snap=build 12|Wooden, stone, golden, and diamond hoes have been removed from creative.}}
{{History|||snap=build 13|All hoes are now available in [[creative]] mode again.}}
{{History||v0.16.2|Wooden hoes can now be found inside the [[chest]] in the large house of [[ice plains]] [[village]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden hoes are now [[smelting|smeltable]].
|Diamond hoes can now be found inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Hoes can now be used to transform [[coarse dirt]] into normal [[dirt]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Due to [[village]]s being overhauled, wooden hoes can no longer be found in [[village]]s.
|[[File:Wooden Hoe JE2 BE2.png|32px]] [[File:Stone Hoe JE2 BE2.png|32px]] [[File:Iron Hoe JE2 BE2.png|32px]] [[File:Golden Hoe JE2 BE2.png|32px]] [[File:Diamond Hoe JE2 BE2.png|32px]] The textures of all hoes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Stone and diamond hoes can now be [[trading|bought]] from toolsmith [[villager]]s.}}
{{History||1.12.0|snap=beta 1.12.0.4|The price of diamond hoes [[trading|sold]] by toolsmith villagers has been lowered to 4 [[emerald]]s.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Hoe BE1.png|32px]] Added netherite hoes.|Netherite hoes are obtained by combining one diamond hoe and one netherite ingot in a crafting table.
|[[File:Wooden Hoe JE3 BE3.png|32px]] [[File:Golden Hoe JE3 BE3.png|32px]] [[File:Diamond Hoe JE3 BE3.png|32px]] The textures of wooden, golden, and diamond hoes have been changed.}}
{{History|||snap=beta 1.16.0.57|Each tier of hoes now has different a speed while [[breaking|mining]] blocks they are effective against.
|Hoes can now break [[hay bale]]s, [[dried kelp block]]s, [[target block]]s, [[Sponge|dry and wet sponges]], [[shroomlight]]s, [[leaves]], [[Nether Wart Block|nether wart and warped wart block]]s quickly.
|Hoes can now be enchanted with [[Efficiency]], [[Fortune]] and [[Silk Touch]].
|Netherite hoes can now be obtained through [[bartering]] with [[piglin]]s.
|Netherite hoes can no longer be [[crafting|crafted]].
|Netherite hoes are now obtained by combining one diamond hoe and one [[netherite ingot]] in a [[smithing table]].
|Stone Hoes can now be created using Blackstone.
|Golden and netherite hoes now generate randomly enchanted in [[bastion remnants]] chests.
|Golden hoes now generate randomly enchanted in ruined portal chests.
|Hoes now deal the same damage as pickaxes of each tier.}}
{{History||1.16.100|snap=beta 1.16.100.54|Netherite hoes can no longer be obtained through [[bartering]] with [[piglin]]s, making them no longer renewable.}}
{{History||1.17.10|snap=beta 1.17.10.20|[[File:Netherite Hoe JE2.png|32px]] The texture of netherite hoes has been changed to match ''Java Edition''.}}

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

{{History|New 3DS}}
{{History||0.1.0|[[File:Wooden Hoe JE1 BE1.png|32px]] [[File:Stone Hoe JE1 BE1.png|32px]] [[File:Iron Hoe JE1 BE1.png|32px]] [[File:Golden Hoe JE1 BE1.png|32px]] [[File:Diamond Hoe JE1 BE1.png|32px]] Added hoes.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*Tilling a [[dirt]] block that has a dirt block on top of it changes it to [[farmland]] even though it cannot be used. If a hoe is used on a [[block]] horizontally adjacent to such a block, the first block reverts to dirt and the selected block is not tilled.
*When a hoe breaks, it does not display the tool breaking animation like on other tools, because tilling is not predicted client-side.
*The textures for the post 1.14 iron and stone hoes have an error, where the color for the edge of the handle is partly the same color as the edge of the top part.  This isn't present in any other tool.

== Gallery ==
<gallery>
Stone Hoe SDGP.png|Stone hoe in the [[Super Duper Graphics Pack]].
Kingbdogz Hoe.jpg|[[Kingbdgoz]] holding a hoe.
</gallery>
=== Enchanted hoes ===
<gallery>
Enchanted Wooden Hoe.gif
Enchanted Stone Hoe.gif
Enchanted Iron Hoe.gif
Enchanted Golden Hoe.gif
Enchanted Diamond Hoe.gif
Enchanted Netherite Hoe.gif
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--hoe Taking Inventory: Hoe] – Minecraft.net on June 25, 2019

{{Items}}

[[Category:Combat]]

[[cs:Motyka]]
[[de:Hacke]]
[[es:Azada]]
[[fr:Houe]]
[[hu:Kapa]]
[[it:Zappa]]
[[ja:クワ]]
[[ko:괭이]]
[[nl:Schoffel]]
[[pl:Motyka]]
[[pt:Enxada]]
[[ru:Мотыга]]
[[tr:Çapa]]
[[uk:Мотика]]
[[zh:锄]]</li></ul>
20w21aAdded custom worlds.
Custom worlds are JSON-driven.
Custom dimensions can be added and vanilla dimensions can be modified.
There is currently no in-game menu to modify worlds; custom worlds can only be generated by importing a JSON file.
pre1The "temparature" biome parameter is now spelled "temperature".
Dimensions and dimension settings can be created through data packs.

Issues

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

External links


Advertisement