Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 

Controls teams.

Syntax[]

team list [<team>]
Lists all teams, with their display names and the amount of entities in them. The optional <team> can be used to specify a particular team.
team add <team> [<displayName>]
Creates a team with the given name and optional display name. <displayName> defaults to <team> when unspecified.
team remove <team>
Deletes the specified team.
team empty <team>
Removes all members from the named team.
team join <team> [<members>]
Assigns the specified entities to the specified team. If no entities is specified, makes the executor join the team.
team leave <members>
Makes the specified entities leave their teams.
team modify <team> <option> <value>
Modifies the options of the specified team.

Arguments[]

<team>: team (in list, remove, empty, join, and modify mode)

Specifies the name of a team.
Must be a team name of an unquoted string. Allowed characters include: -, +, ., _, A-Z, a-z, and 0-9.

<team>: string (in add mode)

Specifies the name for a new team.
Must be a string. And it must be in a single word (Allowed characters include: -, +, ., _, A-Z, a-z, and 0-9).

<displayName>: component

Specifies the team name to be displayed.
Must be a raw JSON text.

<members>: score_holder

Specifies the entities to join or leave the team.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID, or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.

<option>

A specific option to change.
Value must be one of the following:
  • displayName: Set the display name of the team.
  • color: Decide the color of the team and players in chat, above their head, on the Tab menu, and on the sidebar. Also changes the color of the outline of the entities caused by the Glowing effect.
  • friendlyFire: Enable/Disable players inflicting damage on each other when on the same team. (Note: players can still inflict status effects on each other.) Does not affect some non-player entities in a team.
  • seeFriendlyInvisibles: Decide players can see invisible players on their team as whether semi-transparent or completely invisible.
  • nametagVisibility: Decide whose name tags above their heads can be seen.
  • deathMessageVisibility: Control the visibility of death messages for players.
  • collisionRule: Controls the way the entities on the team collide with other entities.
  • prefix: Modifies the prefix that displays before players' names.
  • suffix: Modifies the suffix that displays after players' names.

<value>

Specifies the value to set <option> to.
Shown below are the values for each option.
  • For displayName:
  • For color:
    • <value>: color - Must be a raw JSON text.
      • Defaults to reset. If reset, names are shown in default color and formatting.
  • For friendlyFire:
    • <allowed>: boolean - Must be a raw JSON text.
      • true - (Default) Enable players inflicting damage on each other when in the same team.
      • false - Disable players inflicting damage on each other when in the same team.
  • For seeFriendlyInvisibles:
    • <allowed>: boolean - Must be a raw JSON text.
      • true - (Default) Can see invisible players on the same team semi-transparently.
      • false - Cannot see invisible players on the same team.
  • For nametagVisibility:
    • never - Name above player's head cannot be seen by any players.
    • hideForOtherTeams - Name above player's head can be seen only by players in the same team.
    • hideForOwnTeam - Name above player's head cannot be seen by all the players in the same team.
    • always - (Default) Name above player's head can be seen by all the players.
  • For deathMessageVisibility:
    • never - Hide death message for all the players.
    • hideForOtherTeams - Hide death message to all the players who are not in the same team.
    • hideForOwnTeam - Hide death message to players in the same team.
    • always - (Default) Make death message visible to all the players.
  • For collisionRule:
    • always - (Default) Normal collision.
    • never - No entities can push entities in this team.
    • pushOtherTeams - Entities in this team can be pushed only by other entities in the same team.[1]
    • pushOwnTeam - Entities in this team cannot be pushed by another entity in this team.[1]
  • For prefix:
  • For suffix:

Result[]

CommandTriggerJava Edition
anythe arguments are not specified correctly Unparseable
/team list <team>
/team remove ...
/team empty ...
/team join ...
/team modify ...
<team> doesn't exist Failed
/team add ...the named <team> already exists
/team empty ...the <team> is already empty
/team join ...<members> is not specified when the command's executor is not an entity
<members> fails to resolve to one or more entities
/team leave ...<members> fails to resolve to one or more entities Failed
/team modify displayName ...
/team modify color ...
/team modify friendlyFire ...
/team modify seeFriendlyInvisibles ...
/team modify nametagVisibility ...
/team modify deathMessageVisibility ...
/team modify collisionRule ...
the specified value is the same as current value
anyOtherwiseSuccessful

Output[]

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
anyJava EditionOn fail000
/team listOn success11the number of existing teams
/team list <team>On success11the number of members in the <team></team>
/team add ...
/team remove ...
On success11the number of existing teams after execution
/team empty ...On success11the number of members in the team before execution
/team joinOn success111
/team join <members>On success11the number of specified entities
/team leave ...On success11the number of specified entities
/team modify displayName ...
/team modify color ...
/team modify friendlyFire ...
/team modify seeFriendlyInvisibles ...
/team modify nametagVisibility ...
/team modify deathMessageVisibility ...
/team modify collisionRule ...
On success110
/team modify prefix ...
/team modify suffix ...
On success111

History[]

Java Edition
1.13
{{Extension DPL}}<ul><li>[[Lead|Lead]]<br/>{{About|the item used for leashing and leading mobs|the element|Element#Lead}}
{{Item
| image = Lead.png
| stackable = Yes (64)
| renewable = Yes
}}
'''Leads''' are [[tool]]s used to leash and lead passive and neutral [[animal]]s, [[golem]]s and some [[monster]]s.

== Obtaining ==
=== Chest loot ===
{{LootChestItem|lead}}

=== Crafting ===
{{Crafting
  |A1= String
  |B1= String    
  |A2= String
  |B2= Slimeball
  |C3= String
  |Output= Lead,2
  |type= Tool
}}

=== Mob loot ===
[[Wandering Trader|Wandering trader]]s always spawn with 2 [[llama|trader llama]]s, each held with a lead. When a trader llama is detached, either by killing it or the wandering trader, dragging them far apart, or putting the llama in a [[boat]] or a [[minecart]], the lead drops at the llama's position.

== Usage ==
=== Crafting ingredient ===

{{crafting usage}}

=== Leashing mobs ===
[[File:SuspendedPigs.png|190px|thumb|One block tall mobs, such as pigs, suspend at 7 blocks above the ground.]]
[[File:SuspendedCows.png|190px|thumb|Two block tall mobs, such as cows, also suspend at 7 blocks above the ground.]]

{{control|Using}} a lead on a [[mob]] ties the lead to the mob, allowing it to be moved by the player. Multiple mobs can be held by leads at once, but each mob held requires its own lead.

It is possible to leash the following mobs and other entities:

{{columns-list|colwidth=20em|
* {{EntityLink|Allay}}
* {{EntityLink|Axolotl}}
* {{EntityLink|Bee}}
* {{EntityLink|Boat}}{{only|bedrock}}
* {{EntityLink|Camel}}
* {{EntityLink|Cat}}
* {{EntityLink|Chicken}}
* {{EntityLink|Chicken Jockey}} (only the mount)
* {{EntityLink|Cow}}
* {{EntityLink|Dolphin}}
* {{EntityLink|Donkey}}
* {{EntityLink|Fox}}
* {{EntityLink|Frog}}
* {{EntityLink|Glow Squid}}
* {{EntityLink|Goat}}
* {{EntityLink|Hoglin}}
* {{EntityLink|Horse}}
* {{EntityLink|Iron Golem}}
* {{EntityLink|Llama}}
* {{EntityLink|Mooshroom}}
* {{EntityLink|Mule}}
* {{EntityLink|Ocelot}}
* {{EntityLink|Parrot}}
* {{EntityLink|Pig}}
* {{EntityLink|Polar Bear}}
* {{EntityLink|Rabbit}}
* {{EntityLink|Sheep}}
* {{EntityLink|Skeleton Horse}}
* {{EntityLink|Skeleton Horseman}} (only the mount)
* {{EntityLink|Sniffer}}
* {{EntityLink|Snow Golem}}
* {{EntityLink|Squid}}
* {{EntityLink|Strider}}
* {{EntityLink|Trader Llama}}
* {{EntityLink|Wolf}}
* {{EntityLink|Zoglin}}
* {{EntityLink|Zombie Horse}}}}

Additionally, [[villager]]s, [[wandering trader]]s, and [[monster]]s other than the ones listed above, can be leashed using a map editor or [[NBT]] editor. 

With a mob on a lead held by the player, {{control|using}} the lead on any type of [[fence]] (or [[wall]]{{only|bedrock|short=1}}) attaches the lead to it with a visible knot, tying the mob to it. To attach it to a wall on Bedrock Edition, the player must hold a lead in the main hand.<ref>{{bug|MCPE-108078}}</ref> Multiple leads may be attached to one fence post. A mob tied to a fence tends to stay within 5 blocks of the fence post.

A lead is broken by pressing the {{control|use item}} control on the mob again, hitting the knot, or removing the attached fence post. Leads also break when hit by projectiles. Whenever a lead is removed or broken, it drops as an [[item (entity)|item]] at the location of the mob. However, it does not drop when unleashed in Creative mode.{{only|java}}<ref>{{bug|MCPE-79639}}</ref> A lead does not break if the attached animal dies.

A lead can stretch a maximum of 10 blocks. If the mob is able to move towards the player or fence post, it does so. If not, or if the mob is moving very quickly away from the player, the lead breaks.

When the player or the knot is more than 7 blocks above the ground, the mob being leashed becomes suspended.

Most mobs that can be leashed can still be leashed even if attacking the player leashing them, and any attached leads do not break.

[[Wolf|Wolves]] cannot be leashed after becoming angry. Despite this, if they become angry while already leashed, the lead does not break, but it cannot be reattached when broken through other methods while the wolf is still angry.

A lead attached to a hoglin breaks if it becomes a [[zoglin]].

A lead does not prevent mobs from despawning if they normally would despawn.

When moving downwards and accelerating towards the ground, leashed mobs accumulate fall damage and take it if they hit the ground while still accelerating. When moving up or decelerating (such as when the lead is stretched to its limit), the fall distance is set to one block and the mob therefore does not take any fall damage if it touches the ground.

If the player walks into and back out of a [[nether portal]] while holding a lead connected to a mob, the lead remains attached to the mob. However, if a mob attached to a lead walks into a nether portal, the lead breaks and drops as an item in the other dimension.

A lead can be used to remove a mob from a boat without needing to break the boat, if the mob can normally be leashed.

If a chunk unloads while containing a leashed mob (either by the player walking too far away, or traveling to another dimension via a portal), the lead breaks and drops as an item, leaving the mob free to wander around.

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Lead Knot break1.ogg
|sound2=Lead Knot break2.ogg
|sound3=Lead Knot break3.ogg
|subtitle=Leash Knot breaks
|source=neutral
|description=When a leash knot is destroyed
|id=entity.leash_knot.break
|translationkey=subtitles.entity.leashknot.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Lead Knot place1.ogg
|sound2=Lead Knot place2.ogg
|sound3=Lead Knot place3.ogg
|subtitle=Leash Knot tied
|source=neutral
|description=When a leash knot is placed on a fence
|id=entity.leash_knot.place
|translationkey=subtitles.entity.leashknot.place
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Lead Knot break1.ogg
|sound2=Lead Knot break2.ogg
|sound3=Lead Knot break3.ogg
|source=neutral
|description=When a leash knot is broken by {{ctrl|interacting}} with it
|id=leashknot.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Lead Knot place1.ogg
|sound2=Lead Knot place2.ogg
|sound3=Lead Knot place3.ogg
|source=neutral
|description=When a leash knot is placed on a fence or wall
|id=leashknot.place
|volume=1.0
|pitch=1.0
|foot=1}}

== Leash Knot ==
'''Leash knot''' is an entity created when the [[player]] right-clicks the fence while having a mob leashed.
{{Entity| title = Leash Knot| image = Knot.png|imagesize= 100px|networkid='''[[JE]]''': 77}}
=== Data values ===
==== ID ====
{{edition|java}}:
{{ID table
|edition=java
|generatetranslationkeys=y
|displayname=Leash Knot
|spritetype=entity
|nameid=leash_knot
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leash Knot
|spritetype=entity
|nameid=leash_knot
|id=88
|foot=1}}

==== Entity data ====

Leash knots have entity data that define various properties of the entity.

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lead
|spritetype=item
|nameid=lead
|id=547
|form=item
|foot=1}}

== Achievements ==

{{load achievements|So I Got That Going for Me}}

== Advancements ==

{{load advancements|When the Squad Hops into Town}}

== History ==
{{missing information|The history of a lot of mobs be leashed}}
{{History|java}}
{{History||1.6.1|snap=13w16a|[[File:Lead JE1 BE1.png|32px]] Added leads. 
|Leads do not currently have a tooltip and are called “leashes” in [http://www.mojang.com/2013/04/minecraft-snapshot-13w16a-and-new-launcher/ the change notes].}}
{{History|||snap=13w16b|Leads have been given a tooltip.}}
{{History|||snap=13w18a|Leads have been given a [[crafting]] recipe.}}
{{History||1.9|snap=15w50a|Added a [[sound]] for leads: <code>entity.leashknot.place</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID of the knot has been changed from <code>LeashKnot</code> to <code>leash_knot</code>.}}
{{History|||snap=16w39a|Leads can now be found in [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 420.}}
{{History||1.14|snap=18w43a|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.}}
{{History|||snap=19w05a|Added [[wandering trader]]s, which are naturally equipped with leads.}}
{{History||1.15|snap=?|[[Bee]]s can now be leashed.}}
{{History||1.16|snap=20w09a|[[Skeleton horse]]s and [[zombie horse]]s can now be leashed.<ref>{{bug|MC-166246}}</ref>}}
{{History|||snap=?|[[Hoglin]]s can now be leashed.}}
{{History||1.16.2|snap=20w27a|[[Zoglin]]s can now be leashed.}}
{{History||1.17|snap=21w19a|[[Squid]]s and [[glow squid]]s can now be leashed.<ref>{{bug|MC-136647}}</ref>}}
{{History|||snap=?|[[Axolotl]]s can now be leashed.}}
{{History||1.19|snap=22w13a|Lead may now be found in [[ancient city]] [[chest]]s.}}
{{History|||snap=?|[[Frog]]s can now be leashed.}}
{{History||1.19.3|snap=22w42a|[[Camel]]s can now be leashed.|Mobs no longer accumulate fall damage when dangling on leads.<ref>{{bug|MC-14167||Mobs build up fall damage when dangling on a lead|Fixed}}</ref>}}
{{History||1.20 (Experimental)|link=1.19.4|snap=?|[[Sniffer]]s can now be leashed.}}
{{History||1.20|snap=23w12a|Lead can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Lead no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; lead now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Leads now have better "physics".
|The [[entity]] ID of the knot has been changed from <code>leashknot</code> to <code>leash_knot</code>.
|Leads can now be found inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Leads can now be found inside [[buried treasure]] [[chest]]s.
|Leads can now be used on [[boat]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Leads can now be used to craft [[balloon]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.
|[[Wandering trader]]s now [[drops|drop]] leads after they are detached from trader [[llama]]s.}}
{{History||1.14.0|snap=beta 1.14.0.1|Leads can now be used on [[polar bear]]s, [[ocelot]]s, [[parrot]]s, [[dolphin]]s and old [[villager]]s.}}
{{History||1.19.0|snap=beta 1.19.0.20|Allays can now be leashed.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|[[Sound]]s have been added for leads.}}
{{History|Ps4}}
{{History||1.90|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History|foot}}

== Issues ==
{{issue list|Lead|Leash}}

== Trivia ==
[[File:Steve wearing Lead.png|100px]] [[File:Alex wearing Lead.png|100px]]
* The lead is named as "leash" in the texture file.
* If a [[player]] goes to sleep while holding a mob on a lead, the lead remains attached.
* {{IN|Java}}, when using the {{cmd|item}} command to put a lead in a player's head slot, the item gets rotated and positioned in such a way that it looks like the player is wearing a monocle.

== Gallery ==
<gallery>
Multiple_Leash.png|Many animals can be tied to one fence post.
HorseLeashedOnAFence.png|A [[horse]] wearing [[golden horse armor]] that is leashed to a fence post.
ThreeTiedSheep.png|Three sheep tied to the same fence.
More accurate lead mobs.png|A shot of all the mobs that could be tied with leads as of 1.6.1, except donkeys and mules.
Yo Yo.png|With the use of the leash, it is possible to suspend animals in the air by tying the leash on high-up fence posts.
YoYo.png|A [[donkey]] with the Grumm/Dinnerbone [[name tag]] [[easter egg]] tied to a fence with a lead to make a yo-yo.
Flying_Sheep.png|Several [[sheep]] hanging in the air in [[Creative]] mode.
Pocket Edition Lead.jpg|First image of a lead in ''Bedrock Edition''.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-lead Taking Inventory: Lead] – Minecraft.net on April 8, 2022

{{items}}

{{entities}}

[[Category:Tools]]

[[de:Leine]]
[[es:Rienda]]
[[fr:Laisse]]
[[hu:Lasszó]]
[[it:Guinzaglio]]
[[ja:リード]]
[[ko:끈]]
[[nl:Leidtouw]]
[[pl:Smycz]]
[[pt:Laço]]
[[ru:Поводок]]
[[th:เชือกจูง]]
[[zh:拴绳]]
[[Category:Renewable resources]]</li><li>[[Smithing Template|Smithing Template]]<br/>{{for|the block|Smithing Table}}
{{Item
| title = Smithing Template
| image = <gallery>
Netherite Upgrade Smithing Template.png | Netherite Upgrade
Sentry Armor Trim Smithing Template.png | Armor Trim
</gallery>
| rarity = Rare
| renewable = No<!--Smithing templates are not renewable because diamonds, their only other method of creation, are not renewable.-->
| stackable = Yes (64)
}}
'''Smithing templates''' are items used in [[Smithing Table|smithing tables]] to alter [[Tool|tools]] and [[armor]]. They are consumed when used, but can be [[Crafting|duplicated]] using an existing template, its material and [[Diamond|diamonds]].

The sixteen '''armor trim smithing templates''' are found in a variety of [[Generated structures|structures]], and are used to apply various decorative trims (dependent on the variant) to armor using certain minerals.

'''Netherite upgrade smithing templates''' are required to upgrade diamond equipment with [[Netherite Ingot|netherite]]. They are only found in [[Bastion Remnant|bastion remnants]], but are guaranteed only in [[:en:Bastion_Remnant#Treasure_room|treasure rooms]].

== Obtaining ==
Smithing templates can be found in various [[Generated structures|structures]] and can be duplicated by using seven diamonds and a block based on what the template is.

=== Crafting ===
{{Crafting
|A1=Diamond |B1=Matching Smithing Template                                                                                                                           |C1=Diamond
|A2=Diamond |B2=Netherrack;Cobblestone;Sandstone;End Stone;Terracotta;Terracotta;Netherrack;Cobblestone;Terracotta;Cobbled Deepslate;Blackstone;Purpur Block;Prismarine;Cobblestone;Cobbled Deepslate;Terracotta;Mossy Cobblestone |C2=Diamond
|A3=Diamond |B3=Diamond                                                                                                                                              |C3=Diamond
|Output=Matching Smithing Template,2
}}

{| class="article-table"
|+ Duplication 
! Item !! Material
|-
| {{ItemSprite|netherite-upgrade|text=Netherite Upgrade}} || {{BlockSprite|Netherrack|text=Netherrack}}
|-
| {{ItemSprite|sentry-armor-trim|text=Sentry Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|vex-armor-trim|text=Vex Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|wild-armor-trim|text=Wild Armor Trim}} || {{BlockSprite|Mossy Cobblestone|text=Mossy Cobblestone}}
|-
| {{ItemSprite|coast-armor-trim|text=Coast Armor Trim}} || {{BlockSprite|Cobblestone|text=Cobblestone}}
|-
| {{ItemSprite|dune-armor-trim|text=Dune Armor Trim}} || {{BlockSprite|Sandstone|text=Sandstone}}
|-
| {{ItemSprite|wayfinder-armor-trim|text=Wayfinder Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|raiser-armor-trim|text=Raiser Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|shaper-armor-trim|text=Shaper Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|host-armor-trim|text=Host Armor Trim}} || {{BlockSprite|Terracotta|text=Terracotta}}
|-
| {{ItemSprite|ward-armor-trim|text=Ward Armor Trim}} || {{BlockSprite|Cobbled Deepslate|text=Cobbled Deepslate}}
|-
| {{ItemSprite|silence-armor-trim|text=Silence Armor Trim}} || {{BlockSprite|Cobbled Deepslate|text=Cobbled Deepslate}}
|-
| {{ItemSprite|tide-armor-trim|text=Tide Armor Trim}} || {{BlockSprite|Prismarine|text=Prismarine}}
|-
| {{ItemSprite|snout-armor-trim|text=Snout Armor Trim}} || {{BlockSprite|Blackstone|text=Blackstone}}
|-
| {{ItemSprite|rib-armor-trim|text=Rib Armor Trim}} || {{BlockSprite|Netherrack|text=Netherrack}}
|-
| {{ItemSprite|eye-armor-trim|text=Eye Armor Trim}} || {{BlockSprite|End Stone|text=End Stone}}
|-
| {{ItemSprite|spire-armor-trim|text=Spire Armor Trim}} || {{BlockSprite|Purpur Block|text=Purpur Block}}
|}

{{IN|bedrock}}, spire, tide, and dune armor trims can be duplicated with more blocks than {{in|java}}. In addition to the normal blocks, Tide armor trims can be duplicated using Prismarine Bricks or Dark Prismarine, dune armor trims can be duplicated with smooth sandstone, cut sandstone, or chiseled sandstone, and spire armor trims can be duplicated with purpur pillars.<ref>{{bug|MCPE-172711||Tide, Spire, and Dune Armor Trims can be crafted from more blocks than in Java Edition}}</ref>

=== Mob loot ===
[[Elder guardian]]s have a 20% chance to drop 1 tide armor trim upon death. [[Looting]] doesn't affect this percentage, and the elder guardian doesn't need to be killed by a player in order for the trim to drop.

=== Chest loot ===
{{#invoke:LootChest|base3|netherite-upgrade-smithing-template,sentry-armor-trim-smithing-template,vex-armor-trim-smithing-template,wild-armor-trim-smithing-template,coast-armor-trim-smithing-template,dune-armor-trim-smithing-template,ward-armor-trim-smithing-template,silence-armor-trim-smithing-template,snout-armor-trim-smithing-template,rib-armor-trim-smithing-template,eye-armor-trim-smithing-template,spire-armor-trim-smithing-template}}
Note: In Woodland Mansions, only chests with random loot have the chance to contain the Vex Smithing Template, chests in the "Allium room", "Sapling farm", "Tree-chopping room" and "Fake End portal room" always generate with the same, room specific, loot.

=== Suspicious block loot ===
Items can only be extracted from [[Suspicious Block|suspicious blocks]] using a [[brush]].{{#invoke:LootChest|base3|wayfinder-armor-trim-smithing-template,raiser-armor-trim-smithing-template,shaper-armor-trim-smithing-template,host-armor-trim-smithing-template}}

== Usage ==
=== Crafting ingredient ===
{{Crafting
|A1=Diamond |B1=Matching Smithing Template                                                                                                                           |C1=Diamond
|A2=Diamond |B2=Netherrack;Cobblestone;Sandstone;End Stone;Terracotta;Terracotta;Netherrack;Cobblestone;Terracotta;Cobbled Deepslate;Blackstone;Purpur Block;Prismarine;Cobblestone;Cobbled Deepslate;Terracotta;Mossy Cobblestone |C2=Diamond
|A3=Diamond |B3=Diamond                                                                                                                                              |C3=Diamond
|Output=Matching Smithing Template,2
}}

=== Smithing ingredient ===
Smithing templates are used at a [[smithing table]]. Netherite upgrade smithing templates are used to upgrade diamond gear into netherite gear by using a netherite upgrade, a piece of diamond gear, and a [[netherite ingot]]. 

{{Smithing
|head=1
|ingredients=Netherite Upgrade +<br>Any Diamond Gear +<br>[[Netherite Ingot]]
|Netherite Upgrade
|Diamond Helmet; Diamond Chestplate; Diamond Leggings; Diamond Boots; Diamond Sword; Diamond Pickaxe; Diamond Axe; Diamond Shovel
|Netherite Ingot
|Netherite Helmet; Netherite Chestplate; Netherite Leggings; Netherite Boots; Netherite Sword; Netherite Pickaxe; Netherite Axe; Netherite Shovel
|tail=1
}}

{{FakeImage|{{Animate|Iron_Armor_with_Iron_Shaper_Trim.png; Golden_Armor_with_Golden_Shaper_Trim.png; Diamond_Armor_with_Diamond_Shaper_Trim.png; Netherite_Armor_with_Netherite_Shaper_Trim.png|180px}}|If the armor material and the trimming material are the same, the color palette used for the armor trim is darker.}}
Armor trim smithing templates are used to customize an armor piece's appearance by using a smithing template, an armor piece, and an ingot or crystal ([[emerald]], [[redstone dust]], [[lapis lazuli]], [[amethyst shard]], [[nether quartz]], [[netherite ingot]], [[diamond]], [[gold ingot]], [[iron ingot]], or [[copper ingot]]). Including all dyed leather armor colors and regular armor, there are ≈3.679x10<sup>9</sup> different possible armor pieces<!--5713438 leather colors, plus the 4 other armor materials = 5713442. 5713442 * 161 (the 160 trim combos (16 trims, 10 materials) + untrimmed) = 919864162. 919864162 * 4 (helmet, chestplate, leggings, boots) = 3679456648 ≈ 3.679x10^9-->, and 7.16x10<sup>35</sup> <!--919864162 + 1 (no armor in that slot) = 919864163. 919864163^4 = 715969952015045562662444917041515536 ≈ 7.16x10^35 total possible armor combinations-->total possible armor combinations excluding enchantments and the player not wearing armor.

Already trimmed armor can be trimmed again by applying another template on it; the old trim pattern is overwritten in the process.<ref>{{bug|MC-262538||When combining armor trims the new trim deletes the old one|WAI}}</ref> Therefore, one piece of armor cannot possess multiple trims at the same time.

Most armor trims cover a small portion of the armor piece's surface with the trim material, except for the silence armor trim, which allows the trim material to cover a majority of the armor piece's surface.

All of the trims are purely decorative, and don't impact gameplay or strength of the armor they are applied to in any way. [[Piglin]]s do not pick up any gold-trimmed armor pieces, and they are not pacified by players wearing even a full set of gold-trimmed armor (unless, of course, the armor pieces in question are themselves golden), and netherite-trimmed armor pieces can still be burned by [[fire]].

{{Smithing
|head=1
|ingredients=Any Armor Trim +<br>Any Armor Piece +<br>Any Ingot/Crystal
|Any Armor Trim Smithing Template
|Iron Helmet; Netherite Chestplate;Golden Leggings;Diamond Boots
|Amethyst Shard; Copper Ingot; Diamond; Emerald; Gold Ingot; Iron Ingot; Lapis Lazuli; Nether Quartz; Netherite Ingot; Redstone Dust; Diamond; Emerald
|Amethyst Trim Iron Helmet; Copper Trim Netherite Chestplate; Diamond Trim Golden Leggings; Emerald Trim Diamond Boots; Gold Trim Iron Helmet; Iron Trim Netherite Chestplate; Lapis Trim Golden Leggings; Quartz Trim Diamond Boots; Netherite Trim Iron Helmet; Redstone Trim Netherite Chestplate; Diamond Trim Golden Leggings; Emerald Trim Diamond Boots
|tail=1
}}

;List of color palettes for all materials
*{{ItemSprite|emerald         }} - {{TrimPalette| emerald         }}
*{{ItemSprite|redstone dust   }} - {{TrimPalette| redstone dust   }}
*{{ItemSprite|lapis lazuli    }} - {{TrimPalette| lapis lazuli    }}
*{{ItemSprite|amethyst shard  }} - {{TrimPalette| amethyst shard  }}
*{{ItemSprite|nether quartz   }} - {{TrimPalette| nether quartz   }}
*{{ItemSprite|netherite ingot }} - {{TrimPalette| netherite ingot }} (Darker: {{TrimPalette| netherite ingot |darker=1}})
*{{ItemSprite|diamond         }} - {{TrimPalette| diamond         }} (Darker: {{TrimPalette| diamond         |darker=1}})
*{{ItemSprite|gold ingot      }} - {{TrimPalette| gold ingot      }} (Darker: {{TrimPalette| gold ingot      |darker=1}})
*{{ItemSprite|iron ingot      }} - {{TrimPalette| iron ingot      }} (Darker: {{TrimPalette| iron ingot      |darker=1}})
*{{ItemSprite|copper ingot    }} - {{TrimPalette| copper ingot    }}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Smithing Template
|showforms=y
|generatetranslationkeys=y
|displayname=Netherite Upgrade
|spritename=netherite-upgrade-smithing-template
|spritetype=item
|nameid=netherite_upgrade_smithing_template
|form=item}}
{{ID table
|displayname=Sentry Armor Trim
|spritename=sentry-armor-trim-smithing-template
|spritetype=item
|nameid=sentry_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Vex Armor Trim
|spritename=vex-armor-trim-smithing-template
|spritetype=item
|nameid=vex_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Wild Armor Trim
|spritename=wild-armor-trim-smithing-template
|spritetype=item
|nameid=wild_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Coast Armor Trim
|spritename=coast-armor-trim-smithing-template
|spritetype=item
|nameid=coast_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Dune Armor Trim
|spritename=dune-armor-trim-smithing-template
|spritetype=item
|nameid=dune_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Wayfinder Armor Trim
|spritename=wayfinder-armor-trim-smithing-template
|spritetype=item
|nameid=wayfinder_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Raiser Armor Trim
|spritename=raiser-armor-trim-smithing-template
|spritetype=item
|nameid=raiser_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Shaper Armor Trim
|spritename=shaper-armor-trim-smithing-template
|spritetype=item
|nameid=shaper_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Host Armor Trim
|spritename=host-armor-trim-smithing-template
|spritetype=item
|nameid=host_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Ward Armor Trim
|spritename=ward-armor-trim-smithing-template
|spritetype=item
|nameid=ward_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Silence Armor Trim
|spritename=silence-armor-trim-smithing-template
|spritetype=item
|nameid=silence_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Tide Armor Trim
|spritename=tide-armor-trim-smithing-template
|spritetype=item
|nameid=tide_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Snout Armor Trim
|spritename=snout-armor-trim-smithing-template
|spritetype=item
|nameid=snout_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Rib Armor Trim
|spritename=rib-armor-trim-smithing-template
|spritetype=item
|nameid=rib_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Eye Armor Trim
|spritename=eye-armor-trim-smithing-template
|spritetype=item
|nameid=eye_armor_trim_smithing_template
|form=item}}
{{ID table
|displayname=Spire Armor Trim
|spritename=spire-armor-trim-smithing-template
|spritetype=item
|nameid=spire_armor_trim_smithing_template
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Smithing Template
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Netherite Upgrade
|spritename=netherite-upgrade-smithing-template
|spritetype=item
|nameid=netherite_upgrade_smithing_template
|id=685
|form=item
|translationkey=item.smithing_template.name, upgrade.netherite_upgrade.name}}
{{ID table
|displayname=Sentry Armor Trim
|spritename=sentry-armor-trim-smithing-template
|spritetype=item
|nameid=sentry_armor_trim_smithing_template
|id=686
|form=item
|translationkey=item.smithing_template.name, trim_pattern.sentry.name}}
{{ID table
|displayname=Vex Armor Trim
|spritename=vex-armor-trim-smithing-template
|spritetype=item
|nameid=vex_armor_trim_smithing_template
|id=692
|form=item
|translationkey=item.smithing_template.name, trim_pattern.vex.name}}
{{ID table
|displayname=Wild Armor Trim
|spritename=wild-armor-trim-smithing-template
|spritetype=item
|nameid=wild_armor_trim_smithing_template
|id=689
|form=item
|translationkey=item.smithing_template.name, trim_pattern.wild.name}}
{{ID table
|displayname=Coast Armor Trim
|spritename=coast-armor-trim-smithing-template
|spritetype=item
|nameid=coast_armor_trim_smithing_template
|id=688
|form=item
|translationkey=item.smithing_template.name, trim_pattern.coast.name}}
{{ID table
|displayname=Dune Armor Trim
|spritename=dune-armor-trim-smithing-template
|spritetype=item
|nameid=dune_armor_trim_smithing_template
|id=687
|form=item
|translationkey=item.smithing_template.name, trim_pattern.dune.name}}
{{ID table
|displayname=Wayfinder Armor Trim
|spritename=wayfinder-armor-trim-smithing-template
|spritetype=item
|nameid=wayfinder_armor_trim_smithing_template
|id=698
|form=item
|translationkey=item.smithing_template.name, trim_pattern.wayfinder.name}}
{{ID table
|displayname=Raiser Armor Trim
|spritename=raiser-armor-trim-smithing-template
|spritetype=item
|nameid=raiser_armor_trim_smithing_template
|id=699
|form=item
|translationkey=item.smithing_template.name, trim_pattern.raiser.name}}
{{ID table
|displayname=Shaper Armor Trim
|spritename=shaper-armor-trim-smithing-template
|spritetype=item
|nameid=shaper_armor_trim_smithing_template
|id=700
|form=item
|translationkey=item.smithing_template.name, trim_pattern.shaper.name}}
{{ID table
|displayname=Host Armor Trim
|spritename=host-armor-trim-smithing-template
|spritetype=item
|nameid=host_armor_trim_smithing_template
|id=701
|form=item
|translationkey=item.smithing_template.name, trim_pattern.host.name}}
{{ID table
|displayname=Ward Armor Trim
|spritename=ward-armor-trim-smithing-template
|spritetype=item
|nameid=ward_armor_trim_smithing_template
|id=690
|form=item
|translationkey=item.smithing_template.name, trim_pattern.ward.name}}
{{ID table
|displayname=Silence Armor Trim
|spritename=silence-armor-trim-smithing-template
|spritetype=item
|nameid=silence_armor_trim_smithing_template
|id=697
|form=item
|translationkey=item.smithing_template.name, trim_pattern.silence.name}}
{{ID table
|displayname=Tide Armor Trim
|spritename=tide-armor-trim-smithing-template
|spritetype=item
|nameid=tide_armor_trim_smithing_template
|id=693
|form=item
|translationkey=item.smithing_template.name, trim_pattern.tide.name}}
{{ID table
|displayname=Snout Armor Trim
|spritename=snout-armor-trim-smithing-template
|spritetype=item
|nameid=snout_armor_trim_smithing_template
|id=694
|form=item
|translationkey=item.smithing_template.name, trim_pattern.snout.name}}
{{ID table
|displayname=Rib Armor Trim
|spritename=rib-armor-trim-smithing-template
|spritetype=item
|nameid=rib_armor_trim_smithing_template
|id=695
|form=item
|translationkey=item.smithing_template.name, trim_pattern.rib.name}}
{{ID table
|displayname=Eye Armor Trim
|spritename=eye-armor-trim-smithing-template
|spritetype=item
|nameid=eye_armor_trim_smithing_template
|id=691
|form=item
|translationkey=item.smithing_template.name, trim_pattern.eye.name}}
{{ID table
|displayname=Spire Armor Trim
|spritename=spire-armor-trim-smithing-template
|spritetype=item
|nameid=spire_armor_trim_smithing_template
|id=696
|form=item
|translationkey=item.smithing_template.name, trim_pattern.spire.name
|foot=1}}

== Achievements ==
{{load achievements|Smithing with style}}

== Advancements ==
{{load advancements|Crafting a New Look;Smithing with Style}}

== Video ==
{{yt|klP9SrJFDU8}}

== History ==
{{History|java}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|[[File:Netherite Upgrade Smithing Template JE1 BE1.png|32px]] [[File:Sentry Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Vex Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Wild Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Coast Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Dune Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Ward Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Tide Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Snout Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Rib Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Eye Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Spire Armor Trim Smithing Template JE1 BE1.png|32px]] Added smithing templates behind the "Update 1.20" experimental datapack.}}
{{History|||snap=23w05a|Smithing templates can be used to trim leather armor.
|Gold, iron, diamond, and netherite armor can be trimmed with their respective material.
|The dune, coast, wild, and sentry armor trims now always generate two templates in a chest when found.
|Increased the chances for all smithing templates that generate in chest loot to spawn:
*Netherite upgrade chance to find increased from 3.2% to 10%.
*Coast chance to find increased from 11.1% to 16.7%.
*Dune chance to find increased from 11.1% to 14.3%.
*Eye chance to find increased from 4.7% to 10% in alter chests, and to 100% in library chests.
*Rib chance to find increased from 4.7% to 6.7%.
*Sentry chance to find increased from 20% to 25%.
*Snout chance to find increased from 4.7% to 8.3%.
*Spire chance to find increased from 4.7% to 6.7%.
*Vex chance to find increased from 4.7% to 50%.
*Ward chance to find increased from 4.7% to 5%.
*Wild chance to find increased from 20% to 33%.}}
{{History||1.20|snap=23w12a|Smithing templates are now available without using the "Update 1.20" experimental datapack.|[[File:Wayfinder Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Raiser Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Shaper Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Host Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Silence Armor Trim Smithing Template JE1 BE1.png|32px]] Added wayfinder, raiser, shaper, host, and silence armor trim smithing templates.
|[[File:Sentry Armor Trim Smithing Template JE2 BE2.png|32px]] [[File:Dune Armor Trim Smithing Template JE2 BE2.png|32px]] Changed the textures of the sentry and dune armor trim smithing templates.
|The pattern textures of dune and sentry armor trims are changed from [[File:Armor Trim Dune (sample model) JE1 BE1.png|24px]] [[File:Armor Trim Sentry (sample model) JE1 BE1.png|24px]] to [[File:Armor Trim Dune (sample model) JE2 BE2.png|24px]] [[File:Armor Trim Sentry (sample model) JE2 BE2.png|24px]].<br>
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}
{{History|||snap=23w16a|Wayfinder, raiser, shaper, and host armor trim no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; wayfinder, raiser, shaper, and host armor trim now are in the rare loot.}}
{{History|||snap=23w17a|The probability of the wayfinder, raiser, shaper, and host armor trim to generate in [[suspicious gravel]] in [[trail ruins]] has been changed from 1/11 to 1/12.|The player now get the [[advancement]] "Crafting a new look" when they craft a trimmed armor at a [[smithing table]] using a smithing template, "Smithing with style" when they apply these smithing templates at least once on their armor: Spire, Snout, Rib, Ward, Silence, Vex, Tide, and Wayfinder.}}

{{History|bedrock}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.21|[[File:Netherite Upgrade Smithing Template JE1 BE1.png|32px]] [[File:Sentry Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Vex Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Wild Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Coast Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Dune Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Ward Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Tide Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Snout Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Rib Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Eye Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Spire Armor Trim Smithing Template JE1 BE1.png|32px]] Added smithing templates behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.}}
{{History|||snap=beta 1.19.80.22|[[File:Wayfinder Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Raiser Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Shaper Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Host Armor Trim Smithing Template JE1 BE1.png|32px]] [[File:Silence Armor Trim Smithing Template JE1 BE1.png|32px]] Added wayfinder, raiser, shaper, host, and silence armor trim smithing templates.
|[[File:Sentry Armor Trim Smithing Template JE2 BE2.png|32px]] [[File:Dune Armor Trim Smithing Template JE2 BE2.png|32px]] Changed the textures of the sentry and dune armor trim smithing templates.
|The pattern textures of dune and sentry armor trims are changed from [[File:Armor Trim Dune (sample model) JE1 BE1.png|24px]] [[File:Armor Trim Sentry (sample model) JE1 BE1.png|24px]] to [[File:Armor Trim Dune (sample model) JE2 BE2.png|24px]] [[File:Armor Trim Sentry (sample model) JE2 BE2.png|24px]].<br>
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}
{{History||1.20.0|snap=beta 1.20.0.21|Smithing templates are now available without using the "Next Major Update" experimental toggle.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Smithing templates were named "Smithing Blueprints" in the prototype but was changed because the word "blueprint" sounded modern and technical.<ref>{{ytl|klP9SrJFDU8|Minecraft 1.20: Armor Trims - What Do They Mean?|Minecraft|May 4, 2023|t=98}}</ref>
* When Mojang developer Gnembon was working on armor trims, he accidentally messed up their rendering, making them jet through the player's body in a weird fashion, similar to what appears in {{w|Salvador Dalí}}'s paintings where a hand might poke through a forehead.<ref>{{ytl|ghQODkq4ITI|Mojang Dev Comes To Hermitcraft! (Mojang Developer Gnembom Interview)|GoodVodsWithScar|June 23, 2023|t=1980}}</ref>
* Some of the armor trims feature patterns based on a [[mob]] or [[block]] that is found in the same [[Generated structures|structure]] as the corresponding smithing template.<ref name=":0">"Some of the armor trims reflect the place where you found the template, for example bastions contain a piglin-inspired trim."-[[Sofia Dankis]]-{{Mcnet|armor-trims-coming-minecraft-1-20|Armor Trims Coming to Minecraft 1.20|January 24, 2023}}</ref>
** The spire armor trim resembles a [[shulker]].
** The vex armor trim resembles an [[evoker]]. As an item in the [[inventory]], it resembles the wing or the vein texture of a [[vex]].
** The wild armor trim has moss growing on 3 of its corners.
** The coast armor trim appears to have barnacles attached to it.
** The ward armor trim, as an item in the inventory, resembles the faces inside a [[warden]]'s chest.
** The silence armor trim appears to have sculk creeping onto / infecting it.
** The tide armor trim resembles [[Prismarine|prismarine bricks]].
** The snout armor trim resembles a [[piglin]]<ref name=":0" />.
** The rib armor trim resembles a [[wither skeleton]].
** The eye armor trim resembles an [[eye of ender]]. There are also two eyes on the head part of the armor trim that resemble those of an [[enderman]].
* ''Netherite upgrade smithing template'' (35 characters with "_" and 32 characters without "_") and ''sentry armor trim smithing template'' (35 characters with "_" and 31 characters without "_") are the current longest name for item ID, while ''[[polished blackstone pressure plate]]'' and ''[[cracked polished blackstone bricks]]'' have 34 characters with "_" and 31 characters without "_".
* The silence armor trim is the rarest trim, due to being found in ancient cities in the deep dark, and having only a 1.2% chance to be per chest.
* When [[lapis lazuli]] is used as trim material, it is called "Lapis" instead of its full name "Lapis Lazuli"; this is the only instance of the abbreviation "Lapis" being used in-game.<ref>{{bug|MC-262486|||WAI}}</ref>

== Gallery ==
=== Sprites ===
<gallery>
Netherite Upgrade Smithing Template.png|Netherite Upgrade
Sentry Armor Trim Smithing Template.png|Sentry Armor Trim
Vex Armor Trim Smithing Template.png|Vex Armor Trim
Wild Armor Trim Smithing Template.png|Wild Armor Trim
Coast Armor Trim Smithing Template.png|Coast Armor Trim
Dune Armor Trim Smithing Template.png|Dune Armor Trim
Wayfinder Armor Trim Smithing Template.png|Wayfinder Armor Trim
Raiser Armor Trim Smithing Template.png|Raiser Armor Trim
Shaper Armor Trim Smithing Template.png|Shaper Armor Trim
Host Armor Trim Smithing Template.png|Host Armor Trim
Ward Armor Trim Smithing Template.png|Ward Armor Trim
Silence Armor Trim Smithing Template.png|Silence Armor Trim
Tide Armor Trim Smithing Template.png|Tide Armor Trim
Snout Armor Trim Smithing Template.png|Snout Armor Trim
Rib Armor Trim Smithing Template.png|Rib Armor Trim
Eye Armor Trim Smithing Template.png|Eye Armor Trim
Spire Armor Trim Smithing Template.png|Spire Armor Trim
</gallery>

=== Armor trim patterns ===
<gallery>
Armor Trim Sentry (sample model).png|Sentry Armor Trim
Armor Trim Vex (sample model).png|Vex Armor Trim
Armor Trim Wild (sample model).png|Wild Armor Trim
Armor Trim Coast (sample model).png|Coast Armor Trim
Armor Trim Dune (sample model).png|Dune Armor Trim
Armor Trim Wayfinder (sample model).png|Wayfinder Armor Trim
Armor Trim Raiser (sample model).png|Raiser Armor Trim
Armor Trim Shaper (sample model).png|Shaper Armor Trim
Armor Trim Host (sample model).png|Host Armor Trim
Armor Trim Ward (sample model).png|Ward Armor Trim
Armor Trim Silence (sample model).png|Silence Armor Trim
Armor Trim Tide (sample model).png|Tide Armor Trim
Armor Trim Snout (sample model).png|Snout Armor Trim
Armor Trim Rib (sample model).png|Rib Armor Trim
Armor Trim Eye (sample model).png|Eye Armor Trim
Armor Trim Spire (sample model).png|Spire Armor Trim
</gallery>

=== Official Artwork ===
<gallery>
T&T Thumbnail.jpg|[[Sunny]] wearing amethyst armor trims.
Warden Chasing Alex with Silence Trim Pixel Art.png|A [[warden]] chasing Alex holding the silence armor trim.
Alex Trimming Armor in Smithing Table Pixel Art.png|Alex adding the silence armor trim and amethyst on iron armor.
Alex Wearing Iron Armor with Amethyst Pixel Art.jpg|Alex wearing the trimmed iron armor.
File:Live2023-01.jpeg|Noor working on trimmed iron armor.
</gallery>

=== Screenshots ===
<gallery>
Kingbdogz Armor Trim 1.jpg|Redstone trims on diamond armor.
Kingbdogz Armor Trim 2.jpg|Gold trims on netherite armor.
Too Many Trims.jpg|A large amount of armor trims.
Kingbdogz Armor Trim 3.jpg|Gold on netherite.
Kingbdogz Armor Trim 4.jpg|Diamond on diamond.
New Armor Trims in 23W12A.jpg|<ref>{{Tweet|kingbdogz|1638580472962850831|new trims got the drip The new "Silence" armor trim to the left is now the hardest trim to get, with only a 1% chance per chest to spawn in Ancient Cities. Definitely gonna be a challenge to get!|March 22, 2023}}</ref>
Emerald Armor.png|Emerald on gold.
Xilefian Armor Trims 1.png|[[Xilefian]] showing how armor trims work.
Xilefian Armor Trims 2.png|[[Xilefian]] showing how armor trims work.
Xilefian Armor Trims 3.png|[[Xilefian]] showing how armor trims work.
Armor Trims On Netherite Armors.png|A display of all eleven (before [[Java Edition 23w12a]]) armor trims and ten colors on netherite armors.
Armor Trim Showcase.png|A display of all eleven (before [[Java Edition 23w12a]]) armor trims, on netherite armor using emerald as the trim material.
Armor Trim Colors.png|A display of all ten armor trim colors, using the ward trim on a netherite helmet.
Silence Armor Trim on All Armors.png|A display of all ten colors of the silence armor trim on all armors.
Image 2023-06-07 154100087.png|A screenshot of every armor trim in every color(besides quartz) on leather armor.
Armor Trim Friends.jpg|Official screenshot of [[Alex]] and [[Zuri]] wearing armor trims.
LadyAgnes Armor Trims.jpg|Copper trims on netherite armor.
Trim Lineup.jpg
Fancy Delta.jpg|[[Kai]] wearing trimmed armor in a [[Basalt Delta]].
Trims & Pots.jpg
Noor Gold Armor Trim .jpeg
Noor Diamond Armor Trim.jpeg
Noor Netherite Armor Trim.jpeg
Noor Iron Armor Trim.jpeg
</gallery>

== References ==
{{Reflist}}

{{Items}}

[[Category:Bedrock Edition]]
[[Category:Non-renewable resources]]

[[de:Schmiedevorlage]]
[[es:Molde de herrería]]
[[fr:Modèle de forge]]
[[ja:鍛冶型]]
[[pl:Szablon kowalski]]
[[pt:Molde de ferraria]]
[[ru:Кузнечный шаблон]]
[[uk:Ковальський шаблон]]
[[zh:锻造模板]]</li></ul>
17w45aAdded /team.
18w20aAdded /team option <team> prefix <prefix>.
Added /team option <team> suffix <suffix>.
pre8/team option is now /team modify
Added /team modify <teamName> displayName.
Team names are now text components, not raw strings.
1.18
{{Extension DPL}}<ul><li>[[Gray Dye|Gray Dye]]<br/>{{Item
| image = Gray Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Gray dye'''{{fn|Known as '''Grey Dye''' in British, Canadian, Australian, and New Zealand English variants.}} is a [[Dyeing#Secondary colors|secondary color]] dye.

== Obtaining ==

=== Crafting ===

{{Crafting
  |Black Dye
  |White Dye
  |Output=Gray Dye,2
  |type=Material
  |head=1
  |showdescription=1
  |showname=0
}}
{{Crafting
  |Ink Sac;Black Dye;Ink Sac
  |Bone Meal;Bone Meal;White Dye
  |Output=Gray Dye,2
  |type=Material
  |description={{only|bedrock|education}}
  |foot=1
}}

=== Trading ===

[[Wandering trader]]s sell 3 gray dye for an [[emerald]].{{only|bedrock}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===
Journeyman-level villagers have a 20% chance to buy 12 gray dye for an emerald.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|aliasid=dye / 8
|id=403
|form=item
|translationkey=item.dye.gray.name
|foot=1}}

== Video ==
{{yt|wGalHy0_fj0}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Gray dye can be now [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary [[dye]]s.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|Gray dye is now [[crafting|crafted]] using [[black dye|black]] and [[white dye]]s, instead of [[ink sac]] and [[bone meal]].
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History|||snap=18w44a|Gray dye can now change the text color on the [[sign]]s to gray.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell gray dyes.}}
{{History|||snap=19w11a|Gray dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Gray dye can now used to craft [[gray candle]]s.}}
{{History|||snap=21w19a|Gray dye can no longer be used to craft gray candles.}}
{{History|||snap=Pre-release 1|Gray dye can once again be used to craft gray candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Gray dye can now change the text color on [[hanging sign]]s to gray.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.8.0|snap=build 1|Gray dye can be [[craft]]ed with [[bone meal]] and an [[ink sac]], despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Gray dye is now available in [[creative]] mode.}}
{{History||v0.9.0|snap=build 3|Gray dye can now be obtained in [[survival]] mode.}}
{{History|||snap=build 11|Gray dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Gray dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Gray dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gray dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gray dye can now be used to craft [[concrete powder]], colored [[bed]]s and dyed [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gray dye can now be used to craft [[firework star]]s, [[stained glass]] and patterns on [[banner]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Gray dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Gray dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Gray dye is now [[trading|sold]] by [[wandering trader]]s.
|Gray dye can now be used to dye white [[carpet]]s and undyed [[glass pane]]s.
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of gray dye has been changed from <code>dye/8</code> to <code>gray_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|PS4}}
{{History||1.90|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Notes ==
{{fnlist}}

== References ==
{{Reflist}}

{{Items}}

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

[[cs:Šedé barvivo]]
[[de:Grauer Farbstoff]]
[[es:Tinte gris]]
[[fr:Teinture grise]]
[[hu:Szürke festék]]
[[ja:灰色の染料]]
[[ko:회색 염료]]
[[nl:Grijze kleurstof]]
[[pl:Szary barwnik]]
[[pt:Corante cinza]]
[[ru:Серый краситель]]
[[zh:灰色染料]]</li><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

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

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

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li></ul>
21w37aRemoved 16 characters limit for the name of a team, and 40 characters limit for the name of members.

See also[]

  • /scoreboard — manages scoreboard objectives, players and displays
  • /tag – tags players with a certain string

References[]

  1. a b MC-87984
Advertisement