Minecraft Wiki
Advertisement

<player>.dat files are used by servers to store the state of individual players. The format is also used within level.dat files to store the state of the singleplayer player, which overrides any <player>.dat files with the same name as the singleplayer player. These files are in NBT format.

NBT structure

  • The root tag. In level.dat files, this tag is called "Player".
    • All tags from Entities except the id, CustomName, and CustomNameVisible tags.
    • All tags from Mobs except Equipment, DropChances, CanPickUpLoot, PersistenceRequired, Leashed, and Leash.
    •  DataVersion: Version of the player NBT structure.
    •  Dimension: The dimension the player is in. -1 is the Nether, 0 is the Overworld, 1 is the End. Other values are interpreted as 0.
    •  playerGameType: The game mode of the player. 0 is Survival, 1 is Creative, 2 is Adventure and 3 is Spectator.
    •  Score: The Score displayed upon death.
    •  SelectedItemSlot: The selected hotbar slot of the player.
    •  SelectedItem: Data of the item currently being held by the player, excluding the Slot tag.
    •  SpawnX: See below.
    •  SpawnY: May not exist. The coordinates of the player's bed. These tags are only removed if the player attempts to respawn with no valid bed to spawn at at these coordinates. They are unaffected by breaking beds at these coordinates, and are unaffected by the player's death.
    •  SpawnZ: See above.
    •  SpawnForced: 1 or 0 (true/false) - True if the player should spawn at the above coordinates even if no bed can be found.
    •  Sleeping: 1 or 0 (true/false) - true if the player was in a bed; has no effect on whether the player is in a bed when they log in.
    •  SleepTimer: The number of ticks the player had been in bed. No effect.
    •  foodLevel: The value of the hunger bar; 20 is full. See Hunger.
    •  foodExhaustionLevel: See Hunger.
    •  foodSaturationLevel: See Hunger.
    •  foodTickTimer: See Hunger.
    •  XpLevel: The level shown on the XP bar.
    •  XpP: The progress/percent across the XP bar to the next level.
    •  XpTotal: The total amount of XP the player has collected over time; used for the Score upon death.
    •  XpSeed: The seed used for the next enchantment in enchantment tables.
    •  Inventory: Each compound tag in this list is an item in the player's inventory. (Note: when empty, list type may have unexpected value.
    •  EnderItems: Each compound tag in this list is an item in the player's 27-slot ender chest inventory. (Note: when empty, list type may have unexpected value.)
      • An item in the inventory, includes the Slot tag - slots are numbered 0 to 26, inclusive.
    •  abilities: The abilities this player has.
      •  walkSpeed: The walking speed, always 0.1.
      •  flySpeed: The flying speed, always 0.05.
      •  mayfly: 1 or 0 (true/false) - true if the player can fly.
      •  flying: 1 or 0 (true/false) - true if the player is currently flying.
      •  invulnerable: 1 or 0 (true/false) - true if the player is immune to all damage and harmful effects except for void damage. (damage caused by the /kill command is void damage)
      •  mayBuild: 1 or 0 (true/false) - true if the player can place and destroy blocks.
      •  instabuild: 1 or 0 (true/false) - true if the player can instantly destroy blocks.
    •  RootVehicle(since 15w41a): The root entity that the player is riding.
      •  AttachLeast: The UUIDLeast of the entity the player is riding.
      •  AttachMost: The UUIDMost of the entity the player is riding.
      •  Entity: The NBT data of the root vehicle.

Item structure

Items are used both in the player's inventory and Ender inventory, and in chest tile entities, dropped item entities, furnace tile entities, brewing stand tile entities, and Villager trading recipes. Sometimes a Slot tag is used to specify the slot the item is in, such as with chests; other times there is no Slot tag, such as with dropped items.

  • The item's root tag. Some instances may give this tag a name, other times it is nameless because it is in a list.
    •  Count: Number of items stacked in this inventory slot. Any item can be stacked, including tools, armor, and vehicles. Range is -128 to 127. Values of 1 are not displayed in-game. Values below 1 are displayed in red.[note 1]
    •  Slot: May not exist. The inventory slot the item is in.
    •  Damage: The data value for this item. The name "Damage" comes from when only tools used this value, now many other items use this value for other purposes. For blocks, it is the 4-bit "block data" tag that determines a variant of the block. Defaults to 0.
    •  id: Item/Block ID (This is a Short tag prior to 1.8.) If not specified, Minecraft changes the item to stone (setting ID to 1 and Damage to 0, and ignoring any existing Damage value) when loading the chunk or summoning the item .
    •  tag: Additional information about the item, discussed in the below sections. This tag is optional for most items.

General Tags

Items with durability can be made unbreakable and will never lose any durability. Additionally, items can have specifications for Adventure mode to describe which blocks may be broken with them.

  •  tag: The tag tag.
    •  Unbreakable: 1 or 0 (true/false) - if true, the item doesn't lose durability when used.
    •  CanDestroy: The only blocks this item may break when used by a player in adventure mode.
      • : The block ID.

Block Tags

Blocks can be given tags to specify what blocks they may be placed against in Adventure mode, and to specify what Tile Entity NBT tags to apply to them when placed.

  •  tag: The tag tag.
    •  CanPlaceOn: Determines which blocks that blocks with this tag can be placed against in adventure mode.
      • : The block ID.
    •  BlockEntityTag: Block entity NBT tags which are applied when this block is placed.[1] Used to store data on banners or on blocks obtained in creative by holding ctrl and pressing pick block on a block containing a block entity.

Enchantments

There are two ways enchantments are associated with items; the first way is that the item is actually enchanted and the enchantment affects the behavior of the item, and the second way is that the item is an enchanted book which simply stores the enchantments without actually affecting the behavior of the item. There is also the RepairCost tag which tracks anvil usage for items, making them more costly with every use of the anvil.

  •  tag: The tag tag.
    •  ench: Contains enchantments on this item that affect the way the item works.
      • : A single enchantment.
        •  id: ID of the enchantment.
        •  lvl: Level of the enchantment, where 1 is level 1.
    •  StoredEnchantments: Contains enchantments for enchanted books.
      • : A stored enchantment, identical structure to each enchantment in ench.
    •  RepairCost: Number of enchantment levels to add to the base level cost when repairing, combining, or renaming this item with an Anvil.

StoredEnchantments tooltips will not be displayed if edited onto an item other than an enchanted book. Enchantments stored in ench, however, will always be displayed in the tooltip and will cause the item to glow, even if they cannot have any effect.

Attribute Modifiers

All items can be given Modifiers which affect various Attributes of the player/mob which wears or holds them. Note that if an item has vanilla default AttributeModifiers, these will cease to exist if this tag is added (e.g. a Diamond Sword given an empty AttributeModifiers list will no longer provide a boost to damage). Also note that the default vanilla AttributeModifiers do not actually use this tag, and as such, it will not appear on a natural item.

  •  tag: The tag tag.
    •  AttributeModifiers: Contains Attribute Modifiers on this item which modify Attributes of the wearer or holder (if the item is not in the hand or armor slots, it will have no effect).
      • : A single Attribute Modifier.
        •  AttributeName: The name of the Attribute this Modifier is to act upon.
        •  Name: Name of the Modifier
        •  Slot: Slot the item must be in for the modifier to take effect. "mainhand", "offhand", "feet", "legs", "chest", or "head".
        •  Operation: Modifier Operation. See Attribute Modifiers for info.
        •  Amount: Amount of change from the modifier.
        •  UUIDMost: Uppermost bits of the modifier's UUID.
        •  UUIDLeast: Lowermost bits of the modifier's UUID.

Potion Effects

Potions, splash potions, lingering potions and tipped arrows (since 15w31a) can have multiple, customized effects via the tag tag, bypassing using the data value of the item. The data value is used only for the way the potion looks if these tags are present.

  •  tag: The tag tag.
    •  CustomPotionEffects: The custom Potion effects this potion has.
      • One of these for each effect.
        •  Id: The ID of the effect.
        •  Amplifier: The amplifier of the effect, with 0 being level 1.
        •  Duration: The duration of the effect in ticks.
        •  Ambient: 1 or 0 (true/false) - whether or not this is an effect provided by a beacon and therefore should be less intrusive on the screen. This tag is optional and defaults to 0. Due to a bug, it has no effect on splash potions.
        •  ShowParticles: 1 or 0 (true/false) - whether or not this effect produces particles. This tag is optional and defaults to 1. Due to a bug, it has no effect on splash potions.
    •  Potion (since 15w31a): The name of the default potion effect. This name differs from the potion effect name. For example, the value for an "Instant Health II" potion is "minecraft:strong_healing".

Display Properties

Leather armor can be colored, and all items can have custom display names and lore. Various tooltips can also be hidden.

  •  tag: The tag tag.
    •  display: Display properties.
      •  color: The color of the leather armor. Color codes are calculated from the Red, Green and Blue components using this formula:
        Red<<16 + Green<<8 + Blue[note 2] If this is specified for an item other than leather armor, the tooltip will say "Dyed" but the appearance won't be affected. Note that in the 1.9 snapshots, the "Dyed" tooltip is not shown.
      •  Name: The name to display for an item.
      •  Lore: List of strings to display as lore for the item.[2]
        • A line of text for the lore of an item.
    •  HideFlags: Bit field determining which parts of the tooltip to hide on an item. 1 for "ench", 2 for "AttributeModifiers", 4 for "Unbreakable", 8 for "CanDestroy", 16 for "CanPlaceOn", and 32 for various other information (including potion effects, "StoredEnchantments", written book "generation" and "author", "Explosion", "Fireworks", and map tooltips). For example, setting to 3 would hide both "ench" and "AttributeModifiers" tags, and setting to 63 would hide everything.

Written Books

Both book and quill and written book use the tag tag to store information about the book. Only written books store the title, author, and generation of the book; pages is stored in both varieties.

  •  tag: The tag tag.
    •  resolved: Optional. Created and set to 1 when the book (or a book from the stack) is opened for the first time after signing. Used to determine whether to parse target selectors (including which player is selected by {score:{name:"*", ...}}) within JSON, because their selections become fixed at that point.
    •  generation: The copy tier of the book. 0 = original, 1 = copy of original, 2 = copy of copy, 3 = tattered. If the value is greater than 1, the book cannot be copied. Does not exist for original books. If this tag is missing, it is assumed the book is an original.
    •  author: The author of the written book.
    •  title: The title of the written book.
    •  pages: The list of pages in the book.
      • A single page in the book. If generated by writing in a book and quill in-game, each page is a string in double quotes and uses the escape sequences \" for a double quote, \n for a line break and \\ for a backslash. If created by commands or external tools, a page can be a serialized JSON object or an array of strings and/or objects (see Commands#Raw JSON text) or an unescaped string.

Player Heads

Heads of the player variety can be associated with a specific username to take on the skin of that player when placed. The hand-held item is also updated with the new skin. Within this section, the "owner" of a head means the player whose head it is a copy of, and a player whose inventory contains a head is called the "holder".

  •  tag: The tag tag.
    •  SkullOwner: The username of the player this is a skull of for pre-1.8. Note that SkullOwner is for the item in inventories, whereas ExtraType is for skull blocks placed on the ground.[3]
    •  SkullOwner: 1.8's definition for the skull's owner. Note that Owner is used for skulls placed on the ground.
      •  Id: UUID of owner. Optional. Used to update the other tags when the chunk loads or the holder logs in, in case the owner's name has changed.
      •  Name: Username of owner. If missing or empty, the head will appear as a Steve head. Otherwise, used to store or retrieve the downloaded skin in the cache. Need not be a valid player name, but must not be all spaces.
      •  Properties
        •  textures
          • : An individual texture.
            •  Signature: Optional.
            •  Value: A Base64-encoded JSON object.[4]
              •  timestamp: Optional: Unix time in milliseconds.
              •  profileId: Optional: Player UUID without hyphens.
              •  profileName: Optional: Player name.
              •  isPublic: Optional.
              •  textures
                •  SKIN
                  •  url: URL of a player skin on textures.minecraft.net.[note 3]
                •  CAPE: Optional.
                  •  url: URL of a player cape (64x32 PNG).

Fireworks

Fireworks use the tag tag to store information about their effects.

  •  tag: The tag tag.
    •  Explosion: One of these may appear on a firework star.
      •  Flicker: 1 or 0 (true/false) - true if this explosion will have the Twinkle effect (glowstone dust). May be absent.
      •  Trail: 1 or 0 (true/false) - true if this explosion will have the Trail effect (diamond). May be absent.
      •  Type: The shape of this firework's explosion. 0 = Small Ball, 1 = Large Ball, 2 = Star-shaped, 3 = Creeper-shaped, 4 = Burst. Other values will be named "Unknown Shape" and render as Small Ball.
      •  Colors: Array of integer values corresponding to the primary colors of this firework's explosion. If custom color codes are used, the game will render it as "Custom" in the tooltip, but the proper color will be used in the explosion. Custom colors are integers in the same format as the color tag from Display Properties.
      •  FadeColors: Array of integer values corresponding to the fading colors of this firework's explosion. Same handling of custom colors as Colors. May be absent.
    •  Fireworks: One of these may appear on a firework rocket.
      •  Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). While this value can be anything from -128 to 127, values of -2 and under almost never detonate at all.
      •  Explosions: List of compounds representing each explosion this firework will cause.
        • Same format as 'Explosion' compound on a firework star, as described above.

Armor Stands and Spawn Eggs(since 15w33a)

Armor stands and Spawn Eggs(since 15w33a) may contain potential entity data.

  •  tag: The tag tag.
    •  EntityTag: Stores entity data that is applied to the armor stand when placed or entity when spawned.

= Maps

Maps may be scaled.

  •  tag: The tag tag.
    •  map_is_scaling: 1 or 0 (true/false) - true if map is scaled. May not exist if map is not scaled. Map number is stored as Damage, scale value is stored in Map item format.
    •  Decorations: A list of optional decorations. It will display defined symbols on the map
      • An individual Decoration
        •  id: Identifier of the symbols
        •  type: Type of the symbol (see texture/map/map_icons.png)
        •  x: X position
        •  z: Z position
        •  rot: Rotation of the symbols

Notes

  1. A value of zero means the item will disappear when you try to use or drop it, but it can still be crafted with, or fired in the case of arrows, as though it were a stack of 1. A negative value is similar except that the item can be used by right-clicking, can be used until it wears out if it is a tool or bow (but will break if you use it as a melee weapon). This can let the count go below -128, but it will wrap around (by adding the nearest multiple of 256) when the server restarts or the single-player game is saved and reopened. The same applies if two negative stacks are combined. If Q is pressed while holding a negative stack, it will drop all at once and appear as a normal dropped item, but it will be impossible to pick up. A stack of more than 64 may decrease if moved to or from a container, or the mouse pointer may drop only as many as normally fill a stack and continue to hold the remainder. A stack of N damaged tools used until "they" break will become N – 1 intact tools, but if the stack is split then both tools keep their damage.
  2. For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.
  3. Could be a URL on a non-Mojang site until 1.8.4, but couldn't be a data: or file: URI.

Inventory slot numbers

This shows the numbers used to specify the slot in the inventory while editing with an NBT editor.

In the minecraft 1.9 pre-release, the off-hand slot is #-106.

History

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

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

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

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

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

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

=== Trading ===

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

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

=== Chest loot ===

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

=== Other ===

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

== Usage ==

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

=== Dyeing wool and mobs ===

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

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

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

=== Dyeing carpets ===

Carpets can be dyed.

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

=== Dyeing terracotta ===

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

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

=== Creating concrete powder ===

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

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

=== Staining glass ===

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

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

=== Dyeing shulker boxes ===

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

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

=== Dyeing beds ===

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

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

=== Dyeing candles ===

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

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

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

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

=== Dyeing armor ===

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

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

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

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

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

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

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

=== Dyeing firework stars ===

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

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

=== Creating balloons ===

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

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

=== Creating glow sticks ===

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

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

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

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

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

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

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

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

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

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

== Video ==

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

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

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

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

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

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

==Issues==
{{issue list}}

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

== References ==
{{reflist}}

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

{{Items}}

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

[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li><li>[[Nautilus Shell|Nautilus Shell]]<br/>{{Item
| type =
| stackable = Yes (64)
| renewable = Yes
}}

A '''nautilus shell''' is an item that is used for crafting [[conduit]]s.

==Obtaining==
===Fishing===
{{main|Fishing#Junk and treasure}}
Nautilus shells can be rarely obtained as a treasure item from fishing. The drop chances of nautilus shells slightly increase with each level of [[Luck of the Sea]] on the [[player]]'s [[fishing rod]].

===Mob loot===
[[Drowned]] have a 3%{{only|java|short=1}} or 8%{{only|bedrock|short=1}} chance to spawn with a nautilus shell in their off-hand, and this nautilus shell always drops upon [[death]].

===Trading===
[[Wandering trader]]s may [[trading|sell]] a nautilus shell for 5 [[emerald]]s each, but they only sell 5 of them at a time.

==Usage==
{{IN|bedrock}}, a nautilus shell is one of the few items that can be held in the off-hand.

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

=== Trading ===
Nautilus shells can be given to trident-wielding drowned with a chance for the drowned to pick up the shell and drop the trident.<sup>[''[[Bedrock Edition]] only'']</sup>

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Nautilus Shell
|spritetype=item
|nameid=nautilus_shell
|id=570
|form=item
|foot=1}}

==History==
{{History|java}} 
{{History||1.13|snap=18w15a|[[File:Nautilus Shell JE1 BE2.png|32px]] Added nautilus shells.}}
{{History||1.14|snap=19w05a|Added [[Wandering Trader|wandering trader]]s, which sell nautilus shells.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:Nautilus Shell BE1.png|32px]] Added nautilus shells.}}
{{History|||snap=beta 1.2.20.2|[[File:Nautilus Shell JE1 BE2.png|32px]] The texture of nautilus shells has now been changed.}}
{{History||1.5.0|snap=beta 1.5.0.0|[[Drowned]] now sometimes spawn holding a nautilus shell.
|Nautilus shells are no longer behind [[Experimental Gameplay]].}}
{{History|||snap=beta 1.5.0.1|Nautilus shells can now be used to craft [[conduit]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Nautilus shells can now be obtained from [[trading]] with [[wandering trader]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Nautilus Shell JE1 BE2.png|32px]] Added nautilus shells.}}
{{History||xbox=none|ps=1.91|wiiu=none|Nautilus shells can now be obtained from [[trading]] with [[wandering trader]]s.}}
{{History|foot}}

==Issues==
{{issue list}}

==Trivia==
*[[wikipedia:Nautilus|Nautilus]]es are animals that occupy deep oceans in the real world. However, they are absent in Minecraft and there are currently no plans to add nautilus [[mob]]s into the game.
*Because {{el|bedrock}} allows for Nautilus shells to be held in the off-hand (since drowned hold them), they are the only item in that version that can be put in the off-hand slot without having a specific function.

{{items}}

[[de:Nautilusschale]]
[[es:Caparazón de nautilo]]
[[fr:Coquille de nautile]]
[[it:Conchiglia di nautilus]]
[[ja:オウムガイの殻]]
[[ko:앵무조개 껍데기]]
[[nl:Nautilusschelp]]
[[pl:Muszla łodzika]]
[[pt:Concha de náutilo]]
[[ru:Раковина наутилуса]]
[[th:เปลือกหอยงวงช้าง]]
[[uk:Мушля наутилуса]]
[[zh:鹦鹉螺壳]]
[[Category:Renewable resources]]</li></ul>
14w06aAdded CanDestroy for tools.
Added HideFlags to items.
14w07aAdded BlockEntityTag for all blocks.
14w10aAdded a 5th bit (value of 32) to HideFlags that hides potion effects.
14w33aAdded SelectedItem for all items.

References

  1. Assuming the block is of a type that creates a block entity at all. If not, BlockEntityTag has no effect.
  2. https://www.reddit.com/r/Minecraft/comments/10xlod/minecraft_snapshot_12w40a/c6hinjw?context=1
  3. https://www.reddit.com/r/Minecraft/comments/zxn7u/its_apparently_my_cakeday_so_lets_cash_in_this/
  4. FVBico and Steven W.d.V.'s comments on 51003.


Advertisement