Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
8,970
pages
in: Minecraft stubs, Java Edition
English

NBT format

Revision as of 23:02, 28 February 2020 by Fabian42 (talk | contribs) (→‎Third-Party: The Synalyze forum post is not available either.)
Sign in to edit
This article is about the NBT file format. For using NBT in commands, see Tutorials/Command NBT tags.

The Named Binary Tag format is used by Minecraft for the various files in which it saves data. The format is described by Notch in a very brief specification. The format is designed to store data in a tree structure made up of various tags. All tags have an ID and a name. The original known version was 19132 as introduced in Beta 1.3, and since then has been updated to 19133 with Anvil, with the addition of the Int Array tag. The NBT format dates all the way back to Indev with tags 0 to 10 in use.

Another more user-friendly format of NBT is in plain string, as used in commands. This format is referred to as SNBT, short for stringified NBT. It is different from the JSON format; hence, any JSON used in NBT, such as raw json text, must be enclosed within a string tag.

TAG definition

A tag is an individual part of the data tree. The first byte in a tag is the tag type (ID), followed by a two byte big-endian unsigned integer for the length of the name, then the name as a string in UTF-8 format (Note TAG_End is not named and does not contain the extra 2 bytes; the name is assumed to be empty). The name of tags may contain spaces, although Minecraft itself never saves tags with spaces in the names. Finally, depending on the type of the tag, the bytes that follow are part of that tag's payload. This table describes each of the 13 known tags in version 19133 of the Named Binary Tag format:

ID Icon Tag Type Payload SNBT Format‌[JE only] Description Storage Capacity
0 TAG_End None. - Used to mark the end of compound tags. This tag does not have a name, so it is only ever a single byte 0. It may also be the type of empty List tags. N/A
1 TAG_Byte 1 byte / 8 bits, signed <number>b or <number>B A signed integral type. Sometimes used for booleans. Full range of -(27) to (27 - 1)
(-128 to 127)
2 TAG_Short 2 bytes / 16 bits, signed, big endian <number>s or <number>S A signed integral type. Full range of -(215) to (215 - 1)
(-32,768 to 32,767)
3 TAG_Int 4 bytes / 32 bits, signed, big endian <number> A signed integral type. Full range of -(231) to (231 - 1)
(-2,147,483,648 to 2,147,483,647)
4 TAG_Long 8 bytes / 64 bits, signed, big endian <number>l or <number>L A signed integral type. Full range of -(263) to (263 - 1)
(-9,223,372,036,854,775,808 to 9,223,372,036,854,775,807)
5 TAG_Float 4 bytes / 32 bits, signed, big endian, IEEE 754-2008, binary32 <number>f or <number>F A signed floating point type. Precision varies throughout number line;
See Single-precision floating-point format. Maximum value about 3.4*1038
6 TAG_Double 8 bytes / 64 bits, signed, big endian, IEEE 754-2008, binary64 <decimal number>, <number>d or <number>D A signed floating point type. Precision varies throughout number line;
See Double-precision floating-point format. Maximum value about 1.8*10308
7 TAG_Byte_Array TAG_Int's payload size, then size TAG_Byte's payloads. [B;<byte>,<byte>,...] An array of bytes. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.
8 TAG_String TAG_Short's payload length, then a UTF-8 string with size length. <a-zA-Z0-9 text>, "<text>" (" within needs to be escaped to \"), or '<text>' (' within needs to be escaped to \') A UTF-8 string. It has a size, rather than being null terminated. 32,767 bytes interpretable as UTF-8 (see UTF-8 format; most commonly-used characters are a single byte).
9 TAG_List TAG_Byte's payload tagId, then TAG_Int's payload size, then size tags' payloads, all of type tagId. [<value>,<value>,...] A list of tag payloads, without repeated tag IDs or any tag names. Due to JVM limitations and the implementation of ArrayList, the maximum number of list elements is (231 - 9), or 2,147,483,639. Also note that List and Compound tags may not be nested beyond a depth of 512.
10 TAG_Compound Fully formed tags, followed by a TAG_End. {<tag name>:<value>,<tag name>:<value>,...} A list of fully formed tags, including their IDs, names, and payloads. No two tags may have the same name. Unlike lists, there is no hard limit to the number of tags within a Compound (of course, there is always the implicit limit of virtual memory). Note, however, that Compound and List tags may not be nested beyond a depth of 512.
11 TAG_Int_Array TAG_Int's payload size, then size TAG_Int's payloads. [I;<integer>,<integer>,...] An array of TAG_Int's payloads. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.
12 TAG_Long_Array TAG_Int's payload size, then size TAG_Long's payloads. [L;<long>,<long>,...] An array of TAG_Long's payloads. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.

The List and Compound tags can be and often are recursively nested. It should also be noted that, in a list of lists, each of the sub-lists can list a different kind of tag.

File Format

An NBT file is a GZip'd Compound tag, name and tag ID included. Some of the files utilized by Minecraft may be uncompressed, but in most cases the files follow Notch's original specification and are compressed with GZip. In the Legacy Console Edition, chunks are compressed with XMemCompress, a variation of an LZX compression algorithm. There is no header to specify the version or any other information - only the level.dat file specifies the version.

As used in Minecraft

Minecraft's use of the NBT format is odd at times. In some instances, empty lists may be represented as a list of Byte tags rather than a list of the correct type, or as a list of End tags in newer versions of Minecraft, which can break some older NBT tools. Additionally, almost every root tag has an empty name string and encapsulates only one Compound tag with the actual data and a name. For instance:

  • The root tag for most Minecraft NBT structures.
    •  SomeName: The only tag contained within the root tag - it has a name and contains all the actual data.

Another noticeable oddity is that, although the original specification by Notch allows for spaces in tag names, and even the example uses spaces in the tag names, Minecraft has no known files where any tags have spaces in their names. There is also inconsistent use of letter case, mostly either camelCase or PascalCase, but sometimes even in all lowercase.

Uses

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: 4

Software

Mojang has provided sample Java NBT classes for developers to use and reference as part of the source code for the McRegion -> Anvil converter. Since 1.13, Minecraft includes a builtin converter between SNBT format and compressed NBT format. It comes with the client and the official server.[1]

Official

See also: Tutorials/Running the Data Generator

The data generator from Minecraft is able to convert uncompressed Stringified NBT files with .snbt extension in an input folder to GZip compressed NBT format files with .nbt extension in an output folder, and vice versa.

The vanilla data generator can convert any GZip compressed NBT format to SNBT format. You can simply change the file extension of a file, such as level.dat to level.nbt and put it in the input folder, and the generator will decode the GZip compressed NBT data.

Third-Party

The community has developed programs to view and modify compressed and uncompressed NBT files:

Name NBT Version Description Screenshot
CL-NBT 19132 CL-NBT is an NBT implementation in Common Lisp that can read and write NBT files and load and save McRegion files. Anvil format works with slight modification.
NBT for Python 19133 Library to parse & write NBT files, both standalone or in region files, in the Python scripting language. Provided with application examples for inspecting & editing the Minecraft data files (block / chest / mobs statistics and simple world mapping). Supports old McRegion, pre-flattened and latest Anvil formats.
NBTExplorer - Forum Post 19133 Inspired by and based on NBTEdit, this program allows viewing and editing of NBT files via a Windows tree control. It supports compressed and uncompressed NBT files, and allows for direct editing of the NBT structures in MCRegion and Anvil files, level.dat, etc. File:NBTExplorer.png

History

Java Edition
1.0.0
{{Extension DPL}}<ul><li>[[Iron Nugget|Iron Nugget]]<br/>{{About|the nugget|the ore|Iron Ore|the item|Iron Ingot|the mineral block|Block of Iron}}
{{Item
| image = Iron Nugget.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Iron nuggets''' are pieces of iron that can be obtained by [[smelting]] iron [[tools]]/[[Sword|weapons]] or iron/chainmail [[armor]]. One iron nugget is worth one-ninth of an [[iron ingot]].

== Obtaining ==

=== Crafting ===

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

=== Smelting ===

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

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

=== Chest loot ===

{{LootChestItem|iron-nugget}}

== Usage ==

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

=== Crafting ingredient ===

{{crafting usage}}

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

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

== History ==

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

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

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

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

== Issues ==
{{issue list}}

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

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

== References ==
{{Reflist}}

{{Items}}

[[de:Eisenklumpen]]
[[fr:Pépite de fer]]
[[ja:鉄塊]]
[[ko:철 조각]]
[[nl:IJzerklompje]]
[[pl:Bryłka żelaza]]
[[pt:Pepita de ferro]]
[[ru:Кусочек железа]]
[[uk:Залізний самородок]]
[[zh:铁粒]]
[[Category:Renewable resources]]</li><li>[[Sweet Berries|Sweet Berries]]<br/>{{Block
| title = Sweet Berries
| image = <gallery>
Sweet Berry Bush Age 0.png| Age 0
Sweet Berry Bush Age 1.png| Age 1
Sweet Berry Bush Age 2.png| Age 2
Sweet Berry Bush Age 3.png| Age 3
</gallery>
| image2 = Sweet Berries JE1 BE1.png
| transparent = Yes
| light = No
| tool = Any
| renewable = Yes
| stackable = Yes (64)
| heals = {{hunger|2}}
| flammable = Yes (60 java, 30 bedrock)
| lavasusceptible = No
}}

'''Sweet berries''' are a [[food]] [[item]] obtained from sweet berry bushes and are used to plant them.

'''Sweet berry bushes''' are quick-growing, [[Bone Meal|bonemealable]] [[Plant|plants]] that grow sweet berries, and damage and slow [[Player|players]] and most [[Mob|mobs]] moving through them. They can be found naturally in [[taiga]] and [[Snowy Taiga|snowy taiga]] biomes.

== Obtaining ==

=== Breaking ===
{{See also|Fortune#Discrete random}}
Sweet berry bushes can be mined instantly with any tool or by hand. A mature sweet berry bush yields 2–3 sweet berries. On its third growth stage, it yields 1–2 sweet berries. Each level of [[Fortune]] can increase the amount of drops by 1.

{{IN|ps4}}, the sweet berries drop into the player's inventory. In other editions, they drop on the ground.

=== Natural generation ===
Berry bushes commonly generate in [[taiga]] and [[snowy taiga]] biomes. Each [[chunk]] has {{frac|1|12}} chance to generate sweet berry bushes in [[random patch]]es. They also generate in both [[old growth pine taiga]] and [[old growth spruce taiga]].

=== Chest loot ===
{{LootChestItem|sweet-berries}}

=== Post-generation ===
Sweet berries can be collected from a sweet berry bush by {{control|using}} or {{control|breaking}} it, which yield 1–2 sweet berries in its third growth stage, and 2–3 sweet berries in its final growth stage.

== Usage ==
=== Placement ===
Placing [[sweet berries]] on a [[grass block]], [[dirt]], [[podzol]], [[coarse dirt]], [[farmland]]{{Only|Java}}, or [[moss block]] creates a small sweet berry bush that eventually becomes a fully grown sweet berry bush.

=== Growth ===
A sweet berry bush grows through four stages after it is planted. Its first growth stage is a small bush without any berries. It becomes a grown plant in its second stage, and produces berries in its third and fourth growth stage. The bush needs to be in light level 9 or greater to grow. {{control|Using}} [[bone meal]] on it increases its growth stage by one, and at full maturity, ejects the sweet berry item. The bush can be placed on a 1 block high space, but it cannot grow with a full, non-transparent block immediately above it.

=== Food ===

To eat sweet berries, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|2}} [[hunger]] and 0.4{{only|je|short=1}} / 1.2{{only|be|short=1}} hunger [[saturation]].

=== Composting ===
Placing sweet berries into a [[composter]] has a 30% chance of raising the compost level by 1.

=== Breeding ===
Sweet berries can be fed to [[fox]]es to [[breeding|breed]] them. Foxes are similar to cats when being fed as a wild animal; a sudden movement by the [[player]] may cause the fox to flee even if the player holds sweet berries. A baby fox bred by a [[player]] trusts the player and does not flee.

=== Trading ===
Master-level butcher [[villager]]s offer to [[trading|buy]] 10 sweet berries for an [[emerald]].

=== Entity movement ===

A sweet berry bush (at any stage) slows down all [[entity|entities]] (except [[Item (entity)|items]]) passing through it. At stage 1 and higher, it causes damage. [[Fox]]es are immune to both characteristics, however. Sweet berry bushes deal {{hp|1}} [[damage]] every 0.5 seconds, only if the entity is moving in the hitbox of the bush. Entities that move through sweet berry bushes slow down to about 34.05% of their normal speed, similar to how a [[cobweb]] slows down mobs to 15% of normal speed. This makes it impossible to jump a full [[block]] while inside the bush.

Mobs at standard block height in a [[minecart]] are not damaged when the minecart is pushed through sweet berries. Players in a sweet berry bush take no damage except from horizontal movement, but are unable to jump out of the bush, similar to a cobweb.

=== Bees ===
[[Bee]]s pollinate sweet berry bushes, and then increase the honey level in [[beehive]]s and bee nests by 1.{{only|java}}

== Sounds ==
=== Generic ===
==== Block ====
{{Sound table/Block/Sweet berry bush}}
==== Item ====
{{Sound table/Entity/Food}}
=== Unique ===
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|subtitle=Berries pop
|source=block
|description=When sweet berries are picked by a player
|id=block.sweet_berry_bush.pick_berries
|translationkey=subtitles.item.berries.pick
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|subtitle=Berries pop
|source=block
|description=When sweet berries are picked by a fox
|id=block.sweet_berry_bush.pick_berries
|translationkey=subtitles.item.berries.pick
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Player hurt sweet berry bush1.ogg
|sound2=Player hurt sweet berry bush2.ogg
|subtitle=Player hurts
|source=player
|description=When a player is damaged by touching a sweet berry bush
|id=entity.player.hurt_sweet_berry_bush
|translationkey=subtitles.entity.player.hurt
|volume=1.0
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|source=block
|description=When sweet berries are picked
|id=block.sweet_berry_bush.pick
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Player hurt sweet berry bush1.ogg
|sound2=Player hurt sweet berry bush2.ogg
|source=block
|description=When a player is damaged by touching a sweet berry bush
|id=block.sweet_berry_bush.hurt
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Sweet Berry Bush
|spritetype=block
|nameid=sweet_berry_bush
|blocktags=azalea_log_replaceable, bee_growables
|form=block}}
{{ID table
|displayname=Sweet Berries
|spritetype=item
|nameid=sweet_berries
|itemtags=fox_food
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Sweet Berry Bush
|spritetype=block
|nameid=sweet_berry_bush
|id=462
|form=block}}
{{ID table
|displayname=Sweet Berries
|spritetype=item
|nameid=sweet_berries
|id=287
|form=item
|foot=1}}

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

==Advancements==
{{Load advancements|Husbandry;A Balanced Diet;The Parrots and the Bats;Two by Two}}

== History ==
{{History||September 26, 2018|link={{tweet|minecraft|1044587405779451906}}|Berries are announced to be part of the [[biome]] vote at [[MINECON Earth 2018]].}}
{{History||September 29, 2018|link={{tweet|minecraft|1046097775199498245}}|[[Taiga]] wins the [[biome]] vote, meaning berries are to be added to the game first.}}

{{History|java}}
{{History||December 3, 2018|link={{tweet|cojomax99|1069586461173919745}}|[[Cojomax99]] tweets an image of some berries.}}
{{History||1.14|snap=18w49a|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes.|
[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries.}}
{{History|||snap=18w50a|Sweet berries can now be found within [[taiga]] [[village]] loot [[chest]]s.}}
{{History|||snap=19w03a|Placing a sweet berry into the new [[composter]] has a 10% chance of raising the compost level by 1.
|Added [[sound]]s for sweet berry bushes.}}
{{History|||snap=19w05a|Sweet berries now have a 30% chance of increasing the compost level in a composter by 1.
|The [[sound]] for planting sweet berries has been changed.}}
{{History|||snap=19w07a|Sweet berries can now be fed to [[fox]]es to [[breeding|breed]] them.}}
{{History|||snap=19w11a|Butcher [[villager]]s now [[trading|buy]] sweet berries.}}
{{History||1.15|snap=19w34a|[[Bee]]s can now pollinate sweet berry bushes.}}
{{History|||snap=Pre-Release 2|Sweet berries now generate in [[giant tree taiga]] biomes.}}
{{History||1.16|snap=Pre-release 1|Sweet berry bushes no longer prevent mob spawning inside them.}}
{{History||1.17|snap=21w20a|The sound event for picking berries has been changed as to align better with that of glow berries.<ref>{{bug|MC-220063}}</ref>}}
{{History||1.18|snap=1.18-pre5|Sweet berry bushes in taigas are about 4 times more common than in previous snapshots.}}

{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries, which are available only through Experimental Gameplay.|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes, available only through Experimental Gameplay.}}
{{History||1.11.0|snap=beta 1.11.0.1|Sweet berries can now be used to fill [[composter]]s.}}
{{History|||snap=beta 1.11.0.3|Sweet berries and sweet berry bushes have been fully implemented and are now separate from Experimental Gameplay.}}
{{History|||snap=beta 1.11.0.4|Sweet berries can now be [[trading|sold]] to butcher [[villager]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Sweet berries can now be fed to [[fox]]es to [[breeding|breed]] them.}}
{{History||1.14.0|snap=beta 1.14.0.1|[[Bee]]s can now pollinate sweet berry bushes.}}
{{History||1.16.100|snap=beta 1.16.100.54|Sweet berry bushes now properly damage entities.<ref>{{Bug|MCPE-56142}}</ref>}}
{{History||1.17.0|snap=beta 1.17.0.56|Bees no longer gather nectar from sweet berry bushes.}}

{{History|PS4}}
{{History||1.91|[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries.|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes.}}
{{History|foot}}

=== Sweet berry bush "item" ===
{{:Technical blocks/Sweet Berry Bush}}

== Issues ==
{{issue list|berry|berries|sweet berry|sweet berries|berry bush|sweet berry bush}}

==Trivia==
* {{IN|java}}, sweet berry bushes absorb [[fall damage]] like [[water]].<ref>{{bug|MC-149990|||WAI}}</ref>
* Foxes harvest mature sweet berry bushes that have grown into their third or fourth stage. Unlike how carrots eaten by rabbits are destroyed and not dropped as items, sweet berry bushes harvested by foxes drop as items, although the fox may pick up one of the dropped berries. The bush remains intact, allowing for automatic sweet berry farms.

== Gallery ==
<gallery>
Berry Bush.png|A close-up look of a sweet berry bush.
Naturally generated berry bushes.png|A naturally generated sweet berry bush.
Multiplebushes.png|Multiple bushes of sweet berries in Taiga biome.
BerryBushCloseToRavine.png|A berry bush that is close to a ravine.
Cozy Cabin Berries.jpg|Berry bushes near a cozy cabin.
</gallery>

==References==
{{Reflist}}

{{Blocks|vegetation}}
{{Items}}

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

[[cs:Sladké bobule]]
[[es:Bayas dulces]]
[[de:Süßbeeren]]
[[fr:Baies sucrées]]
[[ja:スイートベリー]]
[[ko:달콤한 열매]]
[[pl:Słodkie jagody]]
[[pt:Bagas doces]]
[[ru:Сладкие ягоды]]
[[th:เบอร์รีหวาน]]
[[zh:甜浆果]]</li></ul>
September 28, 2011Notch works on "saving arbitrary data with item instances."
1.12
{{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>[[Prismarine Shard|Prismarine Shard]]<br/>{{Item
| renewable =  Yes
| stackable = Yes (64)
| type =
}}
A '''prismarine shard''' is an item obtained by defeating [[guardian]]s or [[elder guardian]]s. It can be used to craft various [[prismarine]] blocks as well as [[sea lantern]]s.

== Obtaining ==

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

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

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

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

== History ==

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

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

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

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

== Issues ==

{{issue list}}

{{items}}

[[de:Prismarinscherbe]]
[[es:Fragmento de prismarina]]
[[fr:Éclat de prismarine]]
[[ja:プリズマリンの欠片]]
[[ko:프리즈머린 조각]]
[[nl:Prismarienscherf]]
[[pl:Odłamek pryzmarynu]]
[[pt:Pedaço de prismarinho]]
[[ru:Призмариновый осколок]]
[[uk:Призмариновий уламок]]
[[zh:海晶碎片]]
[[Category:Renewable resources]]</li></ul>
?Added long array tags.
1.13
{{Extension DPL}}<ul><li>[[Green Dye|Green Dye]]<br/>{{redirect|Cactus Green|the plant|Cactus}}{{Item
| title = Green Dye
| renewable = Yes
| stackable = Yes (64)
}}
'''Green dye''' is a [[primary color dye]].

== Obtaining ==

=== Chest loot ===
{{LootChestItem|green-dye}}

=== Smelting ===
{{Smelting
|head=1
|showdescription=1
|Cactus
|Green Dye
|1
|description={{only|Java}}<ref>{{bug|MC-210211||Smelting cactus gives too much experience since 1.13}}</ref>
}}
{{Smelting
|head=0
|showdescription=1
|Cactus
|Green Dye
|0,2
|description={{only|Bedrock}}
|foot=1
}}

=== Trading ===

[[Wandering trader]]s sell 3 green dye for an [[emerald]].

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===
Expert level shepherd villagers have {{frac|1|6}} chance to buy 12 green dye for an emerald.{{only|bedrock}} Expert level shepherds have a {{frac|2|7}} chance to buy 12 green dye for 1 emerald.{{only|java}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Green Dye
|spritetype=item
|nameid=green_dye
|aliasid=dye / 2
|id=397
|form=item
|translationkey=item.dye.green.name
|foot=1}}

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

== History ==

{{History|java beta}}
{{History||1.2|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green, together with all other dyes.}}
{{History|java}}
{{History||1.3.1|snap=1.3|[[File:Green Dye JE2 BE2.png|32px]] The texture of cactus green has been changed.}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Cactus green can be crafted with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be [[crafting|crafted]].}}
{{History||1.7.2|snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Cactus green can now be used to craft green [[concrete powder]].}}
{{History||1.12|snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|"Cactus Green" has been renamed to "Green Dye".
|[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}}
{{History|||snap=18w44a|Green dye can now change the text color on [[sign]]s to green.}}
{{History|||snap=18w50a|Green dye can now be found in [[chest]]s in [[desert]] [[village]] houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells green dye.}}
{{History|||snap=19w11a|Green dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Green dye can now be used to craft [[green candle]]s.}}
{{History|||snap=21w19a|Green dye can no longer be used to craft green candles.}}
{{History|||snap=Pre-release 1|Green dye can once again be used to craft green candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Green dye can now change the text color on [[hanging sign]]s to green.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green. It is currently unobtainable and has no usage.}}
{{History||v0.3.2|Cactus green is now obtainable by [[smelting]] cacti in a [[furnace]]. It still has no usage.}}
{{History||v0.4.0|Cactus green can now be used to craft [[cyan dye]], [[lime dye]], and [[green wool]].}}
{{History||v0.8.0|snap=build 1|[[File:Green Dye JE2 BE2.png|32px]] The texture of cactus green has been changed.}}
{{History||v0.14.0|snap=build 1|Cactus green can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Cactus green can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Cactus green can now be used to dye [[bed]]s, [[shulker box]]es, and craft [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Cactus green can now be used to craft [[stained glass]], patterns on [[banner]]s, and [[firework star]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Cactus green can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.10|"Cactus Green" has been renamed to "Green Dye".}}
{{History||1.10.0|snap=beta 1.10.0.3|Green dye is now sold by [[wandering trader]]s.
|[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Green dye can now be found in [[desert]] [[village]] house [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Green dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of green dye has been changed from <code>dye/2</code> to <code>green_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green.}}
{{History|PS4}}
{{History||1.83|"Cactus Green" has been renamed to "Green Dye".}}
{{History||1.90|[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

[[cs:Kaktusová zeleň]]
[[de:Grüner Farbstoff]]
[[es:Tinte verde]]
[[fr:Teinture verte]]
[[hu:Kaktuszzöld]]
[[ja:緑色の染料]]
[[ko:초록색 염료]]
[[nl:Cactusgroen]]
[[pl:Zielony barwnik]]
[[pt:Corante verde]]
[[ru:Зелёный краситель]]

[[Category:Items]]
[[Category:Dyes]]
[[Category:Renewable resources]]</li><li>[[Gunpowder|Gunpowder]]<br/>{{Item
| image = Gunpowder.png
| stackable = Yes (64)
| renewable = Yes
}}

'''Gunpowder''' is an item that is used for [[explosion]]-related recipes, and as an ingredient in potions.

== Obtaining ==

=== Mob loot ===

==== Creepers ====

[[Creeper]]s can drop 0-2 pieces of gunpowder upon death. [[Looting]] can increase this by one per level, with a maximum of 5 gunpowder.

==== Ghasts ====

[[Ghast]]s can drop 0-2 pieces of gunpowder upon death. Looting can increase this by one per level, with a maximum of 5 gunpowder.

==== Witches ====

[[Witch]]es can drop 0-6 pieces of gunpowder upon death. Looting can increase this by three per level, with a maximum of 15 gunpowder.
<!--
=== Crafting ===

{{Crafting
|showdescription=1
|description= {{only|bedrock|education}}
|Coal; Charcoal
|Sulfur
|Bone Meal
|Output= Gunpowder, 3
|type= Miscellaneous
}}
-->
=== Trading ===

<!--Wandering trader always offer one of the 5 item (one of them is gunpowder)-->

[[Wandering trader]]s have {{frac|1|6}} chance to sell gunpowder for an [[emerald]].

=== Chest loot ===

{{LootChestItem|gunpowder}}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Brewing ingredient ===
{{brewing
  |name=[[Splash Potion]]
  |showname=1
  |Gunpowder
  |Splash Mundane Potion; Splash Potion of Healing; Splash Potion of Fire Resistance; Splash Potion of Harming; Splash Potion of Poison; Splash Potion of Regeneration; Splash Potion of Slowness; Splash Potion of Strength; Splash Potion of Swiftness; Splash Potion of Weakness; Splash Potion of Night Vision; Splash Potion of Invisibility; Splash Potion of Water Breathing; Splash Potion of Leaping
  |base=Any Potion
}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gunpowder
|spritetype=item
|nameid=gunpowder
|id=328
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100130|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.
|Gunpowder is a [[crafting]] ingredient for [[TNT]]. 
|Gunpowder can be [[drops|dropped]] by any [[mob]].}}
{{History||20100219|Gunpowder now [[drops]] only from [[creeper]]s.}}
{{History|java infdev}}
{{History||20100625-2|Gunpowder can now be found in [[dungeon]] [[chest]]s.}}
{{History|java alpha}}
{{History||v1.2.0|snap=preview|Added [[ghast]]s, which [[drops|drop]] gunpowder upon [[death]].{{needs testing|was their gunpowder dropping present in the preview version, or added later on?|type=untestable}}}}
{{History|java beta}}
{{History||1.0|The item now has a display name: ''Sulphur''.}}
{{History||1.3|''Sulphur'' has been renamed to ''Gunpowder''.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 4|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||1.2.1|snap=12w04a|[[Fire charge]]s are now [[crafting|crafted]] with gunpowder.}}
{{History||1.4.2|snap=12w38b|[[Witch]]es may now [[drops|drop]] gunpowder.}}
{{History||1.4.6|snap=12w49a|Gunpowder can now be used to craft a [[firework star]] and a [[firework rocket]].}}
{{History||1.9|snap=15w44a|Gunpowder now generates in [[desert temple]] [[chest]]s.
|The average yield of gunpowder in [[dungeon]] chests has now doubled.}}
{{History||1.11|snap=16w39a|Gunpowder can now be found in [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 289.}}
{{History|||snap=18w11a|Gunpowder can now generate in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History|||snap=19w05a|Added [[wandering trader]]s, which sell gunpowder.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}
{{History||1.20|snap=23w12a|The probability for the gunpowder to generate in [[suspicious sand]] in [[desert temple]]s has been changed from 1/7 to 1/8.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.3|Gunpowder now drops from [[creeper]]s. It is still unobtainable due to creepers not yet spawning naturally.}}
{{History||v0.4.0|Creepers now spawn naturally, making gunpowder obtainable in Survival mode.
|Gunpowder can now be used to craft [[TNT]].}}
{{History||v0.12.1|snap=build 1|Added gunpowder to the [[creative]] [[inventory]].
|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||v0.13.0|snap=build 1|Gunpowder can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.14.0|snap=build 1|Gunpowder can now be dropped by [[witch]]es.}}
{{History||v0.15.0|snap=build 1|Gunpowder can now be used to craft [[fire charge]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gunpowder now generates inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gunpowder can now be used to craft [[firework rocket]]s and [[firework star]]s.}}
{{History||1.4.0|snap=beta 1.2.14.2|Gunpowder now generates inside [[shipwreck]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.}}
{{History|foot}}

== Issues ==
{{issue list}}

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--gunpowder Taking Inventory: Gunpowder] – Minecraft.net on June 21, 2019

{{Items}}

[[Category:Recipe using Charcoal]]

[[cs:Střelný prach]]
[[de:Schwarzpulver]]
[[es:Pólvora]]
[[fr:Poudre à canon]]
[[hu:Puskapor]]
[[it:Polvere da sparo]]
[[ja:火薬]]
[[ko:화약]]
[[nl:Buskruit]]
[[pl:Proch]]
[[pt:Pólvora]]
[[ru:Порох]]
[[th:ดินปืน]]
[[tr:Barut]]
[[uk:Порох]]
[[zh:火药]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li></ul>
18w01aAdded a data generator to both the Minecraft client and the default multiplayer software.
1.14
{{Extension DPL}}<ul><li>[[Raw Cod|Raw Cod]]<br/>{{about|the item|the mob|Cod}}
{{redirect|Raw Fish|raw salmon|Raw Salmon|pufferfish|Pufferfish (item)|tropical fish/clownfish|Tropical fish (item)}}
{{Item
| image = Raw Cod.png
| renewable = Yes
| heals = {{hunger|2}}
| stackable = Yes (64)
}}

'''Raw cod''' is a [[food]] item that can be eaten by the player or cooked to make [[cooked cod]].

== Obtaining ==

=== Mob loot ===

==== Cod ====
[[Cod]] always drops 1 raw cod when killed, unaffected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref> If it is killed while on [[fire]], it drops 1 [[cooked cod]] instead.

==== Dolphins ====
When killed, [[Dolphin|dolphins]] drop 0–1 raw cod. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 0-4 with Looting III. If killed while on fire, they drop cooked cod instead.

==== Guardians and elder guardians ====

[[Guardian]]s and [[elder guardian]]s have a 40% and 50% chance, respectively, to drop raw cod when killed. {{IN|java}}, cooked cod is dropped if a guardian is on fire when killed.

Guardians and elder guardians also have a 2.5% chance to drop a random fish, with 60% of them being raw cod, which drops as cooked if the guardian was on fire. The chance of getting the fish drop is increased by 1% per level with [[Looting]] (for a maximum of 5.5% with Looting III), but the type of fish is not affected.

==== Polar bears ====

[[Polar bear]]s have a 75% chance of dropping 0–2 raw cod when killed. The maximum amount can be increased by 1 per level of Looting, for a maximum of 0-5 with Looting III. If killed while on fire, they drop cooked cod instead.

=== Fishing ===
{{main|Fishing}}

Raw cod can be obtained from fishing. The wait time of one being caught is decreased with the [[Lure]] enchantment and the chance of one being caught is slightly decreased with the [[Luck of the Sea]] enchantment (named as such because it increases treasure, not fish).

Catching cod awards 1-6 experience.

=== Natural generation ===
{{el|java}}{{LootChestItem|raw-cod}}

=== Villager gifts ===
{{in|java}}, fisherman [[villager]]<nowiki/>s throw raw cod at [[player]]s under the [[Hero of the Village]] effect.

== Usage ==

=== Smelting ingredient ===

{{smelting
|Raw Cod
|Cooked Cod
|0.35
}}

=== Food ===

Raw cod restores {{hunger|2}} [[hunger]] and 0.4 [[Hunger#Mechanics|saturation]].

=== Cats ===

Raw cod can be used to tame [[cat]]s with {{frac|1|3}} chance of success, get cats off of [[chest]]s, and [[bed]]s, [[breed]] cats, and make baby cats grow up faster by 10% of the remaining time. Additionally, raw cod can be used to heal cats by {{hp|2|mob=1}}.

Raw cod can be used to gain [[ocelot]] trust, breed ocelots, and make baby ocelots grow up by 10%. 

=== Dolphins ===

[[Dolphin]]s can be fed raw cod. Doing this improves their trust and interaction with the player. However, unlike most animals, feeding dolphins does not allow them to breed.

When a player feeds raw cod to a dolphin, it swims toward the nearest chest in an [[underwater ruins]] or [[shipwreck]]. If the chest in the nearest structure is broken, they swim to the next nearest structure that has a chest.

===Trading===

Fisherman villagers have 50% chance to sell 6 cooked cod for 6 raw cod and 1 [[emerald]] as part of their first tier trade.

Apprentice-level fisherman villagers have a {{frac|2|3}} chance to buy 15 raw cod for an emerald in Java Edition, and always offer the same trade in Bedrock Edition.

=== Wolves ===
{{IN|bedrock}}, raw cod can be used to feed [[wolves]], to heal them by {{hp|2|mob=1}}. However, unlike other meat items, raw cod cannot be used to speed up the growth of baby wolves nor used to breed them, thus making it only feedable when wolves are not at full health.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Cod
|spritetype=item
|nameid=cod
|aliasid=fish
|id=264
|form=item
|translationkey=item.fish.name
|foot=1}}

== Achievements ==

{{load achievements|Delicious Fish;Lion Tamer;Echolocation}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet;Fishy Business;A Complete Catalogue}}

== History ==
{{History|java alpha}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish, which restores {{hp|2}}.}}
{{History|java beta}}
{{History||1.5|Cooking raw fish now gives the '''Delicious Fish''' [[achievement]].}}
{{History||1.8|snap=Pre-release|Raw fish is now stackable to 64 and fills {{hunger|2}} instead of {{hp|2}}.}}
{{History|java}}
{{History||1.2.1|snap=12w04a|Raw fish can now be fed to [[ocelot]]s to tame them into cats.}}
{{History||1.8|snap=14w02a|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|||snap=14w25a|Raw fish is now obtainable as a rare [[drops|drop]] from [[guardian]]s and [[elder guardian]]s.}}
{{History||1.10|snap=16w20a|Raw fish is now dropped from [[polar bear]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>fish</code> and <code>cooked_fish</code> IDs have been split up into their own IDs.
|"Raw Fish" has been renamed to "Raw Cod".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 349.}}
{{History|||snap=18w07a|Raw cod is now used to breed [[turtle]]s.}}
{{History|||snap=18w07b|Raw cod is no longer used to [[breeding|breed]] turtles. [[Seagrass]] is used instead.}}
{{History|||snap=18w08b|Cod, and other [[fish]], have been added as [[mob]]s, which drop their (raw) item form when killed.
|[[File:Raw Cod JE2 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w15a|Raw cod can now be used to feed [[dolphin]]s.
|Raw cod can now be obtained as a [[drops|drop]] from [[dolphin]]s.}}
{{History||1.14|snap=18w43a|[[File:Raw Cod JE3.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w47b|[[File:Raw Cod JE4 BE2.png|32px]] The previous texture change to raw cod has been reverted.}}
{{History|||snap=18w48a|Raw cod can now be found in chests in [[village]] fisher cottages.}}
{{History|||snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] raw cod.}}
{{History|||snap=19w13a|Fisherman villagers now give raw cod to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||v0.12.1|snap=build 1|Raw fish now restore [[hunger]] instead of [[health]].
|Raw fish can now be used to feed [[ocelot]]s to tame them into [[cat]]s.}}
{{History||v0.16.0|snap=build 1|Raw fish is now [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added [[polar bear]]s, which [[drops|drop]] raw fish.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[Cod]] and other [[fish]] have been added as [[mob]]s, which [[drops|drop]] their (raw) [[item]] form when killed.
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=beta 1.2.20.2|Raw cod is now [[drops|dropped]] by [[dolphin]]s and can be used to feed them.}}
{{History||1.5.0|snap=beta 1.5.0.0|Giving raw cod to [[dolphin]]s lead the [[player]] to the nearest [[underwater ruins]] or [[shipwreck]].}}
{{History||1.7.0|snap=beta 1.7.0.2|"Raw Fish" has been renamed to "Raw Cod".}}
{{History||1.8.0|snap=beta 1.8.0.8|Raw cod can no longer can be used to tame [[ocelot]]s.
|Raw cod can now be used to [[breeding|breed]] ocelots and increase baby ocelot growth speed.
|Added [[stray cat]]s, which can be tamed using raw cod.}}
{{History||1.11.0|snap=beta 1.11.0.4|Raw cod can be [[trading|sold]] to fisherman [[villager]]s.
|Fisherman villagers now have 50% chance to [[trading|sell]] 6 cooked cod for 6 raw cod and an [[emerald]] as part of their first tier [[trading|trade]].}} 

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||xbox=TU5|Raw fish is now stackable to 64.
|Raw fish now fills [[hunger]] instead of [[health]].}}
{{History||xbox=TU12|Raw fish can now be fed to [[ocelot]]s to tame them into [[cat]]s.}}
{{History||xbox=TU13|ps=1.0|Raw fish is no longer removed from the [[player]]'s [[inventory]] when trying to tame an [[ocelot]] in [[creative]] mode.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|"Raw Fish" has been renamed to "Raw Cod".
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History|foot}}

== Issues ==

{{issue list}}
== Trivia ==
[[File:Steve wearing Raw Cod.png|75px]] [[File:Alex wearing Raw Cod.png|75px]]

* While a raw cod cannot be equipped in the head slot in Survival mode, equipping it using the {{cmd|item}} command causes it to appear at the side of the player's head.

== See also ==
* [[Fishing]]

== References ==
{{reflist}}

{{items}}

[[de:Roher Kabeljau]]
[[es:Bacalao crudo]]
[[ja:生鱈]]
[[ko:생대구]]
[[pt:Bacalhau cru]]
[[ru:Сырая треска]]
[[zh:生鳕鱼]]
[[Category:Food]]
[[Category:Renewable resources]]</li><li>[[Water Bucket|Water Bucket]]<br/>{{Item
| title = Water Bucket
| renewable = Yes
| image = Water Bucket.png
| stackable = No
}}

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

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

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

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

=== Chest Loot ===

{{LootChestItem|water-bucket}}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

==Issues==
{{issue list}}

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

==References==
{{Reflist}}

{{Items}}

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

[[de:Wassereimer]]
[[ja:水入りバケツ]]
[[pt:Balde de água]]
[[th:ถังน้ำ]]
[[uk:Відро води]]
[[zh:水桶]]</li></ul></nowiki>
19w08a String tags can now be within single quotes ' besides double quotes ".[2]

References

  1. ↑ https://wiki.vg/Data_Generators#NBT_converters
  2. ↑ "Allow single quote in strings by boq · Pull Request #52" – Mojang/brigadier – GitHub.
Minecraft: Java Edition
Versions
Development
Version history
Technical
.minecraft
Development resources
Legacy development resources
Multiplayer
Game customization
Deutsch Français 日本語 Nederlands Português Русский 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki