Minecraft Wiki
Don't have an account?
Register
Register
Minecraft Wiki
Minecraft Wiki
7,425
pages
in: Java Edition, Development
English

Changes: Player.dat format

Back to page
Sign in to edit
m (→‎Item structure: Fixed capitalization again)
SPGoding (talk | contribs)
(→‎History: Add changes to Enchantments[].lvl in 1.17.1 Pre-release 1)
Line 187: Line 187:
 
{{History|||snap=19w06a|Added {{code|BlockStateTag}} for item forms of blocks.}}
  
{{History|||snap=19w06a|Added {{code|BlockStateTag}} for item forms of blocks.}}
 
{{History||1.16.2|snap=20w27a|Added Flag 64 to {{code|HideFlags}} to hide "Dyed" on [[leather armor]].<ref>{{bug|MC-49476}}</ref>}}
  
{{History||1.16.2|snap=20w27a|Added Flag 64 to {{code|HideFlags}} to hide "Dyed" on [[leather armor]].<ref>{{bug|MC-49476}}</ref>}}
  +
{{History||1.17.1|snap=1.17.1 Pre-release 1|{{code|Enchantments[].lvl}} tag is now read as short and clamped between 0 and 255.<ref>{{bug|MC-131290}}</ref>}}
 
{{History|foot}}
  
{{History|foot}}
   

Revision as of 14:54, 18 June 2021

Information icon
This feature is exclusive to Java Edition. 

<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".
    • Tags for all entities, except the id, CustomName and CustomNameVisible
    • Tags common to all entities
    • Tags for all mobs, except HandItems, ArmorItems, HandDropChances, ArmorDropChances, CanPickUpLoot, PersistenceRequired and Leash
    • Tags common to all mobs
    •  abilities: The abilities this player has.
      •  flying: 1 or 0 (true/false) - true if the player is currently flying.
      •  flySpeed: The flying speed, always 0.05.
      •  instabuild: 1 or 0 (true/false) - true if the player can instantly destroy blocks. This is true for Creative mode, and false for other game modes.
      •  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). This also makes all mobs, whether hostile or not, passive to the player. This is true for Creative and Spectator modes, and false for Survival and Adventure modes.
      •  mayBuild: 1 or 0 (true/false) - true if the player can place and destroy blocks. This is true for Creative and Survival modes, and false for Spectator and Adventure modes.
      •  mayfly: 1 or 0 (true/false) - true if the player can fly. This is true for Creative and Spectator modes, and false for Survival and Adventure modes.
      •  walkSpeed: The walking speed, always 0.1.
    •  DataVersion: Version of the player NBT structure. Is increased with every new snapshot and release.
    •  Dimension: The ID of the dimension the player is in. Used to store the players last known location along with Pos.
    •  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.
    •  enteredNetherPosition: Optional. The Overworld position from which the player entered the Nether, for use with the minecraft:nether_travel advancement trigger. The tag is set every time the player passes through a portal from the Overworld to the Nether. When entering a dimension other than the nether by not respawning, the tag is removed. Entering the Nether without using a portal does not update the tag.
      •  x: The X coordinate.
      •  y: The Y coordinate.
      •  z: The Z coordinate.
    •  foodExhaustionLevel: See Hunger.
    •  foodLevel: The value of the hunger bar; 20 is full. See Hunger.
    •  foodSaturationLevel: See Hunger.
    •  foodTickTimer: See Hunger.
    •  Inventory: Each compound tag in this list is an item in the player's inventory. (Note: when empty, list type may have unexpected value.)
    •  LastDeathLocation: May not exist. Location of the player's last death.
      •  dimension: Dimension of last death.
      •  pos: Coordinates of last death.
    •  playerGameType: The game mode of the player. 0 is Survival, 1 is Creative, 2 is Adventure and 3 is Spectator.
    •  previousPlayerGameType: The previous game mode of the player.
    •  recipeBook: Contains a JSON object detailing recipes the player has unlocked.
    •  RootVehicle: The root entity that the player is riding. Optional.
      •  Attach: The UUID of the entity the player is riding, stored as four ints.
      •  Entity: The NBT data of the root vehicle.
    •  Score: The Score displayed upon death.
    •  seenCredits: 1 or 0 (true/false) - true if the player has entered the exit portal in the End at least once.
    •  SelectedItem: Data of the item currently being held by the player, excluding the Slot tag. Only exists when using the /data command, this value is not saved in the player.dat format.
    •  SelectedItemSlot: The selected hotbar slot of the player.
    •  ShoulderEntityLeft: The entity that is on the player's left shoulder. Always displays as a parrot.
    •  ShoulderEntityRight: The entity that is on the player's right shoulder. Always displays as a parrot.
    •  SleepTimer: The number of ticks the player had been in bed. 0 when the player is not sleeping. In bed, increases up to 100, then stops. Skips the night after all players in bed have reached 100. When getting out of bed, instantly changes to 100 and then increases for another 9 ticks (up to 109) before returning to 0.
    •  SpawnDimension: May not exist. The dimension of the player's bed or respawn anchor. These tags are only removed if the player attempts to respawn with no valid bed or respawn anchor to spawn at at these coordinates. They are unaffected by breaking a bed or respawn anchor at these coordinates, and are unaffected by the player's death.
    •  SpawnForced: 1 or 0 (true/false) - may not exist. True if the player should spawn at the below coordinates even if no bed can be found.
    •  SpawnX: See below.
    •  SpawnY: May not exist. The coordinates of the player's bed or respawn anchor. These tags are only removed if the player attempts to respawn with no valid bed or respawn anchor to spawn at at these coordinates. They are unaffected by breaking a bed or respawn anchor at these coordinates, and are unaffected by the player's death.
    •  SpawnZ: See above.
    •  warden_spawn_tracker: Contains data about the warden spawning process for this player.
      •  cooldown_ticks: The number of ticks before the warning_level can be increased again. Decreases by 1 every tick. It is set to 200 game ticks (10 seconds) every time the warning level is increased.
      •  ticks_since_last_warning: The number of ticks since the player was warned for warden spawning. Increases by 1 every tick. After 12000 game ticks (10 minutes) it will be set back to 0, and the warning_level will be decreased by 1.
      •  warning_level: A warning level between 0 and 3 (inclusive). The warden will spawn at level 3.
    •  XpLevel: The level shown on the XP bar.
    •  XpP: The progress/percent across the XP bar to the next level.
    •  XpSeed: The seed used for the next enchantment in enchantment tables.
    •  XpTotal: The total amount of XP the player has collected over time; used for the Score upon death.

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 root tag.
    •  Count: Number of items stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Values below 0 cause the item to be treated as air, resulting in the item being removed.
    •  Slot: The inventory slot the item is in.
    •  id: Item/Block ID. If not specified, gets treated as air, resulting in the item being removed.
    •  tag: Additional information about the item, discussed more in the subsections of the item structure section. This tag is optional for most items. Unlike other entity or block NBT, this tag is never deserialized and can hold user defined tags that are not used by the game by standard.

General Tags

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

  •  tag: Parent tag.
    •  Damage: The number of uses consumed (not remaining) of the item's durability.
    •  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.
      • : A block ID. Validated the same way as the block_predicate command argument, meaning block states and block tags are accepted, as well as client-side only block entity NBT tags.
    •  CustomModelData: A value used in the "custom_model_data" item tag in the overrides of item models.

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: Parent tag
    •  CanPlaceOn: Determines which blocks that blocks with this tag can be placed against in adventure mode.
      • : A block ID. Validated the same way as the block_predicate command argument, meaning block states and block tags are accepted, as well as client-side only block entity NBT tags.
    •  BlockEntityTag: Block entity NBT tags which are applied when this block is placed.[1] Used to store data on banners and shields or on blocks obtained in creative by holding ctrl (or ⌘ Cmd on mac) and pressing pick block on a block containing a block entity.
    •  BlockStateTag: A compound where each key is a block state key, and the value is the block state value to force place for this block.
      •  Block state key: The block state value of the block to edit, for example, facing: "east".

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: Parent tag.
    •  Enchantments: Contains enchantments on this item that affect the way the item works.
      • : A single enchantment.
        •  id: The name of the enchantment.
        •  lvl: The level of the enchantment, where 1 is level 1. Values are clamped between 0 and 255 when reading.
    •  StoredEnchantments: Contains enchantments for enchanted books.
      • : A stored enchantment, identical structure to each enchantment in Enchantments.
    •  RepairCost: Number of experience levels to add to the base level cost when repairing, combining, or renaming this item with an Anvil.

StoredEnchantments tooltips are not displayed if edited onto an item other than an enchanted book. Enchantments stored in Enchantments, however, are always displayed in the tooltip and 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 or mob wearing or holding them. Note that if an item has default attribute modifiers, these cease to exist if this tag is added (e.g. a diamond sword given an empty AttributeModifiers list no longer provides a boost to damage). Also note that default attribute modifiers do not use this tag, and as such, it does not appear on a natural item.

  •  tag: Parent 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 has no effect).
      • : A single Attribute Modifier.
        •  AttributeName: The name of the Attribute this Modifier is to act upon.
        •  Name: The name of the Modifier. Has no known effect.
        •  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.
        •  UUID: The modifier's UUID, stored as four ints. Used when equipping and unequipping the item to identify which modifier to add or remove from the entity.

Potion Effects

Potions, splash potions, lingering potions, and tipped arrows can have multiple, customized effects via the CustomPotionEffects tag. These effects are added to the default effect under the Potion tag if present. In addition the color can be overridden with the CustomPotionColor tag.

  •  tag: Parent tag.
    •  custom_potion_effects: The custom potion effects (status effects) this potion or tipped arrow has.
      • One of these for each effect.
        •  id: The resource location of the effect.
        •  amplifier: The amplifier of the effect, with level I having value 0. Negative levels are discussed here. Optional, and defaults to level I.
        •  duration: The duration of the effect in ticks. Values 0 or lower are treated as 1. Optional, and defaults to 1 tick.
        •  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. Optional, and defaults to false.
        •  show_particles: 1 or 0 (true/false) - whether or not this effect produces particles. Optional, and defaults to true.
        •  show_icon: 1 or 0 (true/false) - true if effect icon is shown. false if no icon is shown.
    •  Potion: The name of the default potion effect. This name differs from the status effect name. For example, the value for an "Instant Health II" potion is "minecraft:strong_healing". A potion or tipped arrow getting its effects from this tag is named with the proper effect. The default value is "minecraft:empty", which gives it the "Uncraftable" name.
    •  CustomPotionColor: The item uses this custom color, and area-of-effect clouds, arrows, and splash and lingering potions use it for their particle effects. This color does not extend, however, to the particles given off by entities who ultimately receive the effect. The numeric color codes are equal to the hex code of the color converted to a decimal number, or can alternatively be calculated from the Red, Green and Blue components using this formula: Red<<16 + Green<<8 + Blue. For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.

Crossbows

Crossbows use NBT data to save what item is charged in the crossbow

  •  tag: Parent tag.
    •  ChargedProjectiles: The items this crossbow has charged, normally one entry (three if enchanted with multishot)
      • : A charged item.
        • Tags common to all items
    •  Charged: If the crossbow is charged.

Display Properties

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

  •  tag: Parent tag.
    •  display: Display properties.
      •  color: The color of the leather armor. The tooltip displays "Dyed" if advanced tooltips are disabled, otherwise it displays the hexadecimal color value. Color codes are the hex code of the color converted to a decimal number, or can be calculated from the Red, Green and Blue components using this formula:
        Red<<16 + Green<<8 + Blue[2]
      •  Name: The JSON text component to use to display the item.
      •  Lore: List of strings to display as lore for the item.
        • A JSON text component representing 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 "Enchantments", 2 for "AttributeModifiers", 4 for "Unbreakable", 8 for "CanDestroy", 16 for "CanPlaceOn", 32 for various other information (including potion effects, "StoredEnchantments", written book "generation" and "author", "Explosion", "Fireworks", amount of items in a bundle, and map tooltips), 64 for "Dyed" on leather armor, and 127 for armor trim information. For example, setting to 3 (1 + 2) would hide both "Enchantments" (1) and "AttributeModifiers" (2) tags, and setting to 127‌[until JE 1.20]/255‌[upcoming: JE 1.20] would hide everything.

Written Books

Written books use NBT data to save their contents as well as miscellaneous extra information.

  •  tag: Parent tag.
    •  filtered_pages: [needs testing]
    •  filtered_title: [needs testing]
    •  resolved: Optional. Created and set to 1 when the book (or a book from the stack) is opened for the first time after being created. Used to determine whether to resolve advanced components within JSON, because their values become fixed at that point.
    •  generation: Optional. 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. 'Tattered' is unused in normal gameplay, and functions identically to the 'copy of copy' tier.
    •  author: The author of the written book.
    •  title: The title of the written book. Lower priority than the item name set by tag.display.Name. Can not be used to open locked containers.
    •  pages: The list of pages in the book.
      • : A single page in the book. Each page is a serialized JSON text.

Book and Quills

Book and quills use NBT data to save their contents.

  •  tag: Parent tag.
    •  pages: The list of pages in the book.
      • : A single page in the book. Each page is a string and uses the escape sequence \n for a line break. However, the command parser does not accept \n, so line breaks need to be set by a player or using loot tables.

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: Parent tag.
    •  SkullOwner: The username of the player this is a skull of. This gets converted to the compound version on almost any action.
    •  SkullOwner: Different definition for the skull's owner.
      •  Id: UUID of owner, stored as four ints. 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 appears 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.
            •  Value: A Base64-encoded JSON object.
              •  isPublic: Optional.
              •  signatureRequired
              •  profileId: Optional: The hexadecimal text form of the player's UUID, without hyphens.
              •  profileName: Optional: Player name.
              •  textures
                •  CAPE: Optional.
                  •  url: URL of a player cape (64x32 PNG).
                •  SKIN
                  •  url: URL of a player skin on textures.minecraft.net.
                  •  metadata
                    •  model: The model of the player skin. Can be "classic" or "slim".
              •  timestamp: Optional: Unix time in milliseconds.
            •  Signature: Optional.

Firework Rockets

Firework rockets use the tag tag to store information about their effects.

  •  tag: Parent tag.
    •  Fireworks: One of these may appear on a firework rocket.
      •  Explosions: List of compounds representing each explosion this firework causes.
        • : A firework explosion.
          • Tags common to all firework explosion effects
      •  Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). Can be anything from -128 to 127.

Firework Stars

Firework stars use the tag tag to store information about their effects.

  •  tag: Parent tag.
    •  Explosion: The explosion effect contributed by this firework star.
      • Tags common to all firework explosion effects

Armor Stands and Spawn Eggs

Armor stands and spawn eggs may contain potential entity data.

  •  tag: Parent tag.
    •  EntityTag: Stores entity data that is applied to the entity when created.

Buckets of Fish

Buckets of fish may contain potential entity data.

  •  tag: Parent tag.
    •  BucketVariantTag: The variant data of the tropical fish in the bucket. Applies only to Bucket of Tropical Fish.
    •  EntityTag: Stores entity data that is applied to the aquatic mob when it is poured out. If this data includes a tropical fish variant, it overrides the one provided in BucketVariantTag.

Maps

Maps may be scaled.

  •  tag: Parent tag.
    •  map: The map number.
    •  map_scale_direction: Only internally used when scaling a map, after that directly removed: The amount to increase the current map scale by when crafting. Always 1.
    •  map_to_lock: 1 or 0 (true/false) - true if the map should be locked after being taken out of the cartography table. Only internally used when locking a map, after that directly removed.
    •  Decorations: A list of optional icons to display on the map. Decorations that are removed or modified do not update until the world is reloaded.
      • An individual decoration.
        •  id: An arbitrary unique string identifying the decoration.
        •  type: The ID of the map icon to display.
        •  x: The world X position of the decoration.
        •  z: The world Z position of the decoration.
        •  rot: The rotation of the symbol, ranging from 0.0 to 360.0, measured clockwise. A rotation of 0 displays the icon upside-down compared to its appearance in the icon texture.
    •  display: The display tag.
      •  MapColor: The color of the markings on the item's texture.

Suspicious Stew

Suspicious stews store their potion effects.

  •  tag: Parent tag.
    •  Effects: The status effects this suspicious stew has.
      • One of these for each effect.
        •  EffectId: The numeric ID of the effect.
        •  EffectDuration: The duration of the effect in ticks. Values 0 or lower are treated as 1. Optional, and defaults to 160 ticks (8 seconds).

Debug Sticks

Debug sticks use the NBT to save the block state to edit for each block.

  •  tag: Parent tag.
    •  DebugProperty: A compound where each key is a block ID, and the value is the block state key to edit for that block ID. Block tags are not supported.
      •  Block ID: The block state key of the block to edit, for example "minecraft:oak_fence": "east".

Compasses

When used as a lodestone compass, compasses store information about their targeted lodestone.

  •  tag: Parent tag.
    •  LodestoneTracked: Optional. 1 or 0 (true/false) - true if the compass is connected to a lodestone. When false, LodestoneDimension and LodestonePos is not automatically removed when the lodestone is destroyed, but the compass still points to that location.
    •  LodestoneDimension: Optional. The dimension of the lodestone to which the compass is pointing.
    •  LodestonePos: Optional. The coordinates of the lodestone to which the compass is pointing.
      •  X: x coordinate
      •  Y: y coordinate
      •  Z: z coordinate

Bundle

Bundles use NBT data to save what item is stored.

  •  tag: Parent tag.
    •  Items: List of items in the bundle.
      • : An item in the bundle.
        • Tags common to all items

Inventory slot numbers

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

History

Clock JE3
This section needs to be updated. 
Please update this section to reflect recent updates or newly available information.
Reason: Almost certainly missing a lot of prior history
Java Edition
1.7.2
{{Extension DPL}}<ul><li>[[Redstone Dust|Redstone Dust]]<br/>{{Redirect|Redstone|the ore|Redstone Ore|the powered mineral block|Block of Redstone|other uses|Redstone (disambiguation)}}
{{Block
| group = Inactive (connected)
| 1-1= Inactive Redstone Wire (NESW).png
| 1-2 = Inactive Redstone Wire (NESW) BE.png
| group2 = Inactive (unconnected)
| 2-1 = Inactive Redstone Wire (unconnected).png
| 2-2 = Inactive Redstone Wire (unconnected).png
| group3 = Active (connected) 
| 3-1 = Active Redstone Wire (NESW).png
| 3-2 = Active Redstone Wire (NESW) BE.png
| group4 = Active (unconnected)
| 4-1 = Active Redstone Wire (unconnected).png
| 4-2 = Active Redstone Wire (unconnected).png
| image = Redstone Dust JE2 BE2.png
| extratext = [[#Gallery|View all renders]]
| transparent = Yes
| light = No
| tool = all
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = No
}}
'''Redstone dust''' is a mineral that can transmit [[Redstone circuit#Power|redstone power]] as a wire when placed as a [[block]]. It is also used in [[crafting]] and [[brewing]].

== Obtaining ==
=== Mining ===
{{see also|Redstone Ore#Natural generation}}
[[Redstone ore]] mined using an iron [[pickaxe]] or higher drops 4 or 5 redstone dust (or more with [[Fortune]], averaging at 6 redstone dust with Fortune III). If mined with [[Silk Touch]], the block drops itself instead of redstone dust.

=== Natural generation ===
15 lengths of redstone dust are naturally generated as part of the trap in each [[jungle pyramid]]. 5 lengths of redstone dust can be found in one type of jail cell room in a [[woodland mansion]]. In [[Ancient City|ancient cities]], multiple pieces of redstone dust can be found integrated into circuitry.

=== Breaking ===
Redstone dust can be broken instantly using any tool, or without a tool, and drops itself as an item.

Redstone dust is removed and drops as an item if:
* its attachment block is moved, removed, or destroyed
* [[water]] or [[lava]] flows into its space
* a [[piston]] tries to push it or moves a block into its space

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

=== Chest loot ===
{{LootChestItem|redstone}}

=== Crafting ===
Redstone dust can be crafted from [[blocks of redstone]].
{{Crafting
|Block of Redstone
|Output=Redstone Dust,9
|type=Redstone
}}

=== Smelting ===
{{Smelting
|showname=1
|Redstone Ore; Deepslate Redstone Ore
|Redstone Dust
|0.7
}}

=== Trading ===
{{IN|java}}, novice-level cleric [[villager]]s sell two redstone dust for one [[emerald]].

{{IN|bedrock}}, novice-level cleric villagers sell four redstone dust for one emerald.

=== Villager gifts ===
{{see also|Tutorials/Raid farming}}
{{IN|Java}}, when the player has the [[Hero of the Village]] status effect, clerics might throw that player a redstone dust as a gift.

== Usage ==
Redstone dust is used for [[#Brewing ingredient|brewing]], [[#Crafting ingredient|crafting]], and in redstone circuits by placing it on the ground to create [[#Redstone component|redstone wire]]. It can also be used to power redstone components.

=== Brewing ingredient ===
{{Brewing
  |head=1
  |Redstone Dust
  |Mundane Potion
  |base=Water Bottle
}}
{{Brewing
  |foot=1
  |name=Increased Duration
  |Redstone Dust
  |showbase=1
  |base=Potion of Fire Resistance; Potion of Invisibility; Potion of Night Vision; Potion of Poison; Potion of Regeneration; Potion of Slowness; Potion of Strength; Potion of Swiftness; Potion of Water Breathing; Potion of Weakness; Potion of Leaping; Potion of Slow Falling
}}

=== Crafting ingredient ===
{{crafting usage|Redstone Dust}}

=== {{anchor|Redstone dust}} Redstone component ===
When placed in the world, redstone dust becomes a block of "redstone wire"{{Info needed|other blco? BE?}}, which can transmit [[Redstone circuit#Power|redstone power]].

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Redstone Dust
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Redstone
|Redstone Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.<br/>
|tail=1
}}

;Trim color palette
The following color palette is shown on the designs on trimmed armor:
*{{TrimPalette|redstone dust}}

=== Placement ===
[[File:Redstone wire as circuit component.png|Examples of redstone wire configuration. ''Top Left:'' Redstone wire connects diagonally vertically through non-opaque blocks. ''Top Right:'' Redstone wire does ''not'' connect diagonally vertically through opaque blocks. ''Center:'' Redstone wire gets darker as its power level drops, to a maximum of 15 blocks from a power source.|thumb]]
[[File:Redstone on Glowstone, Stairs, Slabs.png|Examples of redstone wire placements.|thumb]]
Redstone dust can be placed on [[opaque]] blocks as well as [[glowstone]], upside-down [[slab]]s, [[glass]], upside-down [[stairs]], and [[hopper]]s. It can also be placed on some transparent blocks; see [[Opacity/Placement]] for more information. It cannot be placed suspended in midair, even with commands, which is not unintentional.<ref>{{bug|MC-182709}}</ref>

Redstone wire configures itself to point toward adjacent redstone [[Redstone components#Power components|power components]] and [[Redstone components#Transmission components|transmission component]] connection points. Redstone wire also configures itself to point toward adjacent redstone wire one block higher or lower – unless there is a solid opaque block above the lower redstone wire.

If there is only one such adjacent redstone component, redstone wire configures itself into a {{BlockSprite|redstone-dust}} line pointing both at the neighbor and away from it. If there are two or more such adjacent components, redstone wire connects them in the form of {{BlockSprite|redstone-dust}}, {{BlockSprite|redstone-dust-upleft}}, {{BlockSprite|redstone-dust-t-up}}, or {{BlockSprite|redstone-dust-cross}} as needed.

When there are no adjacent components, a single redstone wire configures itself into a {{BlockSprite|redstone-dust-cross}} plus sign, which can provide power in all four directions. By right-clicking it can be changed into a {{BlockSprite|redstone-dust-dot}} dot, which does not provide power to any of the four directions.

{{IN|bedrock}}, redstone wire automatically configures itself to point toward adjacent blocks or [[Redstone components#Mechanism components|mechanism components]]. {{IN|java}}, it does not. If such a configuration is desired, the other neighbors of the redstone wire must be arranged to create it, i.e the redstone dust must be placed in a way that it would be pointed at the block’s location even if it were not there.

When redstone wire is reconfigured after placement, it does not update other redstone components around it of the change unless that reconfiguration also includes a change in power level or another component provides an update. This can create situations where a mechanism component remains activated when it shouldn't, or vice versa, until it receives an update from something else – a "feature" of redstone wire that can be used to make a [[BUD|block update detector]].

{{-}}

=== Behavior ===
{{Schematic|caption=

{{IN|be}}, the signal can go down from glass blocks.

 |||rd-$ew!|RL-!||||rd-$ew!|RL-!|-
 |rt-$!|rd-$ew!|SB|||rt-$!|rd-$ew!|glass||-
 |ts-$|SB|rd-$ew|RL||ts-$|SB|rd-$ew!|RL-!

}}{{Schematic|caption =

However, the signal can never go down from slabs.

 |||rd-$ew!|RL-!||||rd-$ew!|RL-!|-
 |rt-$!|rd-$ew!|SB|||rt-$!|rd-$ew!|glass||-
 |ts-$|ts-$|rd-$ew|RL||ts-$|ts-$|rd-$ew|RL
}}

Redstone wire can transmit power, which can be used to operate [[Redstone components#Mechanism components|mechanism components]] ([[door]]s, [[piston]]s, [[redstone lamp]]s, etc.).
Redstone wire can be "powered" by a number of methods:
* from an adjacent [[Redstone components#Power components|power component]] or a strongly-powered block
* from the output of a redstone repeater or redstone comparator
* from adjacent redstone wire. The powering dust can be a level higher or lower, but with restrictions:
** Redstone dust can be powered by redstone dust that is one level lower, or on an [[opaque]] block one level higher. A transparent block cannot{{only|java}} pass power downward.
** The block "between" the two dust blocks must be air or transparent. A solid block there "cuts" the connection between the higher and lower dust.

The "power level" of redstone dust can vary from 0 to 15. Most power components power-up adjacent redstone dust to power level 15, but a few ([[daylight sensor]]s, [[trapped chest]]s, and [[weighted pressure plate]]s) may create a lower power level. Redstone repeaters output power level 15 (when turned on), but [[redstone comparator]]s may output a lower power level.

{{Schematic | caption =

Redstone wire can transmit power up to 15 blocks.

 |rt-$!|rd-$ew!+15|rd-$ew!+14|rd-$ew!+13|rd-$ew!+12|rd-$ew!+11|rd-$ew!+10|rd-$ew!+9
 |rd-$ew!+8|rd-$ew!+7|rd-$ew!+6|rd-$ew!+5|rd-$ew!+4|rd-$ew!+3|rd-$ew!+2|rd-$ew!+1|rd-$ew+0

}}
Power level drops by 1 for every block of redstone wire it crosses. Thus, redstone wire can transmit power for no more than 15 blocks. To go further, the power level must be re-strengthened – typically with a redstone repeater.

Powered redstone wire on top of, or pointing at, an opaque block provides ''weak'' power to the block. A weakly-powered block cannot power other adjacent redstone wire, but can still power redstone repeaters and comparators, and activate adjacent mechanism components. Transparent blocks cannot be powered.

When redstone wire is unpowered, it appears dark red. When powered, it becomes bright red at power level 15, fading to darker shades with decreasing power. Powered redstone wire also produces "dust" [[particles]] of the same color.

While redstone wire always provides power to the directions it points into, it can still point into directions in which it cannot give power. If redstone wire comes in the form of a cross, the player can right-click to toggle it between a cross and dot. A redstone dot does not power anything adjacent to it, but powers the block under it.

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Redstone Dust
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=redstone-dust
|spritetype=block
|nameid=redstone_wire
|form=block}}
{{ID table
|displayname=Item
|spritename=redstone-dust
|spritetype=item
|nameid=redstone
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Redstone Dust
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=redstone-dust
|spritetype=block
|nameid=redstone_wire
|id=55
|form=block}}
{{ID table
|displayname=Item
|spritename=redstone-dust
|spritetype=item
|nameid=redstone
|id=373
|form=item
|foot=1}}

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

{{/BS}}

{{LoadPage|Redstone Dust/Asset history|List of block state combinations|h4}}

== Achievements ==
{{load achievements|Dispense With This}}

== Video ==
{{Video note|These videos do not show all uses for redstone in crafting and all methods of obtaining. This video is also outdated, as of 1.13 Java Edition, redstone is now called Redstone Dust.}}

<div style="text-align:center">
<span style="display:inline-block">{{yt|zldqknGFWb4}}</span>
<span style="display:inline-block">{{yt|_IApwvCLJW8}}</span>
</div>

== History ==
{{History||May 21, 2009|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/110762705/my-list-on-tile-types-so-far|[[Notch]] shows interest in adding wire-type [[block]]s.}}
{{History|java alpha}}
{{History||v1.0.1|[[File:Redstone Dust JE1 BE1.png|32px]] Added redstone dust as an [[item]].
|[[File:Inactive Redstone Wire (NS) JE1.png|32px]] [[File:Inactive Redstone Wire (EW) JE1.png|32px]] [[File:Inactive Redstone Wire (NE) JE1.png|32px]] [[File:Inactive Redstone Wire (ES) JE1.png|32px]] [[File:Inactive Redstone Wire (SW) JE1.png|32px]] [[File:Inactive Redstone Wire (NW) JE1.png|32px]] [[File:Inactive Redstone Wire (NEW) JE1.png|32px]] [[File:Inactive Redstone Wire (NES) JE1.png|32px]] [[File:Inactive Redstone Wire (ESW) JE1.png|32px]] [[File:Inactive Redstone Wire (NSW) JE1.png|32px]] [[File:Inactive Redstone Wire (NESW) JE1.png|32px]]<br>[[File:Active Redstone Wire (NS) JE1.png|32px]] [[File:Active Redstone Wire (EW) JE1.png|32px]] [[File:Active Redstone Wire (NE) JE1.png|32px]] [[File:Active Redstone Wire (ES) JE1.png|32px]] [[File:Active Redstone Wire (SW) JE1.png|32px]] [[File:Active Redstone Wire (NW) JE1.png|32px]] [[File:Active Redstone Wire (NEW) JE1.png|32px]] [[File:Active Redstone Wire (NES) JE1.png|32px]] [[File:Active Redstone Wire (ESW) JE1.png|32px]] [[File:Active Redstone Wire (NSW) JE1.png|32px]] [[File:Active Redstone Wire (NESW) JE1.png|32px]] Added redstone dust as a placed [[block]]. 
|Redstone dust as a placed block has two power appearances; either completely on, or completely off.
|Redstone dust is used to craft [[redstone torch]]es.
|At this time, redstone has not been given an official name.}}
{{History||v1.0.2_01|Redstone dust now doesn't connect through solid [[block]]s diagonally down.{{needs testing|may have been changed in v1.0.2|type=untestable}}
|Walking on redstone dust no longer [[breaking|breaks]] it.{{needs testing|may have been changed in v1.0.2|type=untestable}}
|Active redstone dust now gives off [[particles]].{{needs testing|may have been changed in v1.0.2|type=untestable}}}}
{{History||v1.1.0|Redstone is now used to craft [[compass]]es.}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|Redstone is now used to craft [[clock]]s.}}
{{History|java beta}}
{{History||1.0|With the addition of inventory tooltips, the [[item]] form of redstone dust has been named "Redstone", and the usually unobtainable block form has been named "Redstone Dust".}}
{{History||1.2|Redstone is now used to craft [[dispenser]]s and [[note block]]s.}}
{{History||1.3|[[File:Inactive Redstone Wire (NS) JE2.png|32px]] [[File:Inactive Redstone Wire (EW) JE2.png|32px]] [[File:Inactive Redstone Wire (NE) JE2.png|32px]] [[File:Inactive Redstone Wire (ES) JE2.png|32px]] [[File:Inactive Redstone Wire (SW) JE2.png|32px]] [[File:Inactive Redstone Wire (NW) JE2.png|32px]] [[File:Inactive Redstone Wire (NEW) JE2.png|32px]] [[File:Inactive Redstone Wire (NES) JE2.png|32px]] [[File:Inactive Redstone Wire (ESW) JE2.png|32px]] [[File:Inactive Redstone Wire (NSW) JE2.png|32px]] [[File:Inactive Redstone Wire (NESW) JE2.png|32px]]<br>[[File:Active Redstone Wire (NS) JE2.png|32px]] [[File:Active Redstone Wire (EW) JE2.png|32px]] [[File:Active Redstone Wire (NE) JE2.png|32px]] [[File:Active Redstone Wire (ES) JE2.png|32px]] [[File:Active Redstone Wire (SW) JE2.png|32px]] [[File:Active Redstone Wire (NW) JE2.png|32px]] [[File:Active Redstone Wire (NEW) JE2.png|32px]] [[File:Active Redstone Wire (NES) JE2.png|32px]] [[File:Active Redstone Wire (ESW) JE2.png|32px]] [[File:Active Redstone Wire (NSW) JE2.png|32px]] [[File:Active Redstone Wire (NESW) JE2.png|32px]] Redstone wire gets darker the farther away it is from a source of power, using a dedicated [[tint]] system. Previously, it was fully on until it reached its limit.
|Its particles now appear gray due to not being tinted.
|Redstone is now used to craft [[redstone repeater]]s.}}
{{History||1.5|[[File:Inactive Redstone Wire (NS) JE3.png|32px]] [[File:Inactive Redstone Wire (EW) JE3.png|32px]] [[File:Inactive Redstone Wire (NE) JE3.png|32px]] [[File:Inactive Redstone Wire (ES) JE3.png|32px]] [[File:Inactive Redstone Wire (SW) JE3.png|32px]] [[File:Inactive Redstone Wire (NW) JE3.png|32px]] [[File:Inactive Redstone Wire (NEW) JE3.png|32px]] [[File:Inactive Redstone Wire (NES) JE3.png|32px]] [[File:Inactive Redstone Wire (ESW) JE3.png|32px]] [[File:Inactive Redstone Wire (NSW) JE3.png|32px]] [[File:Inactive Redstone Wire (NESW) JE3.png|32px]]<br>[[File:Active Redstone Wire (NS) JE3.png|32px]] [[File:Active Redstone Wire (EW) JE3.png|32px]] [[File:Active Redstone Wire (NE) JE3.png|32px]] [[File:Active Redstone Wire (ES) JE3.png|32px]] [[File:Active Redstone Wire (SW) JE3.png|32px]] [[File:Active Redstone Wire (NW) JE3.png|32px]] [[File:Active Redstone Wire (NEW) JE3.png|32px]] [[File:Active Redstone Wire (NES) JE3.png|32px]] [[File:Active Redstone Wire (ESW) JE3.png|32px]] [[File:Active Redstone Wire (NSW) JE3.png|32px]] [[File:Active Redstone Wire (NESW) JE3.png|32px]] Fully off redstone wire is no longer black.
|Redstone dust can now be placed on [[snow]].
|Redstone is now used to craft [[powered rail]]s and [[detector rail]]s.}}
{{History||1.6.6|Redstone dust now checks if the block below has a solid top face or [[glowstone]], allowing it to be placed on it.}}
{{History||1.7|Redstone dust now connects to a [[redstone repeater|repeater]] without the dust being explicitly pointed at it.
|Redstone can now be used to craft [[piston]]s.}}
{{History||1.8|snap=Pre-release|Redstone can now be found in the new [[stronghold]] storeroom [[chest]]s, and in the new [[mineshaft]] chests.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Redstone can now be [[brewing|brewed]] in a [[water bottle]] to create a [[mundane potion]].
|Redstone can now be found in the new [[stronghold]] altar [[chest]]s.
|Redstone now extends the [[potion]]s of [[Fire Resistance]], [[Slowness]], [[Swiftness]], [[Poison]], [[Weakness]] and [[Strength]].}}
{{History|||snap=Beta 1.9 Prerelease 4|Redstone now extends the new potion of [[Regeneration]].}}
{{History|||snap=RC1|[[File:Inactive Redstone Wire (unconnected) JE1.png|32px]] <br>[[File:Active Redstone Wire (unconnected) JE1.png|32px]] Redstone dust placement on one [[block]] has been changed from a "+" to a "•" shape.}}
{{History||?|Redstone wire block particles are now correctly colored.}}
{{History||1.1|snap=11w49a|Fixed redstone update bug.{{more info}}}}
{{History||1.2.1|snap=12w06a|Redstone can now be placed on [[glowstone]].}}
{{History|||snap=12w07a|Redstone is now used to craft [[redstone lamp]]s.}}
{{History||1.3.1|snap=12w21a|Redstone can now be [[trading|bought]] from priest [[villager]]s, at 2–4 redstone for 1 [[emerald]], making them [[renewable]].}}
{{History|||snap=12w22a|Redstone dust now generates in [[jungle temple]]s.}}
{{History|||snap=12w25a|Redstone dust can now be placed on top of upside-down [[slabs]] and [[stairs]].}}
{{History||1.4.2|snap=12w34a|Redstone now extends the new [[potion]]s of [[Night Vision]] and [[Invisibility]].}}
{{History|||snap=12w38a|[[Witch]]es have been added, which sometimes [[drops|drop]] redstone when killed.}}
{{History||1.5|snap=13w01a|Redstone can now be used to craft [[blocks of redstone]] and [[dropper]]s.}}
{{History||1.7.2|snap=13w36a|Redstone now extends the new [[potion]] of [[Water Breathing]].}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: cleric [[villager]]s now [[trading|sell]] 1–4 redstone for 1 [[emerald]].}}
{{History|||snap=14w25a|Redstone dust no longer changes to [[obsidian]] next to water when [[lava]] flows into it.}}
{{History|||snap=14w27a|Redstone now extends the new [[potion]] of [[Leaping]].}}
{{History||1.9|snap=15w31a|[[File:Inactive Redstone Wire (unconnected) JE2.png|32px]] [[File:Inactive Redstone Wire (NS) JE4.png|32px]] [[File:Inactive Redstone Wire (EW) JE4.png|32px]] [[File:Inactive Redstone Wire (NE) JE4.png|32px]] [[File:Inactive Redstone Wire (ES) JE4.png|32px]] [[File:Inactive Redstone Wire (SW) JE4.png|32px]] [[File:Inactive Redstone Wire (NW) JE4.png|32px]] [[File:Inactive Redstone Wire (NEW) JE4.png|32px]] [[File:Inactive Redstone Wire (NES) JE4.png|32px]] [[File:Inactive Redstone Wire (ESW) JE4.png|32px]] [[File:Inactive Redstone Wire (NSW) JE4.png|32px]] [[File:Inactive Redstone Wire (NESW) JE4.png|32px]]<br>[[File:Active Redstone Wire (unconnected) JE2.png|32px]] [[File:Active Redstone Wire (NS) JE4.png|32px]] [[File:Active Redstone Wire (EW) JE4.png|32px]] [[File:Active Redstone Wire (NE) JE4.png|32px]] [[File:Active Redstone Wire (ES) JE4.png|32px]] [[File:Active Redstone Wire (SW) JE4.png|32px]] [[File:Active Redstone Wire (NW) JE4.png|32px]] [[File:Active Redstone Wire (NEW) JE4.png|32px]] [[File:Active Redstone Wire (NES) JE4.png|32px]] [[File:Active Redstone Wire (ESW) JE4.png|32px]] [[File:Active Redstone Wire (NSW) JE4.png|32px]] [[File:Active Redstone Wire (NESW) JE4.png|32px]] Some slight changes have been made to redstone wire's appearance - the dot now extends outward with two more pixels, and the south-facing section of bends, T shapes and crosses now has one fewer pixel. It also appears straighter and more continuous in straight wire form.
|Redstone can no longer be added to extended [[potion]]s or tier-II potions.}}
{{History|||snap=15w44a|The average yield of redstone from [[dungeon]] [[chest]]s has been cut by more than half.
|The average yield of redstone in [[mineshaft]] chests has been increased.}}
{{History|||snap=15w46a|The hitbox of redstone now covers only part of the surface of the [[block]] below, based on the orientation of the redstone.}}
{{History||1.11|snap=16w39a|Redstone dust can now be found in chests in [[woodland mansion]]s.
|Redstone can now used to craft [[observer]]s.}}
{{History||1.13|snap=17w47a|The [[item]] form of "Redstone" has been renamed to "Redstone Wire".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 55, and the [[item]]'s 331.}}
{{History|||snap=17w48a|"Redstone" has been renamed to "Redstone Dust".}}
{{History|||snap=18w07a|Redstone now extends the new [[potion of the Turtle Master]].}}
{{History||1.14|snap=18w43a|[[File:Redstone Dust JE2 BE2.png|32px]] The texture of redstone dust has been changed.}}
{{History|||snap=18w50a|Redstone dust can now be found in chests in [[village]] temples.}}
{{History|||snap=19w12b|Redstone dust can now be placed on [[glass]], [[ice]] and [[sea lantern]]s.}}
{{History|||snap=19w13a|Cleric villagers now give redstone dust to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|Redstone dust now has a bottom texture.}}
{{History|||snap=20w09a|Redstone can now be used to craft [[target]]s.}}
{{History|||snap=20w18a|Redstone dust placement on one [[block]] has been changed from a "•" back to a "+" shape.
|Redstone dust's hitbox is now no longer strictly a cuboid, and more closely matches the shape of the wiring.<ref>{{bug|MC-137336}}</ref>
|Upward going redstone dust now has a hitbox on the side of the [[block]] too, rather than only on the floor.<ref>{{bug|MC-153508}}</ref>
|Unconnected redstone dust now has all direction block states set to "side".
|The direction block states of redstone dust are now properly set to "side" at the end of a redstone wire on both ends, rather than only the one with other redstone besides it.
|[[File:Inactive Redstone Wire (N).png|32px]] [[File:Inactive Redstone Wire (E).png|32px]] [[File:Inactive Redstone Wire (S).png|32px]] [[File:Inactive Redstone Wire (W).png|32px]]<br>[[File:Active Redstone Wire (N).png|32px]] [[File:Active Redstone Wire (E).png|32px]] [[File:Active Redstone Wire (S).png|32px]] [[File:Active Redstone Wire (W).png|32px]] While not accessible in normal gameplay, redstone dust that points into one side, but not the opposite, now visually reaches halfway across the [[block]].}}
{{History|||snap=20w19a|Redstone dust now visually connects when going up [[soul sand]], 8-layer [[snow]] stacks and the back side of upside-down [[stairs]].
|[[Particles]] are now generated across the length of the redstone wire rather than the center of the [[block]].}}
{{History|||snap=20w21a|Redstone dust placement on one [[block]] is now toggleable between a "+" and a "•" shape, by {{control|interacting}} with it.}}
{{History||1.17|snap=21w08a|Redstone dust can now drop and be smelted from [[deepslate redstone ore]].}}
{{History||1.19|snap=22w13a|Redstone wire now generates in [[Ancient City|ancient cities]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Redstone dust can now be used as an armor trim material.}}

{{History|pocket alpha}}
{{History||v0.8.0|snap=build 1|[[File:Redstone Dust JE1 BE1.png|32px]] Added redstone as an [[item]]. 
|Redstone is now [[drops|dropped]] when [[breaking|mined]] from [[redstone ore]].
|Redstone can be used to craft [[compass]]es and [[clock]]s.}}
{{History|||snap=build 2|Redstone can now be used to craft [[powered rail]]s.}}
{{History||v0.11.0|snap=build 1|Redstone is now used to craft [[redstone block]]s.}}
{{History||v0.12.1|snap=build 1|Redstone has been added to the [[Creative]] [[inventory]], but it still cannot be placed. }}
{{History||v0.13.0|snap=build 1|Redstone can now be placed.
|Redstone is now used to craft [[redstone lamp]]s, [[note block]]s, [[detector rail]]s and [[redstone torch]]es.}}
{{History||v0.14.0|snap=build 1|Redstone is now used to craft [[dispenser]]s and [[dropper]]s.}}
{{History||v0.15.0|snap=build 1|Redstone is now used to craft [[piston]]s and [[observer]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Cleric [[villager]]s now [[trading|sell]] 1–4 redstone for an [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Redstone can now be found in [[woodland mansion]]s.}}
{{History|bedrock}}
{{History||?|[[File:Inactive Redstone Wire (NE) BE.png|32px]] [[File:Inactive Redstone Wire (ES) BE.png|32px]] [[File:Inactive Redstone Wire (SW) BE.png|32px]] [[File:Inactive Redstone Wire (NW) BE.png|32px]] [[File:Inactive Redstone Wire (NEW) BE.png|32px]] [[File:Inactive Redstone Wire (NES) BE.png|32px]] [[File:Inactive Redstone Wire (ESW) BE.png|32px]] [[File:Inactive Redstone Wire (NSW) BE.png|32px]] [[File:Inactive Redstone Wire (NESW) BE.png|32px]]<br>[[File:Active Redstone Wire (NE) BE.png|32px]] [[File:Active Redstone Wire (ES) BE.png|32px]] [[File:Active Redstone Wire (SW) BE.png|32px]] [[File:Active Redstone Wire (NW) BE.png|32px]] [[File:Active Redstone Wire (NEW) BE.png|32px]] [[File:Active Redstone Wire (NES) BE.png|32px]] [[File:Active Redstone Wire (ESW) BE.png|32px]] [[File:Active Redstone Wire (NSW) BE.png|32px]] [[File:Active Redstone Wire (NESW) BE.png|32px]]<br>Placed redstone now assumes its current appearance with a more solid center. Its linear state appearences are unknown.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Redstone Dust JE2 BE2.png|32px]] The texture of redstone has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Redstone can now be found in [[desert]] [[village]] temple [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Cleric [[villager]]s now [[trading|sell]] 4 redstone as part of their first tier [[trading|trade]].}}
{{History||1.16.210|snap=beta 1.16.210.57|"Redstone" has been renamed to "Redstone Dust".}}
{{History||1.17.0|snap=beta 1.16.230.52|Redstone dust can now drop and be smelted from [[deepslate redstone ore]].}}
{{History||1.19.0|snap=beta 1.19.0.26|Redstone wire now generates in [[Ancient City|ancient cities]].}}
{{History||1.19.80|snap=beta 1.19.80.21|Redstone dust can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Redstone Dust JE1 BE1.png|32px]] Added redstone.}}
{{History||xbox=TU3|Redstone now connects to a [[redstone repeater|repeater]] without the dust being explicitly pointed at it.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Redstone Dust JE2 BE2.png|32px]] The texture of redstone has been changed.}}
{{History||ps=1.95|Redstone can now be placed on [[glass]].}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Redstone Dust JE1 BE1.png|32px]] Added redstone dust.}}
{{History|foot}}

=== Redstone wire "item" ===
{{:Technical blocks/Redstone Wire}}

== Gallery ==
=== Renders ===
; Java Edition
<gallery>
Inactive Redstone Wire (NESW).png | 
Inactive Redstone Wire (unconnected).png | 
Inactive Redstone Wire (NS).png | 
Inactive Redstone Wire (EW).png | 
Inactive Redstone Wire (NE).png | 
Inactive Redstone Wire (ES).png | 
Inactive Redstone Wire (SW).png | 
Inactive Redstone Wire (NW).png | 
Inactive Redstone Wire (NEW).png | 
Inactive Redstone Wire (NES).png | 
Inactive Redstone Wire (ESW).png | 
Inactive Redstone Wire (NSW).png
</gallery>
<gallery>
Active Redstone Wire (NESW).png | 
Active Redstone Wire (unconnected).png | 
Active Redstone Wire (NS).png | 
Active Redstone Wire (EW).png | 
Active Redstone Wire (NE).png | 
Active Redstone Wire (ES).png | 
Active Redstone Wire (SW).png | 
Active Redstone Wire (NW).png | 
Active Redstone Wire (NEW).png | 
Active Redstone Wire (NES).png | 
Active Redstone Wire (ESW).png | 
Active Redstone Wire (NSW).png
</gallery>

; Bedrock Edition
<gallery>
Inactive Redstone Wire (NESW) BE.png | 
Inactive Redstone Wire (NESW) BE.png | 
Inactive Redstone Wire (NS).png | 
Inactive Redstone Wire (EW).png | 
Inactive Redstone Wire (NE) BE.png | 
Inactive Redstone Wire (ES) BE.png | 
Inactive Redstone Wire (SW) BE.png | 
Inactive Redstone Wire (NW) BE.png | 
Inactive Redstone Wire (NEW) BE.png | 
Inactive Redstone Wire (NES) BE.png | 
Inactive Redstone Wire (ESW) BE.png | 
Inactive Redstone Wire (NSW) BE.png
</gallery>
<gallery>
Active Redstone Wire (NESW) BE.png | 
Active Redstone Wire (NESW) BE.png | 
Active Redstone Wire (NS).png | 
Active Redstone Wire (EW).png | 
Active Redstone Wire (NE) BE.png | 
Active Redstone Wire (ES) BE.png | 
Active Redstone Wire (SW) BE.png | 
Active Redstone Wire (NW) BE.png | 
Active Redstone Wire (NEW) BE.png | 
Active Redstone Wire (NES) BE.png | 
Active Redstone Wire (ESW) BE.png | 
Active Redstone Wire (NSW) BE.png
</gallery>

=== Screenshots ===
<gallery>
Slab Stair Redstone.png|First image of redstone dust on top of slabs and stairs.
File:Olivia Tinkering.jpeg|[[Olivia]] using a scarce amount of redstone dust.
File:23w32a.jpg|[[Sunny]] using a very long strip of redstone dust.
</gallery>

=== In other media ===
<gallery>
Powered By Redstone JINX.jpg|Official T-shirt artwork "Powered By Redstone" made by [https://www.jinx.com JINX].
File:Redstone Behind Chiseled Bookshelf Pixel Art.png|Pixel art of redstone dust.
</gallery>

== Issues ==
{{issue list|redstone|redstone dust|redstone wire}}

== Trivia ==
* Five updates for [[wikipedia:Windows 10 version history|Windows 10]] released from 2016 to 2018 were codenamed "Redstone", referencing ''Minecraft''.<ref>{{link|url=https://www.theverge.com/2015/4/7/8364355/microsoft-redstone-windows-updates|title=Microsoft plans ‘Redstone’ updates for Windows 10 in 2016|author=Tom Warren|website=The Verge|date=April 7, 2015}}</ref>
* The block has 1,296 possible block state combinations, the highest of all blocks as of 1.15.2, beating [[fire]]'s 512 and [[note block]]'s 800.
* According to {{el|ee}}, redstone dust contains radioactive [[element]]s.

== References ==
{{Reflist}}

{{Redstone}}
{{Blocks|Utility}}
{{Items}}

[[Category:Redstone mechanics]]
[[Category:Mechanisms]]
[[Category:Mechanics]]
[[Category:Generated structure blocks]]
[[Category:Non-solid blocks]]
[[Category:Brewing recipe]]

[[cs:Rudit]]
[[de:Redstone]]
[[el:Σκόνη Κοκκινόπετρας]]
[[es:Polvo de redstone]]
[[fr:Poudre de redstone]]
[[hu:Redstone]]
[[it:Polvere di redstone]]
[[ja:レッドストーンダスト]]
[[ko:레드스톤 가루]]
[[nl:Redstonestof]]
[[pl:Redstone]]
[[pt:Pó de redstone]]
[[ru:Красная пыль]]
[[th:ผงเรดสโตน]]
[[tr:Kızıltaş]]
[[uk:Редстоун]]
[[zh:红石粉]]</li><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></ul></nowiki>
?Added Unbreakable tag for tools.
1.8
{{Extension DPL}}<ul><li>[[Beetroot Soup|Beetroot Soup]]<br/>{{for|other uses|Soup}}
{{Item
| title = Beetroot Soup
| image = Beetroot Soup.png
| renewable = Yes
| heals = {{hunger|6}}
| stackable = No
}}

'''Beetroot soup''' is an unstackable [[food]] item.

== Obtaining ==

=== Crafting ===
{{Crafting
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Bowl
|Output=Beetroot Soup
|type=Foodstuff
}}

=== Natural generation ===

{{LootChestItem|beetroot-soup}}

== Usage ==

Beetroot soup can be eaten to restore {{hunger|6}} [[hunger]] points and 7.2 [[Hunger#Mechanics|saturation]], the same as [[cooked chicken]] and [[mushroom stew]]. After eating, the empty [[bowl]] remains, similarly to mushroom stew and [[rabbit stew]].

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

== Data values ==

=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Beetroot Soup
|spritetype=item
|nameid=beetroot_soup
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Beetroot Soup
|spritetype=item
|nameid=beetroot_soup
|id=286
|form=item
|foot=1}}

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

== History ==
{{History|java}}
{{History||1.9|snap=15w31a|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 436.}}
{{History||1.14|snap=18w43a|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}
{{History|||snap=18w49a|Beetroot soup can now be found in [[chest]]s in [[snowy tundra]] [[village]] houses.}}

{{History|pocket alpha}}
{{History||November 14, 2013|link={{tweet|jbernhardsson|400902957782147072}}|[[Johan Bernhardsson]] posts an image of beetroot soup.}}
{{History||v0.8.0|snap=build 2|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup. It is not obtainable in the Creative inventory.}}
{{History||v0.9.0|snap=build 1|Beetroot soup now requires 6 [[beetroot]]s instead of 4.}}
{{History||v0.12.1|snap=build 12|Beetroot soup now restores {{hunger|6}} instead of {{health|8}}.}}
{{History||v0.13.0|snap=build 3|Beetroot soup can now be stacked.}}
{{history|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Beetroot soup has been added to the Creative inventory.<ref name="missing beetroot soup">{{Bug|MCPE-13804}}</ref>}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}
{{History||1.11.0|snap=beta 1.11.0.1|Beetroot soup can now be found in [[snowy tundra]] [[village]] house [[chest]]s.}}

{{History|console}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|switch=1.0.1|wiiu=Patch 13|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.
|Beetroot soup is not available within the [[Creative inventory]].}}
{{History||?|Added beetroot soup to the Creative inventory.{{info needed|Which update did this occur?}}}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}}

{{Items}}

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

[[de:Borschtsch]]
[[es:Estofado de remolacha]]
[[fr:Soupe de betteraves]]
[[it:Zuppa di barbabietole]]
[[ja:ビートルートスープ]]
[[ko:비트 수프]]
[[nl:Bietensoep]]
[[pl:Barszcz]]
[[pt:Ensopado de beterraba]]
[[ru:Свекольный суп]]
[[th:ซุปบีทรูท]]
[[uk:Борщ]]
[[zh:甜菜汤]]</li><li>[[Water Bucket|Water Bucket]]<br/>{{Item
| title = Water Bucket
| renewable = Yes
| image = Water Bucket.png
| stackable = No
}}

A '''water bucket''' is a [[bucket]] filled with [[water]].

== Obtaining ==
=== Interacting ===
To fill an empty [[bucket]] with water, {{control|use}} it on a [[water]] source block. The water is consumed in the process. Flowing water does not fill a bucket.

{{control|Using}} an empty bucket on a [[cauldron]] filled with water (water level 3) empties the cauldron and fills the bucket.

Water buckets can also be filled by placing an empty one in the fuel slot of a [[furnace]], and a wet [[sponge]] into the oven slot. The bucket is filled when the [[smelting]] process completes, which also leaves the sponge dry and ready to be reused.

=== Chest Loot ===

{{LootChestItem|water-bucket}}

== Usage ==
{{Control|Using}} a water bucket on a solid block places a water source block against that block, emptying the bucket; using a water bucket on a [[waterlogging|waterloggable]] block waterlogs the block. In [[the Nether]], however, the water evaporates, making a fire extinguishing sound and displays smoke particles while nothing gets placed.

=== Dispensers ===
A [[dispenser]] can be loaded with a water bucket, and when activated it places a water block directly before it, emptying the bucket. A dispenser loaded with an empty bucket and a water source right in front of it draws the source into the bucket when activated.

=== Cauldrons ===
A single water bucket can fill a [[cauldron]], and using an empty bucket on a water-filled cauldron fills the bucket. Empty buckets cannot be filled from partly-filled cauldrons.

=== Filling bucket with mobs ===
Water buckets can be used on a [[fish]], [[axolotl]] or [[tadpole]] to create a [[bucket of aquatic mob]].

=== Transportation ===
{{main|Tutorials/Elevators#Water elevators}}
Water buckets can be used as a means of quickly descending great heights in the [[Overworld]] and [[the End]], either by creating a waterfall or using the water bucket while falling to create a safe water landing.

Water buckets can also be used to climb vertical surfaces anywhere but [[the Nether]] by repeatedly creating higher waterfalls from the bottom and swimming up them.

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|subtitle=Bucket fills
|source=player
|description=When a bucket is filled with water
|id=item.bucket.fill
|translationkey=subtitles.item.bucket.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Empty water bucket1.ogg
|sound2=Empty water bucket2.ogg
|sound3=Empty water bucket3.ogg
|subtitle=Bucket empties
|source=block
|description=When the bucket is placed
|id=item.bucket.empty
|translationkey=subtitles.item.bucket.empty
|volume=1.0 <ref group=sound>Except for the second copy of {{cd|empty1}}, which is 0.9</ref>
|pitch=1.0
|distance=16
|foot=1}}

{{el|je}}:
{{Sound table
|type=bedrock
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|source=block
|description=When a bucket is filled with water
|id=bucket.fill_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Empty water bucket1.ogg
|sound2=Empty water bucket2.ogg
|sound3=Empty water bucket3.ogg
|source=block
|description=When a water bucket is emptied
|id=bucket.empty_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=2
|sound=Water Splash Old.ogg
|source=block
|description=When a water bucket is placed in a cauldron<wbr><ref group=sound name=bucketsplash>{{Bug|MCPE-135919}}</ref>
|id=cauldron.fillwater
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a water bucket is removed from a cauldron<wbr><ref group=sound name=bucketsplash/>
|id=cauldron.takewater
|volume=0.1
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Water Bucket
|spritetype=item
|nameid=water_bucket
|aliasid=bucket / 8
|id=362
|form=item
|translationkey=item.bucketWater.name
|foot=1}}

== Advancements ==
{{load advancements|Tactical fishing;The Cutest Predator;Bukkit bukkit}}

==History==
{{History|java infdev}}
{{History||20100615|[[File:Water Bucket JE1 BE1.png|32px]] Added water buckets.}}
{{History|java alpha}}
{{History||v1.2.6|{{control|use|text=Using}} a water bucket on [[block]]s with GUIs ([[chest]]s, [[furnace]]s, etc.) no longer places the water.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Water buckets can now be used to fill [[cauldron]]s.}}
{{History||1.3.1|snap=12w15a|[[Dispenser]]s have now been given the ability to dispense water buckets. They can also collect if activated again.}}
{{History||1.8|snap=14w25a|A water bucket is now shown as the icon when [[water]] is used as a layer in [[Superflat]].}}
{{History|||snap=14w25b|[[Smelting]] a wet [[sponge]] while an empty bucket is in the fuel slot fills the bucket with water.}}
{{History||1.9|snap=15w44a|A full [[cauldron]] can now be emptied with a bucket, yielding a water bucket.}}
{{History|||snap=15w50a|Added sounds for collecting and pouring water using a bucket.}}
{{History||1.13|snap=17w47a|Prior to the ''[[Flattening]]'' this item's numerical ID was 326.}}
{{History|||snap=18w08b|Water buckets can now be used to pick up [[fish]] mobs.}}
{{History||1.14|snap=18w43a|[[File:Water Bucket JE2 BE2.png|32px]] The texture of water buckets has now been changed.
|Water buckets can now suck up liquids directly adjacent to the side they are facing. How this works is unknown, given the water bucket clearly already contains a liquid.}}
{{History|||snap=18w48a|Water buckets can now be found in [[chest]]s in [[village]] fishing cottages.}}
{{History|||snap=19w02a|Water buckets can now be used to put out [[campfire]]s.}}
{{History||1.17|snap=20w51a|Water buckets can now be used to collect [[axolotl]]s.}}
{{History||1.19|snap=22w11a|Water buckets can now be used to collect [[tadpole]]s.}}
{{History||1.19.3|snap=22w45a|Water buckets can now be emptied into [[waterlogging|waterlogged]] blocks, instead of placing water against them.<ref>{{bug|MC-127110|||Fixed}}</ref>}}
{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|[[Wandering trader]]s now have a chance to [[trading|buy]] a water bucket from the player.}}

{{History|pocket alpha}}
{{History||v0.7.0|[[File:Water Bucket JE1 BE1.png|32px]] Added water buckets.
|Water buckets were simply called "Bucket".}}
{{History||v0.7.4|Water buckets no longer stack to 64.}}
{{History||v0.14.0|snap=build 1|Dispensers can now shoot out water from water buckets.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Water buckets can now be used to pick up [[fish mob]]s.
|Moved all bucket items, including water buckets, from the Equipment tab to the Items tab in the [[Creative inventory]].{{verify|type=update}}{{info needed}}<!---please check snapshots, only 1 major release version was checked each--->}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Water Bucket JE2 BE2.png|32px]] The texture of water buckets has now been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of water buckets has been changed from <code>bucket/8</code> to <code>water_bucket</code>.}}
{{History||1.17.0|snap=beta 1.16.230.52|Water buckets can now be used to collect [[axolotl]]s.}}
{{History||1.18.10|snap=beta 1.18.10.24|Water buckets can now be used to collect [[tadpole]]s behind the "Wild Update" experimental toggle.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Water Bucket JE1 BE1.png|32px]] Added water buckets.}}
{{History||xbox=TU9|[[Dispenser]]s have now been given the ability to shoot out the [[liquids]] inside water buckets. They can also suck up the liquids if activated again, but a bug prevents the empty [[bucket]] from being filled. Whether this was ever fixed is unknown.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Water Bucket JE2 BE2.png|32px]] The texture of water buckets has now been changed.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Water Bucket JE1 BE1.png|32px]] Added water buckets.}}
{{History|foot}}

==Issues==
{{issue list}}

==Gallery==
<gallery>
Water Bucket SDGP.png|Water bucket in the [[Super Duper Graphics Pack]].
</gallery>

==References==
{{Reflist}}

{{Items}}

[[Category:Renewable resources]]
[[Category:Tools]]

[[de:Wassereimer]]
[[ja:水入りバケツ]]
[[pt:Balde de água]]
[[th:ถังน้ำ]]
[[uk:Відро води]]
[[zh:水桶]]</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.
1.12
{{Extension DPL}}<ul><li>[[Charcoal|Charcoal]]<br/>{{Item
| image = Charcoal.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}
'''Charcoal''' is an [[item]] obtained by smelting [[log]]s or [[wood]]. It is used as fuel, or for crafting [[torch]]es and [[campfire]]s. Unlike [[coal]], charcoal cannot be traded with [[villager]]s, nor can it be crafted into a [[block of coal]]. Coal and charcoal cannot stack together either. It can be used as a substitute for coal, as both charcoal and coal have an equivalent duration when smelted.

== Obtaining == 

=== Breaking ===

A [[campfire]] broken without the [[Silk Touch]] enchantment drops 2 charcoal.

=== Smelting ===

{{Smelting
 |Any Log; Any Stripped Log; Any Wood; Any Stripped Wood
 |Charcoal
 |foot=1
 |0,15
}}

=== Compound creation ===

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

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

== Usage ==

=== Crafting ingredient ===

{{crafting usage|Charcoal}}
{{Crafting
|B1= Stick
|A2= Stick
|B2= Coal; Charcoal
|C2= Stick
|A3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|B3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|C3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|Output= Campfire
}}

=== Lab table ingredient ===

Charcoal is one of the [[lab table]] ingredients needed to produce the [[heat block]].{{only|education}}

{| class="wikitable"
! Result
! Materials Needed
|-
!rowspan=2|{{slot|Heat Block.gif}}<br>[[Heat Block]]
|{{slot}}{{slot|Iron|link=Element}}{{slot|Water (compound)|link=Compound}}{{slot|Charcoal}}{{slot|Salt|link=Compound}}{{slot}}
|-
|<center>[[Element|Iron]], [[Water (compound)|Water]], Charcoal, [[Compound|Salt]]</center>
|}

=== Fuel ===

When used in a [[furnace]] as a fuel, a piece of charcoal lasts 80 seconds (smelting up to 8 items), the same as coal. Charcoal used as fuel lasts more than 5 times longer than [[wood planks]] or [[wood]] logs used as fuel, being more efficient than any other use of wood for smelting in ''[[Java Edition]]'', but outstripped by [[wooden slabs]] in Bedrock. 

Coal and charcoal are also the only fuels accepted by [[Minecart with Furnace|furnace minecarts]]. They provide approximately four minutes of transit each.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Charcoal
|spritetype=item
|nameid=charcoal
|itemtags=coals
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Charcoal
|spritetype=item
|nameid=charcoal
|aliasid=coal / 1
|id=303
|itemtags=minecraft:coals
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Renewable Energy}}

== History ==

{{History|java beta}}
{{History||December 25, 2010|link=http://www.minecraftforum.net/topic/131047-lantern-update-incoming/page__st__20#entry1986964| In 0.3.2, charcoal was suggested to [[Markus Persson|Notch]] by [https://twitter.com/Moleculor @Moleculor] on [[wikipedia:Twitter|Twitter]] as a writing implement.}}
{{History||1.2|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal, with the same texture as coal.
|Charcoal is not used as a writing implement.}}
{{History|java}}
{{History||1.2.1|snap=12w04a|Charcoal can now be used to craft [[fire charge]]s.}}
{{History||1.3.1|snap=?|Charcoal is now directly available in the creative inventory.}}
{{History|||snap=1.3|[[File:Charcoal JE2 BE2.png|32px]] The texture of charcoal has been changed.}}
{{History||1.6.1|snap=13w19a|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History||1.8|snap=14w02a|Charcoal can no longer be [[trading|traded]] from [[villager]]s.}}
{{History||1.13|snap=17w47a|The different data values for the {{code|coal}} ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 263.}}
{{History||1.14|snap=18w43a|[[File:Charcoal JE4 BE4.png|32px]] The texture of charcoal has been changed.}}
{{History|||snap=19w02a|Charcoal can now be used to craft [[campfire]]s. Destroying a campfire returns 2 charcoal.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal, with the same texture as coal. It is not yet obtainable.}}
{{History||v0.3.2|Charcoal is now obtainable by smelting [[log|wood]] in a furnace.}}
{{History||v0.8.0|snap=build 1|[[File:Charcoal JE2 BE2.png|32px]] The texture of charcoal has been changed.}}
{{History||v0.8.1|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.13.8|Added [[stripped log]] variants, which can be [[smelting|smelted]] to obtain charcoal.}}
{{History|||snap=beta 1.2.20.1|Charcoal now can be crafted using 7 Carbon, 4 Hydrogen, and an Oxygen in a [[compound creator]].
|Charcoal can now be used in the [[lab table]] to create a [[heat block]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Charcoal can now be used to craft [[campfire]]s. Destroying a campfire returns 2 charcoal.
|[[File:Charcoal JE4 BE4.png|32px]] The textures of charcoal has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.51|Charcoal are now used to craft [[soul fire torch]]es.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of charcoal has been changed from {{code|coal/1}} to {{code|charcoal}}.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal.}}
{{History||?|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Charcoal JE4 BE4.png|32px]] The texture of charcoal has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Charcoal JE3 BE3.png|32px]] Added charcoal.}}
{{History|foot}}

== Issues ==
{{issue list|Charcoal}}

== How it's renewable ==
Charcoal comes from smelting log. Logs are renewable and charcoal can be used as fuel to smelt logs{{Items}}

[[Category:Renewable resources]]

[[de:Holzkohle]]
[[fr:Charbon (objet)#Charbon de bois]]
[[hu:Faszén]]
[[it:Carbonella]]
[[ko:목탄]]
[[pt:Carvão#Carvão vegetal]]
[[nl:Steenkool#Houtskool]]
[[ru:Уголь#Древесный уголь]]
[[zh:木炭]]</li><li>[[Prismarine Shard|Prismarine Shard]]<br/>{{Item
| renewable =  Yes
| stackable = Yes (64)
| type =
}}
A '''prismarine shard''' is an item obtained by defeating [[guardian]]s or [[elder guardian]]s. It can be used to craft various [[prismarine]] blocks as well as [[sea lantern]]s.

== Obtaining ==

Prismarine shards are dropped upon the death of [[guardian]]s and [[elder guardian]]s. From these mobs, 0–2 shards are dropped each time. This can be increased to a maximum of 5 with the [[Looting]] enchantment.

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Prismarine Shard
|spritetype=item
|nameid=prismarine_shard
|aliasid=prismarineshard
|id=565
|form=item
|foot=1}}

== History ==

{{History|java}}
{{history||1.8|snap=14w25a|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 409.}}
{{History||1.14|snap=18w43a|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|pocket alpha}}
{{History||v0.16.0|snap=build 1|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Prismarine Shard JE2 BE2.png|32px]] The texture of prismarine shards has now been changed.}}

{{History|New 3DS}}
{{History||1.3.12|[[File:Prismarine Shard JE1 BE1.png|32px]] Added prismarine shards.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{items}}

[[de:Prismarinscherbe]]
[[es:Fragmento de prismarina]]
[[fr:Éclat de prismarine]]
[[ja:プリズマリンの欠片]]
[[ko:프리즈머린 조각]]
[[nl:Prismarienscherf]]
[[pl:Odłamek pryzmarynu]]
[[pt:Pedaço de prismarinho]]
[[ru:Призмариновый осколок]]
[[uk:Призмариновий уламок]]
[[zh:海晶碎片]]
[[Category:Renewable resources]]</li></ul>
pre1Added enteredNetherPosition to players, for use with the minecraft:nether_travel advancement trigger.
1.13
{{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>[[Fish|Fish]]<br/>{{About|the type of mob|the action|Fishing}}
'''Fish''' are aquatic creatures that are found in [[river]] and [[ocean]] biomes.

== Mobs ==
There are four categories of fish mobs in ''Minecraft'': 
*{{EntityLink|Cod}}
*{{EntityLink|Salmon}}
*{{EntityLink|Pufferfish}}
*{{EntityLink|Tropical Fish}} - many color and pattern varieties

In addition, there are other fish-like mobs that have different characteristics from fish: {{EntityLink|Axolotl}}, {{EntityLink|Guardian}}, and {{EntityLink|Elder Guardian}}.

==Obtaining and transporting==
A live fish can be captured by using a [[water bucket]] on a fish, to obtain a [[bucket of fish]], which is the only way to obtain the live mob in item form. Using the bucket of fish on a water source block transfers the fish from the bucket to the body of water. A water bucket may also be used on [[axolotl]]s in this manner.

==Items==
Fish exist in several different item forms. Upon death, fish drop their item form equivalent (cooked if on fire), with a chance to drop a [[bone]]{{only|bedrock}} or [[bone meal]].{{only|java}}

;Non-living
*{{ItemLink|Raw Cod}}
*{{ItemLink|Cooked Cod}}
*{{ItemLink|Raw Salmon}}
*{{ItemLink|Cooked Salmon}}
*{{ItemLink|Pufferfish|link=Pufferfish (item)}}
*{{ItemLink|Tropical Fish|link=Tropical Fish (item)}}
;Living
*{{ItemLink|Bucket of Cod}}
*{{ItemLink|Bucket of Salmon}}
*{{ItemLink|Bucket of Pufferfish}}
*{{ItemLink|Bucket of Tropical Fish}}

== Spawning ==
Various fish can be found in different [[ocean]] [[biomes]], but only [[salmon]] appear in rivers. Fish can also spawn in player-created bodies of water, as long as they are within a river or ocean biome.

{| class="wikitable sortable" style="text-align:left" data-description="Fish biomes"
!'''Fish'''
! style="text-align:left" |{{BiomeLink|Warm Ocean}}
! style="text-align:left" |{{BiomeLink|Lukewarm Ocean}}<br>{{BiomeLink|Deep Lukewarm Ocean}}
! style="text-align:left" |{{BiomeLink|Ocean}}<br>{{BiomeLink|Deep Ocean}}
! style="text-align:left" |{{BiomeLink|Cold Ocean}}<br>{{BiomeLink|Deep Cold Ocean}}
! style="text-align:left" |{{BiomeLink|Frozen Ocean}}<br>{{BiomeLink|Deep Frozen Ocean}}
! style="text-align:left" |{{BiomeLink|River}}<br>{{BiomeLink|Frozen River}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Cod}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Salmon}}
| rowspan=2 {{tc|no}}
| {{tc|no|No{{only|je|short=1}}}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
| {{tc|yes|Yes{{only|be|short=1}}}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Pufferfish}}
| rowspan=2 {{tc|yes}}
| {{tc|yes|Yes{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
|-
| {{tc|no|No{{only|be|short=1}}}}
|-
! style="text-align:left" |{{EntityLink|Tropical Fish}}<ref group="note">Also spawns in {{BiomeLink|Lush Caves}} at any Y-level.</ref>
| {{tc|yes}}
| {{tc|yes}}
| {{tc|no}}
| {{tc|no}}
| {{tc|no}}
| {{tc|no}}
|-
! style="text-align:left" |{{EntityLink|Squid}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Dolphin}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
|}
{{notelist}}

In ''Java Edition'', fish can spawn inside a water block at Y-level 50 to 63 (from 13 blocks below sea level up to inside the block one above it), that also has water above and below it. The spawn block and the block below can be any kind of water, such as a source block, falling water, bubble column, kelp, or even a waterlogged block (as long as the fish can be placed at the bottom center of the spawn block without colliding with anything solid). The block above must be pure water, such as a source block, falling water, or flowing water of any depth. Particularly, the block above cannot also be a bubble column, so fish no longer spawn inside bubble elevators.<ref>{{cite bug|MC|244683|Tropical fish spawn in bubble columns (fixed in 22w07a)}}</ref> 

''Bedrock Edition'' does permit fish to spawn in bubble columns.<ref>{{cite bug|MCPE|73967|Squids, Dolphins, and fish not spawning in bubble columns (fixed in 1.16.20)}}</ref>

Fish can spawn between 24 and 64 block spherical range away from the player.{{only|java}} 

=== Despawning ===
As of [[1.16]], fish can despawn at range of 40 blocks or more from the player, and will instantly despawn more than 64 blocks away, except when spawned using a [[bucket of fish]].

{{Items}}
{{Entities}}

[[cs:Ryba]]
[[de:Fisch (Begriffsklärung)]]
[[es:Pez]]
[[fr:Poisson]]
[[it:Pesce]]
[[ja:魚]]
[[ko:물고기]]
[[nl:Vis]]
[[pl:Ryba (ujednoznacznienie)]]
[[pt:Peixe]]
[[ru:Рыба]]
[[th:ปลา (แก้ความกำกวม)]]
[[uk:Риба]]
[[zh:鱼]]</li></ul>
18w01aName tag is now a text component.
Removed the LocName tag. Instead of LocName:"gui.toTitle", use Name:"{\"translate\":\"gui.toTitle\"}".
18w21aench tag has been renamed Enchantments.
1.14
{{Extension DPL}}<ul><li>[[Totem of Undying|Totem of Undying]]<br/>{{redirect|Totem}}
{{Item
| image = Totem_of_Undying_JE2_BE2.png
| renewable = Yes
| stackable = No
| rarity = Uncommon
|effects=: {{EffectLink|Absorption}} II (0:05)
: {{EffectLink|Regeneration}} II (0:45){{only|java|short=yes}}/ II (0:40){{only|bedrock|short=yes}}
: {{EffectLink|Fire Resistance}} I (0:40)
}}
A '''totem of undying''' is an uncommon [[combat]] item that can save holders from death. It is dropped by [[Evoker|evokers]], which spawn in [[woodland mansion]]s and [[raid]]s.

== Obtaining ==
=== Mob loot ===
Evokers always drop one totem of undying upon death. The drop rate is not affected by [[Looting]].

== Usage ==
[[File:Totem of Undying Animation.gif|alt=The totem animation in Java Edition.|thumb|Animation of the totem activating {{in|java}}.]]
[[File:Totem of Undying Bedrock Animation.gif|alt=The totem animation in Bedrock Edition.|thumb|Animation of the totem activating {{in|bedrock}}.]]
If the [[player]] is holding a totem of undying in their [[off-hand]] or main-hand slot and receives otherwise fatal [[damage]], the totem saves the player from [[death]]. The totem of undying must be in the player's hand (main hand or offhand) for it to work—it does not work if it is in the [[Heads-up display#Hotbar|hotbar]], unless selected. Any [[mob]] that can hold a totem of undying (in a hand or in the mouth) can use it while holding it.{{only|JE}} The totem can be used only once; it disappears after use. It does not save the player from death caused by [[void]] damage, the {{cmd|kill}} [[command]]s or even a [[tipped arrow]] with [[Instant Damage|harming]] effect damage.<ref>{{bug|MC-206307}}</ref>

== Effect ==
When activated, the totem of undying restores {{hp|1}}, removes all existing [[status effect]]s, then grants 40{{only|bedrock|short=1}} or 45{{only|java|short=1}} seconds<ref>{{bug|MCPE-90716}}</ref> of [[Regeneration]] II, 40 seconds of [[Fire Resistance]] I and 5 seconds of [[Absorption]] II. An animation shows the totem of undying appearing to hover in front of the [[player]]'s screen, similar to the animation seen when a player receives the [[Bad Omen]] or [[Hero of the Village]] effect{{only|bedrock|short=1}} or encounters an [[elder guardian]]. When killed by an [[Instant Damage]] tipped [[arrow]], the arrow's instant damage takes effect after the totem has been activated.

The totem of undying also works in [[Hardcore]] mode.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Totem of Undying.ogg
|subtitle=Totem activates
|source=dependent
|description=When something dies, using a totem of undying
|id=item.totem.use
|translationkey=subtitles.item.totem.use
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Totem of Undying.ogg
|source=player
|description=When something dies, using a totem of undying
|id=random.totem
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Totem of Undying
|spritetype=item
|nameid=totem_of_undying
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Totem of Undying
|spritetype=item
|nameid=totem_of_undying
|aliasid=totem
|id=568
|form=item
|translationkey=item.totem.name
|foot=1}}

== Achievements ==
{{load achievements|Cheating Death}}

== Advancements ==
{{load advancements|Postmortal}}

== History ==
{{History||2016|[[File:Totem of Undying (pre-release).png|32px]] An early version of the totem of undying was seen during Minecon shortly before its reveal.}}
{{History|java}}
{{History||1.11|snap=16w39a|[[File:Totem of Undying JE1 BE1.png|32px]] Added totem of undying.}}
{{History||1.11.1|snap=16w50a|The ID name has now been changed from <code>totem</code> to <code>totem_of_undying</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 449.}}
{{History||1.14|snap=18w43a|[[File:Totem of Undying JE2 BE2.png|32px]] The texture of the totem of undying has been changed.}}
{{History|||snap=18w47a|The totem of undying is now [[renewable resource|renewable]] as [[evoker]]s now spawn in [[raid]]s.}}
{{History||1.16.2|snap=20w28a|The totem of undying now gives the [[Fire Resistance]] II status effect for 40 seconds.}}
{{History|||snap=20w29a|The level of Fire Resistance given by the totem of undying is now reduced from II to I.<ref>{{bug|MC-194220}}</ref>}}
{{History||1.20.2|snap=23w31a|Totems of undying now trigger [[sculk sensor]]s when they activate.<ref>{{bug|MC-261427||Sculk sensors and calibrated sculk sensors don't detect totem of undying activating|Fixed}}</ref>}}

{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|[[File:Totem of Undying JE1 BE1.png|32px]] Added totem of undying.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Totem of Undying JE2 BE2.png|32px]] The texture of the totem of undying has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.3|The totem of undying is now [[renewable resource|renewable]] as [[evoker]]s now spawn in [[raid]]s.}}
{{History||1.16.100|snap=beta 1.16.100.54|The level of Fire Resistance given by the totem of undying is now reduced from II to I.<ref>{{bug|MCPE-52364}}</ref>}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of totems of undying has been changed from <code>totem</code> to <code>totem_of_undying</code>.}}

{{History|console}}
{{History||xbox=TU54|xbone=CU44|ps=1.52|wiiu=Patch 24|switch=1.0.4|[[File:Totem of Undying JE1 BE1.png|32px]] Added totem of undying.}}
{{History||xbox=TU56|xbone=CU48|ps=1.55|wiiu=Patch 26|switch=1.0.6|The totem of undying now applies [[Fire Resistance]] II when used.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Totem of Undying JE2 BE2.png|32px]] The texture of the totem of undying has been changed.}}
{{History||xbox=none|xbone=none|ps=1.91|wiiu=none|switch=none|The totem of undying is now [[renewable resource|renewable]] as [[evoker]]s now spawn in [[raid]]s.}}

{{History|new3ds}}
{{History||1.9.19|[[File:Totem of Undying JE1 BE1.png|32px]] Added totem of undying.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* If a [[mob]] holds a totem of undying, the mob also resurrects upon [[Health#Death|death]] and the [[sound]] effect plays. However, the animation does not appear.
* In the {{el|ds}}, the totem of undying can be put in any hotbar slot to activate it, due to the lack of an [[Dual wield|off-hand slot]] in that version.
* Being able to obtain totems of undying in [[raids]] without exploring [[woodland mansions]] is considered a "massive game play design flaw" by Mojang.<ref>{{ytl|YRPlscod34Y}}</ref>

== Gallery ==
<gallery>
File:Particle totem of undying.png|Screenshot of the totem of undying being used mid-animation after a [[drowned]] deals otherwise fatal damage to the player.
File:Totem of Undying activating.gif|Animation of the totem activating.
File:Totem animation in third person mode.png|The totem animation in third person mode.
</gallery>

== References ==
{{reflist}}

{{Items}}

[[de:Totem der Unsterblichkeit]]
[[fr:Totem d'immortalité]]
[[ja:不死のトーテム]]
[[ko:불사의 토템]]
[[lzh:保命符]]
[[nl:Totem der onsterfelijkheid]]
[[pl:Totem nieśmiertelności]]
[[pt:Totem da imortalidade]]
[[ru:Тотем бессмертия]]
[[th:Totem of Undying]]
[[zh:不死图腾]]
[[Category:Renewable resources]]</li><li>[[:Category:Minecraft Dungeons items|Category:Minecraft Dungeons items]]<br/>All items that are in ''[[Minecraft Dungeons]]''.
{{Minecraft Dungeons items}}
[[Category:Minecraft Dungeons]]
[[Category:Items]]
[[ja:カテゴリ:アイテム (Minecraft Dungeons)]]
[[pl:Kategoria:Przedmioty w Minecraft Dungeons]]
[[pt:Categoria:Itens do Minecraft Dungeons]]</li></ul>
18w43aLore tag is now a text component.
Added CustomModelData tag to set custom item model with resource packs.
19w06aAdded BlockStateTag for item forms of blocks.
1.16.2
{{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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Piglins ===
[[Piglin]]s are attracted to golden swords, run toward any golden swords on the ground and inspect it for 6 to 8 seconds before putting it in their [[inventory]] slot.

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

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

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

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

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

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

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

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

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

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

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

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

== Issues ==
{{issue list}}

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

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

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

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

== References ==
{{reflist}}

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

[[de:Schwert]]
[[es:Espada]]
[[fr:Épée]]
[[hu:Kard]]
[[ja:剣]]
[[ko:검]]
[[nl:Zwaard]]
[[pl:Miecz]]
[[pt:Espada]]
[[ru:Меч]]
[[tr:Kılıç]]
[[uk:Меч]]
[[zh:剑]]</li></ul>
20w27aAdded Flag 64 to HideFlags to hide "Dyed" on leather armor.[3]
1.17.1
{{Extension DPL}}<ul><li>[[Bone|Bone]]<br/>{{about|the item|the block|Bone Block|other uses|Bone (disambiguation)}}
{{Item
| image = Bone.png
| renewable = Yes
| stackable = Yes (64)
}} 

A '''bone''' is an [[item]] primarily obtained from [[skeleton]]s and similar mobs. It can be crafted into [[Bone Meal|bone meal]] or used to tame wild [[Wolf|wolves]].

== Obtaining ==

=== Chest loot ===

{{LootChestItem|bone}}

=== Mob loot ===

Skeletons, [[wither skeleton]]s, [[skeleton horse]]s, and [[stray]]s may drop 0–2 bones upon death. The maximum drop is increased by 1 per level of Looting, for a maximum of 0-5 bones with Looting III.

{{IN|bedrock}}, [[salmon]], [[cod]], [[pufferfish]], and [[tropical fish]] have 25% chance to drop 1-2 bones upon death. The maximum drop is increased by 1 to 2 per level of Looting, for a maximum of 2-8 bones with Looting III.
Salmon (small and medium size) have 25% chance to drop 1 bone upon death, The maximum drop is increased by 1 to 2 per level of [[Looting]], for a maximum of 2-7 bones with Looting III. The chance of dropping bones increases by 1% per looting level, so with Looting III there is up to a 28% chance of bones dropping.

=== Fishing ===

Bones can also be obtained by [[fishing]] as part of the junk category. The best chance of catching a bone is achieved without the [[Luck of the Sea]] enchantment, yielding a 1.1% chance.

== Usage ==

=== Helmet ===
[[File:Steve wearing Bone.png|thumb|right|75px]]
[[File:Alex wearing Bone.png|thumb|right|75px]]
While a bone cannot be equipped in the head slot in Survival mode, equipping it using commands causes it to appear in the player's mouth.

=== Taming ===

Using a bone on a wild [[wolf]] has a {{frac|1|3}} chance of [[taming]] it. Bones cannot tame a hostile wolf or a wolf that has already been tamed. However, bones can be used to attract the attention of the tamed ones.

=== Crafting ingredient ===
A bone can be crafted into 3 bone meal.

{{crafting usage}}

== Achievements ==
{{load achievements|Leader of the pack}}

== Advancements ==
{{load advancements|Best Friends Forever}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bone
|spritetype=item
|nameid=bone
|id=415
|form=item
|foot=1}}

== History ==
{{History|java beta}}
{{History||1.2|[[File:Bone JE1 BE1.png|32px]] Added bones.
|Bones can be [[crafting|crafted]] into [[bone meal]].}}
{{History||1.4|Bones can now be used to tame [[wolves]].}}
{{History|java}}
{{History||1.3.1|snap=12w21a|Bones can now be found within [[desert temple]]s, allowing bones to be obtainable on Peaceful difficulty.}}
{{History||1.4.2|snap=12w36a|Added [[wither skeleton]]s, which has a chance to [[drops|drop]] bones when killed.}}
{{History||1.6.1|snap=13w16a|Added [[skeleton horse]]s, which drop bones when killed.}}
{{History||1.7.2|snap=13w36a|Bones can now be more easily obtained in Peaceful difficulty by [[fishing]]. Although, they are considered a "junk" [[item]].}}
{{History||1.9|snap=15w44a|The average yield of bones in [[desert temple]]s has been slightly decreased.
|Bones can now be found in [[dungeon]] [[chest]]s.}}
{{History||1.10|snap=16w20a|Added [[stray]]s, which [[drops|drop]] bones when killed.}}
{{History||1.11|snap=16w39a|Bones can now found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 352.}}
{{History||1.14|snap=18w43a|[[File:Bone JE2.png|32px]] The texture of bones has now been changed.}}
{{History|||snap=18w44a|[[File:Bone JE3 BE2.png|32px]] The texture of bones has now been slightly changed.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Bones now generate in [[ancient city]] chests.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Bone JE1 BE1.png|32px]] Added bones. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.3|Added skeletons, which drop bones when they die.
|Bones can now be used to craft [[bone meal]].}}
{{History||v0.5.0|Bones can now be obtained after activating the [[nether reactor]].}}
{{History||v0.9.0|snap=build 1|Added bones to [[Creative]] mode.}}
{{History||v0.11.0|snap=build 1|Bones can now be more easily obtained in Peaceful difficulty by [[fishing]]. Although, they are considered a "junk" [[item]].}}
{{History||v0.12.1|snap=build 1|Added [[wither skeleton]]s, which have a chance to [[drops|drop]] bones when killed.
|Bones are no longer available from the [[nether reactor]].}}
{{History||v0.13.0|snap=build 1|Bones can now be found inside of the [[desert temple]] hidden [[chest]] room.}}
{{History||v0.15.0|snap=build 1|Added [[stray]]s and [[skeleton horse]]s, which drop bones when killed.
|Bones can now be found in [[jungle temple]] [[chest]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Bone can now be found inside [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Bones now [[drops|drop]] from [[fish]] mobs.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Bone JE3 BE2.png|32px]] The texture of bones has now been changed.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|[[File:Bone JE1 BE1.png|32px]] Added bones.}}
{{History||xbox=TU5|Bones can be found in the Miscellaneous tab in the [[Creative inventory]].}}
{{History||xbox=TU12|Moved bones to the Materials tab in the Creative inventory.}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|Added [[wither skeleton]]s, which have a chance to [[drops|drop]] bones when killed.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Bones can now be obtained from [[fishing]].}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|Added [[stray]]s and [[skeleton horse]]s, which drop bones when killed.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bone JE3 BE2.png|32px]] The texture of bones has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Bone JE1 BE1.png|32px]] Added bones.}}
{{History|foot}}

== Issues ==

{{issue list}}

== See also ==

* [[Bone meal]]
* [[Wolf]]
* [[Dyeing]]

{{Items}}

[[Category:Renewable resources]]

[[de:Knochen]]
[[es:Hueso]]
[[fr:Os]]
[[hu:Csont]]
[[it:Osso]]
[[ja:骨]]
[[ko:뼈]]
[[nl:Bot]]
[[pl:Kość]]
[[pt:Osso]]
[[ru:Кость]]
[[th:กระดูก]]
[[tr:Kemik]]
[[uk:Кістка]]
[[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||b=Lapis Lazuli|c=Any fuel|d=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>
1.17.1 Pre-release 1Enchantments[].lvl tag is now read as short and clamped between 0 and 255.[4]

References

  1. ↑ Assuming the block is of a type that creates a block entity at all. If not, BlockEntityTag has no effect.
  2. ↑ For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.
  3. ↑ MC-49476
  4. ↑ MC-131290
Minecraft
Help
Menu screens
Aspects
Examples
Game customization
Editions
Java
Bedrock
Merged
Ports to consoles
Discontinued
Other
Discontinued
Legacy Console
Other
Miscellaneous
Deutsch Français 日本語 Nederlands Português 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms