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

Functions allow players to run lists of commands using text files with the extension .mcfunction. It is recommended to use UTF-8 encoding (without BOM) for function files to prevent any problems.

Usage

To utilize functions, the text files must first be placed into a top-level folder within [WORLD_NAME]/data/functions[upcoming]. For single player, the world folders can be found in .minecraft/saves. For multiplayer, functions must be placed in every world folder that wants to utilize them. The name of the new top-level folder will be the namespace used when running the functions inside. Functions can also be placed into subfolders within the top-level folder.

For example, running the function custom:example/test will refer to the file located at functions/custom/example/test.mcfunction. If the namespace is left out when trying to call a function, it will default to the minecraft: namespace. Using a custom namespace is recommended in order to prevent unintended behavior in the case of future additions to the default namespace.[1]

Functions, being text files, are easily modifiable and less likely than command blocks to induce lag when used in large quantities. If a function is modified or added, using the /reload command will reload the function files from disk. This allows Minecraft to recognize any changes to the function files, without the need to quit and re-enter the world.

Upon successfully running a function, a message will display in the chat: Executed [amount] command(s) from function '[function file directory]'. The successful output of the commands inside a function cannot be measured with a comparator (although the same effect could be accomplished with the use of /stats and /scoreboard commands).

Function syntax

TestingFunctions

Testing the function system. Three /tellraw messages and one /give command were used in this simple function.

Within the .mcfunction file, one valid command is placed per line, without the usual forward slash (/). Players can add comments within the function text file by preceding them with a #.

Individual commands in functions can be longer than the 32,500 character limit in command blocks but the total number of commands run inside a function will still obey /gamerule maxCommandChainLength, which is 65,536 commands by default; any commands beyond this limit will be ignored.

Running a function

Functions will run all of their commands in a single tick and functions called from within other functions will also run their commands in the same tick as their parent.

Position changes that happen within a function will not affect the relative coordinates used in other commands within that function (or within its child functions) until the next iteration, regardless of the order of commands. The /execute command circumvents this.

For example:

tp @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute @s ~ ~ ~ setblock ~ ~-1 ~ diamond_block

Note - the third line syntax is invalid when used in a datapack in version 1.13 snapshot

When called through a player this function will teleport that player 5 blocks up, place an emerald block one block below their original position before the teleport, and place a diamond block one block below their new position after the teleport. This behavior does not affect position arguments within selectors, which will always test for the current position at the time of execution.

There are several methods of running a function file in-game:

Commands

/function
  • Allows players to run a function once.
  • The commands in the function are run through the entity or command block that ran the /function command.
  • The optional arguments if and unless will make the function only run when the selector was found or not found in the world respectively.
  • Usage: /function <name>
/gamerule gameLoopFunction[upcoming]
  • Runs a function every tick.
  • The commands in the function are run through the server.
    • The coordinates from which the "server" executes commands are (0, 0, 0).
  • If multiple functions need to be looped, it is possible to insert function commands into this looped function file, put function commands in those functions, etc.
  • Usage: /gamerule gameLoopFunction <namespace:path/to/function/file>
  • To stop the loop just point gameLoopFunction to a non-existing function: /gamerule gameLoopFunction -, this value is also the default.

Advancements

Advancements can run a function once as a reward for completing them. The commands in the function are run through the player who completed the advancement.

Reward functions are called within advancement JSON files using the following format:

{
    "rewards": {
        "function": "namespace:path/to/function/file"
    }
}

Tags‌[upcoming: Lua error in Module:Version_link at line 112: attempt to concatenate local 'text' (a nil value).]

Functions can be grouped together using tags in data packs. These tags can then be called to run all the functions inside that tag with /function #(namespace):tag.

Functions tagged in minecraft:tick will automatically run every tick at the beginning of the tick. Functions tagged in minecraft:load will run after (re)loading the datapack.

History

release
1.12
{{Extension DPL}}<ul><li>[[Leather|Leather]]<br/>{{About||the leather from rabbits|Rabbit Hide|the armor material|Armor materials}}
{{Item
| image = Leather.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Leather''' is an [[item]] used to make [[item frame]]s, [[armor]] and [[book]]s.

== Obtaining ==

=== Mob loot ===

Upon death, [[cow]]s, [[mooshroom]]s, [[horse]]s, [[donkey]]s, [[mule]]s, [[llama]]s and [[trader llama]]s drop 0–2 leather, while [[hoglin]]s drop 0–1 leather. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 5 leather (4 leather from hoglins) with Looting III.

A [[fox]] sometimes spawns holding leather, which always drops upon death. Alternatively, a player can drop a [[food]] item, causing the fox to drop the leather.

=== Fishing ===

Leather can be obtained as a "junk" item from [[fishing]].

=== Crafting ===

{{Crafting
  |A1= Rabbit Hide |B1= Rabbit Hide
  |A2= Rabbit Hide |B2= Rabbit Hide
  |Output=Leather
  |type=Material
}}

=== Chest loot ===

{{LootChestItem|leather}}

=== Villager gifts ===

{{in|java}}, leatherworker [[villager]]s throw leather at players under the [[Hero of the Village]] effect.

=== Bartering ===
[[Piglin]]s may [[barter]] 2-4 leather when given a [[gold ingot]].

== Usage ==

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

=== Trading ===

Novice-level leatherworker villagers have a {{frac|2|3}} chance to [[trading|buy]] 6 leather for one [[emerald]] {{in|java}}, and always offer the trade {{in|bedrock}}.

=== Repairing ===

Leather is the repair item for the [[armor materials|leather armor]], and thus can be used to [[item repair|repair]] the following items in an [[anvil]]:
* {{ItemLink|Leather cap}}
* {{ItemLink|Leather tunic}}
* {{ItemLink|Leather pants}}
* {{ItemLink|Leather boots}}

== Achievements ==
{{load achievements|Cow Tipper}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Leather
|spritetype=item
|nameid=leather
|itemtags=ignored_by_piglin_babies
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather
|spritetype=item
|nameid=leather
|id=381
|form=item
|foot=1}}

== History ==

{{History|java alpha}}
{{History||v1.0.8|[[File:Leather JE1 BE1.png|32px]] Added leather.
|Leather [[drops]] from [[cow]]s.
|The [[crafting]] recipe for leather [[armor]] has been changed from cloth to leather (leather armor was previously [[craft]]ed with [[wool]], and was called "cloth armor" in the game code).}}
{{History||v1.0.17|[[Chicken]]s in [[Survival]] [[multiplayer]] now [[drop]] leather if killed by [[fire]], fall [[damage]] or [[cactus]].}}
{{History||v1.2.6|Chickens dropping leather was fixed by this version at the latest.{{when|It would be nice to know exactly when. It's at most a 3 1/2 month bug, though it was at the beginning. Might count as short-lived.}}.}}
{{History|java}}
{{History||1.3.1|snap=12w17a|Leather is now required to craft [[book]]s.}}
{{History||1.4.2|snap=12w34a|Leather is now used to craft the newly added [[item frame]]s.}}
{{History||1.6.1|snap=13w16a|Leather is now used to craft [[horse saddle]]s.|[[Horse]]s now [[drop]] leather.}}
{{History|||snap=13w18a|Leather is no longer used to craft [[horse saddle]]s.}}
{{History||1.7.2|snap=13w36a|Leather can be obtained as one of the "junk" [[item]]s in [[fishing]], making it possible to obtain it without killing any [[animal]]s.}}
{{History||1.8|snap=14w02a|Leather can now be [[trading|sold]] to leatherworker [[villager]]s, at 9–12 leather for 1 [[emerald]].}}
{{History|||snap=14w27b|Leather can now be crafted using 4 [[rabbit hide]].}}
{{History||1.9|snap=15w41a|Leather can now be used to repair [[elytra]].}}
{{History||1.11|snap=16w39a|[[Llama]]s now [[drop]] leather.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 334.}}
{{History|||snap=18w07a|[[Phantom]]s now drop leather.}}
{{History|||snap=18w14a|Phantoms no longer [[drop]] leather.
|[[Phantom membrane]]s are now used to repair [[elytra]], instead of leather.}}
{{History||1.14|snap=18w43a|[[File:Leather JE2 BE2.png|32px]] The texture of leather has been changed.}}
{{History|||snap=18w48a|Leather can now be found in chests in [[village]] tanneries.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with leather in their mouths.}}
{{History|||snap=19w08a|Leather is now used to [[craft]] leather [[horse armor]].}}
{{History|||snap=19w13a|Leatherworker villagers now give leather to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w07a|Leather is dropped by the new [[hoglin]]s.
|Leather has a {{frac|5|109}} (~4.59%) chance of being given by the new [[piglin]]s when [[bartering]], in a stack size of 2–7.}}
{{History|||snap=20w09a|Leather now has a {{frac|20|226}} (~8.84%) chance of being given by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w16a|Leather now generates in [[bastion remnants]] chests.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Leather JE1 BE1.png|32px]] Added leather. It is currently unobtainable and serves no purpose.}}
{{History||v0.6.0|Leather is now obtainable by killing [[cow]]s.
|Leather can be used to craft leather [[armor]].}}
{{History||v0.11.0|snap=build 1|Leather can now be obtained as one of the "junk" [[item]]s in [[fishing]], making it possible to obtain it without killing any [[animal]]s.}}
{{History||v0.12.1|snap=build 1|Leather is now required to craft [[book]]s.}}
{{History||v0.13.0|snap=build 1|Leather can now be [[craft]]ed using 4 [[rabbit hide]].}}
{{History||v0.15.0|snap=build 1|Leather is now used to craft leather [[horse armor]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Leather can now be used to repair [[elytra]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|9-12 leather can now be [[trading|sold]] to leatherworker [[villager]]s.}}
{{History|bedrock}}
{{History||1.6.0|snap=beta 1.6.0.5|[[Phantom membrane]]s are now used to repair [[elytra]], instead of leather.}}
{{History||1.10.0|snap=beta 1.10.0.3|Leather can now be found in [[village]] tannery house [[chest]]s.
|[[File:Leather JE2 BE2.png|32px]] The texture of leather has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has been changed, leatherworker [[villager]]s now [[trading|buy]] 6 leather for an [[emerald]].}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can drop leather.}}
{{History||1.16.0|snap=beta 1.16.0.57|Hoglins now drop leather.
|Leather can now be obtained from bartering with piglin.
|Leather can now be found in [[bastion remnants]] chests.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Leather JE1 BE1.png|32px]] Added leather.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|Leather is now used to [[craft]] leather [[horse armor]].}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|[[Phantom membrane]]s are now used to repair [[elytra]], instead of leather.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Leather JE2 BE2.png|32px]] The texture of leather has been changed.}}

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

== Issues ==

{{issue list}}


{{Items}}

[[Category:Renewable resources]]

[[cs:Kůže]]
[[de:Leder]]
[[es:Cuero]]
[[fr:Cuir]]
[[hu:Bőr]]
[[it:Cuoio]]
[[ja:革]]
[[ko:가죽]]
[[nl:Leer]]
[[pl:Skóra]]
[[pt:Couro]]
[[ru:Кожа]]
[[th:หนังสัตว์]]
[[uk:Шкіра]]
[[zh:皮革]]</li><li>[[Dupe Hack|Dupe Hack]]<br/>{{for|the method to duplicate items and blocks|Tutorials/Block and item duplication}}
{{stub}}
{{Joke feature}}
{{exclusive|java}}{{item
| image = Missing Model.png
| rarity=Common
| stackable=No
|title=minecraft:dupe_hack|renewable=Yes}}
'''minecraft:dupe_hack''' is a joke item from [[Java Edition 23w13a_or_b]].

==Obtaining==

Once the <code>dupe_hack_occurrence_chance</code> vote is approved the '''dupe hack''' item has a random chance of dropping whenever an entity with chests is killed by a player, e.g. when destroying a [[Minecart with Chest|minecart with chest]] with a [[sword]].

It doesn't appear in the [[creative]] menu, not even when the [[Options#Controls|option]] "Operator Items Tab" is enabled, but can be given to the player with [[Commands/give|<code>/give</code>]] and other commands.

==Usage==
The dupe hack item can be used to create a limited amount of duplicate items by placing it on a [[crafting table]] with any other item. It has a random chance of breaking, controlled by the <code>dupe_hack_break_chance</code> vote. This limitation can be mostly bypassed by putting the items in an [[Ender Chest|ender chest]] first and duplicating the chest.

===Crafting ingredient===

{{Crafting
  |Any Item
  |Dupe Hack
  |Output=Any Item, 2
  |showdescription=1
  |description=The dupe hack item remains in the crafting grid after duplicating an item.
  |foot=1
}}

==Data values==
===ID===
{{edition|java}}:{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=minecraft:dupe_hack
|spritetype=item
|nameid=dupe_hack
|form=item|foot=1|spritename=missingno}}
==History==
{{History|java}}
{{History||23w13a_or_b|[[File:Missing Model.png|32px]] Added minecraft:dupe_hack.}}
{{History|foot}}

{{items}}
{{Jokes}}
<references />
[[ja:Dupe Hack]]
[[pt:Dupe Hack]]
[[Category:Joke items]]</li></ul>
pre1Added functions.
pre3Commands are no longer allowed to begin with a / (forward slash)
Comments can now only be preceded with #; using // is no longer allowed
pre4Added new arguments to the /function command: [if|unless] [selector]
pre6Skipped functions (when a conditional fails) are now considered failures when used in commands.
upcoming
1.13
{{Extension DPL}}<ul><li>[[Raw Gold|Raw Gold]]<br/>{{Item
| image = Raw Gold.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw gold''' is a raw metal resource obtained from mining [[gold ore]].

== Obtaining ==
=== Mining ===
[[Gold ore]] and [[deepslate gold ore]] mined with an [[iron pickaxe]] or higher drops 1 unit of raw gold. If the pickaxe is enchanted with [[Fortune]], it can drop an extra unit per level of Fortune, allowing for a maximum of 4 with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops the ore block instead.

=== Crafting ===
{{Crafting
|showname=1
|Block of Raw Gold
|Output=Raw Gold,9
|type=Material
|foot=1
}}

== Usage ==
The primary usage of raw gold is smelting it into [[gold ingot]]s.

=== Crafting ===
{{crafting usage|Raw Gold}}

=== Smelting ingredient ===
{{Smelting
|showname=2
|Raw Gold
|Gold Ingot
|1.0
}}

=== Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to raw gold. They run toward any raw gold on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory.

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|itemtags=piglin_loved
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|form=item
|id=506
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=21w14a|[[File:Raw Gold JE1.png|32px]] Added raw gold.}}
{{History|||snap=April 13, 2021|slink={{Tweet|JasperBoerstra|1381991999952277513}}|[[File:Raw Gold JE2.png|32px]] [[JAPPA]] shows a new raw gold texture.}}
{{History|||snap=21w15a|[[File:Raw Gold JE2.png|32px]] The texture of raw gold has been changed.
|Raw gold can now be used to craft [[block of raw gold]].}}
{{History|||snap=April 16, 2021|slink={{Tweet|JasperBoerstra|1383047666037325829}}|[[File:Raw Gold (pre-release).png|32px]] [[JAPPA]] shows a new raw gold texture again.}}
{{History|||snap=21w16a|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}

{{History|Bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Raw Gold JE2.png|32px]] Added raw gold.}}
{{History|||snap=beta 1.17.0.52|Raw gold are now available without enabling [[experimental gameplay]].}}
{{History|||snap=beta 1.17.0.54|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}
{{History|foot}}

== Issues ==
{{Issue list}}

==Gallery==
<gallery>
JE 1.17 Dev Raw Metals.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 1.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 2.png|Jappa shows raw ore textures.
Jappa Raw Ores 3.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 4.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 5.jpg|Jappa shows raw ore textures.
</gallery>

{{Items}}

[[Category:Non-renewable resources]]

[[de:Rohgold]]
[[es:Oro en bruto]]
[[fr:Or brut]]
[[ja:金の原石]]
[[pl:Surowe złoto]]
[[pt:Ouro bruto]]
[[ru:Необработанное золото]]
[[uk:Необроблене золото]]
[[zh:粗金]]</li><li>[[Banner|Banner]]<br/>{{for|the image|Banner (image)}}
{{Block
| image = <gallery>
White Banner.gif | Banner
White Wall Banner.png | Wall Banner
</gallery>
| rarity = Common
| transparent = Yes
| light = No
| tool = axe
| renewable = Yes
| stackable = Yes (16)
| flammable = No
| lavasusceptible = Yes
}}

'''Banners''' are tall decorative [[blocks]], featuring a field that is highly customizable using [[dye]]s and [[banner pattern]]s.

== Obtaining ==

=== Breaking ===

Banners can be broken with or without a [[tool]], but an [[axe]] is fastest.
{{breaking row|horizontal=1|Banners|Axe}}

A banner also breaks and drops itself as an [[Item (entity)|item]] if the block the banner is attached to is moved, removed, or destroyed.

=== Natural generation ===

{| class="wikitable collapsible"
! Name !! Location !! Appearance !! Design
|-
! Magenta Banner
| Outside of [[end cities]].
| style="text-align: center" | [[File:End City Banner.png|32px]]
| Magenta Banner
* Black Inverted Chevron
* Black Chevron
|-
! Gray Banner
| In banner room in [[woodland mansion]]s.
| style="text-align: center" | [[File:Gray Banner.png|32px]]
| Gray Banner
|-
! Light Gray Banner
| In master bedroom in [[woodland mansion]]s.
| style="text-align: center" | [[File:Master Bedroom Banner.png|32px]]
| Light Gray Banner
* White Flower Charge
|- id="Ominous Banner"
! Ominous Banner{{only|java|short=1}} 
Illager Banner{{only|bedrock|education|short=1}}
| Carried by [[raid captain]]s.<br> Located in [[pillager outpost]]s.

{{IN|java}}, the ominous banner cannot be crafted or copied because the design uses 8 patterns.

{{IN|bedrock}}, the illager banner is a separate type that cannot be placed in a loom.
| style="text-align: center" | [[File:Ominous Banner.png|32px]]<br/>[[File:Ominous Banner BE.png|32px]]
| White Banner{{only|java|short=1}}
* Cyan Lozenge
* Light Gray Base
* Gray Pale
* Light Gray Bordure
* Black Fess
* Light Gray Per Fess
* Light Gray Roundel
* Black Bordure
Separate type entirely{{only|bedrock|short=1}}
|-
! Brown Banner
| Outside of some houses, meeting points, and pillar fountains in savanna [[village]]s. 
| style="text-align: center" | [[File:Brown Banner.png|32px]]
| Brown Banner
|-
! Black Banner
| In altar room in [[woodland mansions]].
| style="text-align: center" | [[File:Black Banner.png|32px]]
| Black Banner
|}

=== Crafting ===

Banners can be crafted from six [[wool]] and a [[stick]] in a pattern resembling a [[sign]].
{{Crafting
|head=1
|showdescription=1
|A1=Matching Wool |B1=Matching Wool |C1=Matching Wool
|A2=Matching Wool |B2=Matching Wool |C2=Matching Wool
|B3=Stick
|Output=Matching Banner
|Olink=Banner
|type=Decoration block
|description=Once the banner is crafted, its base color cannot be changed.{{only|java}}
}}
{{Crafting
|showdescription=1
|Any Banner
|Bleach
|Output=White Banner
|type=Decoration block
|description=Bleach can be used to remove the color of a banner, resulting in a white banner. This includes removing patterns from a white banner.{{only|bedrock|education}}
|foot=1
}}

=== Trading ===
Expert-level cartographer [[villager]]s always offer to [[trading|sell]] 1 or 2 blank banners of a random color for 3 [[emeralds]]. Expert-level shepherd villagers have a {{frac|2|7}} chance of offering the same trade.{{only|java}}

{{IN|bedrock}}, expert-level cartographer and shepherd villagers both offer to sell one of 16 blank banners for 3 emeralds as part of their trades.

=== Mob loot ===

[[Illager]]s that spawn carrying an ominous banner{{only|java|short=1}} / illager banner{{only|bedrock|education|short=1}} always drop it upon death.

== Usage ==

[[File:Standing banner with block.png|thumb|upright|Overlapping block on a banner.]]
[[File:Wall banner with block.png|thumb|upright|Overlapping on a wall mounted banner.]]

There are 16 colored blank banners, and numerous patterns each available in each of the 16 colors. A banner can feature up to 6 different patterns. The top layer of a banner (or the last pattern added) can be washed off by {{control|using}} it on a [[cauldron]] containing water.

Banners, much like signs, can be placed both on the ground facing in any direction, or on a wall. They gently sway as if affected by a breeze, regardless of dimension or location. 

Banners have no collision mask as they are completely non-solid, so [[entities]] can move through them.

Other blocks (including other banners) can be placed on any edge of a banner's hitbox, which is only one block high despite the banner appearing as two blocks tall. This makes it possible to overlap another solid block on the top half of a banner for floor banners, or the bottom half of wall banners.

When a banner is placed on the side of a block, its position is set by the top block, and it is possible to place it so it appears half buried.

Banners can also be placed in [[item frame]]s, where they simply appear as their item model.

[[Water]] and [[lava]] flow around banners. {{IN|bedrock}}, banners can be [[waterlogged]].

<gallery>
File:Wall banner with water below.png| Water can be placed below wall banners
File:Water flowing around banner.png| Water flows around a banner on the ground
</gallery>

Lava can create [[fire]] in air blocks next to banners as if the banners were flammable, but the banners do not burn (and cannot be burned by other methods). Banners also cannot be moved by [[piston]]s.

If a banner is renamed on an [[anvil]], it retains its name when a pattern is added, but not when a pattern is removed.

=== Helmet ===
{{exclusive|java|section=13}}
While a banner cannot be equipped in the [[Helmet|head slot]] in [[Survival]] mode, equipping it using commands causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|java|short=1}}.

=== Chestplate ===
{{exclusive|bedrock|section=13}}
While a banner cannot be equipped in the [[chestplate]] slot in Survival mode, equipping it using NBT editors causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|bedrock|education|short=1}}.
<gallery>
Steve wearing White Banner.png|
Alex wearing White Banner.png|
Pillager with Ominous Banner.png|
Vindicator with Ominous Banner.png|
Evoker with Ominous Banner.png|Illusioner with Ominous Banner.png|
</gallery>

=== Crafting ingredient ===

[[Shield]]s can have patterns applied to them using banners. The shield pattern has a smaller resolution than the banner pattern, causing them to look different or offset. Banners that have more than six patterns, such as Ominous Banners or banners obtained through inventory editors, will be reduced to six patterns on the shield.

{{Crafting
|showdescription=1
|Shield
|Matching Banner; Ominous Banner
|Output=Matching Shield; Ominous Shield
|B2link=Banner
|type=Combat
|description=Applies the banner pattern to the shield. The banner is consumed.<br>The shield must have no pre-existing patterns.<br>Does not change existing durability or enchantments on the shield.
}}

=== Copying ===

Banners can be copied with a blank banner to make multiple identical banners. Banners with more than 6 patterns applied using commands cannot be copied in this manner.

{{Crafting
|showdescription=1
|Matching Banner
|Matching Banner
|Output=Matching Banner
|A2link=Banner
|B2link=Banner
|Olink=Banner
|type=Decoration block
|ignoreusage=1
|description=Copies pattern; both banners must have the same base color, and the one having a pattern copied onto it must have no preexisting pattern.
}}

=== Map marker ===
[[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|thumb|right|How every banner appears {{IN|java}} on a map, including named banners.]]

{{exclusive|java|section=13}}
{{IN|java}}, {{control|using}} on a standing banner with a [[map]] selected places a marker of the banner's position on the selected map, and {{control|using}} on the banner again removes the marker. Note that wall banners cannot serve as map markers. The marker has the same color as the banner's base without decorations. The marker is removed if the banner is destroyed unless the map is locked using a [[cartography table]]. If the banner is renamed, the name appears below the marker.

=== Patterns ===
{{see also|Banner/Patterns|title1=List of patterned banners}}
[[File:Spawned-in Banner.png|thumb|100px|Example of a banner with more than 6 patterns, a result of using the {{cmd|give}} command.]]

A banner may have up to six layers of patterns, which are overlaid with the last-crafted on top. A banner can have up to 16 layers of patterns with the use of commands. The total number of unique banners is approximately 2.3x10^16 (or 23 quadrillion).

Any color banner can be used; the pattern overlays the color. {{IN|java}}, a [[loom]] is used to make patterns. However, {{in|bedrock}}, the patterns can be made in a [[loom]] or a [[crafting table]].

A banner can have more than six layers of patterns through the commands <code>/[[Commands/give|give]]</code>, <code>/[[Commands/setblock|setblock]]</code> or <code>/[[Commands/fill|fill]]</code>. This only works in ''Java Edition'', as Bedrock Edition doesn't have any NBT commands. Here is an example of a mining banner with seven different patterns. There is specific codes for the [[Banner#Item data:~:text=white-,Item,-In Java Edition|colors]] and [[Banner/Patterns|patterns]] that you have to input. 

<code><nowiki>/give @p white_banner{display:{Name:"\"Mining Industries Banner\""},BlockEntityTag:{Patterns:[{Pattern:"cr",Color:15},{Pattern:"bs",Color:15},{Pattern:"sc",Color:12},{Pattern:"ms",Color:0},{Pattern:"hh",Color:15},{Pattern:"bo",Color:15},{Pattern:"tts",Color:8}]}} 1</code>

{{LoadPage|Template:Banner pattern loom recipes|Loom recipes|h4}}
{{LoadPage|Banner/Banner pattern crafting recipes|Crafting recipes|h4|transcluded=1}}

=== Renaming ===
{{IN|java}}, a banner can be given a custom name that remains as the banner is placed and retrieved. The player can use an [[anvil]] to rename the banner item, or may change the <code>CustomName</code> tag using the {{cmd|data}} command on the banner block.

=== Fuel ===
Banners can be used as a fuel in [[furnace]]s, smelting 1.5 items per banner.

=== Note Blocks ===
Banners can be placed under [[note block]]s to produce "bass" sounds.

== Sounds ==
=== Generic ===
{{Sound table/Block/Wood}}
=== Unique ===
{{edition|java}}: ''None''

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Water Splash Old.ogg
|source=block
|description=When all patterns are removed from a banner using a cauldron
|id=cauldron.cleanbanner
|volume=0.1
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=White Banner
|spritetype=block
|nameid=white_banner
|blocktags=banners, wall_post_override
|itemtags=banners
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner
}}
{{ID table
|displayname=Orange Banner
|spritetype=block
|nameid=orange_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Magenta Banner
|spritetype=block
|nameid=magenta_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Blue Banner
|spritetype=block
|nameid=light_blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Yellow Banner
|spritetype=block
|nameid=yellow_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Lime Banner
|spritetype=block
|nameid=lime_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Pink Banner
|spritetype=block
|nameid=pink_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Gray Banner
|spritetype=block
|nameid=gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Gray Banner
|spritetype=block
|nameid=light_gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Cyan Banner
|spritetype=block
|nameid=cyan_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Purple Banner
|spritetype=block
|nameid=purple_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Blue Banner
|spritetype=block
|nameid=blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Brown Banner
|spritetype=block
|nameid=brown_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Green Banner
|spritetype=block
|nameid=green_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Red Banner
|spritetype=block
|nameid=red_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Black Banner
|spritetype=block
|nameid=black_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=White Wall Banner
|spritetype=block
|nameid=white_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner}}
{{ID table
|displayname=Orange Wall Banner
|spritetype=block
|nameid=orange_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.orange_banner}}
{{ID table
|displayname=Magenta Wall Banner
|spritetype=block
|nameid=magenta_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.magenta_banner}}
{{ID table
|displayname=Light Blue Wall Banner
|spritetype=block
|nameid=light_blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_blue_banner}}
{{ID table
|displayname=Yellow Wall Banner
|spritetype=block
|nameid=yellow_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.yellow_banner}}
{{ID table
|displayname=Lime Wall Banner
|spritetype=block
|nameid=lime_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.lime_banner}}
{{ID table
|displayname=Pink Wall Banner
|spritetype=block
|nameid=pink_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.pink_banner}}
{{ID table
|displayname=Gray Wall Banner
|spritetype=block
|nameid=gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.gray_banner}}
{{ID table
|displayname=Light Gray Wall Banner
|spritetype=block
|nameid=light_gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_gray_banner}}
{{ID table
|displayname=Cyan Wall Banner
|spritetype=block
|nameid=cyan_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.cyan_banner}}
{{ID table
|displayname=Purple Wall Banner
|spritetype=block
|nameid=purple_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.purple_banner}}
{{ID table
|displayname=Blue Wall Banner
|spritetype=block
|nameid=blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.blue_banner}}
{{ID table
|displayname=Brown Wall Banner
|spritetype=block
|nameid=brown_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.brown_banner}}
{{ID table
|displayname=Green Wall Banner
|spritetype=block
|nameid=green_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.green_banner}}
{{ID table
|displayname=Red Wall Banner
|spritetype=block
|nameid=red_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.red_banner}}
{{ID table
|displayname=Black Wall Banner
|spritetype=block
|nameid=black_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.black_banner
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=banner
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Banner
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Standing
|spritename=Banners
|spritetype=block
|nameid=standing_banner
|translationkey=tile.standing_banner.black.name, tile.standing_banner.red.name, tile.standing_banner.green.name, tile.standing_banner.brown.name, tile.standing_banner.blue.name, tile.standing_banner.purple.name, tile.standing_banner.cyan.name, tile.standing_banner.silver.name, tile.standing_banner.gray.name, tile.standing_banner.pink.name, tile.standing_banner.lime.name, tile.standing_banner.yellow.name, tile.standing_banner.lightBlue.name, tile.standing_banner.magenta.name, tile.standing_banner.orange.name, tile.standing_banner.white.name
|id=176
|form=block}}
{{ID table
|displayname=Wall
|spritename=Banners
|spritetype=block
|nameid=wall_banner
|id=177
|form=block
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=Banners
|spritetype=item
|nameid=banner
|translationkey=item.banner.black.name, item.banner.red.name, item.banner.green.name, item.banner.brown.name, item.banner.blue.name, item.banner.purple.name, item.banner.cyan.name, item.banner.silver.name, item.banner.gray.name, item.banner.pink.name, item.banner.lime.name, item.banner.yellow.name, item.banner.lightBlue.name, item.banner.magenta.name, item.banner.orange.name, item.banner.white.name
|id=567
|form=item
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=Banner
|foot=1}}

=== Metadata ===
==== Item ====
{{IN|Bedrock}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 0 || black
|-
|| 1 || red
|-
|| 2 || green
|-
|| 3 || brown
|-
|| 4 || blue
|-
|| 5 || purple
|-
|| 6 || cyan
|-
|| 7 || light gray
|-
|| 8 || gray
|-
|| 9 || pink
|-
|| 10 || lime
|-
|| 11 || yellow
|-
|| 12 || light blue
|-
|| 13 || magenta
|-
|| 14 || orange
|-
|| 15 || white
|}

=== Item ===
{{IN|Java}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 15 || black
|-
|| 14 || red
|-
|| 13 || green
|-
|| 12 || brown
|-
|| 11 || blue
|-
|| 10 || purple
|-
|| 9 || cyan
|-
|| 8 || light gray
|-
|| 7 || gray
|-
|| 6 || pink
|-
|| 5 || lime
|-
|| 4 || yellow
|-
|| 3 || light blue
|-
|| 2 || magenta
|-
|| 1 || orange
|-
|| 0 || white
|}

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

=== Block data ===

A banner has a block entity associated with it that holds additional data about the block. 

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

{{el|java}}:
{{see also|Block entity format}}
{{/BE}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
Banners, as items, use an NBT tag <code>BlockEntityTag</code> to indicate the patterns and details when it is placed.

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound|Item}}: The item
** {{nbt|compound|tag}}: Additional information about the item. This tag is optional for most items.
*** {{nbt|compound|BlockEntityTag}}: The details of the shulker box.
**** All block data, except tags common to all block entities.
</div>

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

== Achievements ==
{{load achievements|Fruit on the Loom}}

== Advancements ==
{{load advancements|Voluntary Exile}}

== History ==
{{info needed section|The Nether Update}}
{{History|java}}
{{History||1.8|snap=July 21, 2014|slink=https://twitter.com/jeb_/status/491238882789572608|[[Jeb]] posted a picture of banners, and stated that he is working on them.}}
{{History|||snap=14w30a|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History|||snap=14w30c|Added four additional patterns: Cross (+), Border, Curly Border and Thing (Mojang logo).}}
{{History|||snap=14w31a|Added two additional patterns: Inverted Halves and Base Gradient.
|The banner pattern terminology has been changed based on vexillology advice [[Jeb]] received from [http://www.reddit.com/r/Minecraft/comments/2bkxej/i_made_a_huge_mistake_banners/ his Reddit post].
|Banners can now be used as a [[fuel]] in [[furnace]]s.}}
{{History||1.8.8|snap=pre|The number of layers attainable by using [[commands]] is now limited to 16 per banner.}}
{{History||1.9|snap=15w31a|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History|||snap=15w33c|Banners can be used to apply patterns to [[shield]]s.}}
{{History||1.11|snap=16w33a|Banners now require a [[dye]] when applying a pattern that uses a non-dye [[item]], such as a [[mob head|creeper head]] or [[golden apple|enchanted golden apple]]. Previously, the lack of a dye would have applied the black variant of the pattern.}}
{{History|||snap=16w39a|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.12|snap=January 24, 2017|slink={{tweet|jeb_|823817090511601664}}|[[Jeb]] tweets a screenshot of the changes to the banner color palette.}}
{{History|||snap=17w06a|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History|||snap=pre6|"Chief fess" and "base fess" banners are now just "chief" and "base" banners.}}
{{History||1.13|snap=17w47a|The colors for the <code>banner</code>, <code>wall_banner</code> and <code>standing_banner</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[block]]s' numeral IDs were 176 and 177, and the [[item]]'s 425.}}
{{History|||snap=18w10a|{{control|Using}} a [[map]] on a banner now mark the spot of the banner on the map.}}
{{History||1.14|snap=18w43a|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|All recipes for banner patterns have been removed.}}
{{History|||snap=18w45a|[[File:Ominous Banner Revision 1.png|17px]] Added [[illager patrol]]s, where the leader of an illager patrol carries an [[illager]] banner.}}
{{History|||snap=18w46a|[[File:Ominous Banner.png|17px]] The pattern of [[illager]] banner now has a black border.}}
{{History|||snap=19w11a|Cartographer and shepherd [[villager]]s now [[trading|sell]] banners.}}
{{History|||snap=Pre-Release 2|"Illager Banners" have been renamed to "Ominous Banners".}}
{{History||1.17|snap=20w46a|The unused "base" pattern has been renamed to the "field" pattern and given proper translation strings (its ID is still "base").}}
{{History||1.19.3|snap=22w43a|The ominous banner is now available in the Creative inventory.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Added banners.
|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].
|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|The white banner can now be crafted from a colored banner and [[bleach]], which also removes all patterns, if used on a white banner.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|Brown banners now generate in new [[savanna]] [[village]]s.
|Black banners now generate in [[pillager outpost]] watchtowers.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray banners now generate in pillager outpost watchtowers, instead of black banners.
|[[File:Ominous Banner BE.png|17px]] Added [[illager captain]]s, which drop an [[illager]] banner upon [[death]].}}
{{History|||snap=beta 1.11.0.3|Illager banners now generate in [[pillager outpost]] watchtowers, instead of gray banners.}}
{{History|||snap=beta 1.11.0.4|Banners can now be [[trading|bought]] from cartographer and shepherd [[villager]]s.}}
{{History||1.20.0|snap=beta 1.20.0.20|Banners can now be used to customise [[shield]]s.}}

{{History|console}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|switch=1.0.1|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|switch=1.0.1|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[Loom]]s have been added to help the [[player]] edit banners more easily.}}
{{History||ps=1.91|[[File:Ominous Banner BE.png|17px]] Added [[illager]] banners, which generate with [[pillager outpost]]s and are [[drops|dropped]] by [[illager captain]]s upon [[death]].}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* With 16 blank banners, 38 patterns of 16 colors each (608 uniquely-colored patterns), and 0 to 6 patterns per banner, the number of uniquely crafted banners is 16 × (608<sup>0</sup> + 608<sup>1</sup> + 608<sup>2</sup> + 608<sup>3</sup> + 608<sup>4</sup> + 608<sup>5</sup> + 608<sup>6</sup>) ≈ 809 quadrillion - 809 with 15 zeros (809,573,616,779,945,488). The number of visually distinct banners is smaller, because one or more patterns may completely cover other patterns, or the entire banner, or be duplicated due to the symmetric set of patterns (e.g. field or (yellow) + per pale azure (blue) = field azure + per pale or inverted).
** Not 38 patterns are available on BE, but 40 patterns of 16 colors each (640 uniquely-colored patterns), so the number is even greater. 16 × (640<sup>0</sup> + 640<sup>1</sup> + 640<sup>2</sup> + 640<sup>3</sup> + 640<sup>4</sup> + 640<sup>5</sup> + 640<sup>6</sup>) ≈ 1 quintillion - 1 with 18 zeros (1,101,232,303,249,827,856). This increases the number by almost 1.4 times, or almost 292 quadrillion, despite the addition of only 2 patterns.
* If a banner has over 6 patterns, only the six bottom-most patterns are displayed when hovered over in the [[inventory]].
* The Mojang logo is called "Thing" in-game, which could be considered an alternate translation for [[wiktionary:mojäng|mojäng]]. If [[wikipedia:Google Translate|Google Translate]] is used, it translates to "thingys" or "contraption".
** In the Swedish translation of the game, this pattern is, in fact, called ''mojäng''.
* [[List of block textures#Banner Textures|Banner textures]] are located in \assets\minecraft\textures\entity\banner.
** There are 40 monochrome textures, each containing all 6 sides of the banner.
** The texture of the back side is the mirrored texture of the front side.
** Compared to the texture files, textures' colors are inverted in-game due to them acting as masks for the re-colored base texture, base.png. That means white is visible, while black is transparent.
* Banners that have the purple NBT+ line in the bottom (obtained by holding Ctrl and middle-clicking the banner, which also copies the NBT [[tag]] of anything that the player points their crosshair to) actually have no difference with the base banner obtained by middle click.
*The Illager Banner in Bedrock Edition is available as a separate item but is just a second variant of the white banner.
**Standard variant of white banner is set to type 0.
**Illager variant is set to type 1.

== Gallery ==
<gallery>
Banners Jeb.png|The first image of banners, as tweeted by Jens Bergensten.
Iceland and Norway Flags.png|Another banner image from Jeb.
Searge Banners.png|Several banners made by Searge.
The Bountiful Update.png|Banners in the official 1.8 poster.
BannersBeforeAndAfter.png|An image, tweeted by Jeb, showcasing the changes he made to the banner color palette in the 1.12 update.
Gradients Overlay.png|The result of using gradient different numbers of times, each time increasing the level of gradient by 1.
All positions and rotations of a banner.png|All positions and rotations of a banner
Item Frame with Banner.png|A banner with the [[Mojang]] logo in an [[item frame]].
EndCityBanners.png|Banners floating outside of an [[End city]] tower.
Woodland mansion 1x2 d1.png|Banners hanging above the doorway of a [[woodland mansion]] master bedroom.
Replaceitembanner.png|Banner put in the helmet slot by using the command {{cmd|replaceitem}}{{Only|BE}} or {{cmd|item replace}}{{Only|JE}}.
Better Together Banners.jpg|Banners in ''Bedrock Edition''.
Better Together Banner Crafting 1.jpg|A banner in the hand.
Better Together Banner Crafting 2.jpg|A banner in the inventory.
Better Together Banner Crafting 3.jpg|A banner in the crafting grid.
Better Together Banner Crafting 4.jpg|A banner being given a pattern.
</gallery>

=== Renders ===
<gallery>
Ominous Banner.gif
White Banner.gif
Light Gray Banner.gif
Gray Banner.gif
Black Banner.gif
Brown Banner.gif
Red Banner.gif
Orange Banner.gif
Yellow Banner.gif
Lime Banner.gif
Green Banner.gif
Cyan Banner.gif
Light Blue Banner.gif
Blue Banner.gif
Purple Banner.gif
Magenta Banner.gif
Pink Banner.gif
Ominous Wall Banner.png| 
White Wall Banner.png| 
Light Gray Wall Banner.png| 
Gray Wall Banner.png| 
Black Wall Banner.png| 
Brown Wall Banner.png| 
Red Wall Banner.png| 
Orange Wall Banner.png| 
Yellow Wall Banner.png| 
Lime Wall Banner.png| 
Green Wall Banner.png| 
Cyan Wall Banner.png| 
Light Blue Wall Banner.png| 
Blue Wall Banner.png| 
Purple Wall Banner.png| 
Magenta Wall Banner.png| 
Pink Wall Banner.png
</gallery>

<gallery>
File:Ominous Banner.gif|Ominous banner pattern in Java Edition.
File:Ominous Banner BE.gif|Illager banner pattern in Bedrock Edition.
File:Ominous Banner Revision 1.gif|Old Ominous banner pattern.
File:Ominous Banner washing.gif|Washing with cauldron shows how to apply the ominous banner pattern.
</gallery>

=== [[Lego Minecraft]] Banners ===
<gallery>
File:Lego Red Creeper Banner Collage.jpg|Lego banners from 21127 and 21131
File:Lego Melon Banner.png|Lego banner from 21138
File:Lego Fish Banner.png|Lego banner from 21142
File:Lego Beetroot Banner.png|Lego banner from 21144
File:Lego Wheat Banner.png|Another lego banner from 21144
File:Lego Carrot Banner.png|A third lego banner from 21144
File:Lego Crossbones Banner.png|Lego banner from 21152
File:Lego Green Creeper Banner Collage.jpg|Lego banners from 21155
File:Lego Ominous Banner.png|Lego ominous banner from 21160
</gallery>

== References ==
{{reflist}}

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

[[Category:Generated structure blocks]]
[[Category:Manufactured blocks]]
[[Category:Block entities]]
[[Category:Non-solid blocks]]

[[cs:Prapor]]
[[de:Banner]]
[[es:Estandarte]]
[[fr:Bannière]]
[[ja:旗]]
[[ko:현수막]]
[[nl:Banier]]
[[pl:Sztandar]]
[[pt:Estandarte]]
[[ru:Флаг]]
[[uk:Стяг]]
[[zh:旗帜]]</li></ul></nowiki>
17w43aCustom functions have been moved into data packs.
17w45aFunctions are now completely parsed and cached on load.
17w49bFunction can now be tagged.
Functions tagged in minecraft:tick now run every tick in the beginning of the tick.

Issues

Issues relating to "Function (Java Edition)" are maintained on the bug tracker. Report issues there.

References

Advertisement