Minecraft Wiki
Register
Line 182: Line 182:
   
 
== Command reference ==
 
== Command reference ==
  +
{{split|section=y|Commands/scoreboard|reason=Command info should be on the commands page}}
 
  +
'''For more details, see [[Commands/scoreboard]].'''
   
 
=== Objectives commands ===
 
=== Objectives commands ===
 
{| class="wikitable" style="width:100%" data-description="Objectives commands"
 
{| class="wikitable" style="width:100%" data-description="Objectives commands"
! width="25%" | Command
+
! width="25%" | Commands
 
! width="55%" | Description
 
! width="55%" | Description
! width="20%" | Result
 
 
|-
 
|-
| '''scoreboard objectives list''' || List all existing objectives with their display names and criteria. || Always succeeds {{in|java}}. Fails if there's no objective {{in|bedrock}}.
+
| '''scoreboard objectives list''' || List all existing objectives with their display names and criteria.
 
|-
 
|-
| '''scoreboard objectives add''' <objective> <criteria> [<displayName>]{{only|java}}<br> '''scoreboard objectives add''' <objective: string> dummy [displayName: string]{{only|bedrock}} || Create a new objective with the given internal objective name, specified criterion, and the optional display name. <code><objective></code> must be a plain text at most 16 characters; {{in|bedrock}}, it can also be a double quoted text. <code><criterion></code> must be a valid criterion type. <code><displayName></code> must be a [[Commands#Raw JSON text|JSON text component]], defaulting to <code><objective></code> when unspecified; {{in|bedrock}}, it can also be a plain text that isn't a number. All three arguments are case-sensitive. {{IN|bedrock}}, "dummy" is the only criterion currently supported. See [[#Objectives|above section]] for more on these arguments. || Fails if <code><objective></code> already exists.
+
| '''scoreboard objectives add''' <objective> <criteria> [<displayName>]{{only|java}}<br> '''scoreboard objectives add''' <objective: string> dummy [displayName: string]{{only|bedrock}} || Create a new objective with the given internal objective name, specified criterion, and the optional display name. {{IN|bedrock}}, "dummy" is the only criterion currently supported. <code><displayName></code> defaults to <code><objective></code> when unspecified. See [[#Objectives|above section]] for more on these arguments.
 
|-
 
|-
| '''scoreboard objectives remove''' <objective>{{only|java}}<br> '''scoreboard objectives remove''' <objective: string>{{only|bedrock}} || Delete all references to the named objective in the scoreboard system. Data is deleted from the objectives list and entity scores, and if it was on a display list it is no longer displayed. || Fails if <code><objective></code> does not exist.
+
| '''scoreboard objectives remove''' <objective>{{only|java}}<br> '''scoreboard objectives remove''' <objective: string>{{only|bedrock}} || Delete all references to the named objective in the scoreboard system. Data is deleted from the objectives list and score holders' scores, and if it was on a display list it is no longer displayed.
 
|-
 
|-
| '''scoreboard objectives setdisplay''' <slot > [<objective ]{{only|java}}<br> '''scoreboard objectives setdisplay''' <list|<nowiki>sidebar> [objective: string] [ascending|descending]</nowiki>{{only|bedrock}}<br> '''scoreboard objectives setdisplay''' belowname [objective: string]{{only|bedrock}} || Display score info for the objective in the given slot. Valid slots are listed and described in [[#Display_slots|Display Slots]]. {{IN|bedrock}}, if slot is <code>list</code> or <code>sidebar</code>, there is an additional optional argument <code>ascending|descending</code> to specify the sort order. Note that the objective parameter is optional; if no objective is provided, this display slot is cleared (returned to its default state). || Fails if <code><objective></code> does not exist (if specified). Note that clearing an empty slot still succeeds.
+
| '''scoreboard objectives setdisplay''' <slot > [<objective ]{{only|java}}<br> '''scoreboard objectives setdisplay''' <list|<nowiki>sidebar> [objective: string] [ascending|descending]</nowiki>{{only|bedrock}}<br> '''scoreboard objectives setdisplay''' belowname [objective: string]{{only|bedrock}} || Display score info for the objective in the given slot. Valid slots are listed and described in [[#Display_slots|Display Slots]]. {{IN|bedrock}}, if slot is <code>list</code> or <code>sidebar</code>, there is an additional optional argument <code>ascending|descending</code> to specify the sort order. Note that the objective parameter is optional; if no objective is provided, this display slot is cleared (returned to its default state).
 
|-
 
|-
| '''scoreboard objectives modify''' <objective> '''displayname''' <displayName> {{only|java}}|| Change the display name of the scoreboard in display slots. <code><displayName></code> must be a [[Commands#Raw JSON text|JSON text component]]. || Fails if <code><objective></code> does not exist.
+
| '''scoreboard objectives modify''' <objective> '''displayname''' <displayName> {{only|java}}|| Change the display name of the scoreboard in display slots.
 
|-
 
|-
| '''scoreboard objectives modify''' <objective> '''rendertype''' (hearts<nowiki>|</nowiki>integer) {{only|java}}|| Change the display format of health bars. ||Fails if <code><objective></code> does not exist.
+
| '''scoreboard objectives modify''' <objective> '''rendertype''' (hearts<nowiki>|</nowiki>integer) {{only|java}}|| Change the display format of the player list.
 
|-
 
|-
 
|}
 
|}
Line 207: Line 207:
   
 
{| class="wikitable" style="width:100%" data-description="Players commands"
 
{| class="wikitable" style="width:100%" data-description="Players commands"
! width="25%" | Command
+
! width="25%" | Commands
 
! width="55%" | Description
 
! width="55%" | Description
 
! width="20%" | Result
 
! width="20%" | Result
 
|-
 
|-
| '''scoreboard players list''' [<target>]{{only|java}}<br> '''scoreboard players list''' [playername: target]{{only|bedrock}} || Lists all entities which are tracked in some way by the scoreboard system. The optional <code><target></code> parameter is used to list the scores of a particular entity. And {{in|bedrock}} an asterisk (*) in place of <code>playername: target</code> displays ''all'' scores for the targets tracked by the scoreboard system; {{in|java}}, <code>*</code> doesn't work because of a bug{{citation needed|needs bug link}}. || Fails if uses <code>*</code> {{in|java}}. <br>Fails if <code>playername: target</code> hasn't have recorded scores (if specified), or if there is no tracked entity on the scoreboard (if <code>playername: target</code> isn't specified).{{in|bedrock}}.
+
| '''scoreboard players list''' [<target>]{{only|java}}<br> '''scoreboard players list''' [playername: target]{{only|bedrock}} || Lists all score holders which are tracked in some way by the scoreboard system. The optional <code><target></code> or <code>playername: target</code> parameter is used to list the scores of particular score holders.
 
|-
 
|-
| '''scoreboard players get''' <target> <objective> {{only|java}} || Return the scoreboard value. Can be used in conjunction with the {{cmd|execute}} command: {{cmd|execute store result ...run scoreboard players get ...}}
+
| '''scoreboard players get''' <target> <objective> {{only|java}} || Return the scoreboard value.
| Fails if an asterisk (*) is in place of <code><target></code> because of a bug{{citation needed|needs bug link}}. Fails if <code><objective></code> does not exist.
 
 
|-
 
|-
|'''scoreboard players set''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players set''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Set the target's/targets' score(s) in the given objective, overwriting any previous score. An asterisk (*) may be used in place of <code><targets></code> to represent every target tracked by the scoreboard. <code><score></code> must be between -2,147,483,648 and 2,147,483,647 (inclusive).
+
|'''scoreboard players set''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players set''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Set the targets' scores of the given objective, overwriting any previous score.
|rowspan="3"| Fails if <code><objective></code> does not exist or it is read-only.
 
 
|-
 
|-
| '''scoreboard players add''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players add''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Increments the target's/targets' score(s) in that objective by the given amount. An asterisk (*) can replace <code><targets></code> to represent all entities tracked by the scoreboard. <code><score></code> must be between 0 and 2,147,483,647 (inclusive).
+
| '''scoreboard players add''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players add''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Increments the targets' scores in that objective by the given amount.
 
|-
 
|-
| '''scoreboard players remove''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players remove''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Decrements the target's/targets' score(s) in that objective by the given amount. An asterisk (*) can replace <target> to represent all entities tracked by the scoreboard. <code><score></code> must be between 0 and 2,147,483,647 (inclusive).
+
| '''scoreboard players remove''' <targets> <objective> <score>{{only|java}}<br>'''scoreboard players remove''' <player: targets> <objective: string> <count: int>{{only|bedrock}} || Decrements the targets' scores in that objective by the given amount.
 
|-
 
|-
|'''scoreboard players random''' <player: target> <objective: string> <min: int> <max: int> {{only|bedrock}}||Sets the target's/targets' score(s) in that objective to a random number between min and max, both including. And both <code>min: int</code> and <code>max: int</code> are between -2,147,483,648 and 2,147,483,647 (inclusive).||Fails if <code>objective: string</code> does not exist, or if <min> is greater than <max>.
+
|'''scoreboard players random''' <player: target> <objective: string> <min: int> <max: int> {{only|bedrock}}||Sets the targets' scores in that objective to a random number between min and max, both inclusive.
 
|-
 
|-
| '''scoreboard players reset''' <targets> [<objective>]{{only|java}}<br>'''scoreboard players reset''' <player: target> [objective: string]{{only|bedrock}} || Deletes score or all scores for the target. If <code><objective></code> is specified, then only that objective is cleared. Otherwise, this applies to all objectives. Note that this does not merely set the score(s) to 0: it removes the entity from the scoreboard altogether (or for the given objective). An asterisk (*) can replace <code><target></code> to represent all entities tracked by the scoreboard. This will also disable the target player(s) ability to use {{cmd|trigger}} command on the specified objective{{only|java}}. || Always succeeds, even on entities who are not on the scoreboard.
+
| '''scoreboard players reset''' <targets> [<objective>]{{only|java}}<br>'''scoreboard players reset''' <player: target> [objective: string]{{only|bedrock}} || Deletes score or all scores for the target. If <code><objective></code> is specified, then only that objective is cleared. Otherwise, this applies to all objectives. Note that this does not merely set the score(s) to 0: it removes the targets from the scoreboard altogether (or for the given objective).
 
|-
 
|-
| '''scoreboard players test''' <player: target> <objective: string> <min: wildcard int> [<max: wildcard int>] {{only|bedrock}} || Tests if target's/targets' score(s) is/are within <code>min: wildcard int</code> and <code>max: wildcard int</code> (Default MAX_INT(2,147,483,647)). <code>min: wildcard int</code> can be replaced with asterisk (*) to represent MIN_INT(-2,147,483,648), and <code>max: wildcard int</code> can be replaced with asterisk (*) to represent MAX_INT(2,147,483,647). || Succeeds if target's/targets' score is in the range specified by <code>min: wildcard int</code> and <code>max: wildcard int</code>.
+
| '''scoreboard players test''' <player: target> <objective: string> <min: wildcard int> [<max: wildcard int>] {{only|bedrock}} || Tests if targets' scores are within <code>min: wildcard int</code> and <code>max: wildcard int</code> (Defaults to 2,147,483,647). <code>min: wildcard int</code> can be replaced with asterisk (*) to represent -2,147,483,648, and <code>max: wildcard int</code> can be replaced with asterisk (*) to represent 2,147,483,647.
 
|-
 
|-
| '''scoreboard players enable''' <targets> <objective> {{only|java}} || Enables the target player(s) to use the {{cmd|trigger}} command on the specified objective. This command accepts all entities, but only players are able to actually use the {{cmd|trigger}} command. Until this has been done, players that attempt to {{cmd|trigger}} that objective fail. Using the {{cmd|trigger}} command disables it again. An asterisk (*) may be used to represent all entities tracked by the scoreboard. Using this command sets the targeted entity's score to 0 if the entity did not previously have a score for that scoreboard. || Fails if <code><objective></code> is not an objective of the <code>trigger</code> criteria.
+
| '''scoreboard players enable''' <targets> <objective> {{only|java}} || Enables the target player(s) to use the {{cmd|trigger}} command on the specified objective. This command accepts non-player entities, but only players are able to actually use the {{cmd|trigger}} command. Until this has been done, players that attempt to {{cmd|trigger}} that objective fail. Using the {{cmd|trigger}} command disables it again. Note that if the targets did not previously have a score for that scoreboard, this command will set the its score to 0.
 
|-
 
|-
| '''scoreboard players operation''' <targets> <targetObjective> <operation> <source> <sourceObjective>{{only|java}}<br>'''scoreboard players operation''' <player: target> <targetObjective: string> <operation: operator> <selector: target> <objective: string>{{only|bedrock}} || Applies an arithmetic operation altering the target's/targets' score(s) in the target objective, using source target's/targets' score(s) in the source objective as input.
+
| '''scoreboard players operation''' <targets> <targetObjective> <operation> <source> <sourceObjective>{{only|java}}<br>'''scoreboard players operation''' <player: target> <targetObjective: string> <operation: operator> <selector: target> <objective: string>{{only|bedrock}} || Applies an arithmetic operation altering the targets' score(s) in the target objective, using sources' scores in the source objective as input.
   
 
<operation> may be:
 
<operation> may be:
Line 243: Line 241:
 
* ">" Max: Set target's score to source's score only if source has the greater score.
 
* ">" Max: Set target's score to source's score only if source has the greater score.
 
* "><" Swaps target's and source's scores
 
* "><" Swaps target's and source's scores
In all cases except "><", source's score in the objective remains unchanged. {{IN|java}}, if target or source have no score in the specified objective, takes it as 0. If more than one entity is specified with <code><source></code>, does the operation once with each entity's score in order of entities stored in memory. An asterisk (*) can be used in place of either <code><targets></code> or <code><source></code> to represent all entities tracked by the scoreboard.
+
In all cases except "><", source's score in the objective remains unchanged. In all cases except "><", source's score remains unchanged. If target or source isn't tracked by the specified objective, it will be set to 0. If more than one score holder is specified as sources, performs the operation once with each source's score. If more than one target score holder is specified, performs the operation foe each target one by one.
| Fails if <code><sourceObjective></code> and <code><targetObjective></code> do not exist, or if <code><targetObjective></code> is read-only. Fails {{in|bedrock}} if all requested targets/sources have no score in the specified objectives (if some do and some do not, the operation succeeds only for the combinations where both the target and the selector have a score).
 
 
|}
 
|}
   

Revision as of 10:15, 28 July 2021

For the command, see Commands/scoreboard.
Scoreboard

A screenshot of a scoreboard on the right side of the screen.

The scoreboard system is a complex gameplay mechanic utilized through commands. Mainly intended for mapmakers and server operators, scoreboards are used to track, set, and list the scores of entities in a myriad of different ways.

Objectives

Objectives each have three main parameters: A name, a criterion, and a display name. Objectives track a number of points for entities, and are displayed as integers with a full score range of -2,147,483,648 to 2,147,483,647.

An objective's name is used internally for referencing in commands, target arguments, and the file format. It enforces the 16-character name length limit in commands. In Java Edition, the allowed character set for it includes all lowercase and uppercase letters, numbers, underscore, period, minus and plus. In Bedrock Edition, it can contain any character.

An objective's display name is a raw JSON text and is displayed publicly in various situations. It does not have to be unique.

An objective's criterion determines its behavior—primarily what to track. Lists of valid criteria are provided below.

An entity's score in any objective can be changed via commands unless it's read-only. It can be increased by, decreased by, or set to a given amount. Player statistics are stored separately, and as they update, scores in these objectives are updated in parallel.

A score holder is a player's name or an entity's UUID that has scores in an objective. Scores of non-player entities can be changed only by commands, and not by game events. Unlike players, when a non player entity dies, its scores are deleted.

Commands can check entity scores by using target selection with the scores argument (syntaxed @e[scores={name=min..max}]. This argument uses <name> to specify the internal name of the tested-for objective.

For example, inputting /execute if entity @a[scores={deaths=1..}] into a command block triggers a comparator or conditional command block if any player has died at least once, assuming "deaths" is an objective of the "deathCount" criterion.

Criteria

Java Edition

Single criteria

These criteria's names consist of a single alphabetical string.

Criterion name Description Can be modified
dummy Score is only changed by commands, and not by game events such as death. This is useful for event flags, state mappings, currencies,... Yes
trigger Score is only changed by commands, and not by game events such as death. The /trigger command can be used by a player to set or increment/decrement their own score in an objective with this criterion. The /trigger command fails if the objective has not been "enabled" for the player using it, and the objective is disabled for the player after using the /trigger command on it. Note that the /trigger command can be used by ordinary players even if Cheats are off and they are not an Operator. This is useful for player input via /tellraw interfaces. Yes
deathCount Score increments automatically for a player when they die. Yes
playerKillCount Score increments automatically for a player when they kill another player. Yes
totalKillCount Score increments automatically for a player when they kill another player or a mob. Yes
health Ranges from 0 to 20 on a normal player; represents the amount of half-hearts the player has. May appear as 0 for players before their health has changed for the first time. Extra hearts and absorption hearts also count to the health score, meaning that with Attributes/Modifiers or the Health Boost or Absorption status effects, health can far surpass 20. No
xp Matches the total amount of experience the player has collected since their last death (or in other words, their score). No
level Matches the current experience level of the player. No
food Ranges from 0 to 20; represents the amount of hunger points the player has. May appear as 0 for players before their foodLevel has changed for the first time. No
air Ranges from 0 to 300; represents the amount of air the player has left from swimming under water, matches the air nbt tag of the player. No
armor Ranges from 0 to 20; represents the amount of armor points the player has. May appear as 0 for players before their armor has changed for the first time. No
Compound criteria

Compound criteria's names are divided into parts, delimited with periods (.). For example, minecraft.killed_by:minecraft.zombie is a valid compound criterion, under which player scores would increment whenever they're killed by zombie.

All statistics can be used as a compound criterion whose name is its namespaced ID.

In addition, there are some other compound criteria:

Criteria base name Description Number of sub-criteria
teamkill. Sub-criteria include team colors. Player scores increment when a player kills a member of the given colored team.

These criteria follow the complete format teamkill.<team>, where <team> is a color from the list:

16
killedByTeam. Sub-criteria include team colors. Player scores increment when a player has been killed by a member of the given colored team.

These criteria follow the complete format killedByTeam.<team>, where <team> is a color from the list:

16

All objectives based on compound criteria can be modified with commands.

Bedrock Edition

Currently, dummy is the only criterion supported. As such, score can only be changed by commands.

Display slots

Scoreboard Display

An objective with two points to the player is displayed in the "list" slot, while an objective with the display name "Quest Points" with 0 points to the player is displayed in the "sidebar" slot.

Via the /scoreboard objectives setdisplay command (see command reference), players' scores in specific objectives can be displayed in certain 'slots' in-game. Each 'display slot' can show one objective at a time, and multiple 'display slots' may be used for the same or different objectives.

Slot Description
list Displays a yellow number without a heading on the tab menu, where online players are shown.‌[Java Edition only]

Displays a white number without a heading on the Pause Menu, where online players are shown.‌[Bedrock Edition only]

Visible even in singleplayer.

sidebar Shows on the right hand side of the screen. Shows up to 15 entities with the highest score of that objective with a heading labeled with the objective's <DisplayName>. Note that players are shown even if offline, and untracked players are not shown. In addition, fake players with names starting with a # do not show up in the sidebar under any circumstances.
sidebar.team.<color> ‌[Java Edition only] There are 16 team-specific sidebar display slots. These operate the same as the standard sidebar slot, but only display to players who are on teams which use the specified color (for example, "sidebar.team.green" displays to players on "green" teams). Valid colors are: "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", "white".
belowName Shows the <Score> followed by the objective's <DisplayName> below the player's nametag above their head. This is hidden beyond ~10 blocks and when the player is sneaking. Not visible in singleplayer.

Tags

Main article: Commands/tag

Scoreboard tags are a simple list of single-word strings stored directly in the  Tags data tag of an entity. As with objectives, tags are case-sensitive.

Target selectors can be used to check whether an entity has a tag with the "tag" argument; the '!' character can be placed before a name to check for entities that do not have the tag. For example, inputting /execute if entity @a[tag=banana] into a command block provides comparator output if a player is tagged with "banana". Similarly, /execute if entity @a[tag=!banana] provides output for players who are not tagged "banana".

To test for multiple tags, use the data tag  Tags. For example, /execute if entity @a[tag=banana,tag=apple] checks for a player that has both the "apple" and "banana" tags.

Teams

"team" redirects here. For the command, see Commands/team.
Information icon
This feature is exclusive to Java Edition. 

Teams consist of a name, a display name, a member name prefix, a member name suffix, a boolean allow friendly fire option, and a list of players who are on the team.

A team's Name is used internally for reference in commands, target arguments, and the file format. It is a single, case-sensitive word.

A team's DisplayName is a JSON text component of one or more case-sensitive word, and is displayed publicly in various situations.

A team's MemberNamePrefix & MemberNameSuffix are inserted before and after the names of players on the team, respectively. Prefixes and suffixes are used in the chat, the active players list, the sidebar, and above team members' heads. These can be edited with respective commands.

The AllowFriendlyFire option controls whether or not members of a team are able to damage each other. This defaults to true, leaving PvP mechanics unchanged—ergo, players can harm their teammates. When set to false, however, players on the same team are prevented from directly damaging each other with melee attacks, bows, and Splash Potions of Harming. Note that players on the same team may still inflict negative status effects on each other with potions, even if <AllowFriendlyFire> is false. Some non-player entities in a team are also affected by this.

It is important to note that each individual team member can only be on one team; teams cannot share entities.

Commands can be used to check whether team members exist by using target selection with the "team" argument. (The '!' character may be placed before a name to check for entities not on a team.) For example, inputting /execute if entity @a[team=red] into a command block provides comparator output if any player exists on the red team. Conversely, /execute if entity @a[team=!red] provides output when there are no players on the red team. /execute if entity @a[team=!] allows output when any player is on at least one team, and /execute if entity @a[team=] allows output when no players are on any teams.

Command reference

For more details, see Commands/scoreboard.

Objectives commands

Commands Description
scoreboard objectives list List all existing objectives with their display names and criteria.
scoreboard objectives add <objective> <criteria> [<displayName>]‌[Java Edition only]
scoreboard objectives add <objective: string> dummy [displayName: string]‌[Bedrock Edition only]
Create a new objective with the given internal objective name, specified criterion, and the optional display name. In Bedrock Edition, "dummy" is the only criterion currently supported. <displayName> defaults to <objective> when unspecified. See above section for more on these arguments.
scoreboard objectives remove <objective>‌[Java Edition only]
scoreboard objectives remove <objective: string>‌[Bedrock Edition only]
Delete all references to the named objective in the scoreboard system. Data is deleted from the objectives list and score holders' scores, and if it was on a display list it is no longer displayed.
scoreboard objectives setdisplay <slot > [<objective ]‌[Java Edition only]
scoreboard objectives setdisplay <list|sidebar> [objective: string] [ascending|descending]‌[Bedrock Edition only]
scoreboard objectives setdisplay belowname [objective: string]‌[Bedrock Edition only]
Display score info for the objective in the given slot. Valid slots are listed and described in Display Slots. In Bedrock Edition, if slot is list or sidebar, there is an additional optional argument ascending|descending to specify the sort order. Note that the objective parameter is optional; if no objective is provided, this display slot is cleared (returned to its default state).
scoreboard objectives modify <objective> displayname <displayName> ‌[Java Edition only] Change the display name of the scoreboard in display slots.
scoreboard objectives modify <objective> rendertype (hearts|integer) ‌[Java Edition only] Change the display format of the player list.

Players commands

Commands Description Result
scoreboard players list [<target>]‌[Java Edition only]
scoreboard players list [playername: target]‌[Bedrock Edition only]
Lists all score holders which are tracked in some way by the scoreboard system. The optional <target> or playername: target parameter is used to list the scores of particular score holders.
scoreboard players get <target> <objective> ‌[Java Edition only] Return the scoreboard value.
scoreboard players set <targets> <objective> <score>‌[Java Edition only]
scoreboard players set <player: targets> <objective: string> <count: int>‌[Bedrock Edition only]
Set the targets' scores of the given objective, overwriting any previous score.
scoreboard players add <targets> <objective> <score>‌[Java Edition only]
scoreboard players add <player: targets> <objective: string> <count: int>‌[Bedrock Edition only]
Increments the targets' scores in that objective by the given amount.
scoreboard players remove <targets> <objective> <score>‌[Java Edition only]
scoreboard players remove <player: targets> <objective: string> <count: int>‌[Bedrock Edition only]
Decrements the targets' scores in that objective by the given amount.
scoreboard players random <player: target> <objective: string> <min: int> <max: int> ‌[Bedrock Edition only] Sets the targets' scores in that objective to a random number between min and max, both inclusive.
scoreboard players reset <targets> [<objective>]‌[Java Edition only]
scoreboard players reset <player: target> [objective: string]‌[Bedrock Edition only]
Deletes score or all scores for the target. If <objective> is specified, then only that objective is cleared. Otherwise, this applies to all objectives. Note that this does not merely set the score(s) to 0: it removes the targets from the scoreboard altogether (or for the given objective).
scoreboard players test <player: target> <objective: string> <min: wildcard int> [<max: wildcard int>] ‌[Bedrock Edition only] Tests if targets' scores are within min: wildcard int and max: wildcard int (Defaults to 2,147,483,647). min: wildcard int can be replaced with asterisk (*) to represent -2,147,483,648, and max: wildcard int can be replaced with asterisk (*) to represent 2,147,483,647.
scoreboard players enable <targets> <objective> ‌[Java Edition only] Enables the target player(s) to use the /trigger command on the specified objective. This command accepts non-player entities, but only players are able to actually use the /trigger command. Until this has been done, players that attempt to /trigger that objective fail. Using the /trigger command disables it again. Note that if the targets did not previously have a score for that scoreboard, this command will set the its score to 0.
scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>‌[Java Edition only]
scoreboard players operation <player: target> <targetObjective: string> <operation: operator> <selector: target> <objective: string>‌[Bedrock Edition only]
Applies an arithmetic operation altering the targets' score(s) in the target objective, using sources' scores in the source objective as input.

<operation> may be:

  • "+=" Addition: Add source's score to that of target
  • "-=" Subtraction: Subtract source's score from that of target
  • "*=" Multiplication: Set target's score to the product of target's and source's scores
  • "/=" (Integer) Division: Divide target's score by source's score, and use the result (rounded down) to set the target score.
  • "%=" Modulus: Divide target's score by source's score, and use the remainder to set the target score
  • "=" Assign: Set target's score to that of source
  • "<" Min: Set target's score to source's score only if source has the lesser score.
  • ">" Max: Set target's score to source's score only if source has the greater score.
  • "><" Swaps target's and source's scores

In all cases except "><", source's score in the objective remains unchanged. In all cases except "><", source's score remains unchanged. If target or source isn't tracked by the specified objective, it will be set to 0. If more than one score holder is specified as sources, performs the operation once with each source's score. If more than one target score holder is specified, performs the operation foe each target one by one.

Tags commands

Main article: Commands/tag

Teams commands

Information icon
This feature is exclusive to Java Edition. 
Main article: Commands/team

NBT format

Information icon
This feature is exclusive to Java Edition. 

The file scoreboard.dat in the 'data' folder of a Minecraft world stores the scoreboard data for that world as a GZip'd NBT file:

  • The root tag.
    •  data: The scoreboard data.
      •  Objectives: A list of compound tags representing objectives.
        • An objective.
          •  CriteriaName: The criterion of this objective.
          •  DisplayName: The display name of this objective in JSON. If none was specified during the objective's creation, this is set to {"text":"Value of Name"}.
          •  Name: The internal name of this objective.
          •  RenderType: The way the score is displayed. Can be "integer" or "hearts", but defaults to "integer".
      •  PlayerScores: A list of compound tags representing scores tracked by the scoreboard system.
        • A tracked player/objective pair with a score.
          •  Score: The score this player has in this objective.
          •  Name: The name of the player who has this score in this objective.
          •  Objective: The internal name of the objective which this player has this score in.
          •  Locked: 1 or 0 (true/false) - false if this objective is "enabled". Only meaningful for objectives with the criteria "trigger", where this must be false before a player can use the /trigger command on it.
      •  Teams: A list of compound tags representing teams.
        • A Team.
          •  AllowFriendlyFire: 1 or 0 (true/false) - true if players on this team can harm each other.
          •  SeeFriendlyInvisibles: 1 or 0 (true/false) - true if players on this team can see invisible teammates.
          •  NameTagVisibility: The value of the nametagVisibility option of this team.
          •  DeathMessageVisibility: The value of the deathMessageVisibility option of this team. Valid options are: never, hideForOtherTeams, hideForOwnTeam, always
          •  CollisionRule: The value of the collisionrule option of this team. Valid options are: always, pushOwnTeam, never, pushOtherTeams
          •  DisplayName: The display name of this team in JSON. If none was specified during the team's creation, this is set to {"text":"Value of Name"}.
          •  Name: The internal name of this team.
          •  MemberNamePrefix: The prefix prepended to names of players on this team. In JSON format.
          •  MemberNameSuffix: The suffix appended to names of players on this team. In JSON format
          •  TeamColor: The text-based color ("black", "dark_blue", etc.) given to the team. Does not exist if no color is set.
          •  Players: A list of names of players on this team.
            • The name of a player on this team.
      •  DisplaySlots: A set of slots which are displaying specific objectives. If a slot is empty, its tag is not present.
        •  slot_0: The internal name of the objective displayed in the "list" slot.
        •  slot_1: The internal name of the objective displayed in the "sidebar" slot.
        •  slot_2: The internal name of the objective displayed in the "belowName" slot.
        •  slot_3: The internal name of the objective displayed in the "sidebar.team.black" slot.
        •  slot_4: The internal name of the objective displayed in the "sidebar.team.dark_blue" slot.
        •  slot_5: The internal name of the objective displayed in the "sidebar.team.dark_green" slot.
        •  slot_6: The internal name of the objective displayed in the "sidebar.team.dark_aqua" slot.
        •  slot_7: The internal name of the objective displayed in the "sidebar.team.dark_red" slot.
        •  slot_8: The internal name of the objective displayed in the "sidebar.team.dark_purple" slot.
        •  slot_9: The internal name of the objective displayed in the "sidebar.team.gold" slot.
        •  slot_10: The internal name of the objective displayed in the "sidebar.team.gray" slot.
        •  slot_11: The internal name of the objective displayed in the "sidebar.team.dark_gray" slot.
        •  slot_12: The internal name of the objective displayed in the "sidebar.team.blue" slot.
        •  slot_13: The internal name of the objective displayed in the "sidebar.team.green" slot.
        •  slot_14: The internal name of the objective displayed in the "sidebar.team.aqua" slot.
        •  slot_15: The internal name of the objective displayed in the "sidebar.team.red" slot.
        •  slot_16: The internal name of the objective displayed in the "sidebar.team.light_purple" slot.
        •  slot_17: The internal name of the objective displayed in the "sidebar.team.yellow" slot.
        •  slot_18: The internal name of the objective displayed in the "sidebar.team.white" slot.

History

Java Edition
1.5
{{Extension DPL}}<ul><li>[[:Category:Combat|Category:Combat]]<br/>[[Category:Items]]

[[fr:Catégorie:Combat]]
[[zh:Category:武器]]</li><li>[[Balloon|Balloon]]<br/>{{exclusive|bedrock|education}}
{{education feature}}
{{ItemEntity
|image=White Balloon.png
|extratext = View [[#Gallery|all renders]]
|invimage=White Balloon
|invimage2=Orange Balloon
|invimage3=Magenta Balloon
|invimage4=Light Blue Balloon
|invimage5=Yellow Balloon
|invimage6=Lime Balloon
|invimage7=Pink Balloon
|invimage8=Gray Balloon
|invimage9=Light Gray Balloon
|invimage10=Cyan Balloon
|invimage11=Purple Balloon
|invimage12=Blue Balloon
|invimage13=Brown Balloon
|invimage14=Green Balloon
|invimage15=Red Balloon
|invimage16=Black Balloon
|renewable=No
|stackable=Yes
|size=Height: 0.4 Blocks<br>Width: 0.4 Blocks
}}

'''Balloons''' are [[entities]] that float upward when placed.

== Obtaining ==
Balloons are not available in the [[Creative]] inventory or [[commands]].

=== Crafting ===

{{Crafting
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
|description={{only|bedrock|education}}
|type= Miscellaneous
|head=1
}}
{{Crafting
|A1= Latex
|B1= Bone Meal; Lapis Lazuli; Cocoa Beans; Ink Sac
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= White Balloon; Blue Balloon; Brown Balloon; Black Balloon
|description={{only|bedrock|education}}
|type= Miscellaneous
|foot=1
}}

== Usage ==

When {{control|used}} on a [[mob]], a [[fence]], or a [[wall]], balloons attach to the mob or block, similarly to a [[lead]]. Balloons float into the air faster than the speed the [[player]] flies up, but remain grounded if tied to a fence. If tied to a mob, the balloon floats away and carries the mob into the air, before both eventually [[despawn]] or disappear.
{| class="wikitable sortable" style="text-align: left;"
|+ Balloon-attachable mobs
! Mob
! Mass
|-
| {{EntityLink|Chicken}} 
| 0.6
|-
| {{EntityLink|Cow}} 
| 1.0
|-
| {{EntityLink|Donkey}} 
| 1.0
|-
| {{EntityLink|Horse}} 
| 1.0
|-
| {{EntityLink|Iron Golem}} 
| 2.0
|-
| {{EntityLink|Llama}} 
| 1.0
|-
| {{EntityLink|Mule}} 
| 1.0
|-
| {{EntityLink|Mooshroom}}
| 1.0
|-
| {{EntityLink|Panda}}
| 1.5
|-
| {{EntityLink|Pig}}
| 0.75
|-
| {{EntityLink|Sheep}}
| 0.75
|-
| {{EntityLink|Snow Golem}}
| 1.0
|-
| {{EntityLink|Fox}}
| 0.6
|}

When a balloon is shot by an [[arrow]] or a [[trident]], or floats into a solid block, it pops, summons [[particles]], and is destroyed. It drops nothing. A balloon tied to a fence post bursts when a player strikes it in any direction.

== Sounds ==
{{Sound table
|type=bedrock
|sound=Balloon pop1.ogg
|sound2=Balloon pop2.ogg
|source=neutral
|description=When a balloon collides with a block from above
|id=balloon.pop
|volume=10.0
|pitch=1.75/2.0
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|firstcolumnname=Balloon
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=balloons
|spritetype=item
|nameid=balloon
|id=598
|form=item
|translationkey=item.balloon.black.name,item.balloon.red.name,item.balloon.green.name,item.balloon.brown.name,item.balloon.blue.name,item.balloon.purple.name,item.balloon.cyan.name,item.balloon.silver.name,item.balloon.gray.name,item.balloon.pink.name,item.balloon.lime.name,item.balloon.yellow.name,item.balloon.lightBlue.name,item.balloon.magenta.name,item.balloon.orange.name,item.balloon.white.name
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Balloon
|shownumericids=y
|generatetranslationkeys=y
|displayname=Entity
|spritename=balloons
|spritetype=entity
|nameid=balloon
|id=107
|foot=1}}

=== Metadata ===
In ''Bedrock Edition'', balloon items use the following data values:

{{/DV}}

== History ==

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:White Balloon BE1.png|32px]] [[File:Orange Balloon BE1.png|32px]] [[File:Magenta Balloon BE1.png|32px]] [[File:Light Blue Balloon BE1.png|32px]] [[File:Yellow Balloon BE1.png|32px]] [[File:Lime Balloon BE1.png|32px]] [[File:Pink Balloon BE1.png|32px]] [[File:Gray Balloon BE1.png|32px]] [[File:Silver Balloon BE1.png|32px]] [[File:Cyan Balloon BE1.png|32px]] [[File:Purple Balloon BE1.png|32px]] [[File:Blue Balloon BE1.png|32px]] [[File:Brown Balloon BE1.png|32px]] [[File:Green Balloon BE1.png|32px]] [[File:Red Balloon BE1.png|32px]] [[File:Black Balloon BE1.png|32px]] <br> [[File:White Balloon (item) BE1.png|32px]] [[File:Orange Balloon (item) BE1.png|32px]] [[File:Magenta Balloon (item) BE1.png|32px]] [[File:Light Blue Balloon (item) BE1.png|32px]] [[File:Yellow Balloon (item) BE1.png|32px]] [[File:Lime Balloon (item) BE1.png|32px]] [[File:Pink Balloon (item) BE1.png|32px]] [[File:Gray Balloon (item) BE1.png|32px]] [[File:Silver Balloon (item) BE1.png|32px]] [[File:Cyan Balloon (item) BE1.png|32px]] [[File:Purple Balloon (item) BE1.png|32px]] [[File:Blue Balloon (item) BE1.png|32px]] [[File:Brown Balloon (item) BE1.png|32px]] [[File:Green Balloon (item) BE1.png|32px]] [[File:Red Balloon (item) BE1.png|32px]] [[File:Black Balloon (item) BE1.png|32px]] Added balloons.}}
{{History||1.18.10|snap=beta 1.18.10.24|[[Bee]]s, [[boat]]s, tamed [[cat]]s, [[dolphin]]s, [[glow squid]]s, [[goat]]s, [[hoglin]]s, [[ocelot]]s, [[panda]]s, [[parrot]]s, [[polar bear]]s, [[squid]]s, [[strider]]s, tamed [[wolves]] and [[zoglin]]s can now be leashed.}}
{{History||1.18.30|snap=beta 1.18.30.28|Added the [[boat with chest]], which can be leashed.}}

{{History|education}}
{{History||1.0.27|[[File:White Balloon BE1.png|32px]] [[File:Orange Balloon BE1.png|32px]] [[File:Magenta Balloon BE1.png|32px]] [[File:Light Blue Balloon BE1.png|32px]] [[File:Yellow Balloon BE1.png|32px]] [[File:Lime Balloon.png|32px]] [[File:Pink Balloon BE1.png|32px]] [[File:Gray Balloon BE1.png|32px]] [[File:Silver Balloon BE1.png|32px]] [[File:Cyan Balloon BE1.png|32px]] [[File:Purple Balloon BE1.png|32px]] [[File:Blue Balloon.png|32px]] [[File:Brown Balloon BE1.png|32px]] [[File:Green Balloon BE1.png|32px]] [[File:Red Balloon BE1.png|32px]] [[File:Black Balloon BE1.png|32px]] <br> [[File:White Balloon (item) BE1.png|32px]] [[File:Orange Balloon (item) BE1.png|32px]] [[File:Magenta Balloon (item) BE1.png|32px]] [[File:Light Blue Balloon (item) BE1.png|32px]] [[File:Yellow Balloon (item) BE1.png|32px]] [[File:Lime Balloon (item) BE1.png|32px]] [[File:Pink Balloon (item) BE1.png|32px]] [[File:Gray Balloon (item) BE1.png|32px]] [[File:Silver Balloon (item) BE1.png|32px]] [[File:Cyan Balloon (item) BE1.png|32px]] [[File:Purple Balloon (item) BE1.png|32px]] [[File:Blue Balloon (item) BE1.png|32px]] [[File:Brown Balloon (item) BE1.png|32px]] [[File:Green Balloon (item) BE1.png|32px]] [[File:Red Balloon (item) BE1.png|32px]] [[File:Black Balloon (item) BE1.png|32px]] Added balloons.}}
{{History||1.18.32|snap=1.18.10.04|[[Bee]]s, [[boat]]s, tamed [[cat]]s, [[dolphin]]s, [[glow squid]]s, [[goat]]s, [[hoglin]]s, [[ocelot]]s, [[panda]]s, [[parrot]]s, [[polar bear]]s, [[squid]]s, [[strider]]s, tamed [[wolves]] and [[zoglin]]s can now be leashed.}}
{{History|foot}}
==Gallery==

=== Colors ===
<gallery>
Orange Balloon.png
Magenta Balloon.png
Light Blue Balloon.png
Yellow Balloon.png
Lime Balloon.png
Pink Balloon.png
Gray Balloon.png
Light Gray Balloon.png
Cyan Balloon.png
Purple Balloon.png
Blue Balloon.png
Brown Balloon.png
Green Balloon.png
Red Balloon.png
Black Balloon.png
</gallery>

=== [[Event servers]] ===
<gallery>
File:Legends Balloon.png|Differently designed balloons featured in the ''[[Minecraft Legends Live Event]]''.
File:Sniffer Balloon (Trails and Tales Summer Event) Render.png|A [[Sniffer]] balloon, featured in the [[Trails & Tales Event]].
File:Camel Balloon (Trails and Tales Summer Event) Render.png|A balloon of a [[Camel]], featured in the Trails & Tales Event.
File:Balloon Bundle (Trails and Tales Summer Event) Render.png|Bundle of balloons from the Trails & Tales Event.
</gallery>{{Items}}
{{Entities}}
{{Education Edition}}

[[Category:Education Edition entities]]
[[Category:Education Edition items]]

[[de:Ballon]]
[[it:Palloncino]]
[[ja:風船]]
[[ko:풍선]]
[[pl:Balon]]
[[pt:Balão]]
[[ru:Воздушный шар]]
[[zh:气球]]</li></ul>
13w04aAdded scoreboard.
13w05aAdded team-based functionality.
1.7.2
{{Extension DPL}}<ul><li>[[Ankle Monitor|Ankle Monitor]]<br/>{{Joke feature}}
{{Item
| title = Ankle Monitor
| image = Ankle Monitor.png
| renewable = No
| stackable = Yes (64)
}}

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

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

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

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

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

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

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

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

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

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

== Gallery ==

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

==References==
{{Reflist}}

{{Items}}
{{Jokes}}

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

[[es:Ankle monitor]]</li><li>[[Firework Rocket|Firework Rocket]]<br/>{{redirect|Firework}}
{{ItemEntity
|image=Firework Rocket.png
|renewable='''Trail Effect''':No<br>'''All Others''':Yes
|stackable=Yes (64)‎
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
|networkid=76
}}
A '''firework rocket''' is an [[item]] (and [[entity]]) used for creating decorative explosions, boosting when flying with [[elytra]], and loading into a [[crossbow]] as ammunition.

== Obtaining  ==

Fireworks can be obtained by crafting. {{IN|java}}, a firework with no explosion effect is available on the [[Creative]] inventory and can be crafted as shown below. {{IN|bedrock}}, fireworks with the different base colors or no explosion are available in the Creative inventory.

=== Crafting ===

{{Crafting
|head=1
|showname=0
|showdescription=1
|Paper
|; ; Gunpowder
|; Gunpowder; Gunpowder
|Gunpowder
|Output=Firework Rocket,3
|description=When crafted this way (without a firework star), the rocket does not have explosion effects. The value of gunpowder affects the [[Firework Rocket#Duration and direction|flight duration]].
|type=Miscellaneous
}}
{{Crafting
|Any Firework Star
|Paper
|; ; Gunpowder
|; Gunpowder; Gunpowder
|Gunpowder
|Output= Firework Rocket,3
|description=Adding more gunpowder increases the duration of the rocket. Up to three gunpowder can be used. Up to five firework stars can also be used with three gunpowder. Up to seven firework stars can be used by using firework stars instead of additional gunpowder. All firework stars explode almost simultaneously when the rocket detonates.
|type=Miscellaneous
|foot=1
}}

== Usage ==

=== Launching fireworks ===
To launch a firework rocket, {{control|use}} its item on a block. They can also be launched from [[dispenser]]s and [[crossbow]]s. If shot from a [[Multishot]] [[crossbow]], then 3 rockets fire with the same effects.

=== Elytra ===
{{control|Using}} a firework rocket while flying with [[elytra]] propels the player in the direction they are facing. The duration of the speed boost depends on the flight duration of the rocket. If the rocket is equipped with a firework star of any kind, the player takes damage when it explodes.

=== Crossbow ===
A firework rocket can be used as ammunition for [[crossbow]]s, although it deals [[damage]] only if it has an [[explosion]] effect. A higher flight duration gives the firework rocket a longer range, and more damage is added per firework star. The [[Piercing]] enchantment has no effect on firework rockets shot from a crossbow.

{{IN|java}}, if a firework rocket shot from a [[crossbow]] hits an [[entity]], the rocket instantly [[explosion|explodes]], no matter the flight duration. Attempting to do this {{in|bedrock}}, however, results in the firework passing through the entity,<ref>[[bugtracker:MCPE-52675|MCPE-52675]]</ref> so the [[player]] must plan where to aim.

== Behavior ==
{{see also|Firework Star#Effects}}

Once launched, fireworks fly out vertically, with random horizontal offset up to 5 blocks. {{IN|bedrock|java}}, fireworks can fly in any of the 6 directions a dispenser can point. After [[#Duration and direction|some time]], the firework explodes into a colorful explosion based on the effects of the [[firework star]]s added upon crafting, or no explosion if no firework star was used. If multiple firework stars were added to the rocket upon crafting, they all explode simultaneously.

The explosion of a firework rocket deals damage to mobs and players that are within 5 blocks and not obstructed by [[solid block]]s. The maximum damage of a rocket with one firework star is {{hp|7}}, with the damage decreasing with distance. Each additional firework star on the rocket adds {{hp|2}} points of damage, for a maximum damage of {{hp|19}} with 7 stars. Using commands to add additional firework stars results in more damage. The damage dealt is unaffected by any other ingredients used. The explosion does not destroy end crystals nor damage the Ender dragon, but does destroy armor stands.

There is a delay between the detonation and the player hearing the sound, emulating real fireworks, but this sound travels much more slowly than in the real world.<ref>{{Tweet|jeb|277075644804907009|However, no sound effects for fireworks yet... but everything's implemented, so they can be added without doing a new snapshot|December 7, 2012}}</ref><ref>{{Tweet|jeb|277075517226762242|Haha, @igblan , the speed of sound is 40 m/s, because the realistic speed of ~340 m/s didn't work well in Minecraft scale|December 7, 2012}}</ref> {{IN|java}}, the explosion of a firework can be seen 64 blocks away, regardless of its height. {{IN|bedrock}}, the explosion can be seen from your render distance.

If the explosion exceeds the (unmodded) [[particle]] limit of 16,384, the oldest particles are removed before displaying new ones, resulting in severely diminished firework quality / duration. At most a firework should have 3 trail stars, more than that could waste diamonds, firework stars, and other fireworks. Particle counts per star are:

{| class="wikitable" data-description="Particle counts per firework star"
|-
! Ball Type !! Plain !! Trail
|-
| Small || 98 || ~1300
|-
| Large || 387 || 4000+
|-
| Star || 122 || ~1600
|-
| Creeper || 266 || ~3500
|-
| Burst || 72 || ~930
|}

Twinkle effect adds 2 particles to the count.

Like most other entities, they can be moved by [[water]] and [[explosion]]s, and teleported via [[portal]]s. They also cannot move through solid surfaced blocks, upon hitting one, they either move to a side or explode based on the duration. If a firework explodes under a block, its explosion is flattened.

=== Duration and direction ===

Fireworks travel different heights based on the amount of gunpowder added. The number is displayed as a tag on the item's tooltip with the description of "Flight Duration".

The height it rises is between 8 and 20 blocks with 1 gunpowder, 18 to 34 blocks with 2 gunpowder, and 32 to 52 blocks with 3 gunpowder. 
(Note: Using command blocks, firework rockets with higher durations go higher and keep accelerating with virtually no terminal velocity. If the duration is long enough, the firework rocket could reach heights of over 1,000,000 blocks and speeds of over 10,000 m/s in a matter of minutes. Such fireworks with significant X and Z motions speed up sideways exponentially and reach outside the world boundary in a matter of seconds.{{only|java}})

When spawned, <!-- server-side --> fireworks have a vertical speed of .05 and a random small X and Z speed (random value near zero with a standard deviation of .001).  Each firework also determines its lifetime in ticks by 10 × (number of gunpowder + 1) + random value from 0 to 5 + random value from 0 to 6, after which it explodes.  Each tick, the firework accelerates horizontally by multiplying its X and Z velocities by 1.15, and vertically by adding a constant factor of .04.

Fireworks can be made to travel different directions by being dispensed or launched under flowing water. The firework's direction combines with the flow of the water to go diagonally.

Firework rockets without firework stars shot from a crossbow upon hitting terrain elements will traverse along until stopped by a ledge or into unobstructed terrains again continuing its original flight path. Ledges as tall as one pixel high (e.g. from [[Dirt Path|Dirt Paths]] to [[Grass Block|Grass Blocks]]) will also block the firework. They will still vanish if they hit entities early amidst their flight.

==Village Raids==
After successfully defending a village from a [[Raid]] the villagers may celebrate by setting off firework rockets.

==Boosting elytra==
Fireworks can be used to boost [[elytra]] when in flight. Normally, elytra can glide for a short distance, but with the use of fireworks, the player can fly a long distance, gain speed, and take off from the ground. 

Simply using the firework rocket with elytra spread boosts the player in the direction the player faces. It can leave behind a trail sometimes.

Although fireworks with firework stars can be used, the player takes blast damage if they use it in flight. 

There are four types of rockets, with three types of flight duration. Higher flight durations mean longer boosts. {{IN|bedrock}}, the fireworks obtained from the Creative menu have a flight duration of 1, while {{in|java}}, the fireworks obtained in the Creative menu have a flight duration of 1, 2, or 3.

==Sounds ==
{{Edition|Java}}:<br>
Firework rockets use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Firework blast.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a non-large firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.blast
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework blast far.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a non-large firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.blast_far
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework large blast.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a large firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.large_blast
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework large blast far.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a large firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.large_blast_far
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework twinkle.ogg
|subtitle=Firework twinkles
|source=ambient
|description=When a twinkle firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.twinkle
|translationkey=subtitles.entity.firework_rocket.twinkle
|volume=20.0
|pitch=0.9-1.05
|distance=16}}
{{Sound table
|sound=Firework twinkle far.ogg
|subtitle=Firework twinkles
|source=ambient
|description=When a twinkle firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.twinkle_far
|translationkey=subtitles.entity.firework_rocket.twinkle
|volume=20.0
|pitch=0.9-1.05
|distance=16}}
{{Sound table
|sound=Firework launch.ogg
|subtitle=Firework launches
|source=ambient
|description=When a dispenser shoots, a player uses, or a crossbow fires a firework rocket
|id=entity.firework_rocket.launch
|translationkey=subtitles.entity.firework_rocket.launch
|volume=3.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Firework launches
|source=neutral
|description=When a dispenser fires a firework rocket
|id=entity.firework_rocket.shoot
|translationkey=subtitles.entity.firework_rocket.launch
|volume=1.0
|pitch=1.2
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Firework blast.ogg
|source=ambient
|description=When a non-large firework rocket explodes
|id=firework.blast
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework large blast.ogg
|source=ambient
|description=When a large firework rocket explodes
|id=firework.large_blast
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework twinkle.ogg
|source=ambient
|description=When a twinkle firework rocket explodes
|id=firework.twinkle
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework launch.ogg
|source=ambient
|description=When a dispenser shoots, a player uses, or a crossbow fires a firework rocket
|id=firework.launch
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bow shoot.ogg
|source=ambient
|description=''Unused sound event''
|id=firework.shoot
|volume=1.0
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=item
|nameid=firework_rocket
|aliasid=fireworks
|id=519
|form=item
|translationkey=item.fireworks.name
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=entity
|nameid=fireworks_rocket
|id=72
|foot=1}}

===Item data===

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

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

===Entity data===

{{el|java}}:
{{main|Entity format}}
{{/ED}}

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

==Advancements ==
{{load advancements|Bullseye;Ol' Betsy}}

==History==

{{History|java}}
{{History||November 24, 2012|link=none|[[Jeb]] stated that there may be fireworks in ''Minecraft'' at the ''Future Updates with the Minecraft PC Team'' panel at [[MINECON 2012]].}}
{{History||December 5, 2012|link={{tweet|jeb|276367442362630144}}|Jeb released the first image of fireworks, along with the information that colors, fade, height, effects and shapes are [[crafting|craftable]].}}
{{History||December 7, 2012|link=https://twitter.com/jeb_/status/277075087503536128|Jeb mentions that fireworks should probably scare [[wolves]] and potentially have other effects on mobs.}}
{{History||1.4.6|snap=12w49a|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets.
|Firework rockets cannot be obtained within the [[Creative inventory]].}}
{{History|||snap=12w50a|Added [[sound]] and more effects to firework rockets.}}
{{History||1.10|snap=16w20a|The firework rocket [[crafting]] recipe now produces 3 rockets, rather than 1.}}
{{History||1.11|snap=16w32a|The entity ID has been changed from <code>FireworksRocketEntity</code> to <code>fireworks_rocket</code>.}}
{{History||1.11.1|snap=16w50a|Firework rockets can now cause [[damage]] to [[entity|entities]] that are within their [[explosion]] radius.
|Firework rockets can now boost [[player]]s while flying with [[elytra]].}}
{{History||1.13|snap=17w47a|The ID has been changed from <code>fireworks</code> to <code>firework_rocket</code>.
|The fade effects on fireworks can now be added by combining the firework star with [[dye]]s.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 401.}}
{{History||1.13|snap=?|Firework rockets are now available in the [[Creative]] [[Inventory]]. However, it does not show a flight duration}}
{{History|||snap=pre5|The [[entity]] ID of firework rockets has been changed to <code>firework_rocket</code>.}}
{{History||1.14|snap=18w43a|Fireworks can now be shot from [[crossbow]]s.
|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History||1.15|snap=19w36a|Firework rockets dispensed from a [[dispenser]] now travel in the direction they were fired.}}
{{History||1.17|snap=20w45a|Simple firework rockets with one gunpowder can now be crafted using the [[recipe book]].}}
{{History||1.19.3|snap=22w45a|All three flight durations of firework rockets are now available in the Creative inventory.<ref>{{bug
|MC-194390||A firework rocket from the creative inventory doesn't show a flight duration|Fixed}}</ref>}}


{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets. 
|Firework rockets are available in the Creative inventory in 17 variants, sixteen colors in small ball duration 1, plus one additional preset with only duration 1.{{verify|type=update|Is this the right snapshot?}}{{info needed}}}}
{{History||1.8.0|snap=beta 1.8.0.10|Firework rockets can now be held in the off-hand and be shot from [[crossbow]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of firework rockets has been changed from <code>fireworks</code> to <code>firework_rocket</code>.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets.
|Firework rockets are available in five types in the Creative inventory. The presets are as follows:
* Duration 1, small ball, light blue, twinkle
* Duration 2, creeper shaped, green
* Duration 2, burst, red, fade to orange
* Duration 3, burst, magenta, fade to blue, twinkle
* Duration 2, star shaped, yellow, fade to orange, trail}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The crafting interface has been updated to allow crafting [[firework star]]s and fireworks.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Firework rockets can now boost [[player]]s while flying with [[elytra]].}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Firework rockets now [[damage]] players if there is a [[firework star]] applicated to the firework rocket.}}
{{History||xbox=TU56|xbone=CU47|ps=1.55|wiiu=Patch 26|switch=1.0.6|Firework rockets now produce 3 rockets upon [[crafting]] them instead of 1.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|Added new firework rocket models.}}
{{History|PS4}}
{{History||1.90|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History|foot}}

==Issues==

{{issue list}}

== Trivia==
* Launching a rocket by hand on a wooden [[pressure plate]] activates it. The same doesn't hold for stone pressure plates, or for a [[dispenser]] placing a rocket onto a wooden pressure plate.
* New Year's Eve is what inspired [[Jeb]] to add fireworks.<ref>{{tweet|jeb|277080498814189568|@SPvs_TheWorld New Year's Eve|December 7, 2012}}</ref>
*If the player shoots a firework into a [[Nether portal]], it explodes in [[the Nether]].
*There are around 2×10{{^|136}} distinct fireworks.

==Gallery==

<gallery>
File:Firework jeb twitter.jpg|[[Jeb]]'s first image of Fireworks, also showing that they can be shot from dispensers.
File:1.4.6 release image.png|1.4.6 Release image.
File:Flatexplosion.png|An example of a flattened firework explosion.
File:Creeper firework.png|Creeper face shaped firework.
</gallery>

==References==

{{Reflist}}

{{Items}}
{{Entities}}

[[cs:Rachejtle]]
[[de:Feuerwerksrakete]]
[[es:Cohete de fuegos artificiales]]
[[fr:Feu d'artifice]]
[[hu:Tűzijáték rakéta]]
[[ja:ロケット花火]]
[[ko:폭죽 로켓]]
[[nl:Vuurpijl]]
[[pl:Fajerwerk]]
[[pt:Fogo de artifício]]
[[ru:Пиротехническая ракета]]
[[th:ดอกไม้ไฟ]]
[[zh:烟花火箭]]
[[Category:Renewable resources]]</li></ul>
13w36aAdded statistic-based objective criteria.
1.8
{{Extension DPL}}<ul><li>[[:Category:Plants|Category:Plants]]<br/>All pages covering blocks of such things as tall grass and flowers.

[[Category:Blocks]]
[[Category:Items]]

[[cs:Kategorie:Rostliny]]
[[es:Categoría:Plantas]]
[[fr:Catégorie:Plante]]
[[hu:Kategória:Növények]]
[[it:Categoria:Piante]]
[[ja:カテゴリ:植物]]
[[ko:분류:식물]]
[[nl:Categorie:Planten]]
[[pl:Kategoria:Rośliny]]
[[pt:Categoria:Plantas]]
[[ru:Категория:Растения]]
[[th:หมวดหมู่:พืช]]
[[zh:Category:植物]]</li><li>[[:Category:Invalid data value items|Category:Invalid data value items]]<br/>[[Category:Items]]</li></ul>
14w02aEntities other than players can now be part of teams and have objective scores.
14w06aAdded the trigger and team kill-based objective criteria.
Added /scoreboard players enable.
"*" can be used in a player name argument to represent all players tracked by the scoreboard.
Added the "objective" argument to /scoreboard players reset.
Statistic objective criteria now use named IDs instead of numerical IDs.
Added the achievement.overpowered objective criterion.
14w07aAdded /scoreboard players operation and /scoreboard players test.
Scores for fake players that have a name beginning with "#" won't appear in the sidebar.
Added team-specific sidebar display slots.
Added the nametagVisibility team option.
14w10aAdded the deathMessageVisibility team option.
Added a dataTag argument to /scoreboard players set, /scoreboard players add, and /scoreboard players remove.
Added the stat.crouchOneCm, stat.sprintOneCm, and stat.timeSinceDeath objective criteria.
14w25aAdded =, <, and > to /scoreboard players operation.
14w29aPlayer/entity names in the sidebar are now secondarily sorted by alphabetical order.
14w30aAdded the stat.talkedToVillager and stat.tradedWithVillager objective criteria.
?Added >< to /scoreboard players operation.
1.8.2
{{Extension DPL}}<ul><li>[[Spider Eye|Spider Eye]]<br/>{{Item
| title = Spider Eye
| image = Spider Eye.png
| renewable = Yes
| heals = {{Hunger|2}}
|effects={{EffectLink|Poison}} (0:05)
| stackable = Yes (64)
}}
A '''spider eye''' is a poisonous [[food]] and [[brewing]] item.

== Obtaining ==

=== Mob loot ===

==== Spiders ====
[[Spider]]s and [[cave spider]]s have a {{frac|1|3}} chance of dropping a [[spider eye]] when killed by a player or tamed wolf, but not when killed by environmental damage (such as falling). The maximum amount of spider eyes is increased by 1 per level of [[Looting]]. The chance of a spider '''not''' dropping any spider eyes can be found using the formula <code>2 / (Looting Level + 3)</code>. For example, Looting III gives a {{frac|1|3}} chance of not dropping any spider eyes. All other amounts have an equal chance of occurring.

==== Witches ====

[[Witch]]es have a chance of dropping 0–6 spider eyes upon death. This is increased by 3 per level of [[Looting]], for a maximum of 0-15 spider eyes.

=== Chest loot ===

{{LootChestItem|spider-eye}}

== Usage ==

=== Food ===
When [[Food|eaten]], a spider eye restores {{hunger|2}} [[Hunger|hunger points]] and 3.2 [[Hunger#Mechanics|saturation points]], giving a nourishment value of 1.6. It also applies a [[Poison]] [[effect]] lasting 5 seconds to the player, causing {{hp|4|poisoned=1}} damage, which reduces hunger/saturation by 6 points.

=== Crafting ingredient ===

{{crafting usage}}

=== Brewing ingredient ===

{{brewing
  |showname=1
  |head=1
  |Spider Eye
  |Mundane Potion
  |base=Water Bottle
}}
{{brewing
  |foot=1
  |Spider Eye
  |Potion of Poison
}}

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Spider Eye
|spritetype=item
|nameid=spider_eye
|id=278
|form=item
|foot=1}}

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

== Video ==

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

== History ==

{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Spider Eye JE1 BE1.png|32px]] Added spider eyes. 
|Spider eyes can be used to craft [[fermented spider eye]]s.}}
{{History|||snap=Beta 1.9 Prerelease 3|Spider eyes can now be [[brewing|brewed]] in a [[water bottle]] to create a [[Mundane Potion]], or in an [[Awkward Potion]] to create a [[Potion of Poison]].}}
{{History||1.4.2|snap=12w38b|Spider eyes can now be dropped by [[witch]]es.}}
{{History||1.9|snap=15w44a|Spider eyes can now be found in [[desert pyramid|desert temple]] [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 375.}}
{{History||1.14|snap=18w43a|[[File:Spider Eye JE2 BE2.png|32px]] The texture of spider eyes has been changed.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Spider Eye JE1 BE1.png|32px]] Added spider eyes.|Spider eyes can be used to craft [[fermented spider eye]]s and for [[brewing]].}}
{{History||v0.13.0|snap=build 1|Spider eyes can now be found in [[desert pyramid|desert temple]] [[chest]]s.}}
{{History||v0.14.0|snap=build 1|Spider eyes can now dropped by [[witch]]es.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Spider Eye JE2 BE2.png|32px]] The texture of spider eyes has been changed.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Spider Eye JE1 BE1.png|32px]] Added spider eyes.}}	
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|[[File:Spider Eye JE2 BE2.png|32px]] The texture of spider eyes has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Spider Eye JE1 BE1.png|32px]] Added spider eyes.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}} 


{{items}}



[[cs:Pavoučí oko]]
[[de:Spinnenauge]]
[[es:Ojo de araña]]
[[fr:Œil d'araignée]]
[[hu:Pókszem]]
[[it:Occhio di ragno]]
[[ja:クモの目]]
[[ko:거미 눈]]
[[nl:Spinnenoog]]
[[pl:Oko pająka]]
[[pt:Olho de aranha]]
[[ru:Паучий глаз]]
[[zh:蜘蛛眼]]
[[Category:Food]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li><li>[[Horse Saddle|Horse Saddle]]<br/>{{About|the removed item|the current item|Saddle}}
{{outdated feature|edition=java}}
{{Item
| title = Horse Saddle
| image = Horse Saddle.png
| renewable = Yes
| stackable = Yes (32)
}}

'''Horse saddles''' were [[item]]s which allowed the player to ride [[horse]]s.

== Obtaining ==
=== Crafting ===
{{crafting |ignoreusage=1
|A1=Leather    |B1=Leather    |C1=Leather
|A2=Leather    |B2=Iron Ingot |C2=Leather
|A3=Iron Ingot                |C3=Iron Ingot
|Output=Horse Saddle
}}

== Usage ==
Horse saddles worked just like regular [[saddle]]s, but for [[horse]]s instead of [[pig]]s. Taming a horse was required before putting a horse saddle on it. Unlike any other items, horse saddles could be stacked up to 32.

== Sounds ==
''None''<ref>{{ytl|2a6BQeW6is4|t=330}}; sounds for horses were not added until [[13w22a]]</ref>

== Data values ==
=== ID ===
{{ID table
|nonameid=y
|shownumericids=y
|showforms=y
|generatetranslationkeys=java
|displayname=Horse Saddle
|spritetype=item
|id=416
|form=item
|translationkey=item.horsesaddle.name
|foot=y}}

== History ==
{{History|java}}
{{History||1.6.1|snap=13w16a|[[File:Horse Saddle JE1.png|32px]] Added horse saddles.}}
{{History|||snap=13w18a|Horse saddles have been removed.
|[[Horse]]s and [[zombie horse]]s can now be ridden using regular [[saddle]]s.}}
{{History|foot}}

== Issues ==
Horse saddles have been removed from the game, and as such are no longer supported.

{{Items}}
{{Removed Features}}

[[es:Montura de caballo]]
[[fr:Selle de cheval]]
[[it:Sella di cavallo]]
[[ja:ウマの鞍]]
[[ko:말 안장]]
[[pt:Sela para cavalo]]
[[zh:马鞍]]</li></ul>
Added the stat.cauldronFilled, stat.cauldronUsed, stat.armorCleaned, stat.bannerCleaned, stat.brewingstandInteraction, stat.beaconInteraction, stat.dropperInspected, stat.hopperInspected, stat.dispenserInspected, stat.noteblockPlayed, stat.noteblockTuned, stat.flowerPotted, stat.trappedChestTriggered, stat.enderchestOpened, stat.itemEnchanted, stat.recordPlayed, stat.furnaceInteraction, stat.craftingTableInteraction, stat.chestOpened objective criteria.
1.9
{{Extension DPL}}<ul><li>[[Leggings|Leggings]]<br/>{{Update|Include information about armor trims and updated netherite upgrade information.}}
{{Item
| image = <gallery>
Leather Pants.png | Leather
Chainmail Leggings.png | Chainmail
Iron Leggings.png | Iron
Diamond Leggings.png | Diamond
Golden Leggings.png | Golden
Netherite Leggings.png | Netherite
</gallery>
| durability = 
* Leather: 75
* Chainmail: 225
* Iron: 225
* Golden: 105
* Diamond: 495
* Netherite: 555
| renewable = 
* '''Netherite''': No
* '''All others''': Yes
| stackable = No
}}
'''Leggings''' are a type of [[armor]] that covers the lower body of the player. There are six types of leggings: '''leather pants'''<ref group=fn>Known as '''leather trousers''' in British English variant.{{only|java}}</ref>, '''chainmail leggings''', '''iron leggings''', '''diamond leggings''', '''gold leggings''', and '''netherite leggings'''.

== Obtaining ==

=== Crafting ===

{{crafting
  |head=1
  |showname=0
  |showdescription=1
  |name=Leggings
  |A1= Leather;Gold Ingot;Iron Ingot;Diamond
  |B1= Leather;Gold Ingot;Iron Ingot;Diamond
  |C1= Leather;Gold Ingot;Iron Ingot;Diamond
   |A2= Leather;Gold Ingot;Iron Ingot;Diamond
   |C2= Leather;Gold Ingot;Iron Ingot;Diamond
    |A3= Leather;Gold Ingot;Iron Ingot;Diamond
    |C3= Leather;Gold Ingot;Iron Ingot;Diamond
  |Output= Leather Pants;Golden Leggings;Iron Leggings;Diamond Leggings
  |type= Combat
}}
{{crafting
  |foot=1
  |ignoreusage=1
  |name=Leggings
  |ingredients=Damaged Matching Leggings
  |Damaged Leather Pants; Damaged Golden Leggings; Damaged Chainmail Leggings; Damaged Iron Leggings; Damaged Diamond Leggings; Damaged Netherite Leggings
  |Damaged Leather Pants; Damaged Golden Leggings; Damaged Chainmail Leggings; Damaged Iron Leggings; Damaged Diamond Leggings; Damaged Netherite Leggings
  |Output= Leather Pants; Golden Leggings; Chainmail Leggings; Iron Leggings; Diamond Leggings; Netherite Leggings
  |description= The durability of the two leggings is added together, plus an extra 5% durability. Removes any enchantments.
  |type= Combat
}}

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

=== Repairing ===
==== Grinding ====
{{Grinding
|showdescription=1
|ingredients=Damaged Matching Leggings
|Damaged Leather Pants; Damaged Chainmail Leggings; Damaged Iron Leggings; Damaged Golden Leggings; Damaged Diamond Leggings; Damaged Netherite Leggings
|Damaged Leather Pants; Damaged Chainmail Leggings; Damaged Iron Leggings; Damaged Golden Leggings; Damaged Diamond Leggings; Damaged Netherite Leggings
|Leather Pants; Chainmail Leggings; Iron Leggings; Golden Leggings; Diamond Leggings; Netherite Leggings
|description=The durability of the two leggings are added together, plus an extra 5% durability.
}}

==== [[Anvil mechanics#Unit repair|Unit repair]] ====
Leggings may be repaired on an [[anvil]] by combining them with their corresponding crafting material (leather, gold ingots, iron ingots, diamonds, or netherite ingots), with each repair material restoring 25% of the leggings' maximum durability, rounded down. Any enchantments are retained. Chainmail leggings may be repaired in this way with iron ingots. Leggings may also be repaired by crafting them together with another pair of leggings of the same material, although enchantments are lost.

=== Mob loot ===

If a [[zombie]], [[piglin]], [[zombie pigman]] or [[skeleton]] is wearing armor, there is an 8.5% chance (9.5% with Looting I, 10.5% with Looting II and 11.5% with Looting III) for the mob to drop leggings upon death. The leggings are usually badly damaged and may be enchanted.

[[Vindicator]]s and [[pillager]]s spawn in [[raid]]s have a chance to drop iron leggings, which are usually badly damaged, and may be enchanted.

=== Chest loot ===
{{IN|BE}}, a sealed room in [[woodland mansion]]s can appear that has a chest sometimes containing an [[Efficiency]] I leather pants.<ref>{{bug|MCPE-109048}}</ref>
{{LootChestItem|leather-pants,random-enchanted-leather-pants,chainmail-leggings,iron-leggings,level-enchanted-iron-leggings,golden-leggings,random-enchanted-golden-leggings,diamond-leggings,damaged-diamond-leggings,level-enchanted-diamond-leggings,damaged-random-enchanted-diamond-leggings,damaged-random-enchanted-diamond-leggings-2}}

=== Trading ===
{{IN|java}}, novice-level armorer villagers have a 40% chance to sell iron leggings for 7 emeralds. Apprentice-level armorer villagers have a 50% chance to sell chainmail leggings for 3 emeralds. Expert-level armorer villagers always sell enchanted diamond leggings for 18-35 emeralds. Novice-level leatherworker villagers have a {{frac|2|3}} chance to sell randomly dyed<ref group="note">The leather armor has a random color created by two dyes (possibly the same dye twice).</ref> leather pants for 3 emeralds.

Armorer villagers may give the players with the [[Hero of the Village]] effect chainmail leggings. {{only|java}}

{{IN|bedrock}}, novice-level armorer villagers have a 25% chance of selling iron leggings for 7 emeralds. Apprentice-level armorers have a {{frac|1|3}} chance to sell chainmail leggings for 3 emeralds. Expert-level armorers have a 50% chance to sell enchanted diamond leggings for 14 emeralds. Novice-level leatherworker villagers have 50% chance to sell leather pants for 3 emeralds.

{{notelist|columns=1}}

== Usage ==

Leggings can be placed in the 3rd armor slot of a player's [[inventory]] for activation.

=== Defense points ===

Defense points are each signified by half of a shirt of mail in the armor bar above the health bar. Each defense point reduces any damage dealt to the player that is absorbed by armor by 4%, increasing additively with the number of defense points. Different materials and combinations of armor provide different levels of defense.

The following table shows the number of defense points added by leggings.

{| class="wikitable" data-description="Defense points"
|-
!scope="col" | Material
!scope="col" | Defense points
|-
!scope="row" | Leather
| {{armor|2}}
|-
!scope="row" | Golden
| {{armor|3}}
|-
!scope="row" | Chain
| {{armor|4}}
|-
!scope="row" | Iron
| {{armor|5}}
|-
!scope="row" | Diamond
| rowspan="2" | {{armor|6}}
|-
!scope="row" | Netherite
|}

=== Knockback resistance ===
Netherite leggings provide 10% knockback resistance.

=== Durability ===

The following table shows the amount of damage each piece of armor can absorb before being destroyed.

Any "hit" from a damage source that can be blocked by armor removes one point of durability from each piece of armor worn for every {{hp|4}} of incoming damage (rounded down, but never below 1). Damage taken but not protected by that armor (such as [[Damage#Fall damage|falling]] or [[Damage#Drowning|drowning]]) does not damage the armor, even if it is enchanted to protect against that type of damage. The following chart displays how many hits leggings can endure.

Netherite armor is not damaged by [[lava]] or [[fire]] when worn.

{| class="wikitable" data-description="Durability"
|-
! Material
!Durability
|-
!scope="row" | Leather
| 75
|-
!scope="row" | Golden
| 105
|-
!scope="row" | Chain/Iron
| 225
|-
!scope="row" | Diamond
| 495
|-
!scope="row" | Netherite
| 555
|}

=== Enchantments ===

Leggings can receive the following [[enchantment]]s:
{| class="wikitable"
|-
! Enchantment !! Max Level  !! Notes
|-
| [[Fire Protection]] || IV || <ref group=note name=exclusive>Fire Protection, Blast Protection, Projectile Protection and Protection are mutually exclusive</ref>
|-
| [[Projectile Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Blast Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Unbreaking]] || III ||
|-
|  [[Thorns]] || III || <ref group="note" name="anvil">Only from using an [[anvil]] and [[enchanted book]]s.</ref>
|-
| [[Mending]] || I || <ref group=note name="anvil2">Only from chest loot, fishing, or an anvil and enchanted books.</ref>
|-
| [[Curse of Binding]] || I || <ref group="note" name="anvil2"/>
|-
| [[Curse of Vanishing]] || I || <ref group="note" name="anvil2"/>
|-
| [[Swift Sneak]] || III || <ref group=note name="anvil"/>
|}
{{notelist}}

=== Smelting usage ===

{{Smelting|showname=1|Iron Leggings;Chainmail Leggings;Golden Leggings|Iron Nugget;Iron Nugget;Gold Nugget|0,1}}
=== Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to ''golden'' leggings and pick them up, examining them for 6 to 8 seconds. Piglins can wear other leggings but are not attracted to them. They prefer stronger leggings over weaker leggings, with one exception: They always prefer golden leggings over all other leggings, throwing out stronger leggings in favor of gold leggings. Enchanted leggings are preferred over unenchanted leggings.

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|subtitle=Leather armor rustles
|source=player
|description=When leather leggings are equipped
|id=item.armor.equip_leather
|translationkey=subtitles.item.armor.equip_leather
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|subtitle=Chain armor jingles
|source=player
|description=When chainmail leggings are equipped
|id=item.armor.equip_chain
|translationkey=subtitles.item.armor.equip_chain
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|subtitle=Iron armor clanks
|source=player
|description=When iron leggings are equipped
|id=item.armor.equip_iron
|translationkey=subtitles.item.armor.equip_iron
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|subtitle=Gold armor clinks
|source=player
|description=When gold leggings are equipped
|id=item.armor.equip_gold
|translationkey=subtitles.item.armor.equip_gold
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|subtitle=Diamond armor clangs
|source=player
|description=When diamond leggings are equipped
|id=item.armor.equip_diamond
|translationkey=subtitles.item.armor.equip_diamond
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|subtitle=Netherite armor clanks
|source=player
|description=When netherite leggings are equipped
|id=item.armor.equip_netherite
|translationkey=subtitles.item.armor.equip_netherite
|volume=0.8
|pitch=1.0/0.9
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=dependent
|description=When a pair of leggings' durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|source=player
|description=When leather leggings are equipped
|id=armor.equip_leather
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|source=player
|description=When chain leggings are equipped
|id=armor.equip_chain
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|source=player
|description=When iron leggings are equipped
|id=armor.equip_iron
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|source=player
|description=When gold leggings are equipped
|id=armor.equip_gold
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|source=player
|description=When diamond leggings are equipped
|id=armor.equip_diamond
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|source=player
|description=When netherite leggings are equipped.
|id=armor.equip_netherite
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=2
|sound=Water Splash Old.ogg
|source=block
|description=When leather leggings are dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When leather leggings' dye is removed using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a pair of leggings' durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Leather Pants
|spritetype=item
|nameid=leather_leggings
|itemtags=freeze_immune_wearables
|form=item}}
{{ID table
|displayname=Chainmail Leggings
|spritetype=item
|nameid=chainmail_leggings
|form=item}}
{{ID table
|displayname=Iron Leggings
|spritetype=item
|nameid=iron_leggings
|form=item}}
{{ID table
|displayname=Diamond Leggings
|spritetype=item
|nameid=diamond_leggings
|form=item}}
{{ID table
|displayname=Golden Leggings
|spritetype=item
|nameid=golden_leggings
|form=item}}
{{ID table
|displayname=Netherite Leggings
|spritetype=item
|nameid=netherite_leggings
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather Pants
|spritetype=item
|nameid=leather_leggings
|id=337
|form=item}}
{{ID table
|displayname=Chainmail Leggings
|spritetype=item
|nameid=chainmail_leggings
|id=341
|form=item}}
{{ID table
|displayname=Iron Leggings
|spritetype=item
|nameid=iron_leggings
|id=345
|form=item}}
{{ID table
|displayname=Diamond Leggings
|spritetype=item
|nameid=diamond_leggings
|id=349
|form=item}}
{{ID table
|displayname=Golden Leggings
|spritetype=item
|nameid=golden_leggings
|id=353
|form=item}}
{{ID table
|displayname=Netherite Leggings
|spritetype=item
|nameid=netherite_leggings
|id=611
|form=item
|foot=1}}

=== Item data ===
When leather pants are dyed, it has the following NBT:
<div class="treeview">
* {{nbt|compound|tag}}: Parent tag.
** {{nbt|compound|display}}: Display properties.
*** {{nbt|int|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 calculated from the red, green, and blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''<ref>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref>
</div>

== Achievements ==
{{load achievements|Iron Man;Tie Dye Outfit;Cover me in debris;Oooh, shiny!}}

== Advancements ==
{{load advancements|Suit Up;Cover me With Diamonds;Oh Shiny;Cover Me in Debris}}

== History ==
{{Cleanup|Split history into just leggings history}}
{{Needs render|type=old|Add of armor models from February 12, 2010 ("Added armor models" / "Armor models are displayed on the player in the inventory").}}
{{History|java indev}}
{{History||0.31|snap=20091231-2|[[File:Studded Leggings (item) JE1.png|32px]] [[History of textures/Unused textures#Studded armor|Studded leggings]] are now able to be seen in the [[inventory]]. This was taken directly from one of [[Notch|Notch's]] game's ''[[Legend of the Chambered 2]]''.}}
{{History||February 9, 2010|link=wordofnotch:380486636|[[File:Notch revealed armor.png|32px]] [[Notch]] revealed new models for armor, which included leggings.}}
{{History||20100212-1|Added leggings models.{{more info|No armor sets were added until later, what does this mean?}}
|[[File:Indev 20100212 armor.png|50px]] Leggings models are now displayed on the [[player]] in the [[inventory]].{{more info|No armor sets were added until later, what does this mean?}}}}
{{History||20100218|[[File:Leather Pants JE1.png|32px]] [[File:Leather Pants (item) JE1 BE1.png|32px]] Added cloth leggings, which have been given the textures from one of [[Notch]]'s previous games, ''[[Legend of the Chambered]]''.
|[[File:Chainmail Leggings JE1 BE1.png|32px]] [[File:Chainmail Leggings (item) JE1 BE1.png|32px]] Added chain leggings.
|[[File:Iron Leggings JE1 BE1.png|32px]] [[File:Iron Leggings (item) JE1 BE1.png|32px]] Added iron leggings.
|[[File:Golden Leggings JE1 BE1.png|32px]] [[File:Golden Leggings (item) JE1 BE1.png|32px]] Added gold leggings.
|[[File:Diamond Leggings JE1 BE1.png|32px]] [[File:Diamond Leggings (item) JE1 BE1.png|32px]] Added diamond leggings.
|Leggings can be [[crafting|crafted]] and worn.
|Leggings now function, giving {{Armor|6}}. Leggings have limited [[item durability|durability]], with lower tier leggings less durable than higher tier leggings.}}
{{History|java alpha}}
{{History||v1.0.8|"Wool leggings" have been renamed to "leather leggings".{{verify|Were they "pants" or "leggings" at the time? If not, when did the name change?}}
|Leather pants are now [[crafting|crafted]] with [[leather]] instead of [[wool]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|The armor protection behavior has been changed. Previous to this update, the total armor protection is based in this equation: (((''total equipped armor damage reduction'' − 1) × (''all equipped armor max damage'' − ''total equipped armor damage'')) ÷ (''total equipped armor max damage'' + 1)).}}
{{History|||snap=October 3, 2011|slink={{tweet|notch|120859830339637249}}|The first images of a [[player]] wearing enchanted armor, including leggings, are revealed.}}
{{History|||snap=Beta 1.9 Prerelease 3|Iron leggings can be found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=Beta 1.9 Prerelease 4|Leggings can be [[enchanting|enchanted]].}}
{{History||1.1|snap=12w01a|Iron leggings can be found in the new blacksmith [[chest]]s in [[village]]s.}}
{{History||1.3.1|snap=12w15a|{{key|Shift}}+clicking can be used to equip leggings.}}
{{History|||snap=12w21a|Chain leggings can be obtained legitimately in [[survival]] mode through [[trading]].
|Blacksmith [[villager]]s now [[trading|sell]] chain leggings for 9–10 emeralds.
|Blacksmith villagers now sell diamond leggings for 11–13 emeralds.
|Blacksmith villagers now sell iron leggings for 8–9 emeralds.
|Butchers now sell leather pants for 2–3 emeralds.}}
{{History||1.4.2|snap=12w32a|[[Mob]] armor has been reintroduced. A partial or full set of any armor is now sometimes worn by [[zombie]]s, [[skeleton]]s and [[zombie pigman|zombie pigmen]], with the likelihood increasing with difficulty.}}
{{History|||snap=August 17, 2012|slink={{tweet|Dinnerbone|236445090929844225}}|[[Jeb]] and [[Dinnerbone]] tweeted pictures of [[dye]]able leather armor, including leggings.}}
{{History|||snap=12w34a|Leather pants can be dyed by [[crafting]] leather pants with [[dye]]s. Dyes can be removed by {{control|use|text=using}} dyed leather pants on a [[cauldron]] with [[water]].
|[[File:Leather Pants JE2.png|32px]] [[File:Leather Pants (item) JE2.png|32px]] Default leather pants are now slightly darker.}}
{{History|||snap=12w36a|[[Dye]]d leather pants are now more saturated and have a slight tint of tan in respect to the default armor color.
|[[Wither skeleton]]s can now spawn wearing leggings.}}
{{History|||snap=12w37a|[[File:Leather Pants (item) JE3 BE2.png|32px]]{{info needed|needs updating.}}[[Category:Needs updating]] Leather leggings now have non-dyed parts. This has been implemented so that [[player]]s can distinguish between other types of armor and similar-colored leather armor.
|Leather pants now have knee pads, which has changed the texture from [[File:Leather Pants JE2.png|32px]] to [[File:Leather Pants JE3 BE1.png|32px]].}}
{{History||1.5|snap=13w04a|Leggings in the [[player]]'s hand can be equipped by right-clicking.
|[[Dispenser]]s can now equip nearby players with leggings.}}
{{History||1.8|snap=14w02a|Armorer [[villager]]s now [[trading|sell]] chain leggings for 9–11 emeralds.
|Armorer villagers no longer sell diamond leggings.
|Armorer villagers no longer sell iron leggings.
|Leatherworkers now sell leather pants for 2–4 emeralds.}}
{{History|||snap=14w05a|Leggings no longer turn red when [[mob]]s and [[player]]s are hurt.}}
{{History|||snap=14w06a|Leggings are now visible on [[giant]]s.}}
{{History|||snap=14w25a|Chain leggings [[Java Edition removed features#Chain armor|can no longer be crafted anymore]] due to the [[item]] form of [[fire]] being [[Java Edition removed features#Obtainable until 1.8|removed]].}}
{{History||1.9|snap=15w31a|Enchanted iron and diamond leggings can be found in [[end city]] ship [[chest]]s.
|[[Mob]]s now wear armor from the bottom to the top, rather than from the top to the bottom. This means that a mob with three armor pieces, for example, spawn with all armor except a helmet.}}
{{History|||snap=15w34b|Leggings' [[item durability|durability]] now affects armor value.}}
{{History|||snap=15w36a|Armor value and armor [[enchanting|enchantment]] calculations have been changed. For the original values, see [[Armor/Before 1.9|here]].}}
{{History|||snap=15w36d|Leggings' durability affecting value has been removed.
|Leggings now have an attribute controlling the defense points.}}
{{History|||snap=15w50a|Added {{cd|equip}} [[sound]]s for leggings.}}
{{History|||snap=16w02a|Armor value and armor enchantment calculations have been changed again.}}
{{History|||snap=16w05a|Armor value calculations have been changed, once again.}}
{{History||1.11.1|snap=16w50a|Golden, chain, and iron leggings can be [[smelting|smelted]] down into one of their respective [[nugget]]s. Chain leggings smelt into iron nuggets.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 300 (Leather), 304 (Chainmail), 308 (Iron), 312 (Diamond), and 316 (Golden).}}
{{History|||snap=18w11a|Enchanted leather pants can now generate in the chests of [[shipwreck]]s.}}
{{History|||snap=18w20a|Chain leggings have been renamed to "chainmail leggings".}}
{{History||1.14|snap=18w43a|[[File:Leather Pants JE4 BE2.png|32px]] [[File:Leather Pants (item) JE4 BE3.png|32px]] The textures of leather leggings have been changed.
|[[File:Chainmail Leggings JE2 BE2.png|32px]] [[File:Chainmail Leggings (item) JE2 BE2.png|32px]] The textures of chainmail leggings have been changed.
|[[File:Iron Leggings JE2 BE2.png|32px]] [[File:Iron Leggings (item) JE2 BE2.png|32px]] The textures of iron leggings have been changed.
|[[File:Golden Leggings JE2 BE2.png|32px]] [[File:Golden Leggings (item) JE2 BE2.png|32px]] The textures of gold leggings have been changed.
|[[File:Diamond Leggings JE2 BE2.png|32px]] [[File:Diamond Leggings (item) JE2 BE2.png|32px]] The textures of diamond leggings have been changed.}}
{{History|||snap=18w48a|Leather pants can be found in [[chest]]s in [[village]] tanneries.}}
{{History|||snap=19w08a|[[File:Golden Leggings (item) JE3 BE3.png|32px]] The texture of gold leggings [[item]]s have been changed.}}
{{History|||snap=19w11a|Armorer villagers now sell iron and enchanted diamond leggings, making diamond leggings effectively [[renewable resource|renewable]] again.
|Leather pants sold by leatherworker villagers are now randomly [[dye]]d.}}
{{History|||snap=19w13a|Armorer villagers now give chainmail leggings to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Leggings JE1.png|32px]] [[File:Netherite Leggings (item) JE1.png|32px]] Added netherite leggings.
|Netherite leggings can be [[crafting|crafted]] using one diamond leggings and one [[netherite ingot]].}}
{{History|||snap=20w09a|[[File:Diamond Leggings (item) JE3 BE3.png|32px]] The textures of diamond leggings [[item]]s have been changed.}}
{{History|||snap=20w10a|[[File:Netherite Leggings JE2.png|32px]] [[File:Netherite Leggings (item) JE2 BE1.png|32px]] The texture of netherite leggings have been changed.
|Netherite leggings can no longer be [[crafting|crafted]].
|Netherite leggings are now obtained by combining one diamond leggings and one [[netherite ingot]] in a [[smithing table]].}}
{{History|||snap=20w16a|Netherite leggings now generate randomly enchanted in [[bastion remnant]] chests.
|Golden leggings now generate randomly enchanted in [[ruined portal]] chests.}}
{{History|||snap=20w17a|Diamonds leggings now generate in place of netherite leggings in bastion remnant [[chest]]s.}}
{{History||1.16.4|snap=Pre-release 1|[[File:Netherite Leggings JE3 BE2.png|32px]] The texture of netherite leggings has been changed.}}
{{History||1.18.2|snap=22w03a|Netherite leggings knockback resistance is no longer random.}}
{{History||1.19|snap=22w12a|Added the [[Swift Sneak]] enchantment, which can be applied only to leggings.}}
{{History|||snap=22w13a|Enchanted iron and diamond leggings may be found in [[ancient city]] [[chest]]s.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Non-leather leggings can now be trimmed using a [[smithing table]].
|There are 10 types of material that determine the color of the trim:
*Iron
*Copper
*Gold
*Lapis
*Emerald
*Diamond
*Netherite
*Redstone
*Amethyst
*Quartz
|Upgrading diamond leggings to netherite leggings now requires the netherite upgrade [[smithing template]].}}
{{History|||snap=23w05a|Leather pants can now be trimmed using a smithing table.|Leggings can now have trims of the same material it is made out of.}}
{{History|||snap=23w06a|Swapped {{cd|iron}} and {{cd|iron_darker}} palette, then made {{cd|iron_darker}} darker overall.}}
{{History||1.19.4|snap=23w05a|Leggings can now be swapped by {{ctrl|using}} them in the hotbar.<ref>{{bug|MC-216270|||Fixed}}</ref>}}
{{History||?|Leggings can now be swapped in [[armor stand]]s by {{ctrl|using}} them in the armor stand's slot.}}
{{History||1.20|snap=23w12a|The pattern textures of dune and sentry armor trims are changed.|
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}

{{History|pocket alpha}}
{{History||v0.6.0|[[File:Leather Pants JE1 BE1.png|32px]] [[File:Leather Pants (item) JE1 BE1.png|32px]] Added the leather pants.
|[[File:Chainmail Leggings JE1 BE1.png|32px]] [[File:Chainmail Leggings (item) JE1 BE1.png|32px]] Added the chain leggings.
|[[File:Iron Leggings JE1 BE1.png|32px]] [[File:Iron Leggings (item) JE1 BE1.png|32px]] Added the iron leggings.
|[[File:Golden Leggings JE1 BE1.png|32px]] [[File:Golden Leggings (item) JE1 BE1.png|32px]] Added the golden leggings.
|[[File:Diamond Leggings JE1 BE1.png|32px]] [[File:Diamond Leggings (item) JE1 BE1.png|32px]] Added the diamond leggings.}}
{{History||v0.8.0|snap=build 2|[[File:Leather Pants (item) JE3 BE2.png|32px]] The leather pants sprites have been changed to that of the [[Java Edition|PC]] version, but its armor [[model]] remains that of older versions.}}
{{History||v0.9.0|snap=build 1|Iron leggings now naturally generates in [[village]] [[chest]]s and a [[stronghold]] altar chest.}}
{{History||v0.11.0|snap=build 11|Armor now protects against [[damage]] from [[mob]]s only.}}
{{History||v0.12.1|snap=build 1|Leggings can be worn by mobs.
|Chainmail leggings can be obtained in [[survival]] mode from a mob wearing it.}}
{{History||?|Leggings no longer turn red when [[mob]]s and [[player]]s are hurt.}}
{{History||v0.14.0|snap=build 1|[[File:Leather Pants JE3 BE2.png|32px]] Leather armor can be dyed and the model has been updated.}}
{{History||v0.15.0|snap=build 1|Leggings can be obtained from [[stray]]s and [[husk]]s that naturally spawn with armor.}}
{{History||v0.15.10|[[Cape]]s no longer clip through armor.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron leggings and enchanted diamond leggings can be found inside [[chest]]s within [[end city]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Chainmail leggings are now [[trading|sold]] by armorer smith [[villager]]s via [[trading]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Golden, chain, and iron leggings can be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Chainmail leggings now generate in [[buried treasure]] chests.
|Enchanted leather leggings can be found inside [[shipwreck]] supply room [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Iron leggings now can be found in plains [[village]] weaponsmith [[chest]]s.
|Leather pants can be found inside plains village tannery chests.
|[[File:Leather Pants JE4 BE2.png|32px]] [[File:Leather Pants (item) JE4 BE3.png|32px]] The textures of leather pants have been changed.
|[[File:Chainmail Leggings JE2 BE2.png|32px]] [[File:Chainmail Leggings (item) JE2 BE2.png|32px]] The textures of chainmail leggings have been changed.
|[[File:Iron Leggings JE2 BE2.png|32px]] [[File:Iron Leggings (item) JE2 BE2.png|32px]] The textures of iron leggings have been changed.
|[[File:Golden Leggings JE2 BE2.png|32px]] [[File:Golden Leggings (item) JE2 BE2.png|32px]] The textures of golden leggings have been changed.
|[[File:Diamond Leggings JE2 BE2.png|32px]] [[File:Diamond Leggings (item) JE2 BE2.png|32px]] The textures of diamond leggings have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron leggings now can be found in [[savanna]], [[taiga]], [[desert]], [[snowy taiga]], and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.
|Leather leggings can be found inside savanna, taiga, desert, snowy taiga, and snowy tundra village tannery chests.}}
{{History|||snap=beta 1.11.0.4|[[Pillager]]s and [[vindicator]]s that spawn in [[raid]]s can now drop iron leggings.
|Leather pants are now [[trading|sold]] by leather worker [[villager]]s.
|Iron leggings and diamond leggings are now sold by armorer villagers.}}
{{History||1.11.0|snap=beta 1.11.0.5|[[File:Golden Leggings (item) JE3 BE3.png|32px]] The textures of golden leggings [[item]]s have been changed.}}
{{History||1.12.0|snap=beta 1.12.0.2|[[File:Armor Stand with Leather Armor MCPE-44669.png|32px]] Leather armor no longer show as being [[dye]]d properly when worn by [[armor stand]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Leather armor now appears dyed properly when worn by armor stands.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Leggings BE1.png|32px]] [[File:Netherite Leggings (item) JE2 BE1.png|32px]] Added netherite leggings.
|Netherite leggings can be [[crafting|crafted]] using one diamond leggings and one [[netherite ingot]].
|[[File:Diamond Leggings (item) JE3 BE3.png|32px]] The texture of diamond leggings has been changed.
|Golden leggings can be obtained from [[piglin]]s wearing [[armor]].}}
{{History||1.16.0|snap=beta 1.16.0.57|Netherite leggings can no longer be [[crafting|crafted]].
|Netherite leggings are now obtained by combining one diamond leggings and one [[netherite ingot]] in a [[smithing table]].
|Golden leggings can be found in [[ruined portal]] chests.
|Golden and netherite leggings can be found in [[bastion remnant]] chests.}}
{{History|||snap=beta 1.16.0.63|Diamonds leggings now generate in place of netherite leggings in bastion remnant chests.}}
{{History||1.16.200|snap=beta 1.16.200.52|[[File:Netherite Leggings JE3 BE2.png|32px]] The texture of netherite leggings has been changed.}}
{{History||1.19.0|snap=beta 1.19.0.24|Added the [[Swift Sneak]] enchantment, which is applicable only to leggings.}}
{{History|||snap=beta 1.19.0.26|Enchanted iron and diamond leggings may be found in [[ancient city]] [[chest]]s.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Leather Pants JE3 BE1.png|32px]] [[File:Leather Pants (item) JE1 BE1.png|32px]] Added the leather leggings.
|[[File:Iron Leggings JE1 BE1.png|32px]] [[File:Iron Leggings (item) JE1 BE1.png|32px]] Added the iron leggings.
|[[File:Golden Leggings JE1 BE1.png|32px]] [[File:Golden Leggings (item) JE1 BE1.png|32px]] Added the golden leggings.
|[[File:Diamond Leggings JE1 BE1.png|32px]] [[File:Diamond Leggings (item) JE1 BE1.png|32px]] Added the diamond set.}}
{{History||xbox=TU5|[[File:Chainmail Leggings JE1 BE1.png|32px]] [[File:Chainmail Leggings (item) JE1 BE1.png|32px]] Added the chain leggings.
|Added a quick equip for armor to the [[inventory]] interface.}}
{{History||xbox=TU12|ps=1.03|[[File:Leather Pants (item) JE3 BE2.png|32px]] The textures for leather armor [[item]]s have been changed.}}
{{History||xbox=TU14|ps=1.05|Leather armor can be [[dye]]d.
|[[Item repair]] can now repair armor.}}
{{History||xbox=TU25|xbone=CU13|ps=1.16|Armor now have the quick equip functionality.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Golden, chain, and iron armor can be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History|PS4}}
{{History||1.90|[[File:Leather Cap JE4 BE2.png|32px]] [[File:Leather Tunic JE4 BE2.png|32px]] [[File:Leather Pants JE4 BE2.png|32px]] [[File:Leather Boots JE3 BE2.png|32px]]<br>[[File:Leather Cap (item) JE4 BE3.png|32px]] [[File:Leather Tunic (item) JE4 BE3.png|32px]] [[File:Leather Pants (item) JE4 BE3.png|32px]] [[File:Leather Boots (item) JE4 BE3.png|32px]] The textures of leather armor have been changed.
|[[File:Chainmail Helmet JE3 BE2.png|32px]] [[File:Chainmail Chestplate JE3 BE2.png|32px]] [[File:Chainmail Leggings JE2 BE2.png|32px]] [[File:Chainmail Boots JE2 BE2.png|32px]]<br>[[File:Chainmail Helmet (item) JE2 BE2.png|32px]] [[File:Chainmail Chestplate (item) JE2 BE2.png|32px]] [[File:Chainmail Leggings (item) JE2 BE2.png|32px]] [[File:Chainmail Boots (item) JE2 BE2.png|32px]] The textures of chainmail armor have been changed.
|[[File:Iron Helmet JE2 BE2.png|32px]] [[File:Iron Chestplate JE2 BE2.png|32px]] [[File:Iron Leggings JE2 BE2.png|32px]] [[File:Iron Boots JE2 BE2.png|32px]]<br>[[File:Iron Helmet (item) JE2 BE2.png|32px]] [[File:Iron Chestplate (item) JE2 BE2.png|32px]] [[File:Iron Leggings (item) JE2 BE2.png|32px]] [[File:Iron Boots (item) JE2 BE2.png|32px]] The textures of iron armor have been changed.
|[[File:Golden Helmet JE2 BE2.png|32px]] [[File:Golden Chestplate JE2 BE2.png|32px]] [[File:Golden Leggings JE2 BE2.png|32px]] [[File:Golden Boots JE2 BE2.png|32px]]<br>[[File:Golden Helmet (item) JE3 BE3.png|32px]] [[File:Golden Chestplate (item) JE3 BE3.png|32px]] [[File:Golden Leggings (item) JE3 BE3.png|32px]] [[File:Golden Boots (item) JE3 BE3.png|32px]] The textures of gold armor have been changed.
|[[File:Diamond Helmet JE2 BE2.png|32px]] [[File:Diamond Chestplate JE3 BE2.png|32px]] [[File:Diamond Leggings JE2 BE2.png|32px]] [[File:Diamond Boots JE2 BE2.png|32px]]<br>[[File:Diamond Helmet (item) JE2 BE2.png|32px]] [[File:Diamond Chestplate (item) JE2 BE2.png|32px]] [[File:Diamond Leggings (item) JE2 BE2.png|32px]] [[File:Diamond Boots (item) JE2 BE2.png|32px]] The textures of diamond armor have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Leather Cap JE3 BE1.png|32px]] [[File:Leather Tunic JE3 BE1.png|32px]] [[File:Leather Pants JE3 BE1.png|32px]] [[File:Leather Boots JE2 BE1.png|32px]]<br>[[File:Leather Cap (item) JE3 BE2.png|32px]] [[File:Leather Tunic (item) JE3 BE2.png|32px]] [[File:Leather Pants (item) JE3 BE2.png|32px]] [[File:Leather Boots (item) JE3 BE2.png|32px]] Added the leather set.
|[[File:Chainmail Helmet JE2 BE1.png|32px]] [[File:Chainmail Chestplate JE2 BE1.png|32px]] [[File:Chainmail Leggings JE1 BE1.png|32px]] [[File:Chainmail Boots JE1 BE1.png|32px]]<br>[[File:Chainmail Helmet (item) JE1 BE1.png|32px]] [[File:Chainmail Chestplate (item) JE1 BE1.png|32px]] [[File:Chainmail Leggings (item) JE1 BE1.png|32px]] [[File:Chainmail Boots (item) JE1 BE1.png|32px]] Added the chain set.
|[[File:Iron Helmet JE1 BE1.png|32px]] [[File:Iron Chestplate JE1 BE1.png|32px]] [[File:Iron Leggings JE1 BE1.png|32px]] [[File:Iron Boots JE1 BE1.png|32px]]<br>[[File:Iron Helmet (item) JE1 BE1.png|32px]] [[File:Iron Chestplate (item) JE1 BE1.png|32px]] [[File:Iron Leggings (item) JE1 BE1.png|32px]] [[File:Iron Boots (item) JE1 BE1.png|32px]] Added the iron set.
|[[File:Golden Helmet JE1 BE1.png|32px]] [[File:Golden Chestplate JE1 BE1.png|32px]] [[File:Golden Leggings JE1 BE1.png|32px]] [[File:Golden Boots JE1 BE1.png|32px]]<br>[[File:Golden Helmet (item) JE1 BE1.png|32px]] [[File:Golden Chestplate (item) JE1 BE1.png|32px]] [[File:Golden Leggings (item) JE1 BE1.png|32px]] [[File:Golden Boots (item) JE1 BE1.png|32px]] Added the golden set.
|[[File:Diamond Helmet JE1 BE1.png|32px]] [[File:Diamond Chestplate JE1 BE1.png|32px]] [[File:Diamond Leggings JE1 BE1.png|32px]] [[File:Diamond Boots JE1 BE1.png|32px]]<br>[[File:Diamond Helmet (item) JE1 BE1.png|32px]] [[File:Diamond Chestplate (item) JE1 BE1.png|32px]] [[File:Diamond Leggings (item) JE1 BE1.png|32px]] [[File:Diamond Boots (item) JE1 BE1.png|32px]] Added the diamond set.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==
=== Enchanted Leggings ===
<gallery>
File:Enchanted Leather Pants (item).gif
File:Enchanted Chainmail Leggings (item).gif
File:Enchanted Iron Leggings (item).gif
File:Enchanted Golden Leggings (item).gif
File:Enchanted Diamond Leggings (item).gif
File:Enchanted Netherite Leggings (item).gif
</gallery>
<gallery>
File:Enchanted Leather Leggings.gif
File:Enchanted Chainmail Leggings.gif
File:Enchanted Iron Leggings.gif
File:Enchanted Golden Leggings.gif
File:Enchanted Diamond Leggings.gif
File:Enchanted Netherite Leggings.gif
</gallery>

== Notes ==
{{fnlist}}

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-leggings Taking Inventory:Leggings] – Minecraft.net on February 15, 2019

{{Items}}

[[Category:Armor]]

[[fr:Armure#Jambières]]
[[ja:レギンス]]
[[ko:각반]]
[[pl:Nogawice]]
[[pt:Calças]]
[[zh:护腿]]</li><li>[[Helmet|Helmet]]<br/>{{Update|Include information about armor trims and updated netherite upgrade information.}}
{{redirect|Cap|mob spawning caps|Spawn}}
{{redirect|Turtle Shell|the item dropped by maturing turtles|Scute}}
{{Item
| image = <gallery>
Leather Cap.png| Leather
Chainmail Helmet.png| Chainmail
Iron Helmet.png| Iron
Diamond Helmet.png| Diamond
Golden Helmet.png| Golden
Netherite Helmet.png| Netherite
Turtle Shell.png| Turtle Shell
</gallery>
| durability = 
* Leather: 55
* Chainmail: 165
* Iron: 165
* Golden: 77
* Diamond: 363
* Netherite: 407
* Turtle Shell: 275
| renewable = 
* '''Netherite''': No
* '''All others''': Yes
| stackable = No
}}
'''Helmets''' are a type of [[armor]] that covers the head of the player. There are seven types of helmets: '''leather cap''', '''chainmail helmet''', '''iron helmet''', '''diamond helmet''', '''gold helmet''', '''netherite helmet''', and '''turtle shell'''.

==Obtaining ==

===Crafting===

{{crafting
  |head=1
  |showname=0
  |showdescription=1
  |name=Helmet
   |A2= Leather;Gold Ingot;Iron Ingot;Diamond;Scute
   |B2= Leather;Gold Ingot;Iron Ingot;Diamond;Scute
   |C2= Leather;Gold Ingot;Iron Ingot;Diamond;Scute
    |A3= Leather;Gold Ingot;Iron Ingot;Diamond;Scute
    |C3= Leather;Gold Ingot;Iron Ingot;Diamond;Scute
  |description=
  |Output= Leather Cap;Golden Helmet;Iron Helmet;Diamond Helmet;Turtle Shell
  |type= Combat
}}
{{crafting
  |ignoreusage=1
  |name=[[Helmet]]
  |ingredients=Damaged matching helmet
  |Damaged Leather Cap; Damaged Golden Helmet; Damaged Chainmail Helmet; Damaged Iron Helmet; Damaged Diamond Helmet; Damaged Turtle Shell; Damaged Netherite Helmet
  |Damaged Leather Cap; Damaged Golden Helmet; Damaged Chainmail Helmet; Damaged Iron Helmet; Damaged Diamond Helmet; Damaged Turtle Shell; Damaged Netherite Helmet
  |Output= Leather Cap; Golden Helmet; Chainmail Helmet; Iron Helmet; Diamond Helmet; Turtle Shell; Netherite Helmet
  |description= The durability of the two helmets is added together, plus an extra 5% durability.
  |type= Combat
  |foot=1
}}

===Upgrading===

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

===Repairing===
====Grinding====
{{Grinding
|showdescription=1
|ingredients=2x Damaged [[Leather Cap]] or<br>2x Damaged [[Chainmail Helmet]] or<br>2x Damaged [[Iron Helmet]] or<br>2x Damaged [[Golden Helmet]] or<br>2x Damaged [[Diamond Helmet]] or<br>2x Damaged [[Netherite Helmet]] or<br>2x Damaged [[Turtle Shell]]
|Damaged Leather Cap; Damaged Chainmail Helmet; Damaged Iron Helmet; Damaged Golden Helmet; Damaged Diamond Helmet; Damaged Netherite Helmet; Damaged Turtle Shell
|Damaged Leather Cap; Damaged Chainmail Helmet; Damaged Iron Helmet; Damaged Golden Helmet; Damaged Diamond Helmet; Damaged Netherite Helmet; Damaged Turtle Shell
|Leather Cap; Chainmail Helmet; Iron Helmet; Golden Helmet; Diamond Helmet; Netherite Helmet; Turtle Shell
|description=The durability of the two helmets are added together, plus an extra 5% durability.
}}

====[[Anvil mechanics#Unit repair|Unit repair]]====
Helmets can be repaired in an [[anvil]] by adding units of the [[armor material]]'s repair material, with each repair material restoring 25% of the helmet's maximum durability, rounded down.

===Mob loot===

If a [[zombie]], [[husk]], [[stray]] or [[skeleton]] is wearing armor, there is a 8.5% chance (9.5% with [[Looting]] I, 10.5% with Looting II and 11.5% with Looting III) for the mob to drop a helmet upon death. The dropped helmet is usually badly damaged, and may be [[enchanted]] with enchantment levels 5-19.

{{IN|bedrock}}, [[vindicator]]s and [[pillager]]s spawned in [[raid]]s have a 8.3525% chance (10.28% on hard) to drop [[iron]] helmets. The dropped helmets are usually badly damaged, and have a 50% chance of being [[enchanted]] with a random [[enchantment]].

===Natural generation===
Two [[armor stand]]s are found in each taiga [[village]] outdoor armory, one of them equipped with an [[iron helmet]].

===Chest loot===
{{IN|BE}}, a sealed room in [[woodland mansion]]s can appear that has a chest sometimes containing an [[Efficiency]] I leather cap.<ref>{{bug|MCPE-109048}}</ref>
{{LootChestItem|leather-cap,random-enchanted-leather-cap,chainmail-helmet,iron-helmet,level-enchanted-iron-helmet,golden-helmet,random-enchanted-golden-helmet,diamond-helmet,damaged-diamond-helmet,level-enchanted-diamond-helmet,damaged-random-enchanted-diamond-helmet,damaged-random-enchanted-diamond-helmet-2}}

===Trading===

{{IN|java}}, novice-level armorer villagers have a 40% chance to sell an iron helmet for 4 emeralds. Journeyman-level armorers have a 40% chance to sell a chainmail helmet for 1 emerald. Master-level armorers always sell an enchanted diamond helmet for 11-27 emeralds. Apprentice-level leatherworker villagers have a {{frac|2|3}} chance to sell a leather cap<ref group="note" name="dye note">The leather armor has a random color created by two dyes (possibly the same dye twice.)</ref> for 5 emeralds. Master-level leatherworker villagers offer the same trade.

Armorer villagers may give the players with the [[Hero of the Village]] effect a chainmail helmet.

{{IN|bedrock}}, novice-level armorer villagers have a 25% chance to sell iron helmet for 5 emeralds, {{frac|1|3}} chance to sell chainmail helmet at journeyman-level for an emerald, and 50% chance to sell enchanted diamond helmet for 8 emeralds at master-level. Apprentice-level leatherworker villagers have a 50% chance to sell leather cap for 5 emeralds as part of their trades, and 50% chance to sell an enchanted leather cap for 5 emeralds at the master level.

{{notelist|columns=1}}

==Usage ==

Helmets can be placed in the top armor slot of a player's [[inventory]] for activation.

===Defense points===

Defense points are each signified by half of a shirt of mail in the armor bar above the health bar. Each defense point reduces any damage dealt to the player that is absorbed by armor by 4%, increasing additively with the number of defense points. Different materials and combinations of armor provide different levels of defense.

The following table shows the number of defense points added by helmets.

{| class="wikitable" data-description="Helmet defense points"
|-
! scope="col" |Material
! scope="col" |
|-
! scope="row" |Leather
|{{armor|1}}
|-
! scope="row" |Golden
| rowspan="4" |{{armor|2}}
|-
! scope="row" |Chainmail
|-
! scope="row" |Iron
|-
! scope="row" |Turtle Shell
|-
! scope="row" |Diamond
| rowspan="2" |{{armor|3}}
|-
! scope="row" |Netherite
|}

===Knockback resistance===
A netherite helmet provides 10% knockback resistance.

===Durability===

The following table shows the amount of damage each piece of armor can absorb before being destroyed.

Any "hit" from a damage source that can be blocked by armor removes one point of durability from each piece of armor worn for every {{hp|4}} of incoming damage (rounded down, but never below 1). Damage taken that armor doesn't protect (such as [[Damage#Fall damage|falling]] or [[Damage#Drowning|drowning]]) does not damage the armor, even if it is enchanted to protect against that type of damage. The following chart displays how many hits helmets can endure.

Netherite armor is not damaged by [[lava]] or [[fire]] when worn.

{| class="wikitable" data-description="Helmet durability"
|-
!Material
!Durability
|-
! scope="row" |Leather
|55
|-
! scope="row" |Golden
|77
|-
! scope="row" |Chainmail
| rowspan="2" |165
|-
! scope="row" |Iron
|-
! scope="row" |Turtle Shell
|275
|-
! scope="row" |Diamond
|363
|-
! scope="row" |Netherite
|407
|}

====Repair====

Helmets may be [[item repair|repaired]] by using them along with some of their crafting material (leather, gold ingots, iron ingots, diamonds or netherite) in an [[anvil]]. Chainmail helmets may be repaired in this way with iron ingots. They may also be repaired by crafting them together with another helmet of like material.

===Enchantments===
A helmet can receive the following [[enchantment]]s. Note that while iron and chainmail have the same durability, chainmail has a higher [[Tutorials/Enchanting mechanics#Enchantability|enchantability]] than iron or diamond.
{| class="wikitable"
|-
!Enchantment !!Max Level !!Notes
|-
|[[Fire Protection]]|| IV ||<ref group="note" name="exclusive">Fire Protection, Blast Protection, Projectile Protection and Protection are mutually exclusive</ref>
|-
|[[Projectile Protection]]|| IV ||<ref group="note" name="exclusive" />
|-
|[[Blast Protection]]|| IV ||<ref group="note" name="exclusive" />
|-
|[[Protection]]|| IV ||<ref group="note" name="exclusive" />
|-
|[[Unbreaking]]||III
|
|-
|[[Respiration]]||III
|
|-
|[[Aqua Affinity]]||I
|
|-
|[[Thorns]]||III ||<ref group="note" name="anvil">Only from using an [[anvil]] and [[enchanted book]]s.</ref>
|-
|[[Mending]]||I ||<ref group="note" name="anvil2">Only from chest loot, fishing, or an anvil and enchanted books.</ref>
|-
|[[Curse of Binding]]||I ||<ref group="note" name="anvil2" />
|-
|[[Curse of Vanishing]]||I ||<ref group="note" name="anvil2" />
|}
{{notelist}}

===Turtle shell effect===

Equipping a {{ItemSprite|Turtle Shell}} turtle shell provides the {{EffectLink|Water Breathing}} status effect, allowing the player to remain underwater for an additional 10 seconds. The time that this effect lasts does not begin to count down until the player dives underwater, then the 10 seconds are counted down. The effect immediately recharges after exposure to air.

===Brewing ingredient===
A turtle shell can also be used as a potion brewing ingredient.
{{Brewing
 |Turtle Shell
 |Potion of the Turtle Master
 |Potion of the Turtle Master
 |Potion of the Turtle Master
 |showname=1
}}

===Smelting usage===

{{Smelting|showname=1|Iron Helmet;Chainmail Helmet;Golden Helmet|Iron Nugget;Iron Nugget;Gold Nugget|0,1}}
===Piglins===
{{EntityLink|Piglin|Piglins}} are attracted to ''golden'' helmets and pick them up, examining them for 6 to 8 seconds. Piglins can wear other helmets but are not attracted to them. They prefer stronger helmets over weaker helmets, with one exception: They always prefer golden helmets, throwing out stronger helmets in favor of gold helmets. Enchanted helmets are preferred over unenchanted helmets.

==Sounds ==
{{el|je}}:
{{Sound table
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|subtitle=Leather armor rustles
|source=player
|description=When a leather helmet is equipped
|id=item.armor.equip_leather
|translationkey=subtitles.item.armor.equip_leather
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|subtitle=Chain armor jingles
|source=player
|description=When a chainmail helmet is equipped
|id=item.armor.equip_chain
|translationkey=subtitles.item.armor.equip_chain
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|subtitle=Iron armor clanks
|source=player
|description=When an iron helmet is equipped
|id=item.armor.equip_iron
|translationkey=subtitles.item.armor.equip_iron
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|subtitle=Gold armor clinks
|source=player
|description=When a gold helmet is equipped
|id=item.armor.equip_gold
|translationkey=subtitles.item.armor.equip_gold
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|subtitle=Diamond armor clangs
|source=player
|description=When a diamond helmet is equipped
|id=item.armor.equip_diamond
|translationkey=subtitles.item.armor.equip_diamond
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|subtitle=Netherite armor clanks
|source=player
|description=When a netherite helmet is equipped
|id=item.armor.equip_netherite
|translationkey=subtitles.item.armor.equip_netherite
|volume=0.8
|pitch=1.0/0.9
|distance=16}}
{{Sound table
|sound=Equip turtle shell.ogg
|subtitle=Turtle Shell thunks
|source=player
|description=When a turtle shell is equipped
|id=item.armor.equip_turtle
|translationkey=subtitles.item.armor.equip_turtle
|volume=1.0
|pitch=1.0/0.85/1.1
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=dependent
|description=When a helmet'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}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|source=player
|description=When a leather helmet or a turtle shell is equipped
|id=armor.equip_leather
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|source=player
|description=When a chain helmet is equipped
|id=armor.equip_chain
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|source=player
|description=When an iron helmet is equipped
|id=armor.equip_iron
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|source=player
|description=When a gold helmet is equipped
|id=armor.equip_gold
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|source=player
|description=When a diamond helmet is equipped
|id=armor.equip_diamond
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|source=player
|description=When a netherite helmet is equipped.
|id=armor.equip_netherite
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=2
|sound=Water Splash Old.ogg
|source=block
|description=When a leather helmet is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a leather helmet's dye is removed using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a helmet's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

==Data values ==
=== ID===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Leather Cap
|spritetype=item
|nameid=leather_helmet
|itemtags=freeze_immune_wearables
|form=item}}
{{ID table
|displayname=Chainmail Helmet
|spritetype=item
|nameid=chainmail_helmet
|form=item}}
{{ID table
|displayname=Iron Helmet
|spritetype=item
|nameid=iron_helmet
|form=item}}
{{ID table
|displayname=Diamond Helmet
|spritetype=item
|nameid=diamond_helmet
|form=item}}
{{ID table
|displayname=Golden Helmet
|spritetype=item
|nameid=golden_helmet
|form=item}}
{{ID table
|displayname=Netherite Helmet
|spritetype=item
|nameid=netherite_helmet
|form=item}}
{{ID table
|displayname=Turtle Shell
|spritetype=item
|nameid=turtle_helmet
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather Cap
|spritetype=item
|nameid=leather_helmet
|id=335
|form=item}}
{{ID table
|displayname=Chainmail Helmet
|spritetype=item
|nameid=chainmail_helmet
|id=339
|form=item}}
{{ID table
|displayname=Iron Helmet
|spritetype=item
|nameid=iron_helmet
|id=343
|form=item}}
{{ID table
|displayname=Diamond Helmet
|spritetype=item
|nameid=diamond_helmet
|id=347
|form=item}}
{{ID table
|displayname=Golden Helmet
|spritetype=item
|nameid=golden_helmet
|id=351
|form=item}}
{{ID table
|displayname=Netherite Helmet
|spritetype=item
|nameid=netherite_helmet
|id=609
|form=item}}
{{ID table
|displayname=Turtle Shell
|spritetype=item
|nameid=turtle_helmet
|id=573
|form=item
|foot=1}}

===Item data===
When leather caps are dyed, it has the following NBT:
<div class="treeview">
*{{nbt|compound|tag}}: Parent tag.
**{{nbt|compound|display}}: Display properties. 
***{{nbt|int|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 calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''<ref>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref>
</div>

==Achievements ==
{{load achievements|Iron Man;Tie Dye Outfit;Cover me in debris;Oooh, shiny!}}

==Advancements ==
{{load advancements|Suit Up;Cover me With Diamonds;Oh Shiny;Cover Me in Debris;A Furious Cocktail;How Did We Get Here}}

==History ==
{{History|java classic}}
{{History||August 13, 2009|link=wordofnotch:162091556|Notch tested armor models on [[mob (entity)|mob]]. Only [[chestplate]]s and helmets were available. They were merely aesthetic at the time and had no effect on gameplay.}}
{{History||0.24_SURVIVAL_TEST|[[File:Plate Helmet.png|32px]] Added [[Java_Edition_removed_features#Armor_in_Survival_Test|plate helmet]]s.
|[[File:Chainmail Helmet JE1.png|32px]] Added the model and the texture for unused [[Java_Edition_removed_features#Armor_in_Survival_Test|chain helmet]]s.
|[[File:Zombie full set.png|32px]] [[File:Skeleton helmet.png|26px]] Plate armor models have been tested on [[zombie]]s and [[skeleton]]s. It had no effect on gameplay.}}
{{History|java indev}}
{{History||0.31|snap=20091223-1|Plate and chain armor [[model]]s are no longer used.}}
{{History|||snap=20091231-2|[[File:Leather Cap (item) JE1 BE1.png|32px]] [[File:Studded Helmet (item) JE1.png|32px]] [[File:Chainmail Helmet (item) JE1 BE1.png|32px]] [[File:Iron Helmet (item) JE1 BE1.png|32px]] Added [[item]]s of relation to leather, [[History of textures/Unused textures#Studded armor|studded]], chainmail and plate (iron) helmets.
|The textures of leather helmets are taken from one of [[Notch]]'s previous games, ''[[Legend of the Chambered]]''. The rest are from ''[[Legend of the Chambered 2]]''.}}
{{History||20100206|[[File:Golden Helmet (item) JE1 BE1.png|32px]] [[File:Diamond Helmet (item) JE1 BE1.png|32px]] Added items of golden and diamond helmets.
|Removed leather-chain helmets.}}
{{History||20100212-1|Added armor models.
|[[File:Indev 20100212 armor.png|50px]] Armor models are now displayed on the [[player]] in the [[inventory]].}}
{{History||20100218|[[File:Leather Cap JE1 BE1.png|32px]] [[File:Chainmail Helmet JE2 BE1.png|32px]] [[File:Iron Helmet JE1 BE1.png|32px]] [[File:Golden Helmet JE1 BE1.png|32px]] [[File:Diamond Helmet JE1 BE1.png|32px]] Added models of leather, chainmail, iron, gold, and diamond helmets.
|Helmets can now be [[crafting|crafted]] and worn.
|Helmets now function. All helmets give {{Armor|3}}. Helmets have limited [[item durability|durability]], with lower tier helmets less durable than higher tier helmets.}}
{{History|java alpha}}
{{History||v1.0.8|With the introduction of [[leather]], "Cloth Cap" has been renamed to "Leather Cap".
|Leather cap is now [[crafting|crafted]] with leather instead of [[wool|cloth]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|The armor protection behavior has been changed. Prior to this update, the total armor protection is based in this equation: (((''total equipped armor damage reduction'' − 1) × (''all equipped armor max damage'' − ''total equipped armor damage'')) ÷ (''total equipped armor max damage'' + 1)). Armor no longer reduces certain damage types to be covered by enchantments.}}
{{History|||snap=October 3, 2011|slink={{tweet|notch|120859830339637249}}|The first images of a [[player]] wearing enchanted armor are revealed.}}
{{History|||snap=Beta 1.9 Prerelease 3|Iron helmets can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=Beta 1.9 Prerelease 4|Helmets can now be [[enchanting|enchanted]].}}
{{History||1.1|snap=12w01a|Iron helmets can now be found in the new blacksmith [[chest]]s in [[village]]s.}}
{{History||1.2.1|snap=12w06a|[[Zombie]]s now drop iron helmets on rare occasions and [[zombie pigman|zombie pigmen]] now drop golden helmets.}}
{{History||1.3.1|snap=12w15a|{{key|Shift}}+clicking can now be used to wear helmets.}}
{{History|||snap=12w21a|Chain helmets can now be obtained legitimately in [[survival]] mode through [[trading]].
|Blacksmith [[villager]]s now [[trading|sell]] chain helmets for 5–6 emeralds.
|Blacksmith villagers now sell diamond helmets for 7 emeralds.
|Blacksmith villagers now sell iron helmets for 4–5 emeralds.
|Butchers now sell leather caps for 2–3 emeralds.}}
{{History||1.4.2|snap=12w32a|[[Mob]] armor has been reintroduced. A partial or full set of any armor is now sometimes worn by [[zombie]]s, [[skeleton]]s and [[zombified piglins|zombie pigmen]], with the likelihood increasing with difficulty.}}
{{History|||snap=August 17, 2012|slink={{tweet|Dinnerbone|236445090929844225}}|[[Jeb]] and [[Dinnerbone]] tweeted pictures of [[dye]]able leather armor.}}
{{History|||snap=12w34a|Leather helmets can now be dyed by [[crafting]] a leather armor piece with [[dye]]s. Dyes can be removed by {{control|use|text=using}} dyed leather armor on a [[cauldron]] with [[water]].
|[[File:Leather Cap JE2.png|32px]] [[File:Leather Cap (item) JE2.png|32px]] Default leather caps textures are now slightly darker.}}
{{History|||snap=12w36a|[[Dye]]d leather caps are now more saturated and have a slight tint of tan in respect to the default armor color.}}
{{History|||snap=12w37a|[[File:Leather Cap JE3 BE2.png|32px]] [[File:Leather Cap (item) JE3 BE2.png|32px]] Leather armor now has non-dyed parts on the cap. This has been implemented so that [[player]]s can distinguish between other types of helmets and similarly colored leather caps.}}
{{History||1.5|snap=13w04a|Helmets in the [[player]]'s hand can now be equipped by right-clicking.
|[[Dispenser]]s can now equip nearby players with helmets.}}
{{History||1.8|snap=14w02a|[[Trading|Trades]] changed: armorer [[villager]]s now [[trading|sell]] chain helmets for 5–7 emeralds.
|Armorer villagers no longer sell diamond helmets.
|Armorer villagers now sell iron helmets for 4–6 emeralds.
|Leatherworkers no longer sell other leather caps.}}
{{History|||snap=14w05a|Helmets no longer turns red when [[mob]]s and [[player]]s are hurt.}}
{{History|||snap=14w06a|Helmets are now visible on [[giant]]s.}}
{{History|||snap=14w25a|Chain helmets [[Java Edition removed features#Chainmail armor|cannot be crafted anymore]] due to the [[item]] form of [[fire]] being [[Java Edition removed features#Obtainable until 1.8|removed]].}}
{{History||1.9|snap=15w31a|Enchanted iron and diamond helmets can now be found in [[end city]] ship [[chest]]s.
|[[Mob]]s now wear armor from the bottom to the top, rather than from the top to the bottom. This means that a mob with three armor pieces, for example, spawn with all armor except a helmet.}}
{{History|||snap=15w34b|Helmet [[item durability|durability]] now affects armor value.}}
{{History|||snap=15w36a|Armor and armor [[enchanting|enchantment]] calculations have been changed. For the original values, see [[Armor/Before 1.9|here]].}}
{{History|||snap=15w36d|Helmet durability affecting value has been removed.
|Helmets now has an attribute controlling the defense points.}}
{{History|||snap=15w50a|Added <code>equip</code> [[sound]]s for leather armor.}}
{{History|||snap=16w02a|Armor and armor enchantment calculations have been changed again.}}
{{History|||snap=16w05a|Armor calculations have been changed, once again.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 298, 302, 306, 310 and 314.}}
{{History|||snap=18w07a|[[File:Turtle Shell.png|32px]] [[File:Turtle Shell (item) JE1 BE1.png|32px]] Added turtle shells.}}
{{History|||snap=18w09a|Golden helmets now have a chance of generating in [[underwater ruins]].}}
{{History|||snap=18w11a|Enchanted leather caps can now generate in the chests of [[shipwreck]]s.}}
{{History|||snap=18w20a|"Chain Helmet" has now been renamed to "Chainmail Helmet".}}
{{History||1.14|snap=18w43a|[[File:Leather Cap JE4 BE2.png|32px]] [[File:Chainmail Helmet JE3 BE2.png|32px]] [[File:Iron Helmet JE2 BE2.png|32px]] [[File:Golden Helmet JE2 BE2.png|32px]] [[File:Diamond Helmet JE2 BE2.png|32px]]<br>[[File:Leather Cap (item) JE4 BE3.png|32px]] [[File:Chainmail Helmet (item) JE2 BE2.png|32px]] [[File:Iron Helmet (item) JE2 BE2.png|32px]] [[File:Golden Helmet (item) JE2 BE2.png|32px]] [[File:Diamond Helmet (item) JE2 BE2.png|32px]] The textures of all types of helmets have been changed.}}
{{History|||snap=18w48a|Leather caps can now be found in [[chest]]s in [[village]] tanneries.}}
{{History|||snap=18w50a|Iron helmets can now be found on [[armor stand]]s in [[taiga]] villages.}}
{{History|||snap=19w08a|[[File:Golden Helmet (item) JE3 BE3.png|32px]] The textures of gold helmet [[item]]s have been changed.}}
{{History|||snap=19w11a|Armorer villagers now sell enchanted diamond helmets, making diamond helmets effectively [[renewable resource|renewable]] again.
|Leatherworker villagers now sell randomly [[dye]]d leather caps.}}
{{History|||snap=19w13a|Armorer villagers now give chainmail helmets to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Helmet JE1.png|32px]] [[File:Netherite Helmet (item) JE1.png|32px]] Added netherite helmets.}}
{{History|||snap=20w07a|[[File:Leather piglin helmet.png|32px]] [[File:Chainmail piglin helmet.png|32px]] [[File:Iron piglin helmet.png|32px]] [[File:Golden piglin helmet.png|32px]] [[File:Diamond piglin helmet.png|32px]] [[File:Netherite piglin helmet JE1.png|32px]] Added textures and [[model]]s for all helmets when they are used by [[piglin]]s.
|Netherite helmets are now obtained by combining one diamond armor piece and one netherite ingot in a crafting table.
|[[File:Turtle Shell piglin MC-172110.png|32px]] Turtle shells, when used by piglins and [[zombified piglin]]s, result in a [[missing texture]] when being displayed.<ref>{{Cite bug|MC|172110|Texture of turtle shells is missing when worn by a piglin or zombified piglin|date=February 14, 2020}}</ref>}}
{{History|||snap=20w09a|[[File:Diamond Helmet (item) JE3 BE3.png|32px]] The textures of diamond helmet [[item]]s have been changed.}}
{{History|||snap=20w10a|[[File:Netherite Helmet JE2 BE1.png|32px]] [[File:Netherite Helmet (item) JE2 BE1.png|32px]] The texture of netherite helmets has been changed.
|[[File:Netherite piglin helmet.png|32px]] The texture of netherite helmets for [[piglin]]s has been changed.
|Netherite helmets can no longer be [[crafting|crafted]].
|Netherite helmets are now obtained by combining one diamond helmet and one netherite ingot in a [[smithing table]].}}
{{History|||snap=20w16a|Golden and netherite helmets now generate randomly [[enchanting|enchanted]], and sometimes [[damage]]d, in [[bastion remnant]] and [[ruined portal]] chests.}}
{{History|||snap=20w17a|Diamonds helmets now generate in place of netherite helmets in bastion remnant [[chest]]s.}}
{{History|||snap=pre3|The special helmet [[model]]s and textures created for [[piglin]]s have been removed except for leather helmets.}}
{{History||1.17|snap=20w48a|Wearing a leather helmet now prevents [[Powder Snow#Freezing|freezing]] entirely.}}
{{History|||snap=21w13a|The two unused textures of the leather cap for [[piglin]]s<ref><code>/assets/minecraft/textures/models/armor/piglin_leather_layer_1.png</code></ref><ref><code>/assets/minecraft/textures/models/armor/piglin_leather_layer_1_overlay.png</code></ref> have been removed.}}
{{History||1.18.2|snap=22w03a|Netherite helmet knockback resistance is no longer random.}}
{{History||1.19|snap=22w17a|[[File:Leather Cap JE5.png|32px]] The texture of the leather cap item has been changed.|Changed the leather cap texture when worn so the center bar now extends to the bottom of the back face.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Non-leather helmets can now be trimmed using a [[smithing table]].
|There are 10 types of material that determine the color of the trim:
*Iron
*Copper
*Gold
*Lapis
*Emerald
*Diamond
*Netherite
*Redstone
*Amethyst
*Quartz
|Upgrading diamond helmets to netherite helmets now requires the netherite upgrade [[smithing template]].}}
{{History|||snap=23w05a|Leather caps can now be trimmed using a smithing table.|Helmets can now have trims of the same material it is made out of.}}
{{History|||snap=23w06a|Swapped {{cd|iron}} and {{cd|iron_darker}} palette, then made {{cd|iron_darker}} darker overall.}}
{{History||1.19.4|snap=23w05a|Helmets can now be swapped by {{ctrl|using}} them in the hotbar.<ref>{{bug|MC-216270|||Fixed}}</ref>}}
{{History||?|Helmets can now be swapped in [[armor stand]]s by {{ctrl|using}} them/[[head]]s/[[carved pumpkin]]s in the armor stand's slot.}}
{{History||1.20|snap=23w12a|The pattern textures of dune and sentry armor trims are changed.|Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}

{{History|pocket alpha}}
{{History||v0.6.0|[[File:Leather Cap JE1 BE1.png|32px]] [[File:Chainmail Helmet JE2 BE1.png|32px]] [[File:Iron Helmet JE1 BE1.png|32px]] [[File:Golden Helmet JE1 BE1.png|32px]] [[File:Diamond Helmet JE1 BE1.png|32px]]<br>[[File:Leather Cap (item) JE1 BE1.png|32px]] [[File:Chainmail Helmet (item) JE1 BE1.png|32px]] [[File:Iron Helmet (item) JE1 BE1.png|32px]] [[File:Golden Helmet (item) JE1 BE1.png|32px]] [[File:Diamond Helmet (item) JE1 BE1.png|32px]] Added helmets.}}
{{History||v0.8.0|snap=build 2|[[File:Leather Cap (item) JE3 BE2.png|32px]] The leather helmet sprite has been changed to that of {{el|je}}, but its armor [[model]] remains that of older versions.}}
{{History||v0.9.0|snap=build 1|Iron helmets now naturally generate in [[village]] [[chest]]s and in [[stronghold]] altar chests.}}
{{History||v0.11.0|snap=build 11|Helmets now protect against [[damage]] from [[mob]]s only.}}
{{History||v0.12.1|snap=build 1|Helmets can now be worn by mobs.
|Chainmail helmets can now be obtained in [[survival]] mode from a mob wearing it.}}
{{History||?|Helmets no longer turn red when [[mob]]s and [[player]]s are hurt.}}
{{History||v0.14.0|snap=build 1|[[File:Leather Cap JE3 BE2.png|32px]] The texture of leather helmets have been changed.
|Leather helmets can now be dyed.}}
{{History||v0.15.0|snap=build 1|Helmets can now be obtained from [[stray]]s and [[husk]]s that naturally spawn with armor.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron helmets and enchanted diamond helmets can now be found inside [[chest]]s within [[end city|end cities]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Iron helmets and chainmail helmets are now [[trading|sold]] by armorer smith [[villager]]s via trading.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Golden, chain and iron helmets can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Chainmail helmets now generate in [[buried treasure]] chests.
|Enchanted leather helmets can now be found inside [[shipwreck]] supply room [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Golden helmets can now be found inside [[underwater ruins]] chests.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Turtle Shell.png|32px]] [[File:Turtle Shell (item) JE1 BE1.png|32px]] Added turtle shells.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Leather Cap JE4 BE2.png|32px]] [[File:Chainmail Helmet JE3 BE2.png|32px]] [[File:Iron Helmet JE2 BE2.png|32px]] [[File:Golden Helmet JE2 BE2.png|32px]] [[File:Diamond Helmet JE2 BE2.png|32px]]<br>[[File:Leather Cap (item) JE4 BE3.png|32px]] [[File:Chainmail Helmet (item) JE2 BE2.png|32px]] [[File:Iron Helmet (item) JE2 BE2.png|32px]] [[File:Golden Helmet (item) JE2 BE2.png|32px]] [[File:Diamond Helmet (item) JE2 BE2.png|32px]] The textures of all types of helmets have been changed.
|Iron helmets now can be found in plains [[village]] weaponsmith [[chest]]s.
|Leather helmets can now be found inside plains village tannery chests.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron helmets now can be found in [[savanna]], [[taiga]], [[desert]], [[snowy taiga]] and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.
|Leather helmets can now be found inside savanna, taiga, desert, snowy taiga and snowy tundra village tannery chests.
|Iron helmets can now be found in [[village]] armorer chests.}}
{{History|||snap=beta 1.11.0.4|[[Pillager]]s and [[vindicator]]s that spawn in [[raid]]s can now drop iron helmets.
|Diamond helmets are now sold by armorer villagers.}}
{{History||1.11.0|snap=beta 1.11.0.5|[[File:Golden Helmet (item) JE3 BE3.png|32px]] The textures of gold helmet [[item]]s have been changed.}}
{{History||1.12.0|snap=beta 1.12.0.2|[[File:Armor Stand with Leather Armor MCPE-44669.png|32px]] Leather armor no longer shows as being [[dye]]d properly when worn by [[armor stand]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Leather armor now appears properly dyed when worn by armor stands.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Helmet JE2 BE1.png|32px]] [[File:Netherite Helmet (item) JE2 BE1.png|32px]] Added netherite helmets.
|[[File:Diamond Helmet (item) JE3 BE3.png|32px]] The textures of diamond helmet [[item]]s have been changed.
|Helmets can now be obtained from [[piglin]]s that naturally spawn with golden helmets.}}
{{History|||snap=beta 1.16.0.57|Golden and netherite helmets now generate randomly [[enchanting|enchanted]], and sometimes [[damage]]d, in [[bastion remnant]] chests.
|Netherite helmets can no longer be [[crafting|crafted]].
|Netherite helmets are now obtained by combining one diamond helmet and one netherite ingot in a [[smithing table]].}}
{{History|||snap=beta 1.16.0.63|Diamonds helmets now generate in place of netherite helmets in bastion remnant [[chest]]s.}}
{{History|||snap=beta 1.16.200.53|Netherite helmets now gives a 90% reduction in knockback.}}
{{History||1.16.210|snap=beta 1.16.210.53|Wearing leather helmets now prevents [[Powder Snow#Freezing|freezing]] entirely.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Leather Cap JE1 BE1.png|32px]] [[File:Chainmail Helmet JE2 BE1.png|32px]] [[File:Iron Helmet JE1 BE1.png|32px]] [[File:Golden Helmet JE1 BE1.png|32px]] [[File:Diamond Helmet JE1 BE1.png|32px]]<br>[[File:Leather Cap (item) JE1 BE1.png|32px]] [[File:Chainmail Helmet (item) JE1 BE1.png|32px]] [[File:Iron Helmet (item) JE1 BE1.png|32px]] [[File:Golden Helmet (item) JE1 BE1.png|32px]] [[File:Diamond Helmet (item) JE1 BE1.png|32px]] Added helmets.
|Added a quick equip for armor to the [[inventory]] interface.}}
{{History||xbox=TU12|ps=1.03|[[File:Leather Cap JE3 BE2.png|32px]] [[File:Leather Cap (item) JE3 BE2.png|32px]] The textures for leather helmets have been changed.}}
{{History||xbox=TU14|ps=1.05|Leather helmets can now be [[dye]]d.
|[[Item repair]] can now repair helmets.}}
{{History||xbox=TU25|xbone=CU13|ps=1.16|Helmets now have the quick equip functionality.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Golden, chain and iron helmets can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History|PS4}}
{{History||1.90|[[File:Chainmail Helmet (item) JE2 BE2.png|32px]] [[File:Iron Helmet (item) JE2 BE2.png|32px]] [[File:Golden Helmet (item) JE2 BE2.png|32px]] [[File:Diamond Helmet (item) JE2 BE2.png|32px]] The textures of all types of helmet items have been changed (except for the leather helmets).}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Leather Cap JE1 BE1.png|32px]] [[File:Chainmail Helmet JE2 BE1.png|32px]] [[File:Iron Helmet JE1 BE1.png|32px]] [[File:Golden Helmet JE1 BE1.png|32px]] [[File:Diamond Helmet JE1 BE1.png|32px]]<br>[[File:Leather Cap (item) JE3 BE2.png|32px]] [[File:Chainmail Helmet (item) JE1 BE1.png|32px]] [[File:Iron Helmet (item) JE1 BE1.png|32px]] [[File:Golden Helmet (item) JE1 BE1.png|32px]] [[File:Diamond Helmet (item) JE1 BE1.png|32px]] Added helmets.}}
{{History|foot}}
<gallery>
File:ArmorModel Aug 13 2009.jpg|First image of armor.
File:DinnerboneArmor.png|[[Dinnerbone]]'s first screenshot of dyed armor.
File:ArmorPE.png
</gallery>

;Armor durability from Indev until late Beta
{| class="wikitable" data-description="Armor Durability during Indev until late Beta" style="text-align:center;"
|-
!Leather
!Golden
!Chainmail
!Iron
!Diamond
|-
|33
|66
|66
|132
|264
|}

==Issues ==

{{issue list}}

==Trivia ==
*Unlike the other helmets, the netherite helmet covers most of the player's face, due to a nose guard and cheek plates.
*The turtle shell is the only helmet that is not part of a complete set.
* In Bedrock Edition, there exists a bug<ref>{{Cite bug|MCPE|109048|Efficiency 1 Leather Cap in Woodland Mansions|date=December 1, 2020}}</ref> that makes it possible to obtain a Leather Cap enchanted with Efficiency I from [[Woodland Mansion]] chests with a chance of 1.45%. The enchantment has no effect on the cap, however.

==Gallery ==
<gallery>
File:Zombie helmet.png|A zombie wearing a helmet in [[Survival Test]].
</gallery>
===Enchanted Helmets===
<gallery>
File:Enchanted Leather Cap (item).gif
File:Enchanted Chainmail Helmet (item).gif
File:Enchanted Iron Helmet (item).gif
File:Enchanted Golden Helmet (item).gif
File:Enchanted Diamond Helmet (item).gif
File:Enchanted Netherite Helmet (item).gif
File:Enchanted Turtle Shell (item).gif
</gallery>
<gallery>
File:Enchanted Leather Helmet.gif
File:Enchanted Chainmail Helmet.gif
File:Enchanted Iron Helmet.gif
File:Enchanted Golden Helmet.gif
File:Enchanted Diamond Helmet.gif
File:Enchanted Netherite Helmet.gif
File:Enchanted Turtle Shell.gif
</gallery>

==References ==
{{reflist}}

==External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--helmet Taking Inventory: Helmet] – Minecraft.net on February 20, 2020

{{Items}}

[[Category:Armor]]

[[es:Casco]]
[[ja:ヘルメット]]
[[ko:투구]]
[[pt:Capacete]]
[[pl:Hełm]]
[[zh:头盔]]</li></ul>
15w32aAdded the stat.sneakTime objective criteria.
15w32bAdded /scoreboard players tag.
Added the xp, food, and air objective types.
15w33aAdded the stat.pickup and stat.drop objective criteria.
Added the armor, level objective types.
15w36aAdded collisionRule.
15w49aAdded the stat.aviateOneCm objective criteria.
1.13
{{Extension DPL}}<ul><li>[[Footprint|Footprint]]<br/>{{about|the joke item|the unused particle|Java Edition unused features#Footprint particle}}
{{Joke feature}}
{{Item
| image = Footprint (item).png
| renewable = No
| stackable = Yes (64)
}}

The '''Footprint''' was a joke item from [[Java Edition 20w14∞]], found only in the {{code|missing}} dimension.

== Appearance ==
This item is semi-transparent with a grey colour scheme.

== Obtaining ==

=== Dimension ===
Footprints were obtained only from a chest in the {{Code|missing}} dimension. Only existing in 2020 April fools snapshot 20w14∞, it cannot exist in any non-April Fool's joke versions and April Fool's joke versions before or after 20w14∞. There is a maximum of 2 footprints that can be obtained legitimately in any given world.

=== Cheats/Creative Mode ===
Despite these footprints not being available in the creative inventory, it is still possible to acquire them via the command {{Code|code=give <target> minecraft:footprint <amount>}} or duplicating them by holding down middle-click whilst in creative mode.

== Usage ==
As of snapshot 20w14∞, this item cannot be placed or used in any way other than a trophy. This item can be inserted and/or rotated inside of an item frame, and it has a stack limit of 64.

== Data values ==
=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=Footprint
|spritetype=item
|nameid=footprint
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||20w14∞|[[File:Footprint (item).png|32px]] Added the footprint item.}}
{{History|foot}}

== Gallery ==
<gallery>
File:Missing biome.png|The Easter Egg dimension that the item spawns in.
</gallery>

== Trivia ==
* This is a reference to the removed "Footstep" particle, hence in the "missing" dimension.
** This item is intended as a joke directed towards the commands' community where the "Footstep" particle is commonly requested.<ref>https://gist.github.com/boq/8e65cb85badc75765eeb8956af78aaa5</ref>

== References ==
{{reflist}}

{{Items}}
{{Jokes}}

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

[[es:Footprint]]
[[pt:Pegada]]</li><li>[[Bundle|Bundle]]<br/>{{Experimental feature|bundle}}
{{planned|BE}}
{{Item
| image = Bundle.png
| image2 = Bundle Filled.png
| rarity = Common
| renewable = No
| stackable = No
}}

A '''bundle''' is an [[item]] that can store up to a stack's worth of mixed [[item]] types within itself in a single [[inventory]] slot. Items that stack to 16 occupy more space within the bundle, and items that do not stack occupy the entire bundle without allowing space for any other items.

== Obtaining ==

=== Crafting ===
{{Crafting
  |showdescription=1
  |A1=String      |B1=Rabbit Hide |C1=String 
  |A2=Rabbit Hide                 |C2=Rabbit Hide
  |A3=Rabbit Hide |B3=Rabbit Hide |C3=Rabbit Hide
  |Output=Bundle
  |type=Tool
  |description={{OnlyExperimental|bundle}}
}}

== Usage ==
<!--The tooltip does not reflect the current bundle "tooltip"-->
{{FakeImage|style=max-width:250px;
|1={{Slot|Stick,64}}{{Slot|Ender Pearl,16}}{{Slot|Iron Sword}}<br>{{Slot|Stick,1}}{{Slot|Ender Pearl,4}}{{Slot|Iron Sword,64}}<br>{{Slot|Filled Bundle[Stick x32/Ender Pearl x8]| title = Bundle|link=none}}
|2=Item stack sizes (top row) and the number of bundle slots they take up (middle row). Sticks stack to 64, so they take up one bundle slot; ender pearls stack to 16, so they take up four; and swords do not stack, so they take up the whole bundle. So, for instance, a bundle may have 32 sticks and 8 ender pearls inside (bottom), which take up a total of {{Tooltip|(32×1)|32 Sticks}}+{{Tooltip|(8×4)|8 Ender Pearls}}=64 bundle slots.
}}
Bundles are used to store different [[item|item type]]s in the same [[inventory]] slot. This does not, however, increase the total capacity of the slot: each bundle has 64 "bundle slots" and each item placed in the bundle takes up these slots similar to how they take up space in a normal inventory slot: items that stack to 64 take up 1 bundle slot, items that stack to 16 (for example, [[egg]]s) take up 4, and items that do not stack (such as tools/weapons/armor) take up the whole bundle, all 64 slots.

Although bundles themselves cannot be stacked, a bundle can be placed inside another (nested): the inner bundle itself uses 4 slots plus the number of slots already occupied by the items in that bundle.<ref>{{bug|MC-203567||Bundles can be placed inside of bundles|WAI}}</ref>  

To place items inside a bundle, either (1) pick up the bundle in the inventory and right-click on the item(s) to be placed inside or (2) pick up the item(s) and right-click on the bundle. When placing bundles inside another bundle, the interface uses the first method: picking up Bundle A and right clicking on Bundle B attempts to store Bundle B inside A.  

Bundles can be {{ctrl|used}} inside the inventory to take out the last item put in. In this way, items are accessible LIFO (last in, first out). When {{ctrl|used}} outside the inventory, it dumps all the items out into the world.

Hovering over the bundle shows its contained items in its inventory slots. The number of bundle slots used is displayed as ''<fullness>''/64 in the tooltip. If the bundle is full, then the empty slots are greyed out with an <span class="invslot">{{SlotSprite|Bundle full}}</span>.

[[Shulker box]]es cannot be placed inside of bundles.

[[File:MinecraftBundle.jpg|thumb|Hovering the mouse over a bundle filled with mob loot, nearly full, with 61 items.]]

== Sounds ==
{{Sound table
|sound=Bundle drop contents1.ogg
|sound2=Bundle drop contents2.ogg
|sound3=Bundle drop contents3.ogg
|subtitle=Bundle empties
|source=player
|description=When a bundle's items are thrown onto the ground
|id=item.bundle.drop_contents
|translationkey=subtitles.item.bundle.drop_contents
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 0.8-1.2 or 0.76-1.14 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Bundle insert1.ogg
|sound2=Bundle insert2.ogg
|sound3=Bundle insert3.ogg
|subtitle=Item packed
|source=player
|description=When items are placed into a bundle
|id=item.bundle.insert
|translationkey=subtitles.item.bundle.insert
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 0.8-1.2, 0.76-1.14, or 0.84-1.26 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Bundle remove one1.ogg
|sound2=Bundle remove one2.ogg
|sound3=Bundle remove one3.ogg
|subtitle=Item unpacked
|source=player
|description=When items are removed from a bundle
|id=item.bundle.remove_one
|translationkey=subtitles.item.bundle.remove_one
|volume=0.8
|pitch=''varies' <ref group=sound>Can be 0.8-1.2, 0.84-1.26, or 0.88-1.32 for each sound</ref>
|distance=16
|foot=1}}

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

=== Item data ===

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound|tag}}: The '''tag''' tag.
{{:Player.dat_format/Bundle}}
</div>
== History ==
{{History||October 3, 2020|link={{ytl|DBvZ2Iqmm3M|t=1846s}}|[[File:Bundle JE1.png|32px]][[File:Bundle Filled JE1.png|32px]] Bundles are revealed at [[Minecraft Live 2020]]. Hovering over them shows all items inside scattered around a large area, and incomplete bundles have the empty texture.}}
{{History||October 16, 2021|link=https://clips.twitch.tv/AffluentEncouragingOryxPeteZaroll-cd8pIapkfD4PRHxO|Ulraf, a game developer on ''Minecraft'', states that bundles will not be included in [[Caves & Cliffs]].}}
{{History||November 17, 2021|link=https://www.minecraft.net/en-us/article/caves---cliffs-update-part-ii-coming|Bundles are announced to be added after [[The Wild Update]].}}
{{History|java}}
{{History||1.17|snap=20w45a|[[File:Bundle JE1.png|32px]][[File:Bundle Filled JE1.png|32px]] Added bundles. Hovering over them shows some of the items contained and their quantities, much like the tooltip of a [[shulker box]]. Incomplete bundles have the full texture.}}
{{History|||snap=20w46a|[[File:Bundle JE2.png|32px]][[File:Bundle Filled JE2.png|32px]] The textures of bundles have been changed.
|Hovering over bundles now shows its contained items in special slots, similar to slots in the [[inventory]]. If the bundle is not full, it also has an empty slot with a plus on it.}}
{{History|||snap=20w48a|Bundles now show fullness as a number when [[advanced tooltips]] are enabled.
|{{ctrl|Using}} a bundle in the inventory now empties one item from the bundle instead of emptying all the contents out to the [[inventory]].
|{{ctrl|Using}} a bundle now throws out its entire content into the world.}}
{{History|||snap=20w49a|Bundle fullness is now always shown.
|Full bundles now show the blue bar instead of hiding it, to distinguish from empty bundles.}}
{{History|||snap=20w51a|Bundles now drop its contents when destroyed as an [[Item (entity)|item entity]].
|Bundle fullness has been changed from <code>Fullness: ''<fullness>'' / 64</code> to <code>''<fullness>''/64</code>
|The slots in the tooltip when hovering over bundles have changed to have a border, and rows of slot have a thicker edge between them.
|When the bundle is not full, it instead shows empty slots instead of one slot with a plus. When it is full, those empty slots become greyed out with an X.}}
{{History|||snap=21w05a|The player now receives a tutorial when first having a bundle in the inventory.}}
{{History|||snap=21w19a|Bundles are now accessible only through commands.}}
{{History||1.18|snap=Experimental Snapshot 1|Bundles are now available in the creative inventory and can be crafted once again.}}
{{History|||snap=21w37a|Bundles are once again accessible only through commands.}}
{{History||1.19.3|snap=22w42a|Bundles have been made available once again, and have been moved behind their own datapack.}}
{{h|bedrock}} 
{{h||1.19.50|snap=beta 1.19.50.21|Added bundle GUI textures in the Vanilla Packs.}} 
{{History|foot}}

== Issues ==
{{Issue list}}

== Gallery ==
<gallery>
JE 1.17 Development Bundle.png|The original bundle UI
Bundle in Inventory.jpg|A bundle inventory in the inventory
</gallery>

== References ==
{{Reflist}}

{{Items}}

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

[[de:Bündel]]
[[es:Saco]]
[[fr:Sac]]
[[ja:バンドル]]
[[pl:Sakwa]]
[[pt:Trouxa]]
[[ru:Мешок]]
[[zh:收纳袋]]</li></ul>
pre7Added /scoreboard objectives modify.
pre8Added /scoreboard objectives modify <objectiveName> rendertype hearts, which makes health bars display as hearts, like this: ♥♥♥♥♥♥♥♥♥♥.
Added /scoreboard objectives modify <objectiveName> rendertype integer, which makes health bars display as yellow numbers.
Objective names are now text components, not raw strings.
1.13.1
{{Extension DPL}}<ul><li>[[Beetroot|Beetroot]]<br/>{{about|the basic food item|the seeds|Beetroot Seeds|the soup|Beetroot Soup}}
{{Item
| title = Beetroot
| image = Beetroot.png
| heals = {{hunger|1}}
| renewable = Yes
| stackable = Yes (64)
}}

A '''beetroot''' is a food and [[dye]] ingredient.

== Obtaining ==

=== Farming ===
Beetroots are obtained from harvesting a fully grown [[beetroots|crop block]], which drops 1 beetroot and 1-4 seeds ({{frac|2|5|7}} seeds per plant harvested on average). Seed yield can be increased using a tool enchanted with [[Fortune]], with Fortune III harvesting an average of {{frac|5|3|7}} seeds per plant.

These crops can be found growing in [[village]]s or can be grown from planted [[beetroot seeds]].<!-- Do not add locations for finding seeds. Where to find seeds is described in the article about the seeds. -->

== Usage ==

=== Food ===
A beetroot can be eaten to restore {{hunger|1}} [[hunger]] and 1.2 hunger [[Hunger#Mechanics|saturation]]. Six beetroots can be crafted into [[beetroot soup]], which restores six times the hunger and saturation of a single beetroot.

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

=== Breeding ===
Beetroots can be used to [[breeding|breed]] [[pig]]s. Pigs also follow a player who is holding beetroot.

[[Villager]]s can pick up beetroot items to become willing, allowing them to breed. Villagers need 12 beetroots before they can breed.

=== Composting ===
Placing beetroot into a [[composter]] has a 65% chance of raising the compost level by 1.

=== Trading ===

Novice-level Farmer villagers have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 15 beetroots for an emerald.

== Sounds ==

{{Sound table/Entity/Food}}

== Data values ==

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

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

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

== History ==
{{History|java}}
{{History||1.9|snap=15w31a|[[File:Beetroot JE1 BE1.png|32px]] Beetroots have been added, along with its [[beetroot seeds|seeds]] and [[beetroot soup]]. Beetroot can also be used to craft [[rose red]] dye.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 434.}}
{{History||1.14|snap=18w43a|[[File:Beetroot JE2 BE2.png|32px]] The texture of beetroot has been changed.}}
{{History|||snap=19w03a|Placing beetroot into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Beetroot now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w11a|Farmer [[villager]]s now [[trading|buy]] beetroots.}}
{{History||1.17|snap=21w13a|The model of the [[crop]] for the beetroot crops has been tweaked that the backside textures are mirrored.}}

{{History|pocket alpha}}
{{History||November 13, 2013|link=http://instagram.com/p/gnkWOlJMB3/|[[Jeb]] announces on [[wikipedia:Instagram|Instagram]] that [[Johan Bernhardsson]] is working on a surprise feature for 0.8.0 alongside a picture of the [[player]] holding beetroot.}}
{{History||November 14, 2013|link={{tweet|jbernhardsson|400902957782147072}}|Johan posts another image of beetroot, confirming that the image previously posted by Jeb was indeed beetroot.}}
{{History||v0.8.0|snap=build 2|[[File:Beetroot JE1 BE1.png|32px]] Added beetroots. They are not obtainable in the Creative inventory.}}
{{History||v0.9.0|snap=build 1|Beetroot can now be used to lead and [[breeding|breed]] [[pig]]s.}}
{{History||v0.12.1|snap=build 1|Beetroot now restore [[hunger]], rather than [[health]].
|Beetroot can now generate in [[village]]s as [[crop]]s.}}
{{History||v0.13.1|Added beetroot to the Creative inventory.<ref name="missing beetroot item">https://bugs.mojang.com/browse/MCPE-10497</ref><!---{{info needed}}, the bug tracker has very little information. It's not in the Creative inventory in v0.12.1 or v0.13.0 initial release, but is in v0.14.0--->}}
{{History||v0.16.0|snap=build 1|Beetroot can now be used to craft [[rose red]] dye.}}
{{History||v0.16.2|Beetroot can now be found in [[chest]]s inside large houses in [[snowy taiga]] and [[snowy tundra]] [[village]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|[[Villager]]s can now can pick up beetroot to become willing.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Beetroot JE2 BE2.png|32px]] The texture of beetroot has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Beetroot can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|Beetroot can now be sold to farmer villagers.}}

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

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

== Issues ==

{{Issue list}}

== Gallery ==

<gallery>
File:Beetrootstwitpic.png|The image released by [[Johan Bernhardsson]] on [[Wikipedia:Twitter|Twitter]].
File:Pigs following beetroot holder.png|Pigs following the [[player]].
File:Village Wheat Beetroot Farm.png|Beetroots generated in a [[village]].
File:Beetroot farm.png|A beetroot garden.
</gallery>

== References ==
{{Reflist}}

{{Items}}

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

[[cs:Červená řepa]]
[[de:Rote Bete]]
[[es:Remolacha]]
[[fr:Betterave]]
[[hu:Cékla]]
[[it:Barbabietola]]
[[ja:ビートルート]]
[[ko:비트]]
[[nl:Biet]]
[[pl:Burak]]
[[pt:Beterraba]]
[[ru:Свёкла]]
[[th:บีทรูท]]
[[uk:Буряк]]
[[zh:甜菜根]]</li><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

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

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

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li></ul>
18w31aChanged the scoreboard operator %= from using % to Math.floorMod.
Bedrock Edition
1.7.0
{{Extension DPL}}<ul><li>[[Iron Nugget|Iron Nugget]]<br/>{{About|the nugget|the ore|Iron Ore|the item|Iron Ingot|the mineral block|Block of Iron}}
{{Item
| image = Iron Nugget.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Iron nuggets''' are pieces of iron that can be obtained by [[smelting]] iron [[tools]]/[[Sword|weapons]] or iron/chainmail [[armor]]. One iron nugget is worth one-ninth of an [[iron ingot]].

== Obtaining ==

=== Crafting ===

{{Crafting
|Iron Ingot
|Output= Iron Nugget,9
|type=Material
}}

=== Smelting ===

{{Smelting
|Iron Sword; {Any iron tools}; {Any iron armor}; {Any chainmail armor}; Iron Horse Armor
|Iron Nugget
|0,1
}}
[[Item durability|Durability]] and [[enchantments]] do not affect the ability to smelt iron tools, weapons, or armor into iron nuggets.

=== Bartering ===
[[Piglins]] may [[barter]] 9–36 iron nuggets when given a [[gold ingot]].

=== Chest loot ===

{{LootChestItem|iron-nugget}}

== Usage ==

Iron nuggets are used to craft [[iron ingot]]s, [[lantern]]s, [[soul lantern]]s, and [[chain]]s.

=== Crafting ingredient ===

{{crafting usage}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Iron Nugget
|spritetype=item
|nameid=iron_nugget
|id=569
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.11.1|snap=16w50a|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets. 
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this item's numeral ID was 452.}}
{{History|||snap=18w11a|Iron nuggets now generate in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w46a|Iron nuggets are now used to craft [[lantern]]s.}}
{{History|||snap=18w50a|Iron nuggets can now be found in chests in [[taiga]] [[village]] houses.}}
{{History||1.16|snap=20w06a|Iron nuggets are now used to craft [[soul fire lantern]]s.}}
{{History|||snap=20w10a|Iron nuggets now have a {{frac|10|411}} (~2.43%) chance of being given by [[piglin]]s when [[bartering]], in a stack size of 9–36.}}
{{History|||snap=20w16a|Iron nuggets are now used to craft [[chain]]s.|Iron nuggets now generate in [[ruined portal]] and [[bastion remnant]] [[chest]]s.}}

{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|Iron nuggets can now be found in some [[shipwreck]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Iron nuggets are now used to craft [[lantern]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron nugget can now be found in [[taiga]] [[village]] house chests.}}
{{History||1.16.0|snap=beta 1.16.0.51|Iron nuggets are now used to craft [[soul fire lantern]]s.}}
{{History|||snap=beta 1.16.0.57|Iron nuggets now have a {{frac|10|411}} (~2.43%) chance of being given by [[piglin]]s when [[bartering]], in a stack size of 9–36.
|Iron nuggets now generate in [[ruined portal]] and [[bastion remnant]] [[chest]]s.}}
{{History|||snap=beta 1.16.0.59|Iron nuggets are now used to craft [[chain]]s.}}
{{History||1.16.100|snap=beta 1.16.100.50|Iron nuggets can now be used as fuel in a [[furnace]].<ref>{{bug|MCPE-114216}}</ref>}}
{{History||1.18.30|snap=beta 1.18.30.26|Iron nuggets can no longer be used as fuel in a furnace.}}

{{History|console}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets. 
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|Iron nuggets are now used to craft [[lantern]]s}}

{{History|new 3ds}}
{{History||1.9.19|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History|foot}}

== Issues ==
{{issue list}}

==Gallery==
<gallery>
Pocket Edition Iron Nugget.jpg|First image of an iron nugget in ''Bedrock Edition''.
</gallery>

== See also ==
*[[Gold Nugget]]
*[[Iron]]

== References ==
{{Reflist}}

{{Items}}

[[de:Eisenklumpen]]
[[fr:Pépite de fer]]
[[ja:鉄塊]]
[[ko:철 조각]]
[[nl:IJzerklompje]]
[[pl:Bryłka żelaza]]
[[pt:Pepita de ferro]]
[[ru:Кусочек железа]]
[[uk:Залізний самородок]]
[[zh:铁粒]]
[[Category:Renewable resources]]</li><li>[[Enchanted Book|Enchanted Book]]<br/>{{About|the book that can give items enchantments when used on an anvil|the artifact that can enchant allied mobs in Minecraft Dungeons|Enchanter's Tome}}
{{Item
| image = Enchanted Book.gif
|imagesize=160px
| stackable = No
| renewable =  '''Swift Sneak''': No<br>'''All others''': Yes
| rarity = Uncommon 
}}

An '''enchanted book''' is an [[item]] that lets players add [[enchantments]] to certain items using an [[anvil]].

== Obtaining ==

=== Chest loot ===

==== Level-30 books ====
{{LootChestItem|enchanted-book}}

==== Random enchantment books ====
{{LootChestItem|enchanted-book-rnd}}

==== Soul Speed books ====
{{LootChestItem|enchanted-book-rnd-soul-speed}}

==== Swift Sneak books ====
{{LootChestItem|enchanted-book-rnd-swift-sneak}}

===Fishing===
Enchanted books can be obtained as a "treasure" item from [[fishing]] with a [[fishing rod]] as part of the "treasure" category. The book has the equivalent of a level 30 enchantment from an enchantment table, but treasure enchantments are available and the chance of multiple enchantments is not reduced.

=== Trading ===

{{IN|bedrock}}, librarian [[villager]]s have a 50% chance to sell enchanted books as part of their trades at novice, apprentice, and journeyman-level, and have {{frac|1|3}} chance to sell enchanted books at expert-level as part of their trades, meaning each librarian villager can sell up to four books. The price ranges between 5-64 [[emerald]]s per book. Based on the level of the enchantment and whether it is classified as a "[[Enchanting mechanics|treasure enchantment]]" (meaning they are not obtainable by enchanting, e.g. [[Mending]]), which doubles the cost, or not a price is determined.

{{IN|java}}, librarian villagers have a {{frac|2|3}} chance to sell an enchanted book as part of their trades at the novice, apprentice, and journeyman level, and have a 50% chance to sell an enchanted book at the expert level, meaning each librarian can sell up to four books. The price ranges from 5-64 [[emerald]]s per book, depending on the enchantment's level as well as whether or not it is a [[Enchanting mechanics|treasure enchantment]].
{| class="fandom-table"
|+Cost of Enchanted Books based on their level
!Level
!Lowest Price
!Highest Price
|-
|I (1)
|5
|19
|-
|II (2)
|8
|32
|-
|III (3)
|11
|45
|-
|IV (4)
|14
|58
|-
|V (5)
|17
|71 (capped at 64)
|}
They may contain any available enchantment (except Soul Speed and Swift Sneak) at any available level. See [[Trading#cite_note-enchanted-book-10|trading notes]] for more information on enchantments and prices.

===Drops ===
Vindicators and pillagers that spawn from raids have a small chance to drop an enchanted book with a level 30 enchantment, which may be a treasure enchantment.{{only|bedrock}}

===Enchanting===

[[File:Enchanted Book 4x.png|thumb|An enchanted book with multiple high level enchantments.]]
[[File:Similar enchantments.png|thumb|An enchanted book with multiple enchantments that can be applied to the same item.]]

Players can create an enchanted book by enchanting a [[book]] on an [[enchantment table]]. Books have a decreased chance of getting multiple enchantments (specifically, if multiple enchantments would be added, then one is removed at random), and have a lower "enchantability level" than most other items. Treasure enchantments such as Mending cannot be obtained from an enchantment table.

=== Bartering ===
Players can barter with [[piglin]]s by using or throwing [[gold ingot]]s, and doing so has a {{frac|5|459}} chance for piglins to give the player an enchanted book with any level of [[Soul Speed]]. Soul Speed enchanted books are only obtainable through [[bartering]], [[chest]] loot inside a bastion remnant, and [[fishing]]. They cannot be obtained through [[enchanting]] or [[trading]].

== Usage ==
{{see also|Anvil mechanics}}

In Survival, enchanted books are the only method to obtain certain enchantments on certain tools, such as Unbreaking on [[shield]]s. Enchanted books have a shine effect on their sprite.

To use an enchanted book, the player must place an item in the first slot in an [[anvil]], and a book in the next. In order to complete the enchantment, the player must have the required amount of [[experience]]. Note that using an enchanted book gets significant discounts at the anvil. Enchanted books themselves can be combined to create a single book with increased or multiple enchantments, similar to combining tools or weapons.  

When combining items, the compatible enchantments from the book in the second slot are transferred to the item from the first slot, keeping the highest level of any type. If two enchantments have the same level and a higher level is available, they combine into the next level. If a book is applied to an item that can't take all of its spells, the appropriate spells are transferred, while the unusable ones are lost. Enchanted books are single-use. 

Enchanted books do not exhibit their enchantment. For example, a book with Sharpness IV as an enchantment does no more damage than an un-enchanted book, or any non-weapon item, would when used as a weapon. An exception is the Fire Aspect book which can ignite TNT and light campfires and the Mending book if the block mined can be broken by fist.{{only|bedrock}}

=== Available items ===
{{See also|Enchantments}}

Enchanted books can enchant the usual items that can be enchanted at an [[enchanting table]], but ''unlike an enchanting table'', they are able to boost enchantments such as Sharpness or Thorns to their maximum power, and may apply the following enchantments to items (the table displays only netherite tools and armor, but any type can be enchanted):
<!-- do not change the items listed in this table. It is supposed to show the items that can receive these enchantments from an enchanted book, but are NOT possible through an enchanting table. -->
{| class="wikitable" style="text-align: center;" data-description="Secondary enchantments"
|-
!Enchantment
!Items not enchantable<br>at an enchanting table
!Note
|-
|[[Efficiency]]
|{{simpleGrid|Shears}}{{simpleGrid|Netherite Pickaxe}}{{simpleGrid|Netherite Shovel}}{{simpleGrid|Netherite Axe}}{{simpleGrid|Netherite Hoe}}
|Increases mining speed
|-
|[[Thorns]]||{{simpleGrid|Netherite Helmet}}{{simpleGrid|Netherite Chestplate}}{{simpleGrid|Netherite Leggings}}{{simpleGrid|Netherite Boots}}
|Inflicts damage on attacker
|-
|[[Unbreaking]]
|{{simpleGrid|Shears}}{{simpleGrid|Flint and Steel}}{{simpleGrid|Fishing Rod}}{{simpleGrid|Carrot on a Stick}}{{simpleGrid|Warped Fungus on a Stick}}{{simpleGrid|Trident}}{{simpleGrid|Shield}}{{simpleGrid|Elytra}}<br>
{{simpleGrid|Netherite Pickaxe}}{{simpleGrid|Netherite Shovel}}{{simpleGrid|Netherite Axe}}{{simpleGrid|Netherite Hoe}}{{simpleGrid|Netherite Sword}}{{simpleGrid|Bow}}{{simpleGrid|Crossbow}}<br>
{{simpleGrid|Netherite Helmet}}{{simpleGrid|Netherite Chestplate}}{{simpleGrid|Netherite Leggings}}{{simpleGrid|Netherite Boots}}
|Increasing durability on enchanted tools/armors
|-
|[[Frost Walker]]
|{{simpleGrid|Netherite Boots}}
|Creates walkable ice layer over water

|-
|[[Mending]]
|{{simpleGrid|Netherite Helmet}}{{simpleGrid|Netherite Chestplate}}{{simpleGrid|Netherite Leggings}}{{simpleGrid|Netherite Boots}}<br>
{{simpleGrid|Netherite Pickaxe}}{{simpleGrid|Netherite Shovel}}{{simpleGrid|Netherite Axe}}{{simpleGrid|Netherite Hoe}}{{simpleGrid|Netherite Sword}}{{simpleGrid|Bow}}{{simpleGrid|Crossbow}}<br>
{{simpleGrid|Shears}}{{simpleGrid|Flint and Steel}}{{simpleGrid|Fishing Rod}}{{simpleGrid|Carrot on a Stick}}{{simpleGrid|Warped Fungus on a Stick}}{{simpleGrid|Trident}}{{simpleGrid|Shield}}{{simpleGrid|Elytra}}
|Uses XP Orbs to repair damaged tools/weapons/armors
|-
|[[Curse of Binding]]
|{{simpleGrid|Netherite Helmet}}{{simpleGrid|Netherite Chestplate}}{{simpleGrid|Netherite Leggings}}{{simpleGrid|Netherite Boots}}<br>{{simpleGrid|Elytra}}{{simpleGrid|Carved Pumpkin}}{{simpleGrid|Head}}
|Prevents removal of cursed item
|-
|[[Curse of Vanishing]]
|{{simpleGrid|Netherite Helmet}}{{simpleGrid|Netherite Chestplate}}{{simpleGrid|Netherite Leggings}}{{simpleGrid|Netherite Boots}}<br>
{{simpleGrid|Netherite Pickaxe}}{{simpleGrid|Netherite Shovel}}{{simpleGrid|Netherite Axe}}{{simpleGrid|Netherite Hoe}}{{simpleGrid|Netherite Sword}}{{simpleGrid|Bow}}{{simpleGrid|Crossbow}}<br>
{{simpleGrid|Shears}}{{simpleGrid|Flint and Steel}}{{simpleGrid|Fishing Rod}}{{simpleGrid|Carrot on a Stick}}{{simpleGrid|Warped Fungus on a Stick}}{{simpleGrid|Trident}}{{simpleGrid|Shield}}<br>{{simpleGrid|Elytra}}{{simpleGrid|Carved Pumpkin}}{{simpleGrid|Head}}<br>{{simpleGrid|Compass}}{{simpleGrid|Recovery Compass}}
|Cursed item is destroyed upon death
|-
|[[Soul Speed]]
|{{simpleGrid|Netherite Boots}}
|The wearer's speed is increased when walking on [[soul sand]] or [[soul soil]].
|-
|[[Swift Sneak]]
|{{simpleGrid|Netherite Leggings}}
|The wearer's sneaking speed is increased.
|}

=== Creative mode ===

The player can enchant any item with any enchantment in [[Creative]] mode, allowing any applied effects to exhibit themselves.{{only|java}} For example, a [[stick]] can be enchanted with [[Silk Touch]] to allow the player to successfully dig [[grass block]]s. The enchanted item can still be used in Survival mode without any loss of enchantments.

Enchantments that are normally incompatible are still incompatible; for example, Piercing and Multishot cannot be both applied to the same item, even in Creative mode.

If a block is enchanted, it loses the enchantment upon being placed in the world.

=== Disenchanting ===
Disenchanting an enchanted book at a [[grindstone]] yields a normal [[book]] and some experience depending on the quality of the book.

=== Chiseled bookshelf ===
{{control|Use|text=Using}} the [[chiseled bookshelf]] while having an enchanted book in the main hand will put the book inside the chiseled bookshelf.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Chiseled bookshelf insert enchanted1.ogg
|sound2=Chiseled bookshelf insert enchanted2.ogg
|sound3=Chiseled bookshelf insert enchanted3.ogg
|sound4=Chiseled bookshelf insert enchanted4.ogg
|subtitle=Enchanted Book placed
|source=block
|description=When an enchanted book is placed in a chiseled bookshelf
|id=block.chiseled_bookshelf.insert.enchanted
|translationkey=subtitles.chiseled_bookshelf.insert_enchanted
|volume=0.8
|pitch=''varies'' <ref group=sound name=insertvaries>Can be 1.0, 0.85, or 1.1 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Chiseled bookshelf pickup enchanted1.ogg
|sound2=Chiseled bookshelf pickup enchanted2.ogg
|sound3=Chiseled bookshelf pickup enchanted3.ogg
|subtitle=Enchanted Book taken
|source=block
|description=When an enchanted book is removed from a chiseled bookshelf
|id=block.chiseled_bookshelf.pickup.enchanted
|translationkey=subtitles.chiseled_bookshelf.take_enchanted
|volume=0.8
|pitch=''varies'' <ref group=sound name=pickupvaries>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Chiseled bookshelf insert enchanted1.ogg
|sound2=Chiseled bookshelf insert enchanted2.ogg
|sound3=Chiseled bookshelf insert enchanted3.ogg
|sound4=Chiseled bookshelf insert enchanted4.ogg
|source=block
|description=When an enchanted book is placed in a chiseled bookshelf
|id=insert_enchanted.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound name=insertvaries>Can be 1.0, 0.85, or 1.1 for each sound</ref>}}
{{Sound table
|sound=Chiseled bookshelf pickup enchanted1.ogg
|sound2=Chiseled bookshelf pickup enchanted2.ogg
|sound3=Chiseled bookshelf pickup enchanted3.ogg
|source=block
|description=When an enchanted book is removed from a chiseled bookshelf
|id=pickup_enchanted.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound name=pickupvaries>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Enchanted Book
|spritetype=item
|nameid=enchanted_book
|id=521
|itemtags=minecraft:bookshelf_books</code>
|form=item
|foot=1}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
Enchanted books use an NBT tag <code>StoredEnchantments</code> to indicate the enchantment. 
The allowed sub-tags are <code>id</code> and <code>lvl</code>, equivalent to the format of the <code>Enchantments</code> tag that is used for enchantments applied to items.

''The following NBT structure is provided to show how the <code>StoredEnchantments</code> tag is organized, and is not comprehensive above the <code>tag</code> tag. The full NBT for an item can be found [[Chunk format#Items_and_XP_Orbs|here]].''

<div class="treeview" style="margin-top: 0;">
*{{nbt|compound|tag}}: The tag tag.
**{{nbt|list|StoredEnchantments}}: The list of enchantments on this book.
***{{nbt|compound}} An enchantment
****{{nbt|string|id}}: The enchantment name ID
****{{nbt|short|lvl}}: The enchantment level
</div>

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

==Advancements==
{{load advancements|Enchanter}}

==History==
{{History|java}}
{{History||November 24, 2012|link=none|[[Dinnerbone]] stated that he wanted to add a way to [[enchanting|enchant]] items in an [[anvil]] using [[paper]] at [[MINECON 2012]].}}
{{History||December 6, 2012|link={{tweet|Dinnerbone|276777823996366848}}|Dinnerbone released the first image of enchanting a diamond [[sword]] using an enchanted book that has [[Looting]] II for 6 levels. He also stated that "this is the reason I originally added the anvil."}}
{{History||1.4.6|snap=12w49a|[[File:Enchanted Book JE1 BE1.png|32px]] Added enchanted books. 
|The enchantments of enchanted books can be applied to any [[item]].}}
{{History|||snap=12w50a|In [[Survival]] mode, enchanted books can now be used with limited kind of items. In [[Creative]] mode, they can still be used with any item. It was stated that the remaining functionality in Creative mode is intentional.<ref>{{Tweet|Dinnerbone|277084371146665984|Also enchanted books + items they're not intended for are a little broken and I kindly ask you to not exploit it too badly thanks.|December 7, 2012}}</ref><ref>{{bug|MC-4203}}</ref>
|Librarian [[villager]]s now [[trading|sell]] enchanted books at a cost of 1 [[book]] at 5–64 [[emerald]]s. The cost depends on the [[enchanting|enchantment]] level, and the cost can occasionally go above 64 emeralds; see [[Trading/Before 1.8]] for more details.
|Enchanted books now spawn in [[dungeon]], [[mineshaft]], [[desert temple|desert]] and [[jungle temple|jungle]] temple, [[stronghold]] and [[village]] blacksmith [[chest]]s.}}
{{History|||snap=pre|Enchanted books have been added to the [[Creative inventory]]. All levels for each enchanted book can be found in the search tab, and only the maximum level in the ''Tools'' and ''Combat'' tabs.}}
{{History||1.5.1|snap=13w11a|The [[player]] can now combine enchanted books of the same level to create a higher level variation.}}
{{History||1.7.2|snap=13w36a|Enchanted books can now be obtained by [[fishing]] as a "treasure" [[item]]. It is possible for the book to have multiple enchantments.}}
{{History|||snap=13w39a|When [[enchanting]] books, [[book]]s can now gain multiple enchantments.}}
{{History||1.8|snap=14w02a|[[Trading]] for enchanted books has been changed: the [[emerald]] cost has been doubled for [[treasure enchantment]]s, and cost has been capped at 64.}}
{{History|||snap=14w25a|Enchanted book [[Depth Strider]] added, which can go up to Level III and allows for faster underwater moving.}}
{{History||1.9|snap=15w42a|Enchanted book [[Frost Walker]] added, which can go up to Level II and turns water into [[frosted ice]].
|Enchanted book [[Mending]] added, which repairs [[tools]]/[[armor]] upon receiving [[experience]].}}
{{History|||snap=15w43a|The average yield of enchanted books found in [[stronghold]] library [[chest]]s has now more than tripled.}}
{{History|||snap=15w44a|The average yield from [[desert temple]], [[mineshaft]] and [[dungeon]] chests has been substantially increased. The enchantments on these books are now fully random, rather than enchanted only at level 30.}}
{{History||1.11|snap=16w39a|Enchanted books are now found in the new [[woodland mansion]] chests, with fully random enchantments.
|Enchanted book [[Curse of Binding]] added, which prevents removal of cursed [[armor]].
|Enchanted book [[Curse of Vanishing]] added, which destroys cursed items upon [[death]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 403.}}
{{History|||snap=18w09a|Enchanted books now have a chance of generating in [[underwater ruins]] chests.}}
{{History||1.14|snap=18w43a|[[File:Enchanted Book JE2 BE2.png|32px]] The texture of enchanted books has been changed.}}
{{History|||snap=18w47a|Enchanted books now have a chance of generating in [[pillager outpost]] chests.}}
{{History||1.16|snap=20w11a|Added [[Soul Speed]] enchanted book, which increases player's speed on [[soul sand]] and [[soul soil]]. It can be obtained only via the [[bartering]].}}
{{History|||snap=20w16a|Soul Speed enchanted books now generate in [[bastion remnants]] chests.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Added [[Swift Sneak]] enchanted book, which increases player's speed while sneaking. It can be obtained only in [[ancient city]] chests.
|Enchanted books now generate in [[ancient city]] chests.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Enchanted books can now interact with [[chiseled bookshelves]].}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Enchanted Book JE1 BE1.png|32px]] Added enchanted books. 
|All levels of each enchanted book can be obtained in the Creative inventory.}}
{{History||v0.13.0|snap=build 1|Enchanted books now generate in [[desert temple]]s.}}
{{History||v0.14.0|snap=build 1|Enchanted books now generate in [[mineshaft]]s.}} 
{{History||v0.15.0|snap=build 1|Enchanted books now generate in [[jungle pyramid]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Enchanted books now generate in [[end city|end cities]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Enchanted books can now be [[trading|bought]] from librarian villagers for 5-64 emeralds as part of their tier 1, 4 and 5 trades.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Enchanted books now generate in [[woodland mansion]]s.
|Enchanted books [[Mending]] and [[Frost Walker]] added.}}
{{History|bedrock}}
{{History||1.2.13|snap=beta 1.2.13.5|Added Curse of Binding and Curse of Vanishing [[enchanting|enchantments]], but they are obtainable only via [[trading]] with librarian [[villager]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Enchanted books can now be found in [[underwater ruins]].}}
{{History||1.4.0|snap=beta 1.2.20.2|Curse enchantments are no longer obtainable via trading.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Enchanted Book JE2 BE2.png|32px]] The texture of enchanted books has been changed.
|Enchanted books can now be found in [[pillager outpost]]s.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn in [[raid]]s can now [[drops|drop]] enchanted books.
|[[Trading]] has been changed, enchanted books [[trading|bought]] from librarian [[villager]]s now cost 15-64 [[emerald]]s.
|Librarian villagers now have a 50% chance to [[trading|sell]] enchanted books as part of their first, second, and third tier trade, and {{frac|1|3}} chance to sell enchanted books as part of their fourth tier trades.}}
{{History||1.16.0|snap=beta 1.16.0.57|Added [[Soul Speed]] enchanted book, which can be obtained only via [[bartering]] and at [[bastion remnants]] chests.}}
{{History||1.20.0<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|Enchanted books can now interact with [[chiseled bookshelves]].}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|[[File:Enchanted Book JE1 BE1.png|32px]] Added enchanted books.
|Only the maximum level of each enchanted book can be obtained within the Creative inventory.}}
{{History|PS4}}
{{History||1.90|[[File:Enchanted Book JE2 BE2.png|32px]] The texture of enchanted books has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Enchanted Book JE1 BE1.png|32px]] Added enchanted books.
|All levels of each enchanted book can be obtained in the Creative inventory.}}
{{History|foot}}

== Issues ==

{{Issue list}}

==Trivia==

*When obtained through the {{cmd|give}} command with no stored enchantments, the enchanted book has no attached enchantments, but still shines as if it is enchanted.
*A book enchanted with [[Unbreaking]] III appears in both the tools tab and combat tab of the [[Creative]] [[inventory]].

==Gallery==

<gallery>
File:Dinnerbones_enchanted_Books.png|First image of an enchanted book, released by Dinnerbone.
File:DungeonBook.png|An enchanted book found in a dungeon chest.
File:Enchanted_Book.gif|An animation of an enchanted book.
</gallery>

==References ==

{{reflist}}

{{Items}}

[[Category:Renewable resources]]

[[de:Verzaubertes Buch]]
[[es:Libro encantado]]
[[fr:Livre enchanté]]
[[hu:Varázskönyv]]
[[ja:エンチャントの本]]
[[ko:마법이 부여된 책]]
[[nl:Betoverd boek]]
[[pl:Zaklęta książka]]
[[pt:Livro encantado]]
[[ru:Зачарованная книга]]
[[th:หนังสือร่ายมนตร์]]
[[uk:Зачарована книга]]
[[zh:附魔书]]</li></ul>
beta 1.7.0.2Added basic scoreboard mechanics.
Added dummy scoreboards.

Issues

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

References