Minecraft:Block entity format: Difference between revisions
From SAS Gaming Wiki
More actions
Sync: new page from Minecraft |
Sync: updated from Minecraft |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{distinguish|Entity format}} | {{distinguish|Entity format}} | ||
{{for|{{BE}}|Bedrock Edition level format/Block entity format}} | |||
{{exclusive|java}} | {{exclusive|java}} | ||
| Line 12: | Line 13: | ||
|- | |- | ||
| banner | | banner | ||
| [[Minecraft:Banner]] | | [[Minecraft:Banner]]s | ||
|- | |- | ||
| barrel | | barrel | ||
| Line 19: | Line 20: | ||
| beacon | | beacon | ||
| [[Minecraft:Beacon]] | | [[Minecraft:Beacon]] | ||
|- | |- | ||
| beehive | | beehive | ||
| [[Minecraft:Bee | | [[Minecraft:Bee Nest]]/[[Minecraft:Beehive]] | ||
|- | |- | ||
| bell | | bell | ||
| Line 36: | Line 34: | ||
|- | |- | ||
| brushable_block | | brushable_block | ||
| [[Minecraft:Suspicious | | [[Minecraft:Suspicious Gravel]]/[[Minecraft:Suspicious Sand]] | ||
|- | |- | ||
| calibrated_sculk_sensor | | calibrated_sculk_sensor | ||
| Line 45: | Line 43: | ||
|- | |- | ||
| chest | | chest | ||
| [[Minecraft:Chest]] | | [[Minecraft:Chest]]/[[Minecraft:Copper Chest]]s | ||
|- | |- | ||
| chiseled_bookshelf | | chiseled_bookshelf | ||
| Line 60: | Line 58: | ||
|- | |- | ||
| copper_golem_statue | | copper_golem_statue | ||
| [[Minecraft:Copper Golem Statue]] | | [[Minecraft:Copper Golem Statue]]s | ||
|- | |- | ||
| crafter | | crafter | ||
| Line 96: | Line 94: | ||
|- | |- | ||
| hanging_sign | | hanging_sign | ||
| [[Minecraft:Hanging Sign]] | | [[Minecraft:Hanging Sign]]s | ||
|- | |- | ||
| hopper | | hopper | ||
| Line 115: | Line 113: | ||
| piston | | piston | ||
| [[Minecraft:Moving Piston]] | | [[Minecraft:Moving Piston]] | ||
|- | |||
| potent_sulfur | |||
| [[Minecraft:Potent Sulfur]] | |||
|- | |||
| shelf | |||
| [[Minecraft:Shelves]] | |||
|- | |- | ||
| shulker_box | | shulker_box | ||
| [[Minecraft:Shulker Box]] | | [[Minecraft:Shulker Box]]es | ||
|- | |- | ||
| sign | | sign | ||
| [[Minecraft:Sign]] | | [[Minecraft:Sign]]s | ||
|- | |- | ||
| skull | | skull | ||
| [[Minecraft: | | [[Minecraft:Head]]s | ||
|- | |- | ||
| sculk_catalyst | | sculk_catalyst | ||
| Line 142: | Line 146: | ||
| structure_block | | structure_block | ||
| [[Minecraft:Structure Block]] | | [[Minecraft:Structure Block]] | ||
|- | |||
| test_block | |||
| [[Minecraft:Test Block]] | |||
|- | |||
| test_instance_block | |||
| [[Minecraft:Test Instance Block]] | |||
|- | |- | ||
| trapped_chest | | trapped_chest | ||
| Line 171: | Line 181: | ||
{{collapse|title={{BlockSprite|barrel|link=Barrel|text='''barrel'''}}|content={{#lst:Barrel|block data}}}} | {{collapse|title={{BlockSprite|barrel|link=Barrel|text='''barrel'''}}|content={{#lst:Barrel|block data}}}} | ||
{{collapse|title={{BlockSprite|beacon|link=Beacon|text='''beacon'''}}|content={{#lst:Beacon|block data}}}} | {{collapse|title={{BlockSprite|beacon|link=Beacon|text='''beacon'''}}|content={{#lst:Beacon|block data}}}} | ||
{{collapse|title={{BlockSprite|all-beehives|link=Beehive|text='''beehive'''}}|content={{#lst:Beehive|block data}}}} | {{collapse|title={{BlockSprite|all-beehives|link=Beehive|text='''beehive'''}}|content={{#lst:Beehive|block data}}}} | ||
{{collapse|title={{BlockSprite|bell|link=Bell|text='''bell'''}}|content={{#lst:Bell|block data}}}} | {{collapse|title={{BlockSprite|bell|link=Bell|text='''bell'''}}|content={{#lst:Bell|block data}}}} | ||
| Line 198: | Line 207: | ||
{{collapse|title={{BlockSprite|oak-hanging-sign|link=Hanging Sign|text='''hanging_sign'''}}|content={{#lst:Hanging Sign|block data}}}} | {{collapse|title={{BlockSprite|oak-hanging-sign|link=Hanging Sign|text='''hanging_sign'''}}|content={{#lst:Hanging Sign|block data}}}} | ||
{{collapse|title={{BlockSprite|hopper|link=Hopper|text='''hopper'''}}|content={{#lst:Hopper|block data}}}} | {{collapse|title={{BlockSprite|hopper|link=Hopper|text='''hopper'''}}|content={{#lst:Hopper|block data}}}} | ||
{{collapse|title={{BlockSprite|jigsaw-block|link=Jigsaw Block|text=''' | {{collapse|title={{BlockSprite|jigsaw-block|link=Jigsaw Block|text='''jigsaw'''}}|content={{#lst:Jigsaw Block|block data}}}} | ||
{{collapse|title={{BlockSprite|jukebox|link=Jukebox|text='''jukebox'''}}|content={{#lst:Jukebox|block data}}}} | {{collapse|title={{BlockSprite|jukebox|link=Jukebox|text='''jukebox'''}}|content={{#lst:Jukebox|block data}}}} | ||
{{collapse|title={{BlockSprite|lectern|link=Lectern|text='''lectern'''}}|content={{#lst:Lectern|block data}}}} | {{collapse|title={{BlockSprite|lectern|link=Lectern|text='''lectern'''}}|content={{#lst:Lectern|block data}}}} | ||
{{collapse|title={{BlockSprite|monster-spawner|link=Monster Spawner|text='''mob_spawner'''}}|content={{#lst:Monster Spawner|block data}}}} | {{collapse|title={{BlockSprite|monster-spawner|link=Monster Spawner|text='''mob_spawner'''}}|content={{#lst:Monster Spawner|block data}}}} | ||
{{collapse|title={{BlockSprite|piston|link=Piston/Technical components#Moving piston|text='''piston'''}}|content={{#lst:Piston/Technical components|block data}}}} | {{collapse|title={{BlockSprite|piston|link=Piston/Technical components#Moving piston|text='''piston'''}}|content={{#lst:Piston/Technical components|block data}}}} | ||
{{collapse|title={{BlockSprite|potent-sulfur|link=Potent Sulfur|text='''potent_sulfur'''}}|content={{#lst:Potent Sulfur|block data}}}} | |||
{{collapse|title={{BlockSprite|sculk-catalyst|link=Sculk Catalyst|text='''sculk_catalyst'''}}|content={{#lst:Sculk Catalyst|block data}}}} | {{collapse|title={{BlockSprite|sculk-catalyst|link=Sculk Catalyst|text='''sculk_catalyst'''}}|content={{#lst:Sculk Catalyst|block data}}}} | ||
{{collapse|title={{BlockSprite|sculk-sensor|link=Sculk Sensor|text='''sculk_sensor'''}}|content={{#lst:Sculk Sensor|block data}}}} | {{collapse|title={{BlockSprite|sculk-sensor|link=Sculk Sensor|text='''sculk_sensor'''}}|content={{#lst:Sculk Sensor|block data}}}} | ||
| Line 212: | Line 222: | ||
{{collapse|title={{BlockSprite|soul-campfire|link=Soul Campfire|text='''soul_campfire'''}}|content={{#lst:Campfire|block data}}}} | {{collapse|title={{BlockSprite|soul-campfire|link=Soul Campfire|text='''soul_campfire'''}}|content={{#lst:Campfire|block data}}}} | ||
{{collapse|title={{BlockSprite|structure-block|link=Structure Block|text='''structure_block'''}}|content={{#lst:Structure Block|block data}}}} | {{collapse|title={{BlockSprite|structure-block|link=Structure Block|text='''structure_block'''}}|content={{#lst:Structure Block|block data}}}} | ||
<!--{{collapse|title={{BlockSprite|test-block|link=Test Block|text='''test_block'''}}|content={{#lst:Test Block|block data}}}} | |||
{{collapse|title={{BlockSprite|test-instance-block|link=Test Instance Block|text='''test_instance_block'''}}|content={{#lst:Test Instance Block|block data}}}}--> | |||
{{collapse|title={{BlockSprite|trapped-chest|link=Trapped Chest|text='''trapped_chest'''}}|content={{#lst:Chest|block data}}}} | {{collapse|title={{BlockSprite|trapped-chest|link=Trapped Chest|text='''trapped_chest'''}}|content={{#lst:Chest|block data}}}} | ||
{{collapse|title={{BlockSprite|trial-spawner|link=Trial Spawner|text='''trial_spawner'''}}|content={{#lst:Trial Spawner|block data}}}} | {{collapse|title={{BlockSprite|trial-spawner|link=Trial Spawner|text='''trial_spawner'''}}|content={{#lst:Trial Spawner|block data}}}} | ||
| Line 218: | Line 230: | ||
== History == | == History == | ||
{{empty | {{info needed section|How were chest and furnace contents handled in their initial implementation versions? Or spawner entities? Or signs, when implemented as placed blocks rather than as entities?}} | ||
{{HistoryTable | |||
|{{HistoryLine|java beta}} | |||
|{{HistoryLine||1.2|Added <code>Trap</code> for dispensers. | |||
|Added <code>Music</code> for note blocks.}} | |||
|{{HistoryLine||1.7|Added <code>Piston</code> for moving pistons.}} | |||
|{{HistoryLine||1.8|dev=Pre-release|<code>Chest</code> is now used to render chests newly changed model.}} | |||
|{{HistoryLine|java}} | |||
|{{HistoryLine||1.0.0|dev=Beta 1.9 Prerelease 3|Added <code>Cauldron</code> for brewing stands. | |||
|Added <code>EnchantTable</code> for enchantment tables. | |||
|Added <code>AirPortal</code> for End portal blocks.}} | |||
|{{HistoryLine||1.3.1|dev=12w21a|Added <code>EnderChest</code> for ender chests.}} | |||
|{{HistoryLine||1.4.2|dev=12w32a|Added <code>Control</code> for command blocks. | |||
|Added <code>Beacon</code> for beacons.}} | |||
|{{HistoryLine|||dev=12w36a|Added <code>Skull</code> for heads.}} | |||
|{{HistoryLine||1.5|dev=13w01a|Added <code>DLDetector</code> for daylight sensors. | |||
|Added <code>Hopper</code> for hoppers. | |||
|Added <code>Comparator</code> for redstone comparators.}} | |||
|{{HistoryLine|||dev=13w03a|Added <code>Dropper</code> for droppers.}} | |||
|{{HistoryLine||1.7.2|dev=13w36a|Added <code>FlowerPot</code> for flower pots.}} | |||
|{{HistoryLine||1.8|dev=14w30a|Added <code>Banner</code> for banners.}} | |||
|{{HistoryLine||1.9|dev=15w31a|Added <code>EndGateway</code> for the End gateway block. | |||
|Added <code>Structure</code> for structure blocks. | |||
|Added <code>powered</code> and <code>conditional</code> fields to <code>Control</code>}} | |||
|{{HistoryLine|||dev=15w47a|Added <code>PaymentItem</code> to <code>Beacon</code>.}} | |||
|{{HistoryLine|||dev=15w49a|Removed <code>PaymentItem</code> from <code>Beacon</code>.}} | |||
|{{HistoryLine||1.11|dev=16w32a|The [[Minecraft:namespaced ID]] of block entities have been lowercased, renamed and namespaced.}} | |||
|{{HistoryLine|||dev=16w39a|Added <code>shulker_box</code> for shulker boxes.}} | |||
|{{HistoryLine||1.12|dev=17w15a|Added <code>bed</code> for beds.}} | |||
|{{HistoryLine||1.13|dev=17w47a|Removed <code>noteblock</code> for note blocks. | |||
|Removed <code>flower_pot</code> for flower pots. | |||
|Removed <code>color</code> from <code>bed</code>. | |||
|Removed <code>Base</code> from <code>banner</code>. | |||
|Removed <code>Rot</code> and <code>SkullType</code> from <code>skull</code>. | |||
|Added <code>trapped_chest</code> for trapped chests. | |||
|Merged fields <code>BlockId</code> and <code>BlockData</code> into <code>blockState</code> for <code>piston</code>. | |||
|Removed <code>Record</code> from <code>jukebox</code>.}} | |||
|{{HistoryLine|||dev=18w15a|Added <code>conduit</code> for conduits.}} | |||
|{{HistoryLine||1.14|dev=18w44a|Added <code>barrel</code> for barrels. | |||
|Added <code>bell</code> for bells. | |||
|Added <code>lectern</code> for lectern.}} | |||
|{{HistoryLine|||dev=18w46a|Added <code>jigsaw</code> for jigsaw block.}} | |||
|{{HistoryLine|||dev=19w02a|Added <code>campfire</code> for camfires.}} | |||
|{{HistoryLine|||dev=18w50a|Added <code>blast_furnace</code> for blast furnaces. | |||
|Added <code>smoker</code> for smokers.}} | |||
|{{HistoryLine||1.15|dev=19w34a|Added <code>beehive</code> for beehives and bee nests.}} | |||
|{{HistoryLine||1.17|dev=20w49a|Added <code>sculk_sensor</code> for sculk sensors.}} | |||
|{{HistoryLine||1.19|dev=Deep Dark Experimental Snapshot 1|Added <code>sculk_catelyst</code> for sculk catelyst. | |||
|Added <code>sculk_shrieker</code> for sculk shriekers.}} | |||
|{{HistoryLine|||dev=22w11a|Implemented the previously mentioned features into normal snapshot.}} | |||
|{{HistoryLine||1.19.3|exp=Update 1.20|dev=22w42a|Added <code>chiseled_bookshelf</code> for chiseled bookshelves. | |||
|Added <code>hanging_sign</code> for hanging signs.}} | |||
|{{HistoryLine||1.19.4|exp=Update 1.20|dev=23w07a|Added <code>decorated_pot</code> for decorated pots. | |||
|Added <code>suspicious_sand</code> for suspicious sand.}} | |||
|{{HistoryLine||1.20|dev=23w12a|Added <code>calibrated_sculk_sensor</code> for calibrated sculk sensors. | |||
|Renamed <code>suspicious_sand</code> to <code>brushable_block</code>.}} | |||
|{{HistoryLine||1.20.2|dev=23w32a|Some fields in <code>beacon</code> were changed: | |||
* <code>Primary</code> (integer) -> <code>primary_effect</code> (string, resource identifier) | |||
* <code>Secondary</code> (integer) -> <code>secondary_effect</code> (string, resource identifier)}} | |||
|{{HistoryLine||1.20.3|exp=Update 1.21|dev=23w45a|Added <code>trial_spawner</code> for trial spawners.}} | |||
|{{HistoryLine|||dev=23w42a|Added <code>crafter</code> for crafters.}} | |||
|{{HistoryLine||1.20.5|exp=Update 1.21|dev=24w05a|Added <code>vault</code> for vaults.}} | |||
|{{HistoryLine||1.21.2|exp=Winter Drop|dev=24w40a|Added <code>creaking_heart</code> for creaking heart.}} | |||
|{{HistoryLine|||dev=24w39a|Renamed <code>Lock</code> field in containers to <code>lock</code> as now it has become a compound that represents an item predicate.}} | |||
|{{HistoryLine||1.21.4|dev=Pre-Release 2|Some fields for <code>furnace</code>, <code>blast_furnace</code>, and <code>smoker</code> were changed: | |||
* Renamed <code>CookTime</code> to <code>cooking_time_spent</code>. | |||
* Renamed <code>CookTimeTotal</code> to <code>cooking_total_time</code>. | |||
* Renamed <code>BurnTime</code> to <code>lit_time_remaining</code>. | |||
* Added the field <code>lit_total_time</code> representing the total time the furnace should be lit.}} | |||
|{{HistoryLine||1.21.5|dev=25w03a|Added <code>test_block</code> for test blocks. | |||
|Added <code>test_instance_block</code> for test instance blocks.}} | |||
|{{HistoryLine|||dev=25w07a|The <code>CustomName</code> field is no longer preserved when removed. | |||
|The <code>LootTable</code> field is no longer preserved when removed. | |||
|The <code>exit_portal</code> field for <code>end_gateway</code> is no longer preserved when removed. | |||
|The <code>RecipesUsed</code> field for <code>furnace</code>, <code>smoker</code> and <code>blast_furnace</code> is no longer preserved when removed. | |||
|The <code>note_block_sound</code> field for <code>skull</code> is no longer preserved when removed.}} | |||
|{{HistoryLine|||dev=25w09a|The <code>CookingTimes</code> and <code>CookingTotalTimes</code> for <code>campfire</code> fields are no longer preserved when removed. | |||
|The <code>last_interacted_slot</code> field for <code>chiseled_bookshelf</code> now defaults to -1 if not specified. | |||
|The <code>TransferCooldown</code> field for <code>hopper</code> now default to -1 if not specified. | |||
|The <code>jigsaw</code> fields, <code>name</code>, <code>target</code>, and <code>pool</code> now default to <code>minecraft:empty</code> if not specified, and the <code>final_state</code> field now defaults to <code>minecraft:air</code> if not specified. | |||
|The <code>warning_level</code> field for <code>sculk_shrieker</code> now defaults to 0 if not specified. | |||
|<code>structure_block</code>The <code>ignoreEntities</code> and <code>showboundingbox</code> fields now default to <code>true</code> if not specified, the <code>posY</code> field now defaults to 1 if not specified.}} | |||
|{{HistoryLine||1.21.9|dev=25w31a|Added <code>copper_golem_statue</code> for copper golem statues. | |||
|Added <code>shelf</code> for shelves.}} | |||
|{{HistoryLine|||dev=25w34a|Added <code>align_items_to_bottom</code> to <code>shelf</code>.}} | |||
|{{HistoryLine||26.2|dev=snap3|Removed <code>bed</code> for beds.}} | |||
|{{HistoryLine|||dev=snap5|Added <code>potent_sulfur</code> for potent sulfur.}} | |||
|{{HistoryLine|upcoming java}} | |||
|{{HistoryLine||26.3|dev=snap1|{{cd|minecraft:decorated_pot}}: Field {{cd|sherds}} no longer stores a list of 4 item IDs. Instead, the new format is an object with 4 optional item stack fields.}} | |||
}} | |||
== Navigation == | == Navigation == | ||
Latest revision as of 11:03, 16 July 2026
Template:Distinguish Template:For Template:Exclusive
A Minecraft:block entity is used to store information about a block that can't be stored in the block's Minecraft:block states. It is stored inside the chunk data and Minecraft:structure files.
NBT format
Block entities are stored using Minecraft:NBT in the following format:
- Template:Nbt: A block entity<section begin="nbt format" />
- Template:Nbt: Block entity ID
- Template:Nbt: 1 or 0 (Template:Cd) - If
true, this is an invalid block entity, and this block is not immediately placed when a loaded chunk is loaded. Iffalse, this is a normal block entity that can be immediately placed. - Template:Nbt: X coordinate of the block entity.
- Template:Nbt: Y coordinate of the block entity.
- Template:Nbt: Z coordinate of the block entity.
- Template:Nbt: Optional map of data components that are not represented by additional fields.
- See Template:Slink.<section end="nbt format" />
- Additional fields depending on the block entity type (Template:Nbt), see Template:Slink
Types
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
Template:Collapse
History
Template:Navbox Java Edition technical
Minecraft:ja:ブロックエンティティフォーマット Minecraft:ko:블록 개체 형식 Minecraft:uk:Формат блока-сутности Minecraft:zh:方块实体数据格式