Function (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. Function files will be added in Bedrock Edition 1.8,‌ however they are only available in behavior packs.

Usage

To utilize functions, the text files must first be placed into a top-level folder within [WORLD_NAME]/datapacks/[DATA_PACK_NAME]/data/[NAMESPACE]/functions. 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 (In 1.12 you MUST place the functions inside the main world folder (the one specified in the server.properties, level-name=(world-name here)), otherwise it will NOT work.). 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 data/custom/functions/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.

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

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. Functions will use the command environment of whatever called the function. This includes command sender, position, rotation, etc.

Changes to the command environment that happen within a function will not affect the command environment used by the other commands within that same function (or within its child functions) until the next iteration, regardless of the order of commands. The /execute command is an exception and will update the command environment.

For example:

1.12

execute @a ~ ~ ~ function foo:bar

foo:bar

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

1.13

execute as @a at @s run function foo:bar

foo:bar

teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute at @s run setblock ~ ~-1 ~ diamond_block

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 target selector arguments.

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>

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

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

Java Edition
1.12 {{Extension DPL}}<ul><li>[[Horse Armor|Horse Armor]]<br/>{{Item | image = <gallery> Leather Horse Armor.png | Leather Iron Horse Armor.png | Iron Golden Horse Armor.png | Golden Diamond Horse Armor.png | Diamond </gallery> | image2 = <gallery> Leather Horse Armor (item).png|Leather Iron Horse Armor (item).png|Iron Golden Horse Armor (item).png|Golden Diamond Horse Armor (item).png|Diamond </gallery> | extratext = View [[#Gallery|all renders]] | renewable = * '''Leather''': Yes * '''All others''': No | stackable = No }} '''Horse armor''' is a special type of [[armor]] that can be given to a [[horse]] to wear. == Obtaining == ===Chest loot=== {{LootChestItem|iron-horse-armor}} {{LootChestItem|golden-horse-armor}} {{LootChestItem|diamond-horse-armor}} ===Crafting=== {{crafting |A1= Leather |C1= Leather |A2= Leather |B2= Leather |C2= Leather |A3= Leather |C3= Leather |Output= Leather Horse Armor |type=Miscellaneous }} Only leather horse armor can be crafted; other horse armor can be obtained only from chest loot from some generated structures. ===Trading=== Expert-level [[leatherworker]] villagers [[trading|sell]] leather horse armor for 6 [[emerald]]s as part of their trade. ==Usage== Only normal adult horses can wear armor; foals, [[donkey]]s, [[mule]]s, and undead variants such as [[skeleton horse]]s and [[zombie horse]]s cannot be equipped with armor. === Types === Horse armor has leather, iron, gold, and diamond variants. However, horse armor does not have netherite or chainmail variants. === Armor Stands === Horse armor cannot be placed or displayed on [[armor stand]]s. ===Protection=== Horse armor can be equipped to horses either by manually placing it in its respective slot by pressing E while riding the horse ({{SlotSprite|Horse Armor}}), or by right-clicking the horse with it. There is a gradual increase in the defense given from a horse wearing the different types of armor. Note that golden horse armor provides more protection than iron horse armor, whereas the opposite is true for [[armor|player armor]]. {| class="wikitable" data-description="Armor defense" |- ! Material !! [[Armor]] |- ! [[Leather]] | {{armor|3}} |- ! [[Iron]] | {{armor|5}} |- ! [[Gold]] | {{armor|7}} |- ! [[Diamond]] | {{armor|11}} |} When a horse dies while equipped with any horse armor, it drops its normal loot, saddle (if it had one), and the horse armor. Leather horse armor protects horses from freezing in [[powder snow]], but it does not negate other powder snow effects (e.g., falling through, inability to jump). ===Durability=== Unlike [[armor|player armor]], horse armor does not have durability. This means a single horse armor can be used infinitely unless destroyed. === Enchanting === Unlike [[armor|player armor]], horse armor cannot be enchanted in survival mode. However, {{in|java}} Creative mode, horse armor can be used with an [[anvil]] to enchant with [[Depth Strider]], [[Thorns]], [[Respiration]], [[Feather Falling]], and [[Curse of vanishing]]. Other enchantments can be applied, but they have no effect. === Dyeing === Leather horse armor can be dyed 12,326,391 different colors (using lone dyes or dye combinations) and put onto a horse to display that color. These changes can be reverted by {{control|using}} a filled [[cauldron]] with dyed leather horse armor. ===Smelting usage=== {{Smelting|showname=1|Iron Horse Armor;Golden Horse Armor|Iron Nugget;Gold Nugget|0,1}} ===Piglins=== {{EntityLink|Piglin|Piglins}} are attracted to golden horse armor and run toward any golden horse armor on the ground, inspecting it for 6 to 8 seconds before putting it in their inventory. == Sounds == {{Edition|Java}}: {{Sound table |sound=Horse armor.ogg |subtitle=Horse armor equips |source=neutral |description=When armor is equipped to a horse |id=entity.horse.armor |translationkey=subtitles.entity.horse.armor |volume=0.5 |pitch=1.0 |distance=16 |foot=1}} {{Edition|Bedrock}}: {{Sound table |type=bedrock |sound=Horse armor.ogg |source=neutral |description=When armor is equipped to a horse |id=mob.horse.armor |volume=0.6 |pitch=1.0 |foot=1}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Leather Horse Armor |spritetype=item |nameid=leather_horse_armor |form=item}} {{ID table |displayname=Iron Horse Armor |spritetype=item |nameid=iron_horse_armor |form=item}} {{ID table |displayname=Diamond Horse Armor |spritetype=item |nameid=diamond_horse_armor |form=item}} {{ID table |displayname=Golden Horse Armor |spritetype=item |nameid=golden_horse_armor |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |showaliasids=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Leather Horse Armor |spritetype=item |nameid=leather_horse_armor |aliasid=horsearmorleather |id=530 |form=item |translationkey=item.horsearmorleather.name}} {{ID table |displayname=Iron Horse Armor |spritetype=item |nameid=iron_horse_armor |aliasid=horsearmoriron |id=531 |form=item |translationkey=item.horsearmoriron.name}} {{ID table |displayname=Diamond Horse Armor |spritetype=item |nameid=diamond_horse_armor |aliasid=horsearmordiamond |id=533 |form=item |translationkey=item.horsearmordiamond.name}} {{ID table |displayname=Golden Horse Armor |spritetype=item |nameid=golden_horse_armor |aliasid=horsearmorgold |id=532 |form=item |translationkey=item.horsearmorgold.name |foot=1}} === Item data === When leather horse armor is dyed, it has the following NBT: {{el|java}}: {{main|Player.dat format}} <div class="treeview"> * {{nbt|compound|tag}}: Parent tag. ** {{nbt|compound|display}}: Display properties. *** {{nbt|int|color}}: The color of the leather armor. The tooltip displays "Dyed" if advanced tooltips are disabled, otherwise it displays the hexadecimal color value. Color codes are calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''<ref>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref> </div> {{el|bedrock}}: : See [[Bedrock Edition level format/Item format]]. == History == {{History|java}} {{History||1.6.1|snap=13w16a|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor. |Horse armor can be [[crafting|crafted]] using the following recipe. {{{!}} class{{=}}"collapsible collapsed" ! Recipe {{!}}- {{!}} {{Crafting Table |C1=Iron Ingot; Gold Ingot; Diamond |A2=Iron Ingot; Gold Ingot; Diamond |B2=Any Wool |C2=Iron Ingot; Gold Ingot; Diamond |A3=Iron Ingot; Gold Ingot; Diamond |B3=Iron Ingot; Gold Ingot; Diamond |C3=Iron Ingot; Gold Ingot; Diamond |Output=Iron Horse Armor; Golden Horse Armor; Diamond Horse Armor }} {{!}}} }} {{History|||snap=13w18a|The crafting recipe for horse armor has been removed. |Horse armor can now be found in [[chest]]s in [[jungle temple|jungle]] & [[desert temple]]s, [[dungeon]]s, [[nether fortress]]es, [[stronghold]] altar rooms and [[village]] blacksmith buildings. |Iron horse armor can now additionally be found in [[mineshaft]] chests.}} {{History|||snap=13w21a|Horse armor is no longer stackable, to be consistent with other types of [[armor]].}} {{History||1.9|snap=15w31a|Horse armor has been added to [[end city]] [[chest]]s.}} {{History|||snap=15w43a|The average yield of horse armor in [[nether fortress]] chests has slightly decreased.}} {{History|||snap=15w44a|The average yield of horse armor in [[desert temple]] chests has increased. |The average yield of iron horse armor from [[dungeon]] chests has slightly decreased. |Iron horse armor has been removed from [[mineshaft]] [[chest]]s.}} {{History||1.11.1|snap=16w50a|Golden and iron horse armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}} {{History||1.13|snap=17w45a|[[File:Iron Horse Armor JE2.png|32px]] [[File:Golden Horse Armor JE2.png|32px]] [[File:Diamond Horse Armor JE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}} {{History|||snap=17w46a|[[File:Iron Horse Armor 17w46a.png|32px]] [[File:Golden Horse Armor 17w46a.png|32px]] [[File:Diamond Horse Armor 17w46a.png|32px]] The model of horse armor has been changed, but the textures of horse armor have remained unaltered.}} {{History|||snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 417, 418 and 419.}} {{History|||snap=18w03a|[[File:Iron Horse Armor JE3.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}} {{History|||snap=18w22a|[[File:Iron Horse Armor JE4 BE2.png|32px]] The texture of iron horse armor when equipped has been changed.<ref>{{bug|MC-124357}}</ref>}} {{History|||snap=pre2|A bug with the [[horse]] skin and horse armor textures not applying correctly has been fixed.<ref>{{bug|MC-124364}}</ref>}} {{History||1.14|snap=18w50a|[[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of horse armor [[item]]s have been changed.}} {{History|||snap=February 20, 2019|slink=https://twitter.com/_LadyAgnes/status/1098134917299531776?s=19|Leather horse armor announced for {{el|je}}.}} {{History|||snap=19w08a|[[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of iron, gold and diamond horse armor have been changed. |[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Leather Horse Armor (item) JE1.png|32px]] Added leather horse armor, which can be [[dyeing|dyed]] 12,326,391 different colors, similar to leather [[armor]].}} {{History|||snap=19w11a|Leatherworker [[villager]]s now [[trading|sell]] leather horse armor.}} {{History||1.14.1|snap=Pre-Release 1|[[File:Leather Horse Armor (item) JE2.png|32px]] The texture of leather horse armor [[item]] has been changed to be more consistent with the other types of horse armor. |[[File:Iron Horse Armor (item) JE4 BE3.png|32px]] The texture of iron horse armor item has been changed.}} {{History||1.16|snap=20w15a|Horse armor placed in a dispenser can now be put on tamed horses.}} {{History|||snap=20w16a|Golden horse armor now generates in [[ruined portal]] chests.}} {{History||1.17|snap=21w13a|Leather horse armor now protects [[horse]]s from [[freezing]].}} {{History||1.19|snap=22w13a|Diamond horse armor may now be found in [[ancient city]] [[chest]]s.}} {{History|pocket alpha}} {{History||v0.15.0|snap=build 1|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor and [[dyeing|dyeable]] leather horse armor as a version exclusive.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|Horse armor can now be found inside [[end city]] [[chest]]s.}} {{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden horse armor are now [[smelting|smeltable]].}} {{History|bedrock}} {{History||1.2.6|snap=beta 1.2.6.2|[[File:Leather Horse Armor BE2.png|32px]] [[File:Iron Horse Armor JE4 BE2.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has been changed.}} {{History||1.10.0|snap=beta 1.10.0.3|Horse armor can now be found in [[plains]] [[village]] weaponsmith [[chest]]s. |[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE2.png|32px]] [[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of all horse armor have been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Horse armor can now be found in [[savanna]], [[desert]], [[taiga]], [[snowy taiga]] and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.}} {{History|||snap=beta 1.11.0.4|Leather horse armor can now be [[trading|bought]] from leatherworker [[villager]]s.}} {{History|||snap=beta 1.11.0.5|[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE4 BE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of all horse armor [[item]]s have been changed.}} {{History||1.17.0|snap=beta 1.16.230.54|Leather horse armor now protects [[horse]]s from [[freezing]].}} {{History|console}} {{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}} {{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden horse armor are now [[smelting|smeltable]].}} {{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|[[File:Leather Horse Armor BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] Added leather horse armor.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of leather, iron, gold and diamond horse armor have been changed.}} {{History|3ds}} {{History||0.1.0|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}} {{History|foot}} == Issues == {{issue list}} == Gallery == <gallery> Leather Horse Armor.png | Undyed Leather armor White Leather Horse Armor.png | White Leather armor Light Gray Leather Horse Armor.png | Light Gray Leather armor Gray Leather Horse Armor.png | Gray Leather armor Black Leather Horse Armor.png | Black Leather armor Brown Leather Horse Armor.png | Brown Leather armor Red Leather Horse Armor.png | Red Leather armor Orange Leather Horse Armor.png | Orange Leather armor Yellow Leather Horse Armor.png | Yellow Leather armor Lime Leather Horse Armor.png | Lime Leather armor Green Leather Horse Armor.png | Green Leather armor Cyan Leather Horse Armor.png | Cyan Leather armor Light Blue Leather Horse Armor.png | Light Blue Leather armor Blue Leather Horse Armor.png | Blue Leather armor Purple Leather Horse Armor.png | Purple Leather armor Magenta Leather Horse Armor.png | Magenta Leather armor Pink Leather Horse Armor.png | Pink Leather armor </gallery> === Screenshots === <gallery> Armored Horse.png|A [[horse]] equipped with iron horse armor and bound to a fence post by a [[lead]]. 13w21a-new-HorseUI-inventory.png|The GUI for horses implemented in [[Java Edition 13w21a|13w21a]], which allows the removal and switching of armor. GodSpawner.png|A golden horse armor found in a [[dungeon]] chest, which coincidentally contains an [[enchanted golden apple]]. Horses with armor.png|4 [[horse]]s equipped with [[leather]], [[iron]], [[gold]], and [[diamond]] armor. Leather Horse Armor 1.jpg|First image of leather horse armor. Leather Horse Armor 2.jpg|Second image of leather horse armor. Leather Horse Armor 3.jpg|Third image of leather horse armor. Leather Horse Armor 4.jpg|Fourth image of leather horse armor. Leather Horse Armor 5.jpg|Fifth image of leather horse armor. </gallery> == Notes == {{Notelist}} == References == {{Reflist}} {{items}} [[Category:Armor]] [[de:Rossharnisch]] [[es:Armadura para caballo]] [[fr:Armure pour cheval]] [[it:Bardatura]] [[ja:馬鎧]] [[ko:말 갑옷]] [[nl:Paardenharnas]] [[pl:Zbroja końska]] [[pt:Armadura para cavalo]] [[ru:Конская броня]] [[uk:Кінські обладунки]] [[zh:马铠]]</li><li>[[Popped Chorus Fruit|Popped Chorus Fruit]]<br/>{{Item | image = Popped Chorus Fruit.png | renewable = Yes | stackable = Yes (64) }} '''Popped chorus fruit''' is an [[item]] obtained by [[smelting]] [[chorus fruit]], and used to craft [[end rod]]s and [[purpur blocks]]. Unlike raw chorus fruit, the popped fruit is inedible. == Obtaining == === Smelting === {{Smelting |Chorus Fruit |Popped Chorus Fruit |0,1 }} == Usage == === Crafting ingredient === {{crafting usage}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Popped Chorus Fruit |spritetype=item |nameid=popped_chorus_fruit |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showaliasids=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Popped Chorus Fruit |spritetype=item |nameid=popped_chorus_fruit |aliasid=chorus_fruit_popped |id=559 |form=item |translationkey=item.chorus_fruit_popped.name |foot=1}} == History == {{History|java}} {{History||1.9|snap=15w31a|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit. |Popped chorus fruit are used to craft [[purpur block]]s.}} {{History|||snap=15w44b|Popped chorus fruit are now used to craft [[end rod]]s.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 433.}} {{History|||snap=pre5|The ID of popped chorus fruit has now been changed to <code>popped_chorus_fruit</code>.}} {{History||1.14|snap=18w43a|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}} {{History||1.16.100|snap=beta 1.16.100.56|The ID of popped chorus fruit has been changed from <code>chorus_fruit_popped</code> to <code>popped_chorus_fruit</code>.}} {{History|console}} {{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}} {{History|new 3ds}} {{History||1.7.10|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}} {{History|foot}} == Issues == {{issue list}} {{Items}} [[cs:Vypukaný květ chorusu]] [[de:Geplatzte Chorusfrucht]] [[fr:Chorus éclaté]] [[it:Frutto di chorus scoppiato]] [[ja:焼いたコーラスフルーツ]] [[ko:튀긴 후렴과]] [[nl:Gepoft Chorusfruit]] [[pl:Prażony owoc refrenusu]] [[pt:Fruta do coro cozida]] [[ru:Приготовленный плод коруса]] [[zh:爆裂紫颂果]] [[Category:Renewable resources]]</li></ul>		pre1			Added functions.
		pre3			Commands are no longer allowed to begin with a / (forward slash)
					Comments can now only be preceded with #; using // is no longer allowed
		pre4			Added new arguments to the /function command: [if|unless] [selector]
		pre6			Skipped functions (when a conditional fails) are now considered failures when used in commands.
1.13 {{Extension DPL}}<ul><li>[[Item Frame|Item Frame]]<br/>{{redirect|Frame}} {{ItemEntity | group = Item Frame | 1-1 = Item Frame.png | 1-2 = Item Frame (item).png | group2 = Glow Item Frame | 2-1 = Glow Item Frame.png | 2-2 = Glow Item Frame (item).png | extratext = [[#Renders|View all renders]] | renewable = Yes | stackable = Yes (64) | drops = {{ItemLink|Item Frame}} (1)<br> or {{ItemLink|Glow Item Frame}} (1)<br>{{EnvSprite|items}} The item it contains. }} An '''item frame''' is an [[entity]]{{only|java|short=y}} or [[block entity]]{{only|bedrock|short=y}} that displays the item or block that is inside it. A '''glow item frame''' keeps itself and the item inside it illuminated, even in the dark. == Obtaining == === Breaking === {{IN|je}}, an empty item frame can be broken simply by punching it. If the item frame contains an item, punching it drops the item, leaving the frame on the wall. Because item frames are [[entities]] {{in|java}}, they can be broken in [[Adventure]] mode. They will also be targeted by commands using the @e selector.{{only|java}} === Natural generation === An item frame containing a pair of [[elytra]] generates in each [[end ship]]. [[File:BoatElytra.png|thumb|An item frame naturally generating in an end ship.]] === Crafting === {{Crafting |head=1 |A1= Stick |B1= Stick |C1= Stick |A2= Stick |B2= Leather |C2= Stick |A3= Stick |B3= Stick |C3= Stick |Output= Item Frame |type= Decoration block }} {{Crafting |foot=1 |Glow Ink Sac |Item Frame |Output= Glow Item Frame |type= Decoration block }} === Trading === Expert-level [[Trading#Cartographer|cartographer]] [[villager]]s have a chance to sell an item frame for 7 [[emerald]]s. == Usage == === Item display === [[File:Item Frame (map filled partial).png|thumb|150px|Item frame with partially filled map]] Item frames can be placed on the sides of [[cactus]] blocks, [[pressure plate]]s, [[fence]]s, [[tree]]s, [[slab]]s, [[cobblestone wall]]s, [[chest]]s, [[door]]s, and all [[solid block]]s. They can also be placed on the top and bottom of these blocks. To place on chests and doors, the player needs to be [[sneaking]]. As item frames are an entity, multiple item frames can occupy the same block, although on different faces. It also allows non-solid blocks to occupy the same space.{{only|java}} Players can place items in the frame by {{control|using}} the item. If a [[map]] is placed in an item frame, it enlarges to show the map in the size of a full block, with the item frame's location displayed as a green pointer on the map, pointing in the direction the item frame is facing. If this is done in the Nether, the green cursor spins around similar to the white cursor (players). If an item in an item frame has been renamed using an [[anvil]], it displays its custom name when the cursor is over the item frame. If the player places a block inside the frame, it is displayed in miniature half in, half out of the block. This can be most notably seen on stairs or slabs. {{control|Pick block}} may be used on item frames by players in creative mode only, the control has no effect for players in Survival or Adventure mode. When the item frame is displaying an item, {{control|pick block}} picks the displayed item instead of the item frame. Item frames can be placed on the lid of a [[shulker box]] that is positioned horizontally, but pop off when the lid is opened.{{only|java}} === Rotation === The displayed item can then be rotated by right-clicking the frame. Items displayed in the item frame can turn 45° diagonally, with a total of 8 possibilities (90° and 4 possibilities if it is a map), and the frame outputs a [[Mechanics/Redstone/Circuit#Power level|redstone signal]] depending on the rotation phase that can be interpreted by a [[redstone comparator]] (note that this rotation value is separate from the clock or compass rotation). As long as the frame remains placed, it remembers the orientation of the last item it held, and uses it for the next item it holds.{{only|java}} === Glow item frames === [[File:Item Frames Comparison.png|thumb|260px|Comparison between ordinary item frame and glow item frame in the dark.]] When an item is placed inside a glow item frame, it appears to glow, even though it does not emit any [[light level]]. == Sounds == Item frames and glow item frames share the same sounds. === Generic === {{Edition|Bedrock}}:<!--Item frames are blocks in BE, so they get the generic section.--> {{Sound table/Block/Item frame/BE}} === Unique === {{Edition|Java}}: {{Sound table |rowspan=2 |sound=Item Frame add item1.ogg |sound2=Item Frame add item2.ogg |soumd3=Item Frame add item3.ogg |sound4=Item Frame add item4.ogg |subtitle=Item Frame fills |source=neutral |description=When an item is placed in an item frame |id=entity.item_frame.add_item |translationkey=subtitles.entity.item_frame.add_item |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Glow Item Frame fills |source=neutral |description=When an item is placed in a glow item frame |id=entity.glow_item_frame.add_item |translationkey=subtitles.entity.glow_item_frame.add_item |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |rowspan=2 |sound=Item Frame break1.ogg |sound2=Item Frame break2.ogg |sound3=Item Frame break3.ogg |subtitle=Item Frame breaks<ref group=sound name=breaks>{{bug|MC-194948}}</ref> |source=neutral |description=When an item frame is broken or pops off |id=entity.item_frame.break |translationkey=subtitles.entity.item_frame.break |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Glow Item Frame breaks<ref group=sound name=breaks/> |source=neutral |description=When a glow item frame is broken or pops off |id=entity.glow_item_frame.break |translationkey=subtitles.entity.glow_item_frame.break |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |rowspan=2 |sound=Item Frame place1.ogg |sound2=Item Frame place2.ogg |sound3=Item Frame place3.ogg |sound4=Item Frame place4.ogg |subtitle=Item Frame placed |source=neutral |description=When an item frame is placed |id=entity.item_frame.place |translationkey=subtitles.entity.item_frame.place |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Glow Item Frame placed |source=neutral |description=When a glow item frame is placed |id=entity.glow_item_frame.place |translationkey=subtitles.entity.glow_item_frame.place |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |rowspan=2 |sound=Item Frame remove item1.ogg |sound2=Item Frame remove item2.ogg |sound3=Item Frame remove item3.ogg |sound4=Item Frame remove item4.ogg |subtitle=Item Frame empties |source=neutral |description=When an item is removed from an item frame |id=entity.item_frame.remove_item |translationkey=subtitles.entity.item_frame.remove_item |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Glow Item Frame empties |source=neutral |description=When an item is removed from a glow item frame |id=entity.glow_item_frame.remove_item |translationkey=subtitles.entity.glow_item_frame.remove_item |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |rowspan=2 |sound=Item Frame rotate item1.ogg |sound2=Item Frame rotate item2.ogg |sound3=Item Frame rotate item3.ogg |sound4=Item Frame rotate item4.ogg |subtitle=Item Frame clicks |source=neutral |description=When an item is rotated in an item frame |id=entity.item_frame.rotate_item |translationkey=subtitles.entity.item_frame.rotate_item |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Glow Item Frame clicks |source=neutral |description=When an item is rotated in an item frame |id=entity.glow_item_frame.rotate_item |translationkey=subtitles.entity.glow_item_frame.rotate_item |volume=1.0 |pitch=1.0 |distance=16 |foot=1}} {{Edition|Bedrock}}: {{Sound table |type=bedrock |sound=Item Frame add item1.ogg |sound2=Item Frame add item2.ogg |soumd3=Item Frame add item3.ogg |sound4=Item Frame add item4.ogg |source=block |description=When an item is placed in an item frame |id=block.itemframe.add_item |volume=1.0 |pitch=1.0}} {{Sound table |sound=Item Frame remove item1.ogg |sound2=Item Frame remove item2.ogg |sound3=Item Frame remove item3.ogg |sound4=Item Frame remove item4.ogg |source=block |description=When an item is removed from an item frame |id=block.itemframe.remove_item |volume=1.0 |pitch=1.0}} {{Sound table |sound=Item Frame rotate item1.ogg |sound2=Item Frame rotate item2.ogg |sound3=Item Frame rotate item3.ogg |sound4=Item Frame rotate item4.ogg |source=block |description=When an item is rotated in an item frame |id=block.itemframe.rotate_item |volume=1.0 |pitch=1.0 |foot=1}} == Achievements == {{load achievements|Map room}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |firstcolumnname=Item |showforms=y |generatetranslationkeys=y |displayname=Item Frame |spritetype=item |nameid=item_frame |form=item}} {{ID table |displayname=Glow Item Frame |spritetype=item |nameid=glow_item_frame |form=item |foot=1}} {{ID table |edition=java |firstcolumnname=Entity |generatetranslationkeys=y |displayname=Item Frame |spritetype=entity |nameid=item_frame}} {{ID table |displayname=Glow Item Frame |spritetype=entity |nameid=glow_item_frame |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |firstcolumnname=Item Frame |shownumericids=y |showforms=y |generatetranslationkeys=y |displayname=Item |spritename=item-frame |spritetype=item |nameid=frame |id=513 |form=item}} {{ID table |displayname=Block |spritename=item-frame |spritetype=block |nameid=frame |id=199 |form=block |translationkey=- |itemform=item.frame}} {{ID table |displayname=Item |spritename=glow-item-frame |spritetype=item |nameid=glow_frame |id=623 |form=item}} {{ID table |displayname=Block |spritename=glow-item-frame |spritetype=block |nameid=glow_frame |form=block |id=594 |itemform=item.glow_frame |translationkey=- |foot=1}} {{ID table |notnamespaced=y |displayname=Block entity |spritename=item-frame |spritetype=block |nameid=ItemFrame}} {{ID table |displayname=Block entity |spritename=glow-item-frame |spritetype=block |nameid=GlowItemFrame |foot=1}} === Block states=== {{see also|Block states}} {{/BS}}<br /> ===Item data=== {{el|java}}:{{main|Player.dat format}}<div class="treeview"> *{{nbt|compound|tag}}'''<span data-ve-ignore="true" class="nowrap"> tag</span>''': The item's '''tag''' tag. {{:Player.dat_format/Entity Spawners}}Unlike spawn eggs, cannot change the type of entity created using the <code>id</code> tag. Data that item frames do not normally use (see below) has no effect. </div> ===Entity data=== {{main|Entity format}} {{IN|java}}, item frames have entity data that define various properties of the entity. {{/ED}} ===Block data=== {{IN|bedrock}}, an item frame has a block entity associated with it that holds additional data about the block. See [[Bedrock Edition level format/Block entity format]]. == Video== <div style="text-align:center">{{yt|rJLj95DBb-w}}</div> ==History== {{History|java}} {{History||August 15, 2012|link={{tweet|Dinnerbone|235724805196877824}}|[[File:Item Frame (pre-release).png|32px]] [[Dinnerbone]] showed the first image of item frames.}} {{History||August 15, 2012|link={{tweet|Dinnerbone|235742974271700993}}|[[File:Item Frame (item) (pre-release).png|32px]] Dinnerbone showed item frame in item form.}} {{History||August 15, 2012|link={{tweet|jeb_|235746335368814592}}|[[File:Item Frame (pre-release 2).png|32px]] [[Jeb]] showed the item frames with new model.}} {{History||August 16, 2012|link={{tweet|Dinnerbone|236062188555624448}}|[[File:Item Frame (item) JE1 BE1.png|32px]] Dinnerbone showed the item frame in item form with new texture.}} {{History||1.4.2|snap=12w34a|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames. |There is currently a bug where attempting to place an item frame in [[multiplayer]] causes an internal server error, as well as other bugs.}} {{History|||snap=12w34b|The multiplayer item frame bug has been fixed.}} {{History|||snap=12w38a|Item frames no longer despawn when the [[player]] moves 20 [[block]]s away.}} {{History||1.7.2|snap=13w36a|Items renamed using an [[anvil]] now display their name when looked at up close.}} {{History|||snap=13w38a|[[Map]]s placed in an item frame now cover the whole block face, allowing seamless tiling of adjacent maps. This makes undiscovered areas of maps invisible.}} {{History|||snap=13w43a|[[File:Item Frame (map) JE1 BE1.png|32px]] Incomplete maps placed in item frames now display the item frame texture underneath.}} {{History||1.8|snap=14w04a|[[Item]]s and [[block]]s displayed in the item frame now rotate 45 degrees when rotated instead of 90 degrees, and a [[comparator]] outputs a [[redstone]] signal depending on the rotation phase.}} {{History|||snap=14w10a|Multiple item frames can no longer be placed on the same block face.}} {{History||1.9|snap=15w41a|An item frame now generates in the treasure room of [[end ship]]s, above the [[shulker]] that guards the treasure. It holds [[elytra]].}} {{History|||snap=15w49a|Item frames are no longer destroyed by [[lightning]] bolts.}} {{History|||snap=15w50a|Added [[sound]]s to item frames: <code>entity.itemframe.add_item</code>, <code>entity.itemframe.break</code>, <code>entity.itemframe.place</code>, <code>entity.itemframe.remove_item</code>, and <code>entity.itemframe.rotate_item</code>.}} {{History||1.11|snap=16w32a|The [[entity]] ID of item frames has been changed from <code>ItemFrame</code> to <code>item_frame</code>.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 389.}} {{History|||snap=17w50a|Item frames can now be put on floors and ceilings.}} {{History||1.14|snap=18w43a|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}} {{History|||snap=19w11a|Item frames are now [[trading|sold]] by cartographer [[villager]]s.}} {{History||1.15|snap=19w38a|[[File:Item Frame 19w38a.png|32px]] [[File:Item Frame Map 19w38a.png|32px]] Item frames now appear dark, same as suffocating [[mob]]s.<ref>{{bug|mc-161283|||Fixed}}</ref>}} {{History|||snap=19w39a|Item frames are now colored correctly.}} {{History||1.16|snap=20w10a|The NBT <code>Invisible</code> and <code>Fixed</code> have been added to item frames.}} {{History||1.17|snap=21w03a|[[File:Glow Item Frame JE1 BE3.png|32px]] [[File:Glow Item Frame (map) JE1 BE3.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Added glow item frames.}} {{History|||snap=21w10a|Added new [[subtitles]] for glow item frames.}} {{History||1.18|snap=21w41a|[[File:Item Frame (item) JE3.png|32px]] [[File:Glow Item Frame (item) JE2.png|32px]] The textures of item frames and glow item frames as item have been changed.}} {{History||1.19|snap=22w15a|Item frames now adjusts its hitbox to account for the larger size of a framed [[map]].}} {{History|||snap=Pre-release 3|Reverted the change in 22w15a.}} {{History|pocket alpha}} {{History||v0.14.0|snap=build 1|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (map) JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames. |Item frames are considered as a [[block entity]] instead of an [[entity]].<ref>{{tweet|_tomcc|690127591525728257|Let's create some drama: ItemFrames in MCPE will behave like signs and won't be placeable in blocks, and can't put many in the same block.|21 Jan 2016}}</ref>}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|An item frame containing [[elytra]] now generates in [[end city]] ships.}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}} {{History||1.11.0|snap=beta 1.11.0.4|Item frames can now be [[trading|bought]] from cartographer [[villager]]s.}} {{History||1.13.0|snap=beta 1.13.0.9|Item frames can now be placed on the top and bottom of [[block]]s.}} {{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed, item frames are now offered by expert-level cartographer villager.}} {{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.210.59|[[File:Item Frame.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Added glow item frames. |Has the default item frame block texture.}} {{History|||snap=beta 1.16.210.60|Temporarily removed glow item frames due to a crash.}} {{History|||snap=beta 1.16.220.50|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Re-added glow item frames.}} {{History|||snap=beta 1.16.220.52|[[File:Glow Item Frame BE2.png|32px]] [[File:Glow Item Frame (map) BE2.png|32px]] Glow Item Frame block texture uses update block texture due to a bug.}} {{History||1.17.0|snap=beta 1.16.230.52|[[File:Item Frame.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] The glow item frame block textures have been reverted back to the previous one.}} {{History|||snap=beta 1.17.0.50|[[File:Glow Item Frame JE1 BE3.png|32px]] [[File:Glow Item Frame (map) JE1 BE3.png|32px]] The textures of glow item frames have been changed to match Java Edition. |Now produces [[redstone]] signals.}} {{History|||snap=beta 1.17.0.52|Maps now glow in glow item frames. |Glow Item Frames are no longer available only through [[Experimental Gameplay]].}} {{History||1.18.10|snap=beta 1.18.10.20|[[File:Item Frame (item) JE3.png|32px]] [[File:Glow Item Frame (item) JE2.png|32px]] The textures of item frames and glow item frames as item have been changed.}} {{History|console}} {{History||xbox=TU9|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Item Frame LCE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames.}} {{History||xbox=TU11|The limit for item frames in a world has been increased. A message is now displayed when the maximum number of item frames are reached.}} {{History||xbox=TU12|[[File:Item Frame JE1 BE1.png|32px]] The entity texture of item frames has been changed.}} {{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[Item]]s and [[block]]s displayed in the item frame now rotate 45 degrees when rotated instead of 90 degrees, and a [[redstone comparator|comparator]] now outputs a [[redstone]] signal depending on the rotation phase.}} {{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for item frames.}} {{History||xbox=TU56|xbone=CU47|ps=1.55|wiiu=Patch 26|switch=1.0.6|If the [[item]] in the item frame has a name (from an [[anvil]]) it now shows as if there is a name tag on the item frame.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}} {{History|new 3ds}} {{History||0.1.0|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (map) JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames.}} {{History|foot}} == Issues== {{issue list}} == Trivia== *The item frame is based upon a suggestion on [[wikipedia:Reddit|Reddit]], like the [[ender chest]] and [[flower pot]].<ref>{{Tweet|dinnerbone|235747041286975488}}</ref> *The item frame is the only entity to reference a block [[model]].{{only|java|short=1}} Because of this, the texture of the frame border is the same as the birch planks texture. *Item frame is the '''only''' placeable item that can interfere with other non-full block entities. *Due to the way layer textures are displayed in Minecraft, maps float on item frames, similar to how icons float on the map itself. == Gallery == === Renders === <gallery> Item Frame.png | Item Frame Item Frame (map).png | Map Item Frame Glow Item Frame.png | Glow Item Frame Glow Item Frame (map).png | Map Glow Item Frame Item Frame with Item.png | With item Item Frame with rotated Item.png | With rotated item Item Frame with Block.png | With block Item Frame with rotated Block.png | With rotated block </gallery> === Screenshots === <gallery> Slab Frame.png|An item frame on the side of a slab. ItemFrameBoxed.png|Four item frames in a one-block space.{{only|java}} Item Frames Woodbase.png|The frame itself uses the texture of birch planks. Item Frame rotation.gif|The rotation of an item in an item frame. Front-back-itemframe.png|The front and back of an item frame are the same. Big skills right there.png|A glow item frame inside a glow item frame. Frame fireplace.png|An image of a fireplace retweeted by Dinnerbone. 11 Framed.png|[[11]] in an item frame. </gallery> === Development images === <gallery> Suggestion for itemframes.png|Original Reddit image suggesting item frames and flower pots. Item frame2.png|Dinnerbone's first screenshot showing armor and weapons. Item frame3.png|Dinnerbone's second screenshot showing a map, a compass, and two diamond swords. Item frame4.png|Dinnerbone's third screenshot showing a golden sword in all directions, the item frame item itself, and a working clock. Item frame1.png|Jeb's screenshot of the item frame. FlowerPot.png|Snapshot showing plant pots and item frames. Item frame5.png|Snapshot image of an ender pearl in an item frame. SOATPC.png|An image tweeted by Dinnerbone showing how hovering over an item frame containing a renamed item shows a name tag. Pocket Edition Item Frames.jpg|First image of item frames in ''Bedrock Edition''. </gallery> == See also == *{{ItemLink|Painting}} == References == {{Reflist}} {{Blocks|Utility}} {{items}} {{entities}} [[Category:Block entities]] [[Category:Utility blocks]] [[Category:Manufactured blocks]] [[Category:Generated structure blocks]] [[Category:Storage]] [[cs:Rámeček]] [[de:Rahmen]] [[es:Marco]] [[fr:Cadre]] [[hu:Eszköz keret]] [[it:Cornice]] [[ja:額縁]] [[ko:아이템 액자]] [[nl:Voorwerplijst]] [[pl:Ramka na przedmiot]] [[pt:Moldura]] [[ru:Рамка]] [[th:กรอบโชว์สิ่งของ]] [[zh:物品展示框]]</li><li>[[Pottery Sherd|Pottery Sherd]]<br/>{{Item | image=Angler Pottery Sherd.png | extratext = View [[#Items|all items]] | renewable = No | stackable = Yes (64) }} <!-- IT IS SHERD, NOT SHARD! DO NOT CHANGE TO SHARD, AS IT IS NAMED SHERD IN-GAME! --> '''Pottery sherds'''<ref group="note">The word "[[wiktionary:sherd#English|sherd]]" or "[[wiktionary:potsherd#English|potsherd]]" is used by archaeologists to refer to fragments of pottery or other ceramics in order to differentiate them from "shards" of glass, metal, minerals and other materials. </ref> are a set of twenty [[item]]s used to craft [[decorated pot]]s with ornamental designs. They can be obtained only by [[brush]]ing [[suspicious block]]s, with the variants of sherd obtainable being dependent on the structure. == Obtaining == === Breaking === When a [[decorated pot]] is broken with a [[pickaxe]], [[axe]], [[shovel]], [[hoe]] or [[sword]] that is ''not'' enchanted with [[Silk Touch]], it drops all of the pottery sherds and [[brick]]s used to craft it with a 0.00009659969% chance of spawning in a desert well. === Suspicious block loot === Pottery sherds can be found as [[suspicious block]] loot in [[trail ruins]], [[ocean ruins]], [[desert pyramids]] and [[desert well]]s, and can be extracted from these blocks using a [[brush]]. {{#invoke:LootChest|base3|angler-pottery-sherd,archer-pottery-sherd,arms-up-pottery-sherd,blade-pottery-sherd,brewer-pottery-sherd,burn-pottery-sherd,danger-pottery-sherd,explorer-pottery-sherd,friend-pottery-sherd,heart-pottery-sherd,heartbreak-pottery-sherd,howl-pottery-sherd,miner-pottery-sherd,mourner-pottery-sherd,plenty-pottery-sherd,prize-pottery-sherd,sheaf-pottery-sherd,shelter-pottery-sherd,skull-pottery-sherd,snort-pottery-sherd}} == Usage == === Crafting ingredient === {{Crafting |ingredients=Any Pottery Sherd or [[Brick]] |B1= Any Pottery Sherd |A2= Any Pottery Sherd |C2= Any Pottery Sherd |B3= Any Pottery Sherd |Output= Decorated Pot |type= Decoration block }} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Angler Pottery Sherd |spritetype=item |nameid=angler_pottery_sherd |form=item}} {{ID table |displayname=Archer Pottery Sherd |spritetype=item |nameid=archer_pottery_sherd |form=item}} {{ID table |displayname=Arms Up Pottery Sherd |spritetype=item |nameid=arms_up_pottery_sherd |form=item}} {{ID table |displayname=Blade Pottery Sherd |spritetype=item |nameid=blade_pottery_sherd |form=item}} {{ID table |displayname=Brewer Pottery Sherd |spritetype=item |nameid=brewer_pottery_sherd |form=item}} {{ID table |displayname=Burn Pottery Sherd |spritetype=item |nameid=burn_pottery_sherd |form=item}} {{ID table |displayname=Danger Pottery Sherd |spritetype=item |nameid=danger_pottery_sherd |form=item}} {{ID table |displayname=Explorer Pottery Sherd |spritetype=item |nameid=explorer_pottery_sherd |form=item}} {{ID table |displayname=Friend Pottery Sherd |spritetype=item |nameid=friend_pottery_sherd |form=item}} {{ID table |displayname=Heart Pottery Sherd |spritetype=item |nameid=heart_pottery_sherd |form=item}} {{ID table |displayname=Heartbreak Pottery Sherd |spritetype=item |nameid=heartbreak_pottery_sherd |form=item}} {{ID table |displayname=Howl Pottery Sherd |spritetype=item |nameid=howl_pottery_sherd |form=item}} {{ID table |displayname=Miner Pottery Sherd |spritetype=item |nameid=miner_pottery_sherd |form=item}} {{ID table |displayname=Mourner Pottery Sherd |spritetype=item |nameid=mourner_pottery_sherd |form=item}} {{ID table |displayname=Plenty Pottery Sherd |spritetype=item |nameid=plenty_pottery_sherd |form=item}} {{ID table |displayname=Prize Pottery Sherd |spritetype=item |nameid=prize_pottery_sherd |form=item}} {{ID table |displayname=Sheaf Pottery Sherd |spritetype=item |nameid=sheaf_pottery_sherd |form=item}} {{ID table |displayname=Shelter Pottery Sherd |spritetype=item |nameid=shelter_pottery_sherd |form=item}} {{ID table |displayname=Skull Pottery Sherd |spritetype=item |nameid=skull_pottery_sherd |form=item}} {{ID table |displayname=Snort Pottery Sherd |spritetype=item |nameid=snort_pottery_sherd |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Angler Pottery Sherd |spritetype=item |nameid=angler_pottery_sherd |id=664 |form=item}} {{ID table |displayname=Archer Pottery Sherd |spritetype=item |nameid=archer_pottery_sherd |id=665 |form=item}} {{ID table |displayname=Arms Up Pottery Sherd |spritetype=item |nameid=arms_up_pottery_sherd |id=666 |form=item}} {{ID table |displayname=Blade Pottery Sherd |spritetype=item |nameid=blade_pottery_sherd |id=667 |form=item}} {{ID table |displayname=Brewer Pottery Sherd |spritetype=item |nameid=brewer_pottery_sherd |id=668 |form=item}} {{ID table |displayname=Burn Pottery Sherd |spritetype=item |nameid=burn_pottery_sherd |id=669 |form=item}} {{ID table |displayname=Danger Pottery Sherd |spritetype=item |nameid=danger_pottery_sherd |id=670 |form=item}} {{ID table |displayname=Explorer Pottery Sherd |spritetype=item |nameid=explorer_pottery_sherd |id=671 |form=item}} {{ID table |displayname=Friend Pottery Sherd |spritetype=item |nameid=friend_pottery_sherd |id=672 |form=item}} {{ID table |displayname=Heart Pottery Sherd |spritetype=item |nameid=heart_pottery_sherd |id=673 |form=item}} {{ID table |displayname=Heartbreak Pottery Sherd |spritetype=item |nameid=heartbreak_pottery_sherd |id=674 |form=item}} {{ID table |displayname=Howl Pottery Sherd |spritetype=item |nameid=howl_pottery_sherd |id=675 |form=item}} {{ID table |displayname=Miner Pottery Sherd |spritetype=item |nameid=miner_pottery_sherd |id=676 |form=item}} {{ID table |displayname=Mourner Pottery Sherd |spritetype=item |nameid=mourner_pottery_sherd |id=677 |form=item}} {{ID table |displayname=Plenty Pottery Sherd |spritetype=item |nameid=plenty_pottery_sherd |id=678 |form=item}} {{ID table |displayname=Prize Pottery Sherd |spritetype=item |nameid=prize_pottery_sherd |id=679 |form=item}} {{ID table |displayname=Sheaf Pottery Sherd |spritetype=item |nameid=sheaf_pottery_sherd |id=680 |form=item}} {{ID table |displayname=Shelter Pottery Sherd |spritetype=item |nameid=shelter_pottery_sherd |id=681 |form=item}} {{ID table |displayname=Skull Pottery Sherd |spritetype=item |nameid=skull_pottery_sherd |id=682 |form=item}} {{ID table |displayname=Snort Pottery Sherd |spritetype=item |nameid=snort_pottery_sherd |id=683 |form=item |foot=1}} == Achievements == {{Load achievements|Careful restoration}} == Advancements == {{Load advancements|Respecting the Remnants;Careful Restoration}} == History == {{History||October 3, 2020|[[File:Blue Ceramic Shard.png|32px]][[File:Orange Ceramic Shard.png|32px]][[File:Ceramic Shard 1.png|32px]][[File:Ceramic Shard 2.png|32px]][[File:Ceramic Shard 3.png|32px]][[File:Ceramic Shard 4.png|32px]] Ceramic shards were announced at [[Minecraft Live 2020]].|link=https://youtu.be/DBvZ2Iqmm3M?t=2216}} {{History||February 10, 2023|[[Sofia Dankis]] posted an article about upcoming archaeology features, including pottery shards.|link=https://www.minecraft.net/en-us/article/archeology-coming-minecraft-120}} {{History|java}} {{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Archer Pottery Sherd JE1.png|32px]] [[File:Arms Up Pottery Sherd JE1 BE2.png|32px]] [[File:Prize Pottery Sherd JE1 BE2.png|32px]] [[File:Skull Pottery Sherd JE1 BE2.png|32px]] Added pottery shards behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}} {{History|||snap=1.19.4 Pre-release 3|[[File:Archer Pottery Sherd JE2 BE2.png|32px]] Changed the texture of archer pottery shard.}} {{History||1.20|snap=23w12a|Pottery shards are now out of the 1.20 experimental data pack.|[[File:Angler Pottery Sherd JE1 BE1.png|32px]] [[File:Blade Pottery Sherd JE1 BE1.png|32px]] [[File:Brewer Pottery Sherd JE1 BE1.png|32px]] [[File:Burn Pottery Sherd JE1 BE1.png|32px]] [[File:Danger Pottery Sherd JE1 BE1.png|32px]] [[File:Explorer Pottery Sherd JE1 BE1.png|32px]] [[File:Friend Pottery Sherd JE1 BE1.png|32px]] [[File:Heart Pottery Sherd JE1 BE1.png|32px]] [[File:Heartbreak Pottery Sherd JE1 BE1.png|32px]] [[File:Howl Pottery Sherd JE1 BE1.png|32px]] [[File:Miner Pottery Sherd JE1 BE1.png|32px]] [[File:Mourner Pottery Sherd JE1 BE1.png|32px]] [[File:Plenty Pottery Sherd JE1 BE1.png|32px]] [[File:Sheaf Pottery Sherd JE1 BE1.png|32px]] [[File:Shelter Pottery Sherd JE1 BE1.png|32px]] [[File:Snort Pottery Sherd JE1 BE1.png|32px]] Added another sixteen pottery shards. |The probability for the archer, prize, and skull pottery shards to generate in the [[suspicious sand]] in [[desert temple]] and in [[desert well]] has been changed from 1/7 to 1/8, for the arms up pottery sherd to generate in the suspicious sand in [[desert well]] has been changed from 3/7 to 1/4.}} {{History|||snap=23w16a|Renamed "Pottery Shard" to "Pottery Sherd".|Burn, danger, friend, heart, heartbreak, howl and sheaf pottery sherds 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]]; burn, danger, friend, heart, heartbreak, howl and sheaf pottery sherds now are in the rare loot.}} {{History|||snap=23w17a|The probability of the burn, danger, friend, heart, heartbreak, howl, and sheaf pottery sherds to generate in [[suspicious gravel]] in [[trail ruins]] has been changed from 1/11 to 1/12.{{verify}}|The player now gets the [[advancement]] "Respecting the remnants" when they brush a [[suspicious sand]] or a [[suspicious gravel]] to obtain a pottery sherd, "Careful restoration" when they craft a decorated pot using 4 pottery sherds.}} {{History|bedrock}} {{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|[[File:Archer Pottery Sherd BE1.png|32px]] [[File:Arms Up Pottery Sherd BE1.png|32px]] [[File:Prize Pottery Sherd BE1.png|32px]] [[File:Skull Pottery Sherd BE1.png|32px]] Added pottery shards behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.}} {{History|||snap=beta 1.19.80.20|[[File:Archer Pottery Sherd JE2 BE2.png|32px]] Changed the texture of archer pottery shard.}} {{h|||snap=beta 1.19.80.22|[[File:Angler Pottery Sherd JE1 BE1.png|32px]] [[File:Blade Pottery Sherd JE1 BE1.png|32px]] [[File:Brewer Pottery Sherd JE1 BE1.png|32px]] [[File:Burn Pottery Sherd JE1 BE1.png|32px]] [[File:Danger Pottery Sherd JE1 BE1.png|32px]] [[File:Explorer Pottery Sherd JE1 BE1.png|32px]] [[File:Friend Pottery Sherd JE1 BE1.png|32px]] [[File:Heart Pottery Sherd JE1 BE1.png|32px]] [[File:Heartbreak Pottery Sherd JE1 BE1.png|32px]] [[File:Howl Pottery Sherd JE1 BE1.png|32px]] [[File:Miner Pottery Sherd JE1 BE1.png|32px]] [[File:Mourner Pottery Sherd JE1 BE1.png|32px]] [[File:Plenty Pottery Sherd JE1 BE1.png|32px]] [[File:Sheaf Pottery Sherd JE1 BE1.png|32px]] [[File:Shelter Pottery Sherd JE1 BE1.png|32px]] [[File:Snort Pottery Sherd JE1 BE1.png|32px]] Added another sixteen pottery shards. |[[File:Arms Up Pottery Sherd JE1 BE2.png|32px]] [[File:Prize Pottery Sherd JE1 BE2.png|32px]] [[File:Skull Pottery Sherd JE1 BE2.png|32px]] Changed the texture of arms up, prize and skull pottery shards.<ref>{{bug|MCPE-167202}}</ref>}} {{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.20.0|snap=beta 1.20.0.20|Miner pottery shard can generate in desert pyramids.}} {{History||1.20.0|snap=beta 1.20.0.21|Pottery shards are now available without using the "Next Major Update" experimental toggle.}} {{History|||snap=beta 1.20.0.22|Renamed "Pottery Shard" to "Pottery Sherd".}} {{History|foot}} == Issues == {{issue list}} == Trivia == * Many pottery sherds are based on another in-game mob or item: ** The angler pottery sherd depicts a [[fishing rod]]. ** The archer pottery sherd depicts a [[bow]] and [[arrow]]. ** The blade pottery sherd depicts a [[sword]]. ** The brewer pottery sherd depicts a [[potion]]. ** The burn pottery sherd depicts [[fire]]. ** The danger pottery sherd depicts a [[creeper]]. ** The explorer pottery sherd depicts a [[map]]. ** The friend pottery sherd depicts the unibrow and nose of a [[villager]] or [[iron golem]]. ** The howl pottery sherd depicts a [[wolf]]. ** The miner pottery sherd depicts a [[pickaxe]]. ** The mourner pottery sherd depicts an early design for the [[warden]]. ** The plenty pottery sherd depicts a [[chest]]. ** The sheaf pottery sherd depicts [[wheat]]. ** The skull pottery sherd depicts a [[skeleton]]. ** The snort pottery sherd depicts a [[sniffer]]. **The prize pottery sherd depicts a diamond cut [[diamond]] ***It could depict a [[MCE:Ruby|ruby]] from ''Minecraft Earth'', as well. **The arms up pottery sherd depicts a [[character]] with their arms up. **The heart and heartbreak pottery sherds depict a [[Health|heart]] and broken heart respectively. **The shelter pottery sherd depicts a [[tree]]. ==Gallery== === Items === <gallery> Angler Pottery Sherd.png|Angler Pottery Sherd Archer Pottery Sherd.png|Archer Pottery Sherd Arms Up Pottery Sherd.png|Arms Up Pottery Sherd Blade Pottery Sherd.png|Blade Pottery Sherd Brewer Pottery Sherd.png|Brewer Pottery Sherd Burn Pottery Sherd.png|Burn Pottery Sherd Danger Pottery Sherd.png|Danger Pottery Sherd Explorer Pottery Sherd.png|Explorer Pottery Sherd Friend Pottery Sherd.png|Friend Pottery Sherd Heart Pottery Sherd.png|Heart Pottery Sherd Heartbreak Pottery Sherd.png|Heartbreak Pottery Sherd Howl Pottery Sherd.png|Howl Pottery Sherd Miner Pottery Sherd.png|Miner Pottery Sherd Mourner Pottery Sherd.png|Mourner Pottery Sherd Plenty Pottery Sherd.png|Plenty Pottery Sherd Prize Pottery Sherd.png|Prize Pottery Sherd Sheaf Pottery Sherd.png|Sheaf Pottery Sherd Shelter Pottery Sherd.png|Shelter Pottery Sherd Skull Pottery Sherd.png|Skull Pottery Sherd Snort Pottery Sherd.png|Snort Pottery Sherd </gallery> === Development images === <gallery> JE 1.17 Development Archeology.jpg|Blue ceramic shard. JE 1.17 Development Archeology 2.jpg|Ceramic shards. </gallery> === Official artwork === <gallery> Pottery Sherd Pixel Art.png|Pixel artwork of [[Ari]] holding a skull pottery sherd. File:T&T Thumbnail.jpg|Ari holding up a different sherd. </gallery> == References == <references /> == Notes == <references group="note"/> {{Items}} [[Category:Non-renewable resources]] [[de:Töpferscherbe]] [[es:Fragmento de cerámica]] [[fr:Tesson de poterie]] [[ja:壺の欠片]] [[pt:Óstraco]] [[zh:陶片]]</li></ul>		17w43a			Custom functions have been moved into data packs.
		17w45a			Functions are now completely parsed and cached on load.
		17w49b			Function 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.