This feature is exclusive to Java Edition.
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.
TAG definition
Add more columns [discuss]
This section might benefit of the addition of the "prefix and/or suffix in SNBT" column.
A tag is an individual part of the data tree. The first byte in a tag is the tag type (ID), followed by two bytes 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 12 known tags in version 19133 of the Named Binary Tag format:
| ID | Icon | Tag Type | Payload | Defined in commands | 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> or "<text>"
|
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
- level.dat is stored in compressed NBT format.
- <player>.dat files are stored in compressed NBT format.
- idcounts.dat is stored in uncompressed NBT format.
- villages.dat is stored in compressed NBT format.
- map_<#>.dat files are stored in compressed NBT format.
- servers.dat, which is used to store the list of saved multiplayer servers as uncompressed NBT.
- Chunks are stored in compressed NBT format within Region files.
- scoreboard.dat is stored in compressed NBT format.
- Generated structures are stored in compressed NBT format.
- Saved structures are stored in compressed NBT format.
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. Other than this, 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. | |
| MineBack Ultimate | 19133 | MineBack Ultimate provides a full NBT editor supporting all available types of NBT format file (Map, Level, World etc.). It comes with a modern GUI and many helper functions. | File:MineBackNBTEditor.png |
| 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. | |
| NBTEdit | 19132 | Allows for viewing and modifying NBT files via a Windows tree control. It is outdated not only from being an NBT version behind, but because it does not support multiple tags with the same name and it forces incorrect ranges on some types, and it lacks support for uncompressed NBT files. | File:NBTEdit Level.Dat.png |
| 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 |
| NBT grammar for Synalyze It! | 19132 | Using this grammar Synalyze It! displays a color-coded hex dump along with the parsed tag tree. Currently only uncompressed files are supported. | File:Synalyze-It-NBT-decoded.png |
| NEINedit | 19132 | NBT editor for mac with a text-based tree structure. | File:NEINedit.png |
| NBT2YAML | 19133 | nbt2yaml presents a command line interface for reading and editing Minecraft NBT files using a custom YAML format. It also includes a Python API for parsing and writing NBT files to/from a simple Python data structure. | |
| webNBT | 19133 | webNBT is an NBT-editor that runs in modern browsers without requiring the user to download an application or use third-party browser plugins (like Flash or Java). |
History
| Java Edition | |||||
|---|---|---|---|---|---|
1.0.0{{Extension DPL}}<ul><li>[[:Category:Tools|Category:Tools]]<br/>[[Category:Items]]
[[fr:Catégorie:Outil]]
[[it:Categoria:Attrezzi]]</li><li>[[Knowledge Book|Knowledge Book]]<br/>{{exclusive|java}}
{{Item
| image = Knowledge Book.png
| renewable = No
| stackable = No
| rarity = Epic
}}
A '''knowledge book''' is a utility item that reveals available [[crafting]] recipes to the player when {{control|used|use}}.
== Obtaining ==
Knowledge books can be obtained only by using [[commands]], as it is not found in the [[creative]] inventory; therefore, it is impossible to obtain in other modes such as [[survival]] and [[adventure]] except with commands.
For example, to give oneself a knowledge book that reveals the recipes for [[bucket]]s and [[flower pot]]s, use: {{cmd|give @s minecraft:knowledge_book{Recipes:["minecraft:bucket", "minecraft:flower_pot"]} }}.
== Usage ==
Knowledge books are used to reveal recipes to the player who uses it, by adding it to their [[recipe book]]. Using a knowledge book consumes it, removing it from the player's inventory.
Knowledge books are especially useful to mapmakers in conjunction with {{cmd|gamerule doLimitedCrafting true}}, because then any item is craftable only if its recipe is unlocked first.
== Sounds ==
{{Sound table
|sound=Chiseled bookshelf insert1.ogg
|sound2=Chiseled bookshelf insert2.ogg
|sound3=Chiseled bookshelf insert3.ogg
|sound4=Chiseled bookshelf insert4.ogg
|subtitle=Book placed
|source=block
|description=When a knowledge book is placed in a chiseled bookshelf
|id=block.chiseled_bookshelf.insert
|translationkey=subtitles.chiseled_bookshelf.insert
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.85, or 1.1 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Chiseled bookshelf pickup1.ogg
|sound2=Chiseled bookshelf pickup2.ogg
|sound3=Chiseled bookshelf pickup3.ogg
|subtitle=Book taken
|source=block
|description=When a knowledge book is removed from a chiseled bookshelf
|id=block.chiseled_bookshelf.pickup
|translationkey=subtitles.chiseled_bookshelf.take
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|distance=16
|foot=1}}
== Data values ==
=== ID ===
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Knowledge Book
|spritetype=item
|nameid=knowledge_book
|form=item
|foot=1}}
=== Item data ===
Recipe books use the NBT tag <code>Recipes</code> to indicate the recipes they contain.
''The following NBT structure is provided to show how the <code>Recipes</code> tag is organized, and is not comprehensive above the <code>tag</code> tag. The full NBT for an item can be found [[Chunk format#Items and XP Orbs|here]].''
<div class="treeview" style="margin-top: 0;">
* {{nbt|compound}} Entity data
** {{nbt|compound|Item}}: The item
*** {{nbt|compound|tag}}: Additional information about the item. This tag is optional for most items.
**** {{nbt|list|Recipes}}: The list of recipes this book contains.
***** {{nbt|string}} the name of a recipe, for instance <code>minecraft:gold_nugget</code> or <code>minecraft:gold_ingot_from_nuggets</code>
</div>
== History ==
{{History|java}}
{{History||1.12|snap=17w13a|[[File:Knowledge Book JE1.png|32px]] Added knowledge books.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 453.}}
{{History||1.14|snap=18w43a|[[File:Knowledge Book JE2.png|32px]] The texture of knowledge books has now been changed.}}
{{History||1.20|snap=1.20 Release Candidate 1|Knowledge books can now be placed in [[chiseled bookshelf|chiseled bookshelves]].}}
{{History|Foot}}
== Issues ==
{{Issue list}}
== See also ==
* [[Book]]
* [[Enchanted Book]]
* {{cmd|recipe}} command
{{Items}}
[[Category:Non-renewable resources]]
[[de:Buch des Wissens]]
[[es:Enciclopedia]]
[[fr:Livre des connaissances]]
[[ja:知恵の本]]
[[ko:지식의 책]]
[[lzh:天工開物]]
[[pl:Księga wiedzy]]
[[pt:Enciclopédia]]
[[ru:Книга знаний]]
[[zh:知识之书]]</li></ul> | September 28, 2011 | Notch works on "saving arbitrary data with item instances." | |||
1.12{{Extension DPL}}<ul><li>[[Firework Rocket|Firework Rocket]]<br/>{{redirect|Firework}}
{{ItemEntity
|image=Firework Rocket.png
|renewable='''Trail Effect'''：No<br>'''All Others'''：Yes
|stackable=Yes (64)
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
|networkid=76
}}
A '''firework rocket''' is an [[item]] (and [[entity]]) used for creating decorative explosions, boosting when flying with [[elytra]], and loading into a [[crossbow]] as ammunition.
== Obtaining ==
Fireworks can be obtained by crafting. {{IN|java}}, a firework with no explosion effect is available on the [[Creative]] inventory and can be crafted as shown below. {{IN|bedrock}}, fireworks with the different base colors or no explosion are available in the Creative inventory.
=== Crafting ===
{{Crafting
|head=1
|showname=0
|showdescription=1
|Paper
|; ; Gunpowder
|; Gunpowder; Gunpowder
|Gunpowder
|Output=Firework Rocket,3
|description=When crafted this way (without a firework star), the rocket does not have explosion effects. The value of gunpowder affects the [[Firework Rocket#Duration and direction|flight duration]].
|type=Miscellaneous
}}
{{Crafting
|Any Firework Star
|Paper
|; ; Gunpowder
|; Gunpowder; Gunpowder
|Gunpowder
|Output= Firework Rocket,3
|description=Adding more gunpowder increases the duration of the rocket. Up to three gunpowder can be used. Up to five firework stars can also be used with three gunpowder. Up to seven firework stars can be used by using firework stars instead of additional gunpowder. All firework stars explode almost simultaneously when the rocket detonates.
|type=Miscellaneous
|foot=1
}}
== Usage ==
=== Launching fireworks ===
To launch a firework rocket, {{control|use}} its item on a block. They can also be launched from [[dispenser]]s and [[crossbow]]s. If shot from a [[Multishot]] [[crossbow]], then 3 rockets fire with the same effects.
=== Elytra ===
{{control|Using}} a firework rocket while flying with [[elytra]] propels the player in the direction they are facing. The duration of the speed boost depends on the flight duration of the rocket. If the rocket is equipped with a firework star of any kind, the player takes damage when it explodes.
=== Crossbow ===
A firework rocket can be used as ammunition for [[crossbow]]s, although it deals [[damage]] only if it has an [[explosion]] effect. A higher flight duration gives the firework rocket a longer range, and more damage is added per firework star. The [[Piercing]] enchantment has no effect on firework rockets shot from a crossbow.
{{IN|java}}, if a firework rocket shot from a [[crossbow]] hits an [[entity]], the rocket instantly [[explosion|explodes]], no matter the flight duration. Attempting to do this {{in|bedrock}}, however, results in the firework passing through the entity,<ref>[[bugtracker:MCPE-52675|MCPE-52675]]</ref> so the [[player]] must plan where to aim.
== Behavior ==
{{see also|Firework Star#Effects}}
Once launched, fireworks fly out vertically, with random horizontal offset up to 5 blocks. {{IN|bedrock|java}}, fireworks can fly in any of the 6 directions a dispenser can point. After [[#Duration and direction|some time]], the firework explodes into a colorful explosion based on the effects of the [[firework star]]s added upon crafting, or no explosion if no firework star was used. If multiple firework stars were added to the rocket upon crafting, they all explode simultaneously.
The explosion of a firework rocket deals damage to mobs and players that are within 5 blocks and not obstructed by [[solid block]]s. The maximum damage of a rocket with one firework star is {{hp|7}}, with the damage decreasing with distance. Each additional firework star on the rocket adds {{hp|2}} points of damage, for a maximum damage of {{hp|19}} with 7 stars. Using commands to add additional firework stars results in more damage. The damage dealt is unaffected by any other ingredients used. The explosion does not destroy end crystals nor damage the Ender dragon, but does destroy armor stands.
There is a delay between the detonation and the player hearing the sound, emulating real fireworks, but this sound travels much more slowly than in the real world.<ref>{{Tweet|jeb|277075644804907009|However, no sound effects for fireworks yet... but everything's implemented, so they can be added without doing a new snapshot|December 7, 2012}}</ref><ref>{{Tweet|jeb|277075517226762242|Haha, @igblan , the speed of sound is 40 m/s, because the realistic speed of ~340 m/s didn't work well in Minecraft scale|December 7, 2012}}</ref> {{IN|java}}, the explosion of a firework can be seen 64 blocks away, regardless of its height. {{IN|bedrock}}, the explosion can be seen from your render distance.
If the explosion exceeds the (unmodded) [[particle]] limit of 16,384, the oldest particles are removed before displaying new ones, resulting in severely diminished firework quality / duration. At most a firework should have 3 trail stars, more than that could waste diamonds, firework stars, and other fireworks. Particle counts per star are:
{| class="wikitable" data-description="Particle counts per firework star"
|-
! Ball Type !! Plain !! Trail
|-
| Small || 98 || ~1300
|-
| Large || 387 || 4000+
|-
| Star || 122 || ~1600
|-
| Creeper || 266 || ~3500
|-
| Burst || 72 || ~930
|}
Twinkle effect adds 2 particles to the count.
Like most other entities, they can be moved by [[water]] and [[explosion]]s, and teleported via [[portal]]s. They also cannot move through solid surfaced blocks, upon hitting one, they either move to a side or explode based on the duration. If a firework explodes under a block, its explosion is flattened.
=== Duration and direction ===
Fireworks travel different heights based on the amount of gunpowder added. The number is displayed as a tag on the item's tooltip with the description of "Flight Duration".
The height it rises is between 8 and 20 blocks with 1 gunpowder, 18 to 34 blocks with 2 gunpowder, and 32 to 52 blocks with 3 gunpowder.
(Note: Using command blocks, firework rockets with higher durations go higher and keep accelerating with virtually no terminal velocity. If the duration is long enough, the firework rocket could reach heights of over 1,000,000 blocks and speeds of over 10,000 m/s in a matter of minutes. Such fireworks with significant X and Z motions speed up sideways exponentially and reach outside the world boundary in a matter of seconds.{{only|java}})
When spawned, <!-- server-side --> fireworks have a vertical speed of .05 and a random small X and Z speed (random value near zero with a standard deviation of .001). Each firework also determines its lifetime in ticks by 10 × (number of gunpowder + 1) + random value from 0 to 5 + random value from 0 to 6, after which it explodes. Each tick, the firework accelerates horizontally by multiplying its X and Z velocities by 1.15, and vertically by adding a constant factor of .04.
Fireworks can be made to travel different directions by being dispensed or launched under flowing water. The firework's direction combines with the flow of the water to go diagonally.
== Village Raids ==
After successfully defending a village from a [[Raid]] the villagers may celebrate by setting off firework rockets.
== Boosting elytra ==
Fireworks can be used to boost [[elytra]] when in flight. Normally, elytra can glide for a short distance, but with the use of fireworks, the player can fly a long distance, gain speed, and take off from the ground.
Simply using the firework rocket with elytra spread boosts the player in the direction the player faces. It can leave behind a trail sometimes.
Although fireworks with firework stars can be used, the player takes blast damage if they use it in flight.
There are four types of rockets, with three types of flight duration. Higher flight durations mean longer boosts. {{IN|bedrock}}, the fireworks obtained from the Creative menu have a flight duration of 1, while {{in|java}}, the fireworks obtained in the Creative menu have a flight duration of 1, 2, or 3.
== Sounds ==
{{Edition|Java}}:<br>
Firework rockets use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Firework blast.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a non-large firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.blast
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework blast far.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a non-large firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.blast_far
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework large blast.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a large firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.large_blast
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework large blast far.ogg
|subtitle=Firework blasts
|source=ambient
|description=When a large firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.large_blast_far
|translationkey=subtitles.entity.firework_rocket.blast
|volume=20.0
|pitch=0.95-1.05
|distance=16}}
{{Sound table
|sound=Firework twinkle.ogg
|subtitle=Firework twinkles
|source=ambient
|description=When a twinkle firework rocket explodes within a 16-block radius of the player
|id=entity.firework_rocket.twinkle
|translationkey=subtitles.entity.firework_rocket.twinkle
|volume=20.0
|pitch=0.9-1.05
|distance=16}}
{{Sound table
|sound=Firework twinkle far.ogg
|subtitle=Firework twinkles
|source=ambient
|description=When a twinkle firework rocket explodes greater than 16 blocks away from the player
|id=entity.firework_rocket.twinkle_far
|translationkey=subtitles.entity.firework_rocket.twinkle
|volume=20.0
|pitch=0.9-1.05
|distance=16}}
{{Sound table
|sound=Firework launch.ogg
|subtitle=Firework launches
|source=ambient
|description=When a dispenser shoots, a player uses, or a crossbow fires a firework rocket
|id=entity.firework_rocket.launch
|translationkey=subtitles.entity.firework_rocket.launch
|volume=3.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Firework launches
|source=neutral
|description=When a dispenser fires a firework rocket
|id=entity.firework_rocket.shoot
|translationkey=subtitles.entity.firework_rocket.launch
|volume=1.0
|pitch=1.2
|distance=16
|foot=1}}
{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Firework blast.ogg
|source=ambient
|description=When a non-large firework rocket explodes
|id=firework.blast
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework large blast.ogg
|source=ambient
|description=When a large firework rocket explodes
|id=firework.large_blast
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework twinkle.ogg
|source=ambient
|description=When a twinkle firework rocket explodes
|id=firework.twinkle
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Firework launch.ogg
|source=ambient
|description=When a dispenser shoots, a player uses, or a crossbow fires a firework rocket
|id=firework.launch
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bow shoot.ogg
|source=ambient
|description=''Unused sound event''
|id=firework.shoot
|volume=1.0
|pitch=1.0
|foot=1}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=item
|nameid=firework_rocket
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=entity
|nameid=firework_rocket
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=item
|nameid=firework_rocket
|aliasid=fireworks
|id=519
|form=item
|translationkey=item.fireworks.name
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Firework Rocket
|spritetype=entity
|nameid=fireworks_rocket
|id=72
|foot=1}}
=== Item data ===
{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Firework Rockets}}
</div>
{{el|bedrock}}:
: See [[Bedrock Edition level format/Item format]].
=== Entity data ===
{{el|java}}:
{{main|Entity format}}
{{/ED}}
{{el|bedrock}}:
: See [[Bedrock Edition level format/Entity format]].
== Advancements ==
{{load advancements|Bullseye;Ol' Betsy}}
== History ==
{{History|java}}
{{History||November 24, 2012|link=none|[[Jeb]] stated that there may be fireworks in ''Minecraft'' at the ''Future Updates with the Minecraft PC Team'' panel at [[MINECON 2012]].}}
{{History||December 5, 2012|link={{tweet|jeb|276367442362630144}}|Jeb released the first image of fireworks, along with the information that colors, fade, height, effects and shapes are [[crafting|craftable]].}}
{{History||December 7, 2012|link=https://twitter.com/jeb_/status/277075087503536128|Jeb mentions that fireworks should probably scare [[wolves]] and potentially have other effects on mobs.}}
{{History||1.4.6|snap=12w49a|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets.
|Firework rockets cannot be obtained within the [[Creative inventory]].}}
{{History|||snap=12w50a|Added [[sound]] and more effects to firework rockets.}}
{{History||1.10|snap=16w20a|The firework rocket [[crafting]] recipe now produces 3 rockets, rather than 1.}}
{{History||1.11|snap=16w32a|The entity ID has been changed from <code>FireworksRocketEntity</code> to <code>fireworks_rocket</code>.}}
{{History||1.11.1|snap=16w50a|Firework rockets can now cause [[damage]] to [[entity|entities]] that are within their [[explosion]] radius.
|Firework rockets can now boost [[player]]s while flying with [[elytra]].}}
{{History||1.13|snap=17w47a|The ID has been changed from <code>fireworks</code> to <code>firework_rocket</code>.
|The fade effects on fireworks can now be added by combining the firework star with [[dye]]s.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 401.}}
{{History||1.13|snap=?|Firework rockets are now available in the [[Creative]] [[Inventory]]. However, it does not show a flight duration}}
{{History|||snap=pre5|The [[entity]] ID of firework rockets has been changed to <code>firework_rocket</code>.}}
{{History||1.14|snap=18w43a|Fireworks can now be shot from [[crossbow]]s.
|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History||1.15|snap=19w36a|Firework rockets dispensed from a [[dispenser]] now travel in the direction they were fired.}}
{{History||1.17|snap=20w45a|Simple firework rockets with one gunpowder can now be crafted using the [[recipe book]].}}
{{History||1.19.3|snap=22w45a|All three flight durations of firework rockets are now available in the Creative inventory.<ref>{{bug
|MC-194390||A firework rocket from the creative inventory doesn't show a flight duration|Fixed}}</ref>}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets.
|Firework rockets are available in the Creative inventory in 17 variants, sixteen colors in small ball duration 1, plus one additional preset with only duration 1.{{verify|type=update|Is this the right snapshot?}}{{info needed}}}}
{{History||1.8.0|snap=beta 1.8.0.10|Firework rockets can now be held in the off-hand and be shot from [[crossbow]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of firework rockets has been changed from <code>fireworks</code> to <code>firework_rocket</code>.}}
{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Firework Rocket JE1 BE1.png|32px]] Added firework rockets.
|Firework rockets are available in five types in the Creative inventory. The presets are as follows:
* Duration 1, small ball, light blue, twinkle
* Duration 2, creeper shaped, green
* Duration 2, burst, red, fade to orange
* Duration 3, burst, magenta, fade to blue, twinkle
* Duration 2, star shaped, yellow, fade to orange, trail}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The crafting interface has been updated to allow crafting [[firework star]]s and fireworks.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Firework rockets can now boost [[player]]s while flying with [[elytra]].}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Firework rockets now [[damage]] players if there is a [[firework star]] applicated to the firework rocket.}}
{{History||xbox=TU56|xbone=CU47|ps=1.55|wiiu=Patch 26|switch=1.0.6|Firework rockets now produce 3 rockets upon [[crafting]] them instead of 1.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|Added new firework rocket models.}}
{{History|PS4}}
{{History||1.90|[[File:Firework Rocket JE2 BE2.png|32px]] The texture of firework rockets has been changed.}}
{{History|foot}}
== Issues ==
{{issue list}}
== Trivia ==
* Launching a rocket by hand on a wooden [[pressure plate]] activates it. The same doesn't hold for stone pressure plates, or for a [[dispenser]] placing a rocket onto a wooden pressure plate.
* New Year's Eve is what inspired [[Jeb]] to add fireworks.<ref>{{tweet|jeb|277080498814189568|@SPvs_TheWorld New Year's Eve|December 7, 2012}}</ref>
* If the player shoots a firework into a [[Nether portal]], it explodes in [[the Nether]].
* There are around 2×10{{^|136}} distinct fireworks.
== Gallery ==
<gallery>
File:Firework jeb twitter.jpg|[[Jeb]]'s first image of Fireworks, also showing that they can be shot from dispensers.
File:1.4.6 release image.png|1.4.6 Release image.
File:Flatexplosion.png|An example of a flattened firework explosion.
File:Creeper firework.png|Creeper face shaped firework.
</gallery>
== References ==
{{Reflist}}
{{Items}}
{{Entities}}
[[cs:Rachejtle]]
[[de:Feuerwerksrakete]]
[[es:Cohete de fuegos artificiales]]
[[fr:Feu d'artifice]]
[[hu:Tűzijáték rakéta]]
[[ja:ロケット花火]]
[[ko:폭죽 로켓]]
[[nl:Vuurpijl]]
[[pl:Fajerwerk]]
[[pt:Fogo de artifício]]
[[ru:Пиротехническая ракета]]
[[th:ดอกไม้ไฟ]]
[[zh:烟花火箭]]
[[Category:Renewable resources]]</li><li>[[Brush|Brush]]<br/>{{Item
|image=Brush.png
|rarity=Common
|renewable=Yes
|durability=64
|stackable=No
}}
A '''brush''' is a [[tool]] used in [[archaeology]] to excavate [[suspicious block]]s for different items.
==Obtaining==
===Crafting===
{{Crafting
|head=1
|showname=0
|showdescription=1
|B1=Feather
|B2=Copper Ingot
|B3=Stick
|Output=Brush
|type=Tool
}}
{{crafting
|foot=1
|ignoreusage=1
|Damaged Brush
|Damaged Brush
|Output=Brush
|description=The durability of the two brushes is added together, plus an extra 5% durability.
|type=Tool
}}
==Usage==
{{Main|Suspicious Block}}
{{Control|Using}} the brush on any block displays a brushing animation, slowing down the player and creating breaking [[particles]], but not actually damaging the block or brush. When continuously brushing a [[suspicious block]], a random item slowly emerges from it until it drops out, and the block turns into regular [[sand]] or regular [[gravel]], depleting 1 [[durability]] point on the brush. It takes 96 [[game tick]]s (4.8 seconds) to brush a single suspicious block.
=== Enchantments ===
A brush can receive the following [[enchantment]]s:
{|class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Anvil}}
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|}
== Sounds ==
{{Edition|Java}}:
{{Sound table
<!--All of these sounds are, in fact, different-->
|sound=Brushing sand1.ogg
|sound2=Brushing sand2.ogg
|sound3=Brushing sand3.ogg
|sound4=Brushing sand4.ogg
|subtitle=Brushing Sand
|source=block
|description=While a brush is brushing suspicious sand
|id=item.brush.brushing.sand
|translationkey=subtitles.item.brush.brushing.sand
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing gravel1.ogg
|sound2=Brushing gravel2.ogg
|sound3=Brushing gravel3.ogg
|sound4=Brushing gravel4.ogg
|subtitle=Brushing Gravel
|source=block
|description=While a brush is brushing suspicious gravel
|id=item.brush.brushing.gravel
|translationkey=subtitles.item.brush.brushing.gravel
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing generic1.ogg
|sound2=Brushing generic2.ogg
|sound3=Brushing generic3.ogg
|sound4=Brushing generic4.ogg
|subtitle=Brushing
|source=block
|description=While a brush is brushing any other block
|id=item.brush.brushing.generic
|translationkey=subtitles.item.brush.brushing.generic
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing sand completed1.ogg
|sound2=Brushing sand completed2.ogg
|sound3=Brushing sand completed3.ogg
|sound4=Brushing sand completed4.ogg
|sound5=Brushing sand completed5.ogg
|subtitle=Brushing Sand completed
|source=Players<ref group=sound name=badsource>{{Bug|MC-260202}}</ref>|overridesource=1
|description=When a brush finishes brushing suspicious sand
|id=item.brush.brushing.sand.complete
|translationkey=subtitles.item.brush.brushing.sand.complete
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Brushing gravel completed1.ogg
|sound2=Brushing gravel completed2.ogg
|sound3=Brushing gravel completed3.ogg
|sound4=Brushing gravel completed4.ogg
|subtitle=Brushing Gravel completed
|source=Players<ref group=sound name=badsource/>|overridesource=1
|description=When a brush finishes brushing suspicious gravel
|id=item.brush.brushing.gravel.complete
|translationkey=subtitles.item.brush.brushing.gravel.complete
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}
{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Brushing sand1.ogg
|sound2=Brushing sand2.ogg
|sound3=Brushing sand3.ogg
|sound4=Brushing sand4.ogg
|source=player
|description=While a brush is brushing suspicious sand
|id=brush.suspicious_sand
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing gravel1.ogg
|sound2=Brushing gravel2.ogg
|sound3=Brushing gravel3.ogg
|sound4=Brushing gravel4.ogg
|source=player
|description=While a brush is brushing suspicious gravel
|id=brush.suspicious_gravel
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing generic1.ogg
|sound2=Brushing generic2.ogg
|sound3=Brushing generic3.ogg
|sound4=Brushing generic4.ogg
|source=player
|description=While a brush is brushing any other block
|id=brush.generic
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing sand completed1.ogg
|sound2=Brushing sand completed2.ogg
|sound3=Brushing sand completed3.ogg
|sound4=Brushing sand completed4.ogg
|sound5=Brushing sand completed5.ogg
|source=player
|description=When a brush finishes brushing suspicious sand
|id=brush_completed.suspicious_sand
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing gravel completed1.ogg
|sound2=Brushing gravel completed2.ogg
|sound3=Brushing gravel completed3.ogg
|sound4=Brushing gravel completed4.ogg
|source=player
|description=When a brush finishes brushing suspicious gravel
|id=brush_completed.suspicious_gravel
|volume=1.0
|pitch=0.8-1.0
|foot=1}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Brush
|spritetype=item
|nameid=brush
|form=item
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Brush
|spritetype=item
|nameid=brush
|id=684
|form=item
|foot=1}}
== Advancements ==
{{load advancements|Respecting the Remnants}}
== History ==
{{History||October 3, 2020|link=https://youtu.be/DBvZ2Iqmm3M?t=2178|[[File:Brush (pre-release 1).png|32px]][[File:Brush 2.png|32px]] Brushes were announced at [[Minecraft Live 2020]] with two variants.}}
{{History||?|link=https://youtu.be/klP9SrJFDU8?t=206|[[File:Brush (pre-release 2).png|32px]] Changed the brush's item texture.}}
{{History||February 10, 2023|[[File:Brush JE1 BE1.png|32px]] [[Sofia Dankis]] posted an article about upcoming archaeology features, including brushes.|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:Brush JE1 BE1.png|32px]] Added brushes with an updated texture behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].|The crafting recipe was originally three [[string]] and two [[stick]]s.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|A1 = String
|B1 = String
|C1 = String
|B2 = Stick
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History|||snap=1.19.4 Pre-release 1|The crafting recipe for brushes has been changed:
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|B1 = Feather
|B2 = Copper Ingot
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||1.20|snap=23w12a|Brushes are now available without using the "Update 1.20" experimental data pack.
|Brushes can now brush [[suspicious gravel]].}}
{{History|||snap=23w14a|The brushing sound of brush is now controlled by the "Blocks" sound slider instead of the "Players" sound slider.}}
{{History|||snap=23w17a|The player now gets the [[advancement]] "Respecting the Remnants" when they use a brush on a [[suspicious block]] to obtain a [[pottery sherd]].}}
{{History|bedrock}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|[[File:Brush JE1 BE1.png|32px]] Added brushes behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.
|The crafting recipe is originally three [[string]] and two [[stick]]s.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|A1 = String
|B1 = String
|C1 = String
|B2 = Stick
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|The crafting recipe for brushes has been changed:
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|B1 = Feather
|B2 = Copper Ingot
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||1.20.0|snap=beta 1.20.0.21|Brushes are now available without using the "Next Major Update" experimental toggle.}}
{{History|foot}}
== Issues ==
{{Issue list}}
== References ==
{{Reflist}}
==External Links==
*[https://www.minecraft.net/en-us/article/brush Taking Inventory: Brush] – Minecraft.net on July 6, 2023
{{Items}}
[[Category:Renewable resources]]
[[de:Pinsel]]
[[es:Pincel]]
[[ja:ブラシ]]
[[pt:Pincel]]
[[pl:Pędzel]]
[[uk:Щітка]]
[[zh:刷子]]</li></ul> | ? | Added long array tags. | |||
