Minecraft Wiki
Advertisement
This article is about the phenomenon in Bedrock Edition. For the current phenomenon in Java Edition, see Far Lands/Java Edition. For the old phenomenon in Java Edition, see Far Lands/Java Edition/Pre-Beta 1.8. For other distance effects, see Distance effects.
Move arrows
It has been suggested that this page be moved to Bedrock Edition Far Lands.
If this move affects many pages or may potentially be controversial, do not move the page until a consensus is reached.
 [discuss]
When moving, be sure to use the appropriate tool instead of simply copying and pasting the page's contents, to preserve edit history.
Information icon
This feature is exclusive to Bedrock Edition. 
Far lands corner pocket

The X and Z Far Lands

The Far Lands[1] are a terrain generation bug in Bedrock Edition that happens millions of blocks from the world origin. It essentially forms the "edge" of an "infinite" world.

Location

The Far Lands initiate at X/Z: 12,550,821 and −12,550,824.

Structure

File:EdgesPE.png

Map of the relative positions of the Far Lands. In the Overworld, Nothingness appears instead of the skygrid. (not to scale)

The Bedrock Edition Far Lands are different from the Java Edition Far Lands. The content of the Far Lands in the Bedrock Edition is slightly different in biomes and structure in positive coordinates. Sand and gravel do not fall from generating in Bedrock Edition, resulting in relatively stable performance. (Bubble columns can still cause those blocks to fall, however.) The Far Lands do not generate on flat worlds, due to the lack of a noise generator.

The exact structure depends on the platform. On Realms and Bedrock Dedicated Servers, the Far Lands generate the same as on Windows 10, Xbox One, and PlayStation 4: only the nothingness generates. On mobile devices and Nintendo Switch the Edge Far Lands may generate, depending on the coordinates. In multiplayer, the structure depends on the platform used by the owner of the world. In Minecraft Education, what happens at the Far lands depends on the world. Sometimes it is a skygrid, and sometimes it is a plain ocean/bedrock with different biomes. The features of the Far Lands in other Bedrock ports remain unknown.

Caves generated close to the Far Lands sometimes have an edgy "zipper" consistency, with sometimes only every second block being hollowed out.

Edge Far Lands

Despite Y level 256 being the maximum build height, the Far Lands are still cut off at Y=128, although trees still generate normally. (as the terrain generator is limited to Y=128 despite the 256 height limit)

If fossils generate here, they usually generate in mid-air without touching any block.

Warm and lukewarm ocean biomes in the Edge Far Lands appear as a "desert-like" patch, without any water in it, while normal and cold oceans generate grass blocks. Shipwrecks and underwater ruins always generate above ground, sometimes higher than 128 on the Y axis. Buried treasure sometimes generates without touching any block.

There are many distinct terrain types of Edge Far Lands, listed in the table below:

Coordinates Effects
Overworld Nether and End
X or Z +12,550,821 The Far Lands generate, or more specifically, "The Loop" or the Tunnel Lands.
X and Z +12,550,821 Terrain generation stops entirely, except for certain features listed below. Terrain becomes a skygrid.
X −12,550,824 Terrain generation stops entirely, except for certain features listed below.
Z −12,550,824 Terrain generation stops entirely, except for certain features listed below. Terrain becomes a skygrid.
X +12,559,913 Some stretches of terrain stop suddenly beyond this point, marking the transition from the Tunnel Lands to the Pole lands. The Far Lands start to transition from "the Loop" into the Comb Lands, where sections of land that are 3 blocks wide are missing, giving way to comb-like structures.
X +12,560,361 The Far Lands completes the transition from the tunnel Lands to the Pole Lands. The terrain suddenly changes to have more comb-like structures.
X +12,561,029 The Strip Lands generate, which consists mostly of 1D and 2D panels of land.
Z +12,561,029 Some stretches of terrain stop suddenly beyond this point, as the Far Lands start to transition from the Tunnel Lands to the Pole lands. The Far Lands start to transition into the Comb Lands, farther than the X Far Lands.
X +12,562,277 The Far Lands almost disappear, although a few rare isolated blocks of terrain may generate. The terrain becomes horizontal solid or dotted lines of blocks.
Z +12,562,277 The Z Polestrip Lands generate, which generates like the Pole Lands here, but gradually changes to the Strip Lands until nothing generates. The Z Strip Lands generate.
X +12,758,545 Terrain generation stops entirely, except for certain features listed below.
Z +12,758,545 Terrain generation stops entirely, except for certain features listed below.

Repetitiveness

Usually, the Far Lands' appearance never seems to repeat. However, they start to become extremely repetitive and stretched horizontally, a great distance from the X or Z axis, with sections 12 blocks wide being repeated. There is a sudden change of the Far Lands terrain when the number of blocks from the axis exceeds 12,550,821 divided by a power of 2. This corresponds to when sections of the Far Lands terrain appear to recur more times. The periodicity of the Far Lands starts to become apparent at 784,426 or more blocks from the axis. Nearly perfect repeating occurs starting at around 3,137,705 blocks from the axis. Beyond 6,275,412 blocks from the axis, the sections appear to be symmetric, all the way to the Corner Far Lands. The Z Far Lands tend to look more repetitive than the X Far Lands for no apparent reason. Currently there is no explanation for this, as in Java Edition Beta 1.7.3 the terrain stays the same. This happens on every Bedrock Edition of the game that generates them. (i.e. mobile, Nintendo Switch)

Nothingness

In the Far Lands with negative X coordinates, after the positive X coordinates degrade, and all the Far Lands in the Windows 10 Edition, the terrain stops generating entirely, resulting in there being nothing present aside from the ocean and the bedrock layer.

Certain structures are able to generate in this area. Several, such as desert temples, have elongated foundations when generated here. Jungle temples here do not have a foundation; they instead appear to float above the water. Fossils can generate underwater, but do not generate on the bedrock floor. Igloos generate underwater on the bedrock layer, replacing the bottom bedrock layer with stone bricks. Underwater ruins and shipwrecks always generate on the bedrock layer, and lava veins (with magma blocks, obsidian, and stone on top) still generate near the bedrock layer, often creating bubble columns. Buried treasure generates above water. Pillager outposts generate only the watchtower without any peripheral structure around it; however, although the pillagers fall into the void, new pillagers can spawn again and again (infinitely) in and around the watchtower. Village buildings generate on a floating platform of grass below them. Iron golems spawn without falling through the world, although they cannot move.

Desert wells, dungeons, abandoned mineshafts, and woodland mansions cannot generate here.

Mobs such as dolphins, cod, and salmon still spawn normally. Seagrass and kelp still generate on bedrock.

In the frozen ocean biome, the surface of the ocean still freezes, and icebergs can still generate. Polar bears can spawn without falling into the void.

Skygrid

Note: As of 1.16.0, the skygrid generates only in the Nether and the End. In the Overworld, all areas previously occupied by skygrid are instead occupied by nothingness. If the world was created before 1.16.0, the skygrid continues to generate in the Overworld, including new chunks.

In the Corner Far Lands, Far Lands with negative Z, and past the normal positive Z Far Lands, a 3D grid pattern of grass blocks appears instead of the ordinary stack/loop. Tall grass and trees generate on these blocks. This results in a perfect three-dimensional array of grass blocks levitating high above the ocean.[2] The name is a bit misleading, since the array of blocks extends not only up to Y=128, but also down to bedrock level. Structures generated here follow similar rules to that of the Nothingness with some differences:

  • Tall ice spikes can generate from sea level, reaching Y=128.
  • Igloos generate on Y=64, instead of the bedrock layer underwater.
  • Prior to Village and Pillage, villages generated here at high altitudes between 64 and 128 have tall foundations extending from the bedrock layer.
    • After Village and Pillage, villages generated in the skygrid generate in sea level, just like in nothingness.
  • Unlike in nothingness, woodland mansions can generate in the skygrid.

Effects

Bedrock Edition uses 32-bit floating-point numbers (as opposed to 64-bit on Java Edition). At any given coordinates, even near the world origin, attempting to move is impossible if it is too slow. At every power of 2, the "minimum speed" doubles.

The player's hitbox corners are stored individually in memory (as opposed to the coordinates of the actual player in storage). If the player is at a power of 2, the hitbox corners may move at different speeds, changing the size of the hitbox. These size changes are usually negligible, but can potentially be significant. In extreme cases, the player's hitbox size reaches 0, making it possible to fall through the world.[3]

  • Minor jitteriness can be first experienced at X/Z: ±16,384, noticeable if the player is moving slowly.
  • At X/Z: ±131,072, most sunflowers start to render incorrectly. The jitteriness becomes noticeable when the player is sneaking.
  • At X/Z: ±524,288, easily visible jitteriness is experienced and the further the player travels, the world gradually starts to become glitchy and unplayable.[4] It also becomes impossible to move forward or backward while in cobwebs past this point. Some blocks with 3D models render incorrectly, such as string, tripwire hooks, item frames, levers and lecterns.
  • Past X/Z: ±1,048,576, the jitteriness becomes considerably unbearable, making crashes frequent at this point on low-end devices. Most blocks with 3D models, including cacti, levers, torches and bamboo render incorrectly,[4] and become more distorted the farther out the player travels.
  • Past X/Z: ±4,194,304, it is impossible to walk normally. Ender pearls, an elytra with fireworks, horseback, speed potions, and water are the only acceptable ways to travel from here onward.
  • Beyond X/Z: ±8,388,608, every entity less than 1 block high or wide, including the player, falls through blocks. Since blocks still have collision detection from the sides (unless both coordinates exceed this value) Speed 8 allows players to walk past 8,388,608, but if they teleport past 8,388,608, they always fall through the world. Flying, elytra and horseback are the only ways to navigate past this point in Survival; thus, it is impossible to reach the Far Lands on foot.
FarLandsEdge PocketEdition

Far Lands on Minecraft Bedrock Edition

The terrain errors initiate at X/Z ±12,550,821, like in Java Edition.

  • Between X: +12,561,029 and X: +12,758,546 the Far Lands begin to take on a thinner "shredded" appearance, before fading out into either a Nothingness state.
  • What generates from there to the beginning of the Stripe Lands (X/Z: ±16,777,216) is just ocean, with a floor of bedrock. The bedrock generates in a pattern identical to how it normally generates underground. Biomes still exist; swamps darken the water and cold biomes generate ice on the top layer of water. Generated structures, such as villages, witch huts, and jungle temples still generate here. The large blocks of land eventually phases out to become long thin strips and eventually dotted arrays of floating blocks, resembling a 1-dimensional cross-section of the skygrid.
  • At X/Z: ±16,777,216, the Stripe Lands begin to render. They are caused when the precision loss of the world causes 1 out of every 2 blocks to be considered "invalid".
  • X/Z ±30,000,000 is the maximum teleportation distance; any attempt to teleport farther puts the player back at this coordinate, and using commands above 30,000,000 causes an "Unable to fill, summon, more object" error message because it is an illegal position in the command.
  • X/Z ±31,999,872 can be reached in the Overworld with the Nether by entering a Nether portal past X/Z ±3,999,984 in the Nether.
  • Beyond X/Z ±33,554,432 the "stripes" of the Stripe Lands disappear, leaving only vertical block rendering.
  • Beyond X/Z: ±67,108,864, it becomes impossible to manually travel using elytra with fireworks. However, it is possible to teleport using chorus fruit.
  • Generated structures like villages and ice spikes may continue to generate as far up to X/Z: ±134,217,728. However, they appear two-dimensional at this distance. In the Windows 10, Xbox One and PlayStation 4 editions, there is no limit to how far out structures can generate and they can be seen at distances of over 2 billion blocks.
  • Beyond X/Z: ±134,217,728, teleportation using chorus fruit is confirmed to be impossible. The only way to move beyond this limit is by using external tools.
  • At every power of two in the Stripe Lands, gaps between rendered blocks double. At X/Z ±1,073,741,824, blocks are 128 blocks apart and neighboring slices are invisible with a low render distance.
  • MCPEFarLandsEnd

    Far Lands at X/Z 1,073,741,823 in Minecraft Bedrock Edition.

    Near X/Z: ±2,147,483,648, the game crashes, as this is the 32-bit integer limit. However, not all devices are able to reach this point, and you can /tp after that.

Dimensions

The Far Lands of the Nether and End share characteristics of the Overworld Far Lands, although with some differences. They generate more similarly to each other than to the Overworld Far Lands.

The Nether

The Nether slime Lands are similar to the Overworld Far Lands, except generated with Nether terrain features, with a lava ocean at Y=31. Bastion remnants and ruined portals continue to generate. Bastions "float" on the lava, with their foundations at Y=29.[5]

The Nether can be a great way to reach the Far Lands in the Overworld, as every block in the Nether counts as 8 blocks in the Overworld. The player must travel to 1,568,853 or higher to spawn in the Far Lands. Teleporting just a few blocks less allows the player to see the beginning of the Far Lands.

The End

The End Far Lands are not of much interest, being made of almost exclusively end stone, and appear a bit more squashed and stretched horizontally than the Overworld Far Lands. Micro-end islands still generate inside the Far Lands, even after the latter dissipates. Since there is no signature liquid of the End, they just generate down to a dry void; similarly, there is no bedrock floor.

The End Far Lands are cut off at y=128, although structures still generate on top.

Cause

The terrain is generated based on 16 octaves of Perlin noise. Each noise generator takes floating-point inputs and uses those to interpolate between noise values at whole numbers. It does so by:

  1. Casting to a 32-bit integer, where the game rounds toward zero and handles overflow by picking the closest representable value;
  2. Subtracting one if the integer is greater than the original input, to always round down;
  3. Subtracting that integer from the original input to get a remainder in the interval [0, 1) suitable for interpolation.

It covers an interval of [−231, 231) without causing any problems. The problem is that many of the octaves cover a scale much smaller than a block, with up to 171.103 noise units per block. Indeed, 231 ≈ 171.103×12,550,824.053. Thus, the Far Lands start 12,550,824 blocks away from the center of the Minecraft world. Once this value is exceeded, the integer is always 231−1, thus breaking the generation algorithm.

At the positive end, the remainder starts out relatively small but usually much larger than 1, and grows by 171.103 per block. At the negative end, the remainder starts at −232. This value is then adjusted by ((6x−15)x+10)x3 or in this case, ((6(12,550,824.053)−15)(12,550,824.053)+10)(12,550,824.053)3 ≈ 1.8685826 × 1036 for quintic interpolation. Even one block in at the positive end, this is already around 1011. The negative end starts all the way around −1049. For the Corner Far Lands, multiply the values of both edges. When interpolation (really extrapolation) is attempted with values as large as these, it produces similarly large output. That output completely dwarfs all other terms that would normally give the terrain its shape, instead effectively passing only the sign of this one noise function through.

There are several other factors to the cause of the Far Lands, making things slightly more complicated:

  • Noise is sampled only every four blocks and linearly interpolated in between. This is why when 12,550,824 is affected by the bug, it reaches out three more blocks to 12,550,821.
  • Each noise generator picks a random offset in [0, 256) to add to its input. This usually moves the boundary under 12,550,824, starting the Far Lands at 12,550,821. With a few seeds, it might not, putting the start at 12,550,825. Rarely, if the boundary is just barely within 12,550,824, the first couple blocks of the Far Lands might look somewhat normal. The southern and eastern Far Lands do this independently of one another. At the negative end, the Far Lands always start at block coordinate −12,550,825, with the positive edge of those blocks at −12,550,824.
  • There are actually two sets of noise generators, which are blended together based on another noise generator. This is responsible for relatively smooth alternation between two sets of tunnels or plains. Occasionally, one of the noise generators starts generating the Far Lands before the other because it uses a different offset, producing an incongruous boundary.

Video

History

Pocket Edition Alpha
0.9.0
{{Extension DPL}}<ul><li>[[Debug Stick|Debug Stick]]<br/>{{about|the item|other uses|Debug}}
{{exclusive|java}}
{{Item
| image = Debug Stick.gif
| rarity = Epic
| renewable = No
| stackable = No
}}

The '''debug stick''' is an [[item]] used to edit the [[block states]] of [[block]]s. It is visually identical to a regular [[stick]], but with a glint (as if [[Enchanting|enchanted]]).

== Obtaining ==

The debug stick is obtainable via [[commands]] such as {{cmd|/give}} or {{Cmd|/item}}, or the Creative inventory if the player has the appropriate permissions. It can be obtained only in worlds with cheats on.

== Usage ==

The debug stick can be used to change block states. {{control|Hitting}} the block allows players to select the block state key they wish to change, for an example, switching between the ''conditional'' and the ''facing'' block state keys for a [[command block]]. {{control|Using}} the block allows them to cycle through the valid values for the block state key, again as an example, the player can make the command block face, ''down'', ''east'', ''north'', ''south'', ''up'', or ''west'' if they chose the ''facing'' block state key. {{control|Sneaking}} while {{control|hitting}} or {{control|using}} cycles through the block state keys or values in reverse order.

It is notable that {{Control|using}} debug stick directly on an interactive block without {{Control|sneaking}} uses the block itself instead of the stick.<ref>{{bug|MC-200199}} </ref>

The debug stick cannot be used while in Survival or Adventure mode. It works only in creative mode with cheats enabled. In modes other than Creative, it acts like a regular item — although when {{control|using}} it on a block, the player swings the stick as if interacting with it (but nothing happens).

== Data values ==
=== ID ===
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Debug Stick
|spritetype=item
|nameid=debug_stick
|form=item
|foot=1}}

=== Item data ===

<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Debug Sticks}}
</div>

== History ==

{{History|java}}
{{History||1.13|snap=17w47a|[[File:Debug Stick.gif|32px]] Added debug sticks.}}
{{History||1.16|snap=20w10a|Debug sticks are now capable of editing [[fire]] due to its added hitbox.}}
{{History||1.19.3|snap=22w44a|The debug stick is now available in the creative inventory, but only if cheats are enabled.}}
{{History|||snap=22w45a|Moved the debug stick behind the Operator Utilities tab in the creative inventory. The tab is only available if cheats are enabled and the "Operator Items Tab" option in the controls menu is turned on.}}
{{History|foot}}

== Issues ==
The debug stick is not supported, and any issues resulting of its usage are closed as "Won't Fix" in the issue tracker.<br/> Issues with the stick itself are considered valid.<ref>https://bugs.mojang.com/browse/MC-122323?focusedCommentId=419481&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-419481</ref><ref>{{reddit|7es23r||Just be aware that any weird state you create with it you cannot naturally create and any bugs that come from it will be shot down as 'Wont fix' :D|_Grum|November 22, 2017}}</ref>

{{issue list}}

== Trivia ==
*An [[add-on]] made by Mineplex was showcased in [[MINECON Live 2019]], which had an editor stick for {{el|be}}, similar to the Debug Stick.<ref>{{ytl|OZqNaEX8208|MINECON Live 2019 @ 1:05:02|Minecraft|September 28, 2019|t=3902}}</ref>

== Gallery ==
<gallery>
Technically Updated.jpg|Artwork of Steve and Alex wielding debug sticks.
</gallery>

== See also ==
*[[Block states]]

== References ==
{{Reflist}}

{{Items}}

[[Category:Non-renewable resources]]

[[de:Debug-Stab]]
[[es:Palo de depuración]]
[[fr:Bâton de débogage]]
[[ja:デバッグ棒]]
[[ko:디버그 막대기]]
[[pl:Patyk debugujący]]
[[pt:Graveto de depuração]]
[[ru:Палка отладки]]
[[zh:调试棒]]</li><li>[[Ankle Monitor|Ankle Monitor]]<br/>{{Joke feature}}
{{Item
| title = Ankle Monitor
| image = Ankle Monitor.png
| renewable = No
| stackable = Yes (64)
}}

The '''Ankle monitor''' was a joke foot item.

== Usage ==
Ankle monitors were equipped in the boots slot. In survival mode, when equipped, it could not be taken off. However, players in Creative mode are unaffected.

When equipped, the player would be afflicted with {{EffectLink|Slowness}} I.

During the night, being a certain number of blocks from the world spawn, above a certain minimum,{{checkthecode|how much?}} would prompt the following message in chat: "CURFEW WARNING! You are violating your house arrest! Get back by [distance] meters!"

If in [[the Nether]] or [[the End]], a different set of messages would be cycled through which can be seen in the section below.

=== Nether and End messages ===
* CURFEW WARNING! You are violating your house arrest! Uuuh... where are you anyway?
* CURFEW WARNING! Hello, are you there?
* CURFEW WARNING! I'm sure you have important things to do, but you need to go back!
* CURFEW WARNING! We're lonely back home!
* CURFEW WARNING! By "we" I mean I. I'm lonely.
* CURFEW WARNING! Ok enough games... GET BACK RIGHT NOW!
* CURFEW WARNING! LAST WARNING!
* CURFEW WARNING! LASTEST WARNING (really now)
* CURFEW WARNING! ...
* CURFEW WARNING! So... Where are you?
* CURFEW WARNING! Having a good day?
* CURFEW WARNING! Did you see that monster over there?
* CURFEW WARNING! Give it a whack, if you would be so kind.
* CURFEW WARNING! Teheee...
* CURFEW WARNING! Ok, enough of this!
* CURFEW WARNING! Last straw!
* CURFEW WARNING! Now you die.
* CURFEW WARNING! Boom!
* CURFEW WARNING! Hehe, fun right?
* CURFEW WARNING! Ok, you will not hear anything more from me now!
* CURFEW WARNING! You'll be as lonely as I am.
* CURFEW WARNING! How does that feel?
* CURFEW WARNING! I know, I'll wipe my memory. That way, I can start over!
* CURFEW WARNING! *bzzzzttt*

== Sounds ==
{{Sound table
|sound=Robot1arm1.ogg
|sound2=Robot1arm2.ogg
|sound3=Robot1arm3.ogg
|sound4=Robot1arm4.ogg
|source=dependent
|subtitle=''None''
|description=When a notification is displayed
|id=item.ankle_monitor.warning
|translationkey=''None''
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|shownumericids=y
|showforms=y
|generatetranslationkeys=java
|displayname=Ankle Monitor
|spritetype=item
|nameid=ankle_monitor
|id=501
|form=item
|translationkey=item.ankleMonitor.name
|foot=1}}

== History ==
{{History|java}}
{{History||1.RV-Pre1|[[File:Ankle_Monitor_(item).png|32px]] [[File:Ankle Monitor.png|32px]] Added ankle monitors.}}
{{History||1.11|snap=16w39a|The inability to remove ankle monitors was somewhat implemented into the canonical game through the addition of [[Curse of Binding]].<ref>{{ytl|Vm6oplvyyh0|t=3m31s}}</ref>}}
{{History|foot}}

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

== Gallery ==

<gallery>
TechGear.png|A [[player]] wearing the gear featured in this [[wikipedia:April Fools' Day|April Fools']] joke version.
</gallery>

==References==
{{Reflist}}

{{Items}}
{{Jokes}}

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

[[es:Ankle monitor]]</li></ul>
build 1First appearance of the Far Lands.
0.10.0
{{Extension DPL}}<ul><li>[[Painting|Painting]]<br/>{{ItemEntity
|title=Painting
|image=Painting JE2 BE2.png
|extratext=View [[#Renders|all renders]]
|renewable=Yes
|stackable=Yes (64)
|drops=1 {{ItemLink|Painting}}
}}
'''Paintings''' are decorative [[entity|entities]] that hang on walls.

== Obtaining ==
=== Crafting ===
{{Crafting
|A1= Stick |B1= Stick    |C1= Stick
|A2= Stick |B2= Any Wool |C2= Stick
|A3= Stick |B3= Stick    |C3= Stick
|Output= Painting
|type= Decoration block
}}

Paintings can be crafted with any color of [[wool]]. The color of the wool used does not influence the picture chosen when the painting is placed.
Once placed, it displays a random painting.

=== Breaking ===
To remove a painting from a wall, the player can {{control|attack}} it, break one of its supporting blocks, cover one square of it with a block, hit it with an arrow, egg, ender pearl, snowball, or fire charge, or subject it to an explosion. The painting then drops as an item. Arrows that hit paintings disappear.

=== Trading ===
Master-level shepherd [[villager]]s sell 3 paintings for 2 [[emerald]]s.

== Usage ==
=== Placement ===
Paintings can be placed on the sides of [[solid block]]s, [[sign]]s, [[banner]]s, or [[sculk vein]]s . A small gap is visible between the painting and attachment surface. There are several different sizes of paintings (see below). When placed, a painting checks for the largest amount of space it has. It then chooses a random painting of that size. The player can add blocks around the painting to ensure it is the size wanted. When the supporting blocks are removed, the painting breaks after 20 game [[tick]]s (1 second) if no supporting blocks are replaced during that interval.

=== Properties ===
Being an entity, paintings can simultaneously exist in the same space as blocks such as water or torches. Specifically, they can share the space with any block whose collision box does not intersect its hitbox.

Players and mobs are able to walk through paintings, as long as the blocks supporting the painting allow it. Secret doorways can be created this way. [[Light]] propagates through paintings as well.

If a player is concealed behind a painting, the player's name is also concealed from other players.{{verify|Is this true in Bedrock?}}

Paintings are non-flammable.

== Canvases ==
There are 26 paintings in the game. These are mostly based on paintings by [[Kristoffer Zetterstrand]], who also created the ''Minecraft'' versions.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:150px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:3em" |Original
! style="min-width:3em" |Name
! style="min-width:3em;max-width:4.5em" |[[Resource location]]
! style="min-width:10em" |Description
! Java Edition version added
|-
! [[File:Alban (texture).png|64px]]
| rowspan="7" | 1×1 blocks<br>16×16 pixels || [https://zetterstrand.com/work/pictures/archive/alban.jpeg "Albanian"] || Albanian || <code>alban</code> || A man wearing a fez next to a house and a bush. As the name of the painting suggests, it may be a landscape in [[Wikipedia:Albania|Albania]]. || rowspan="9" | [[Indev 20100223]]
|-
! [[File:Aztec (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/2aztbig.jpg "de_aztec"]|| de_aztec || <code>aztec</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Aztec2 (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/11aztec_for_print.jpg "de_aztec"]|| de_aztec || <code>aztec2</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Bomb (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/12bomb.jpg "Target successfully bombed"]|| Target Successfully Bombed || <code>bomb</code> || The map [[w:c:counterstrike:Dust II|de_dust2]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]'', named “target successfully bombed" in reference to the game. 
|-
! [[File:Kebab (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/kebab2.jpg "Kebab med tre pepperoni"] || Kebab med tre pepperoni || <code>kebab</code> || A kebab with three green chili peppers. 
|-
! [[File:Plant (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/paradistrad.jpeg "Paradisträd"] || Paradisträd || <code>plant</code> || Still life of two plants in pots. "Paradisträd" is Swedish for "[[Wikipedia:Crassula ovata|money tree]]", which is a common name for the depicted species in Scandinavia. 
|-
! [[File:Wasteland (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Wasteland_1920.jpg "Wasteland"]|| Wasteland || <code>wasteland</code> || A view of some wastelands; a small animal (presumably a rabbit) is sitting on the window ledge. 
|-
! [[File:Courbet (texture).png|128px]]
| rowspan="5" | 2×1 blocks<br>32×16 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bonjourmonsieurcourbet_BIG.jpg "Bonjour monsieur Courbet"]|| Bonjour Monsieur Courbet || <code>courbet</code> || Two hikers with pointy beards seemingly greeting each other. Based on Gustave Courbet's painting ''[[Wikipedia:La rencontre|The Meeting or "Bonjour, Monsieur Courbet"]]''. 
|-
! [[File:Pool (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/thepool_1920.jpg "The pool"]|| The Pool || <code>pool</code> || Some men and women skinny-dipping in a pool over a cube of sorts. Also there is an old man resting in the lower-right edge. 
|-
! [[File:Sea (texture).png|128px]]
| rowspan=2 |[https://zetterstrand.com/eventz/wp-content/uploads/SeaSide_1920.jpg "Seaside"]
| Seaside
| <code>sea</code>
| Mountains and a lake, with a small photo of a mountain and a bright-colored plant on the window ledge. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Creebet (texture).png|128px]]
| Creebet || <code>creebet</code> || Mountains and a lake, with a small photo of a mountain and a creeper looking at the viewer through a window. || [[Alpha v1.1.1]]
|-
! [[File:Sunset (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/sunset_dense.jpg "sunset_dense"]|| sunset_dense || <code>sunset</code> || A view of mountains at sunset. || [[Indev 20100223]]
|-
! [[File:Graham (texture).png|64px]]
| rowspan="2" | 1×2 blocks<br>16×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/graham.jpg "Graham"]|| Graham || <code>graham</code> || King Graham, the player character in the video game series ''[[Wikipedia:King's Quest|King's Quest]]''. The original is based on ''[[Wikipedia:File:Sánchez_Cotán_(Bodegón_con_membrillo,_repollo,_melón_y_pepino).jpg|Still Life with Quince, Cabbage, Melon, and Cucumber]]'' by Juan Sánchez Cotán.|| [[Alpha v1.1.1]]
|-
! [[File:Wanderer (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/wanderer_1920.jpg "Wanderer"]|| Wanderer || <code>wanderer</code> || A version of Caspar David Friedrich's famous painting ''[[Wikipedia:Wanderer above the Sea of Fog|Wanderer above the Sea of Fog]]''. || rowspan="4" | [[Indev 20100223]]
|-
! [[File:Bust (texture).png|128px]]
| rowspan="6" | 2×2 blocks<br>32×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bust_1915.jpg "Bust"]|| Bust || <code>bust</code> || A bust of [[Wikipedia:Marcus Aurelius|Marcus Aurelius]] surrounded by fire. 
|-
! [[File:Match (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Match_rgb_1918.jpg "Match"]|| Match || <code>match</code> || A hand holding a match, causing fire on a white cubic gas fireplace. 
|-
! [[File:Skull and Roses (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/moonlight-installation_1920.jpg "Moonlight Installation"]|| Skull and Roses || <code>skull_and_roses</code> || A skeleton at night with red flowers in the foreground. The original painting was different, depicting a woman sitting in a couch, while the skull is in the middle of a body of glacial water of sorts. 
|-
! [[File:Stage (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/The-stage-is-set-1.jpg "The stage is set"]
| The Stage Is Set
| <code>stage</code>
| Scenery from ''[[Wikipedia:Space Quest I|Space Quest I]]'', with the character Graham from the video game series ''[[Wikipedia:King's Quest|King's Quest]]'' appearing twice. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Void (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/the-void_1920.jpg "The Void"]|| The void || <code>void</code> || An angel praying into a void with fire below. || [[Indev 20100223]]
|-
! [[File:Wither (painting texture).png‎|128px]]
| – || Wither || <code>wither</code> || The creation of a [[wither]]. 
This is the only painting not based on a real painting. Made by Jens Bergensten.<ref>{{Citation|url=https://www.youtube.com/watch?v=kK5Y4k-vVXc|title=Who Made Minecraft’s LAST Painting?!|author=AntVenom|website=YouTube|date=29 October 2022}}</ref><ref>https://www.reddit.com/r/Minecraft/comments/1tzav2/comment/cedagcy/</ref>
|| [[Java Edition 1.4.2]] ([[12w36a]])
|-
! [[File:Fighters (texture).png|128px]]
| 4×2 blocks<br>64×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/fighters.jpg "Fighters"]|| Fighters || <code>fighters</code> || Two men poised to fight. Paper versions of fighters from the game ''[[Wikipedia:International Karate +|International Karate +]]''. || [[Indev 20100223]]
|-
! [[File:Donkey Kong (texture).png|128px]]
| rowspan="2" | 4×3 blocks<br>64×48 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/kong.jpg "Kong"]|| Kong || <code>donkey_kong</code> || A paper-looking screenshot of the level [https://www.mariowiki.com/100m 100m] from the arcade game ''[[Wikipedia:Donkey Kong (arcade game)|Donkey Kong]]''. || rowspan="2" | [[Alpha v1.1.1]]
|-
! [[File:Skeleton (painting texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/mortal_coil.jpg "Mortal Coil"]|| Mortal Coil || <code>skeleton</code> || [[w:c:grim-fandango:Bruno Martinez|Bruno Martinez]] from the adventure game ''[[Wikipedia:Grim Fandango|Grim Fandango]]''. 
|-
! [[File:Burning Skull (texture).png‎|128px]]
| rowspan="3" | 4×4 blocks<br>64×64 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/skull_on_fire_framed_c_1910.jpg "Skull on Fire"]|| Skull On Fire || <code>burning_skull</code> || A Skull on fire; in the background there is a moon in a clear night sky.<br>This painting is based on a Minecraft screenshot,<ref>{{Citation|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|website=Imgur|date=22 August 2020|title=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH}}</ref> with the grass block and a 3D skull added on top.<ref>{{Citation|url=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|title=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|website=Imgur|date=23 August 2020}}</ref>
(See the [[:en:Painting#Trivia|trivia]] section for more info.)
| [[Java Edition Beta 1.2 01|Beta 1.2_01]] / [[Java Edition Beta 1.3|Beta 1.3]]
|-
! [[File:Pigscene (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/rgb_1914.jpg "RGB"]|| Pigscene || <code>pigscene</code> <!-- yes, without an underscore --> || A girl pointing to a pig on a canvas. In the original version, the canvas showed red, green and blue blocks, representing the three colors of the [[Wikipedia:RGB color model|RGB color model]] that is typically used by computer displays. It is based on the painting ''[[Wikipedia:File:Jacob van Oost (I) - The Artist's Studio - WGA16654.jpg|The Artist's Studio]]'' by Jacob van Oost.|| [[Alpha v1.1.1]]
|-
! [[File:Pointer (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/pointer_1920.jpg "Pointer"]|| Pointer || <code>pointer</code> || The main character of the game ''[[Wikipedia:International Karate +|International Karate +]]'' in a fighting stance touching a large hand. It could also be interpreted as a play on Michelangelo's famous painting ''[[Wikipedia:The Creation of Adam|The Creation of Adam]]''. || [[Indev 20100223]]
|}

=== Unused paintings ===
In [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]], with the addition of paintings to Pocket Edition, four unused 32×32 paintings were present in <samp>[[kz.png]]</samp> which remained unused. See {{slink|Bedrock Edition unused features|Paintings}} for more information. They were also added to Java Edition in snapshot [[Java Edition 22w16a|22w16a]]. They cannot be placed by default, but can be summoned by [[commands]] (such as {{cmd|/summon painting ~ ~ ~ {variant:"water"} }}) or through a [[datapack]].

According to [[Helen Zbihlyj]],<ref>https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 ([https://web.archive.org/web/20220422115723/https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 archived])</ref> these paintings were originally added "as part of a Pocket Edition promo map" (no footage found) which was planned to be a part of [[Pocket Edition]] promotion at [[MINECON 2012]] [[MINECON 2013|or 2013]] and have never been used in game. The artist of these paintings remains unknown.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:100px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:6em" |Name
! style="min-width:10em" |[[Resource location]]
! style="min-width:10em" |Description
! style="min-width:5em;max-width:10em" |Bedrock Edition version added
! style="min-width:5em;max-width:8em" |Java Edition version added
|-
! [[File:Earth (texture) BE2.png|128px]]
| rowspan="4" | 2×2 blocks<br>32×32 pixels || Earth || <code>earth</code> || One of the four {{Wikipedia|Classical element|classical elements}}: Earth. || rowspan="4" | [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]] || rowspan="4" | [[Java Edition 22w16a|22w16a]]
|-
! [[File:Fire (texture) BE2.png|128px]]
| Fire || <code>fire</code> || One of the four classical elements: Fire. 
|-
! [[File:Water (texture) BE2.png|128px]]
| Water || <code>water</code> || One of the four classical elements: Water. 
|-
! [[File:Wind (texture) BE2.png|128px]]
| Wind || <code>wind</code> || One of the four classical elements: Air. 
|}

==Sounds==
{{Edition|Java}}:
{{Sound table
|sound=Painting break1.ogg
|sound2=Painting break2.ogg
|sound3=Painting break3.ogg
|subtitle=Painting breaks<ref>{{Cite bug|MC|194948|Painting, item frame and lead breaking subtitles inconsistent with block breaking subtitle|date=July 14, 2020}}</ref>
|source=neutral
|description=When a painting is broken or pops off
|id=entity.painting.break
|translationkey=subtitles.entity.painting.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Painting place1.ogg
|sound2=Painting place2.ogg
|sound3=Painting place3.ogg
|sound4=Painting place4.ogg
|subtitle=Painting placed
|source=neutral
|description=When a painting is placed
|id=entity.painting.place
|translationkey=subtitles.entity.painting.place
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Item Frame break1.ogg
|sound2=Item Frame break2.ogg
|sound3=Item Frame break3.ogg
|source=block
|description=When a painting is broken or pops off
|id=block.itemframe.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Item Frame add item1.ogg
|sound2=Item Frame add item2.ogg
|soumd3=Item Frame add item3.ogg
|sound4=Item Frame add item4.ogg
|source=block
|description=When a painting is placed
|id=block.itemframe.add_item
|volume=1.0
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=item
|nameid=painting
|id=357
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=entity
|nameid=painting
|id=83
|foot=1}}

=== Entity data ===

Paintings have entity data that defines 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|M3vWDirTMek}}</div>

== History ==
{{History|java indev}}
{{History||20100223|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 19 canvases, which can be viewed at [[Java Edition history of textures/Paintings]].
|The [[crafting]] recipe of paintings uses eight [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Oak Planks
  |B1=Oak Planks
  |C1=Oak Planks
  |A2=Oak Planks
  |B2=Light Gray Wool
  |C2=Oak Planks
  |A3=Oak Planks
  |B3=Oak Planks
  |C3=Oak Planks
  |Output=Painting
}}
{{!}}}
|Painting textures are currently stored on a [[texture atlas]] called <samp>[[kz.png]]</samp>.}}
{{History|java infdev}}
{{History||20100227-1|The [[crafting]] recipe has of paintings has been changed, so that it now uses [[stick]]s, rather than [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Stick
  |B1=Stick
  |C1=Stick
  |A2=Stick
  |B2=Light Gray Wool
  |C2=Stick
  |A3=Stick
  |B3=Stick
  |C3=Stick
  |Output=Painting
}}
{{!}}}
}}
{{History|java alpha}}
{{History||v1.1.1|Added five more painting canvases, for a total of 24.
|The textures of two paintings have been changed.}}
{{History|java beta}}
{{History||1.2_01|Added a new painting, although it uses an untextured part of <samp>kz.png</samp> due to the painting texture not yet being implemented.}}
{{History||1.3|The texture of the new painting, has been added to the part of <samp>kz.png</samp> displayed by the new painting.}}
{{History||April 27, 2011|link=https://web.archive.org/web/20201111211000/https://notch.tumblr.com/post/4988431144/the-maps|Custom paintings are mentioned by [[Notch]].}}
{{History||1.7.3|Paintings pushed by [[piston]]s now pop off.}}
{{History|java}}
{{History||1.4.2|snap=12w36a|Added new painting canvas 'Wither'.
|Paintings can now be placed overlapping one another.}}
{{History||1.8|snap=14w10a|Paintings can no longer be placed directly inside of each other.}}
{{History||1.9|snap=15w49a|Paintings can no longer be destroyed by [[lightning]].}}
{{History|||snap=15w50a|Added [[sound]]s for placing and breaking paintings: <code>entity.painting.place</code> and <code>entity.painting.break</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID for paintings has been changed from <code>Painting</code> to <code>painting</code>.}}
{{History||1.12|snap=17w06a|Paintings now have a more intuitive placement system. When placed, a painting always uses the maximum possible amount of available space.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 321.}}
{{History|||snap=18w02a|Paintings now use a [[resource location]] for their motive.}}
{{History||1.14|snap=18w43a|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History|||snap=19w07a|Paintings are now stored as individual image files instead of parts of a single large image file, and now support animations.}}
{{History|||snap=19w11a|Shepherd [[villager]]s now [[trading|sell]] paintings.}}
{{History||1.17|snap=21w11a|The painting back texture has been updated to be in line with the texture update.}}
{{History||1.19|snap=22w16a|Added the four unused paintings from Bedrock Edition: "Earth", "Wind", "Fire", and "Water".|These paintings can only be added through a [[data pack]], or with the {{cmd|summon}} command.}}
{{History||1.19.4|snap=23w06a|Added [[painting]] variants to "Functional Blocks" tab.|Paintings with pre-defined variant will now display author, title and size in description when hovered over.|The "Operator Utilities" tab now contains the four paintings that are not available in Survival mode.}}

{{History|pocket alpha}}
{{History||v0.5.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Bedrock Edition history of textures/Paintings]].}}
{{History||v0.8.0|snap=build 3|A new painting rendering has been added.{{info needed|What exactly changed?}}}}
{{History||v0.12.1|snap=build 1|Paintings are no longer available from the [[nether reactor]].}}
{{History||v0.15.0|snap=build 1|Paintings now have [[sound]]s when placed and broken.}}
{{History|pocket}}
{{History||1.0.7|Added new painting canvas 'Wither'.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Paintings can now be [[trading|bought]] from shepherd [[villager]]s.}}
{{History||1.17.0|snap=beta 1.17.0.50|The painting back texture has been updated to be in line with the texture update.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Legacy Console Edition history of textures/Paintings]].}}
{{History||xbox=TU11|The limit for paintings in a world has been increased. 
|A message is now displayed when the maximum paintings are reached.}}
{{History||xbox=TU14|ps=1.04|Added new painting canvas 'Wither'.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for paintings.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[New Nintendo 3DS Edition history of textures/Paintings]].}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* On April 26, 2011, Notch stated that the automapping code can be used to share custom paintings and books in the future.<ref>{{tweet|notch|62970142207913984|The auto mapping code can be used to share custom paintings and books in the future. There's a hard cap on 65536 of each/world, though|April 26, 2011}}</ref>
* The texture on the back of a painting is the same as the wooden planks texture, but with a yellowish color similar to that of [[chests]] (but slightly darker).
* The "Skull on Fire" painting contains a Minecraft world in the background, which is based on a screenshot taken by the artist in [[Java Edition Alpha v1.1.2 01|Alpha 1.1.2_01]] (or earlier) on October 12, 2010, at 13:22:49 (UTC+2).<ref>{{cite|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|title=The original (never publicly shared before) screenshot that Kristoffer Zetterstrand took and based his painting on.|website=Imgur}}</ref>
**The seeds for this world are -1044887956651363087 and -6984854390176336655 (both are the same), standing at X=-249.65, Y=91, Z=-29.04.<ref>https://pastebin.com/fzAY9ES4</ref><ref>https://www.reddit.com/r/Minecraft/comments/iqg3ey/the_original_screenshot_seed_of_the_minecraft/</ref>
* The "Skull on Fire" painting's texture was added in [[Java Edition Beta 1.3|Beta 1.3]]. However, the code for paintings to randomly display the part of the [[Kz.png]] texture that was to be occupied by the Burning Skull painting was added earlier, in [[Java Edition Beta 1.2_01|Beta 1.2_01]]. As there was nothing on this part of the texture except for a purple background grid, this is what would be displayed if the painting was randomly chosen, until the Burning Skull painting texture was actually added.
* The original "Skull on Fire" painting was given to the winner of an official texture pack competition by Mojang.<ref>https://web.archive.org/web/20110110003612/http://www.webhallen.com:80/minecraft/</ref>

== Gallery ==
<gallery>
File:Notch Painting Screenshot.png|The first image of paintings released by [[Notch]].
File:Skull on Fire world.jpg|The original screenshot behind the "Skull on Fire" painting.
File:Burning Skull Render.jpg|A render of the "Skull on Fire" painting that [[Kristoffer Zetterstrand]] used as a reference image.
File:Skull on Fire IRL.jpg|The original "Skull on Fire" painting being painted.
File:Burning Skull JE1.png|The "Skull on Fire" painting as it appeared between versions [[Java Edition Beta 1.2_01|Beta 1.2_01]] and [[Java Edition Beta 1.2_02|Beta 1.2_02]], prior to its texture being added in [[Java Edition Beta 1.3|Beta 1.3]].
</gallery>

=== Renders ===
<gallery>
Alban.png | Albanian
Aztec.png | de_aztec
Aztec2.png | de_aztec
Bomb.png | Target Successfully Bombed
Kebab.png | Kebab med tre pepperoni
Plant.png | Paradisträd
Wasteland.png | Wasteland
Courbet.png | Bonjour Monsieur Courbet
Creebet.png | Creebet
Pool.png | The Pool
Sea.png | Seaside
Sunset.png | sunset_dense
Graham.png | Graham
Wanderer.png | Wanderer
Bust.png | Bust
Match.png | Match
Skull and Roses.png | Skull and Roses
Stage.png | The Stage Is Set
Void.png | The void
Wither (painting).png | Wither
Fighters.png | Fighters
Donkey Kong.png | Kong
Skeleton (painting).png | Mortal Coil
Burning Skull.png | Skull On Fire
Pigscene.png | Pigscene
Pointer.png | Pointer
Earth BE2.png | Earth
Fire BE2.png | Fire
Water BE2.png | Water
Wind BE2.png | Wind
</gallery>

== See also ==
* [[Item Frame]]
* [[Bedrock Edition unused features#Paintings|Unused paintings]]
* [[Kz.png]]
* [[Kristoffer Zetterstrand]]

== References ==
{{reflist}}

== External links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-painting Taking Inventory: Painting] – Minecraft.net on January 18, 2019

{{items}}
{{entities}}

[[cs:Obraz]]
[[de:Gemälde]]
[[es:Cuadro]]
[[fr:Tableau]]
[[hu:Festmény]]
[[it:Quadro]]
[[ja:絵画]]
[[ko:그림]]
[[nl:Schilderij]]
[[pl:Obraz]]
[[pt:Quadro]]
[[ru:Картина]]
[[th:ภาพวาด]]
[[uk:Картина]]
[[zh:画]]</li><li>[[Potato|Potato]]<br/>{{about|the raw potato|the cooked potato|Baked Potato|the potato that can inflict poison|Poisonous Potato}}
{{Item
| group = Age 0-1
| 1-1 = Potatoes Age 0-1.png
| 1-2 = Potatoes Age 0-1 BE.png
| group2 = Age 2-3
| 2-1 = Potatoes Age 4-6.png
| 2-2 = Potatoes Age 2-3 BE.png
| group3 = Age 4-6
| 3-1 = Potatoes Age 4-6.png
| 3-2 = Potatoes Age 4-6 BE.png
| group4 = Age 7
| 4-1 = Potatoes Age 7.png
| 4-2 = Potatoes Age 7 BE.png
| image = Potato JE3 BE2.png
| renewable = Yes
| heals = {{hunger|1}}
| stackable = Yes (64)
}}

A '''potato''' is a [[food]] [[item]] obtained from potato crops that can be used to plant them, consumed raw or [[cook]]ed to make [[baked potato]]es.

'''Potato crops''' are planted in [[farmland]] and used to grow potatoes and, rarely, [[Poisonous Potato|poisonous potatoes]].

== Obtaining ==

=== Natural generation ===
[[Village]] farm plots have a chance of being planted with potatoes. The exact chance depends on the style of the village:

{| class="wikitable"
! Village style !! Chance
|-
| {{EnvSprite|snowy-village}} Snowy || 70%
|-
| {{EnvSprite|plains-village}} Plains || 15%
|-
| {{EnvSprite|taiga-village}} Taiga || 10%
|}

Fully grown potato crops drop 2 to 5 potatoes ({{frac|3|5|7}} per crop harvested on average) and have a 2% chance of dropping an additional [[poisonous potato]]. Potato yield can be increased using a tool enchanted with [[Fortune]], with Fortune III harvesting an average of {{frac|5|3|7}} potatoes. [[Bone meal]] can be used to mature the potato to its last stage of growth.

The first two potatoes always drop, and then three more attempts are made to drop a potato with a success rate of 57.14286% to yield the extra 0–3 drops. Each level of Fortune enchantment increases the number of attempts by one.

=== Mob loot ===
[[Zombie]]s, [[husk]]s, and [[zombie villager]]s have a 2.5% ({{frac|1|40}}) chance of dropping either an [[iron ingot]], [[carrot]], or potato when killed by a player or tamed wolf. This is increased by 1% ({{frac|1|100}}) per level of looting. This gives potatoes the following chances of dropping:
* {{frac|1|120}} (about 0.83%)
* {{frac|7|600}} (about 1.17%) with Looting I
* {{frac|9|600}} (1.50%) with Looting II
* {{frac|11|600}} (about 1.83%) with Looting III
If a zombie, husk, or zombie villager is killed with fire, it drops a baked potato instead.

=== Chest loot ===
{{LootChestItem|potato}}

== Usage ==

=== Farming ===
{{main|Tutorials/Crop farming}}
When farmed, potatoes require 8 [[Block tick|stages]] to grow. However, there are four ''visible'' stages due to having only four distinct textures: every two stages have the same texture, except that growth stage 7 keeps the same appearance as stages 5–6, so that only stage 8 has the final, mature appearance. Planted potatoes require a light level of 9 or greater to continue growing. If the light level is 7 or below, the crops instantly un-plant themselves ("pop off"). It is not possible to plant potatoes if the light level is too low.

Crops grow faster if the farmland they are planted in is [[Farmland#Hydration|hydrated]]. Using [[bone meal]] on crops also increases the speed of growth by randomly increasing their growth stage by 2 to 5.

Crops break if pushed by a [[piston]] or if their supporting farmland breaks or turns to dirt (i.e. by being trampled), dropping their usual drops.

=== Food ===
To eat a potato, press and hold {{control|use}} while it is selected in the [[hotbar]]. Eating a potato restores {{hunger|1}} hunger and 0.6 [[Hunger#Mechanics|saturation]].

=== Breeding ===
[[Pig]]s follow and can be [[bred]] by a player holding a potato.

[[Villager]]s can pick up potato items to become willing, which allow them to breed. Villagers require 12 potatoes to become willing.

=== Smelting ingredient ===
{{Smelting
|showname=1
|Potato
|Baked Potato
|0.35
}}

=== Trading ===
Novice-level farmer villagers have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 26 potatoes for an [[emerald]] as part of their trade.

=== Composting ===
Placing a potato into a [[composter]] has a 65% chance of raising the compost level by 1. This is less efficient than composting with [[Baked Potato|baked potatoes]], which has a higher success chance of 85%.

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

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Potatoes
|spritetype=block
|nameid=potatoes
|blocktags=bee_growables, crops
|form=block}}
{{ID table
|displayname=Potato
|spritetype=item
|nameid=potato
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Potatoes
|spritetype=block
|nameid=potatoes
|id=142
|form=block}}
{{ID table
|displayname=Potato
|spritetype=item
|nameid=potato
|id=280
|form=item
|foot=1}}

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

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

== History ==
{{History|java}}
{{History||1.4.2|snap=12w34a|[[File:Potato JE1 BE1.png|32px]] Added potatoes.
|[[File:Potatoes Age 0-1 JE1.png|32px]] [[File:Potatoes Age 2-3 JE1.png|32px]] [[File:Potatoes Age 4-6 JE1.png|32px]] [[File:Potatoes Age 7 JE1.png|32px]] Added potato crops.}}
{{History|||snap=12w36a|Potatoes can now be found in [[village]]s.}}
{{History||1.5|snap=13w09b|The [[Fortune]] enchantment now works when harvesting potatoes.<ref>{{bug|MC-1680}}</ref>}}
{{History||1.8|snap=14w02a|Potatoes can now be [[trading|sold]] to farmer [[villager]]s, at 15–19 potatoes for 1 [[emerald]].}}
{{History|||snap=14w04a|Farmer villagers now harvest fully grown potatoes.
|Villagers can now be made willing using 12 potatoes.}}
{{History|||snap=14w06a|[[File:Potatoes Age 0-1 JE2.png|32px]] [[File:Potatoes Age 2-3 JE2.png|32px]] [[File:Potatoes Age 4-6 JE2.png|32px]] [[File:Potatoes Age 7 JE2.png|32px]] Potato crops are now a pixel higher - previously they were offset one pixel down as to match farmland's sunken model. This is likely an accidental result of model conversion.}}
{{History|||snap=14w10a|[[File:Missing Model JE2.png|32px]] [[File:Missing Model JE2.png|32px]] [[File:Missing Model JE2.png|32px]] [[File:Missing Model JE2.png|32px]]<br>[[File:Missing Model (anisotropic filtering) JE2.png|32px]] [[File:Missing Model (anisotropic filtering) JE2.png|32px]] [[File:Missing Model (anisotropic filtering) JE2.png|32px]] [[File:Missing Model (anisotropic filtering) JE2.png|32px]]<br>Potato crops of all stages [[Missing model|no longer have a model]].}}
{{History|||snap=14w10b|[[File:Potatoes Age 0-1 JE4.png|32px]] [[File:Potatoes Age 2-3 JE4.png|32px]] [[File:Potatoes Age 4-6 JE4.png|32px]] [[File:Potatoes Age 7 JE4.png|32px]] Potato crops now have models again.<ref>{{bug|MC-50232}}</ref> In addition, they are now offset downwards by one pixel once more.<ref>{{bug|MC-50155}}</ref>}}
{{History|||snap=14w25a|[[File:Potatoes Age 0-1 JE5.png|32px]] [[File:Potatoes Age 2-3 JE5.png|32px]] [[File:Potatoes Age 4-6 JE5.png|32px]] [[File:Potatoes Age 7 JE5.png|32px]] Potato crops are now darker and subject to directional shading.}}
{{History|||snap=14w27a|[[File:Potatoes Age 0-1 JE6.png|32px]] [[File:Potatoes Age 2-3 JE6.png|32px]] [[File:Potatoes Age 4-6 JE6.png|32px]] [[File:Potatoes Age 7 JE6.png|32px]] Potato crops are no longer subject to directional shading.}}
{{History||1.9|snap=15w31a|Potatoes can now be used to lead and breed [[pig]]s.}}
{{History|||snap=15w38a|The [[drop]] chances of potatoes has now been slightly improved from average {{frac|2|3|5}} per potato crop harvested to {{frac|2|5|7}}.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this block's numeral ID was 142, and the item's 392.}}
{{History|||snap=18w11a|Potatoes now have a chance of generating in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Potato JE2.png|32px]] The texture of potatoes has been changed.
|[[File:Potatoes Age 0-1 JE7.png|32px]] [[File:Potatoes Age 2-3 JE7.png|32px]] [[File:Potatoes Age 4-6 JE7.png|32px]] [[File:Potatoes Age 7 JE7.png|32px]] The textures of potato crops have been changed.}}
{{History|||snap=18w47a|Potatoes now generate in [[pillager outpost]] chests.}}
{{History|||snap=18w48a|Potatoes can now be found in chests in [[plains]] village houses.}}
{{History|||snap=18w49a|Potatoes can now be found in chests in [[snowy tundra|snowy]] village houses.}}
{{History|||snap=18w50a|Potatoes can now be found in chests in [[taiga]] village houses.
|[[File:Potato JE3 BE2.png|32px]] The texture of potatoes has been changed, once again.}}
{{History|||snap=19w03a|Added placement and new breaking [[sound]]s to potatoes.
|Placing a potato into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Potatoes now have a 65% chance of increasing the compost level in a composter by 1.}}
{{History||1.15|snap=19w34a|[[Bee]]s can now pollinate potato crops.}}
{{History||1.17|snap=21w13a|[[File:Potatoes Age 0-1 JE8.png|32px]] [[File:Potatoes Age 2-3 JE8.png|32px]] [[File:Potatoes Age 4-6 JE8.png|32px]] [[File:Potatoes Age 7 JE8.png|32px]] The "crop" template model has changed such that pixels appear in the same physical positions on opposite sides of texture planes, changing the potato crop's appearance in the process.<ref>{{bug|MC-199242}}</ref>}}

{{History|pocket alpha}}
{{History||v0.8.0|snap=build 1|[[File:Potato JE1 BE1.png|32px]] Added potatoes.
|[[File:Potatoes Age 0-1 JE6 BE1.png|32px]] [[File:Potatoes Age 2-3 JE6 BE1.png|32px]] [[File:Potatoes Age 4-6 JE6 BE1.png|32px]] [[File:Potatoes Age 7 JE6 BE1.png|32px]]{{verify|Correct models?}} Added potato crops.
|Potatoes are a rare [[drops|drop]] from killing [[zombie]]s.}}
{{History|||snap=build 3|Potatoes now have a chance to drop when tilling [[grass block]]s.}}
{{History|||snap=build 4|Potatoes are no longer dropped from tilling grass blocks.}}
{{History||v0.9.0|snap=build 1|Potato crops now naturally spawn in [[village]]s.
|Potatoes can now be used to lead and breed [[pig]]s.}}
{{History||v0.12.1|snap=build 1|Potatoes now restore [[hunger]] instead of [[health]].
|Farmer (profession) [[villager]]s now plant and harvest potatoes.}}
{{History||v0.16.2|Potatoes can now be found in the [[chest]] inside large houses in [[ice plains]] and [[cold taiga]] [[village]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|Potatoes can now be found in [[pillager outpost]]s and [[plains]] [[village]] houses.
|[[File:Potato JE3 BE2.png|32px]] The texture of potatoes has been changed.
|[[File:Potatoes Age 0-1 JE7.png|32px]] [[File:Potatoes Age 2-3 JE7.png|32px]] [[File:Potatoes Age 4-6 JE7.png|32px]] [[File:Potatoes Age 7 JE7.png|32px]]{{verify|Correct models?}} The textures of potato crops have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Potatoes can now be used to fill up [[composter]]s.
|Potatoes can now be found in [[taiga]], [[snowy taiga]] and [[snowy tundra]] village house [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has now been changed, farmer [[villager]]s now have a 25% chance to [[trading|buy]] 26 potatoes for an [[emerald]].}}
{{History||1.14.0|snap=beta 1.14.0.1|[[Bee]]s can now pollinate potato crops.}}
{{History||?|[[File:Potatoes Age 0-1 BE.png|32px]] [[File:Potatoes Age 2-3 BE.png|32px]] [[File:Potatoes Age 4-6 BE.png|32px]] [[File:Potatoes Age 7 BE.png|32px]] Potato crop planes use a mapping that results in very unnatural mirroring when viewed from certain angles, such as northwest.<ref>{{bug|MCPE-146936}}</ref>}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Potato JE1 BE1.png|32px]] Added potatoes.
|[[File:Potatoes Age 0-1 JE6 BE1.png|32px]] [[File:Potatoes Age 2-3 JE6 BE1.png|32px]] [[File:Potatoes Age 4-6 JE6 BE1.png|32px]] [[File:Potatoes Age 7 JE6 BE1.png|32px]]{{verify|Correct models?}} Added potato crops.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Potato JE3 BE2.png|32px]] The texture of potatoes has been changed.
|[[File:Potatoes Age 0-1 JE7.png|32px]] [[File:Potatoes Age 2-3 JE7.png|32px]] [[File:Potatoes Age 4-6 JE7.png|32px]] [[File:Potatoes Age 7 JE7.png|32px]]{{verify|Correct models?}} The textures of potato crops have been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Potato JE1 BE1.png|32px]] Added potatoes.
|[[File:Potatoes Age 0-1 JE6 BE1.png|32px]] [[File:Potatoes Age 2-3 JE6 BE1.png|32px]] [[File:Potatoes Age 4-6 JE6 BE1.png|32px]] [[File:Potatoes Age 7 JE6 BE1.png|32px]]{{verify|Correct models?}} Added potato crops.}}
{{History|foot}}

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

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
AllSeeds.png|All the seeds that exist in the game (except [[Pitcher Plant|seeds fr]][[Torchflower Seeds|om 1.20,]] [[nether wart]] and [[cocoa beans]]).
VillageGrowingCarrotsAndPotatoes.png|[[Carrot]]s and potatoes found growing naturally in a [[village]].
File:Hot Potato.jpeg|Official render of a potato to celebrate National Potato Day.<ref> https://twitter.com/Minecraft/status/1692969488617029859?s=20| Hot potato! @ a friend to toss it.</ref>
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--potato Taking Inventory: Potato] – Minecraft.net on December 16, 2021

{{items}}
{{blocks|vegetation}}

[[Category:Plants]]
[[Category:Food]]
[[Category:Renewable resources]]
[[Category:Non-solid blocks]]
[[Category:Generated structure blocks]]

[[cs:Brambora]]
[[de:Kartoffel]]
[[es:Patata]]
[[fr:Pomme de terre]]
[[hu:Burgonya]]
[[it:Patata]]
[[ja:ジャガイモ]]
[[ko:감자]]
[[nl:Aardappel]]
[[pl:Ziemniak]]
[[pt:Batata]]
<br />
[[ru:Картофель]]
[[th:มันฝรั่ง]]
[[uk:Картопля]]
[[zh:马铃薯]]</li></ul>
build 1Chunk jittering at extreme coordinates no longer occur.
0.16.0
{{Extension DPL}}<ul><li>[[White Dye|White Dye]]<br/>{{Item
| image = White Dye.png
| renewable = Yes
| stackable = Yes (64)
}}

'''White dye''' is a [[Dye#Primary|primary color dye]] similar to [[bone meal]].

== Obtaining ==
=== Crafting ===
{{Crafting
 |showname=0
 |Bone Meal
 |Output=White Dye
 |type=Material
 |head=1
}}
{{Crafting
 |Lily of the Valley
 |Output=White Dye
 |type=Material
 |foot=1
}}

=== Loot chest ===
{{#invoke:LootChest|base3|white-dye}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===

Apprentice-level shepherd villagers have a 20% chance to buy 12 white dye for an emerald.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=White Dye
|spritetype=item
|nameid=white_dye
|aliasid=dye / 19
|id=410
|form=item
|translationkey=item.dye.white_new.name
|foot=1}}

== History ==

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

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:White Dye JE1 BE1.png|32px]] Added white dye.}}
{{History||1.9.0|snap=beta 1.9.0.0|Added [[flower|lilies of the valley]], which can be used to [[crafting|craft]] white dye.}}
{{History||1.11.0|snap=beta 1.11.0.4|White dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of white dye has been changed from <code>dye/19</code> to <code>white_dye</code>.}}

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

== Issues ==
{{issue list}}


{{Items}}

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

[[de:Weißer Farbstoff]]
[[es:Tinte blanco]]
[[fr:Teinture blanche]]
[[ja:白色の染料]]
[[ko:하얀색 염료]]
[[pl:Biały barwnik]]
[[pt:Corante branco]]
[[zh:白色染料]]</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>
build 1Access to the Far Lands without modifying the game is feasible, due to the addition of the /tp command.
Bedrock Edition
1.16.0
{{Extension DPL}}<ul><li>[[Glow Stick|Glow Stick]]<br/>{{stub}}
{{education feature}}
{{Item
| image = White Glow Stick.png
| extratext = View [[#Gallery|all renders]]
| renewable = No
| durability = 95
| stackable = No
}}
'''Glow sticks''' are [[Chemistry Update|chemistry]]-related [[item]]s, which can be lit up in the player's hand for a limited time.

== Obtaining ==
{{iN|be}}, glow sticks cannot be obtained by the {{cmd|give}} command. They also cannot be obtained in [[Survival]]. Cheats must be enabled to obtain glow sticks in Survival mode, or in [[Minecraft Education]].

=== Crafting ===

{{Crafting
|showdescription=1
|ingredients=[[Polyethylene]] +<br>[[Hydrogen Peroxide]] +<br>Matching [[Dye]] +<br>[[Luminol]]
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= White Dye; Orange Dye; Magenta Dye; Light Blue Dye; Yellow Dye; Lime Dye; Pink Dye; Gray Dye; Cyan Dye; Purple Dye; Blue Dye; Brown Dye; Green Dye; Red Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
|description={{only|bedrock|education}}
|type= Miscellaneous
}}

<div style="display:none">

<!--
    This is so the pre-Village & Pillage dyes can have dye-related crafting recipes show on their respective pages.
    They don't need to be displayed on this page because they already intuitively list "Any Matching Dye".
-->

{{Crafting
|showdescription=1
|ingredients=[[Polyethylene]] +<br>[[Hydrogen Peroxide]] +<br>Matching [[Dye]] +<br>[[Luminol]]
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= Bone Meal; Lapis Lazuli; Cocoa Beans  
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= White Glow Stick; Blue Glow Stick; Brown Glow Stick
|description={{only|bedrock|Education}}
|type= Miscellaneous
}}
</div>

== Usage ==

While equipped, [[player]]s can {{control|use}} glow sticks to shake them, causing them to appear bright regardless of the [[light]] level. This is only an aesthetic change, as no light is emitted to the surrounding area. A [[particle]] effect is visible until the [[durability]] runs out. The glow stick's durability depletes while lit{{Info needed}}, in both Survival and Creative modes.

== Sounds ==
{{Sound table
|type=bedrock
|sound=Flint and steel click.ogg
|source=block
|description=While a glowstick is being activated
|id=fire.ignite
|volume=1.0
|pitch=0.5/0.7
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Glow Stick
|spritename=glow-sticks
|spritetype=item
|nameid=glow_stick
|id=601
|form=item
|translationkey=item.glow_stick.black.name,item.glow_stick.red.name,item.glow_stick.green.name,item.glow_stick.brown.name,item.glow_stick.blue.name,item.glow_stick.purple.name,item.glow_stick.cyan.name,item.glow_stick.silver.name,item.glow_stick.gray.name,item.glow_stick.pink.name,item.glow_stick.lime.name,item.glow_stick.yellow.name,item.glow_stick.lightBlue.name,item.glow_stick.magenta.name,item.glow_stick.orange.name,item.glow_stick.white.name
|foot=1}}

===Metadata===
{{/DV}}

===Item data===

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

== History ==

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:White Glow Stick.png|32px]] [[File:Orange Glow Stick.png|32px]] [[File:Magenta Glow Stick.png|32px]] [[File:Light Blue Glow Stick.png|32px]] [[File:Yellow Glow Stick.png|32px]] [[File:Lime Glow Stick.png|32px]] [[File:Pink Glow Stick.png|32px]] [[File:Gray Glow Stick.png|32px]] [[File:Cyan Glow Stick.png|32px]] [[File:Purple Glow Stick.png|32px]] [[File:Blue Glow Stick.png|32px]] [[File:Brown Glow Stick.png|32px]] [[File:Green Glow Stick.png|32px]] [[File:Red Glow Stick.png|32px]] Added glow sticks.}}
{{History||1.14.60|snap=?|Making a glow stick results in an edible item called {{code|item.glow_stick.black.name}}.}}
{{History||?|Making a glow stick results in correct items again.
|Making a glow stick with dye has been made an upgrade{{info needed|what is this supposed to mean?}}
|Putting 2 glow sticks in a Crafting Table now outputs a correct glow stick.}}
{{History||1.17.0|snap=?|[[File:Missing Glow Stick.png|32px]] Two black glow sticks, using the [[missing texture]] if Education Edition is disabled, now generate in fake end portal rooms in [[mansion]]s instead of [[ender pearl]]s.}}
{{h||1.18.0|snap=beta 1.18.0.21|Glow sticks no longer generate in [[woodland mansion]]s.}}

{{History|education}}
{{History||1.0.27|[[File:White Glow Stick.png|32px]] [[File:Orange Glow Stick.png|32px]] [[File:Magenta Glow Stick.png|32px]] [[File:Light Blue Glow Stick.png|32px]] [[File:Yellow Glow Stick.png|32px]] [[File:Lime Glow Stick.png|32px]] [[File:Pink Glow Stick.png|32px]] [[File:Gray Glow Stick.png|32px]] [[File:Cyan Glow Stick.png|32px]] [[File:Purple Glow Stick.png|32px]] [[File:Blue Glow Stick.png|32px]] [[File:Brown Glow Stick.png|32px]] [[File:Green Glow Stick.png|32px]] [[File:Red Glow Stick.png|32px]] Added glow sticks.}}
{{History|foot}}

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

== Trivia ==
* The glowing reaction of [[Wikipedia:Luminol|Luminol]] during oxidation exists in real life. It is used for detecting blood in crime scenes.
* Players cannot enchant glow sticks with Unbreaking or Mending, despite the items having [[durability]].
* The black and light gray glow sticks use the same texture as the red glow stick.{{verify|It seems they use the missing texture instead. Was this the case beforehand, and they only started using the missing texture later?}}

== Issues ==
{{issue list}}

{{items}}
{{Education Edition}}

[[Category:Non-renewable resources]]
[[Category:Education Edition items]]

[[de:Knicklicht]]
[[ja:ケミカルライト]]
[[ko:발광봉]]
[[pt:Graveto Brilhante]]
[[ru:Химический источник света]]
[[zh:荧光棒]]</li><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}

'''Sugar cane''' is a block found as 1–4-block-tall. It plants near water in the [[Overworld]]. As an item, it is an important crafting ingredient.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

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

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

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li></ul>
?The Far Lands in the Overworld generate without the Skygrid.

Issues

The world at excessive coordinates is not supported, and as such issues related to the Far Lands may not be fixed. This is because such issues would affect only players who intentionally teleport to high coordinates, and they are difficult to fix because they are a limitation of the game engine itself.[6]

Trivia

  • The Far Lands make an appearance in Minecraft: Story Mode, where it is the location of The Maze and Ivor's Cottage.

Gallery

In other media

Minecraft: Story Mode

References

Advertisement