Minecraft:Block entity format: Difference between revisions

Revision as of 11:02, 6 May 2026

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.

Block Entities
Block Entity ID	Associated Block
banner	Minecraft:Banners
barrel	Minecraft:Barrel
beacon	Minecraft:Beacon
bed	Minecraft:Beds
beehive	Minecraft:Bee Nest/Minecraft:Beehive
bell	Minecraft:Bell
blast_furnace	Minecraft:Blast Furnace
brewing_stand	Minecraft:Brewing Stand
brushable_block	Minecraft:Suspicious Gravel/Minecraft:Suspicious Sand
calibrated_sculk_sensor	Minecraft:Calibrated Sculk Sensor
campfire	Minecraft:Campfire
chest	Minecraft:Chest/Minecraft:Copper Chests
chiseled_bookshelf	Minecraft:Chiseled Bookshelf
comparator	Minecraft:Redstone Comparator
command_block	Minecraft:Command Block
conduit	Minecraft:Conduit
copper_golem_statue	Minecraft:Copper Golem Statues
crafter	Minecraft:Crafter
creaking_heart	Minecraft:Creaking Heart
daylight_detector	Minecraft:Daylight Detector
decorated_pot	Minecraft:Decorated Pot
dispenser	Minecraft:Dispenser
dropper	Minecraft:Dropper
enchanting_table	Minecraft:Enchanting Table
ender_chest	Minecraft:Ender Chest
end_gateway	End Gateway
end_portal	End Portal
furnace	Minecraft:Furnace
hanging_sign	Minecraft:Hanging Signs
hopper	Minecraft:Hopper
jigsaw	Minecraft:Jigsaw Block
jukebox	Minecraft:Jukebox
lectern	Minecraft:Lectern
mob_spawner	Minecraft:Monster Spawner
piston	Minecraft:Moving Piston
potent_sulfur	Minecraft:Potent Sulfur
shelf	Minecraft:Shelves
shulker_box	Minecraft:Shulker Boxes
sign	Minecraft:Signs
skull	Minecraft:Heads
sculk_catalyst	Minecraft:Sculk Catalyst
sculk_sensor	Minecraft:Sculk Sensor
sculk_shrieker	Minecraft:Sculk Shrieker
smoker	Minecraft:Smoker
soul_campfire	Minecraft:Soul Campfire
structure_block	Minecraft:Structure Block
test_block	Minecraft:Test Block
test_instance_block	Minecraft:Test Instance Block
trapped_chest	Minecraft:Trapped Chest
trial_spawner	Minecraft:Trial Spawner
vault	Minecraft:Vault

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. If false, 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

History

Template:HistoryTable

Navigation

Template:Navbox Java Edition technical

Minecraft:ja:ブロックエンティティフォーマット Minecraft:ko:블록 개체 형식 Minecraft:uk:Формат блока-сутности Minecraft:zh:方块实体数据格式

@@ Line 12: / Line 12: @@
 |-
 | banner
-| [[Minecraft:Banner]]
+| [[Minecraft:Banner]]s
 |-
 | barrel
@@ Line 21: / Line 21: @@
 |-
 | bed
-| [[Minecraft:Bed]]
+| [[Minecraft:Bed]]s
 |-
 | beehive
-| [[Minecraft:Bee nest]]/[[Minecraft:beehive]]
+| [[Minecraft:Bee Nest]]/[[Minecraft:Beehive]]
 |-
 | bell
@@ Line 36: / Line 36: @@
 |-
 | brushable_block
-| [[Minecraft:Suspicious Block]]
+| [[Minecraft:Suspicious Gravel]]/[[Minecraft:Suspicious Sand]]
 |-
 | calibrated_sculk_sensor
@@ Line 45: / Line 45: @@
 |-
 | chest
-| [[Minecraft:Chest]]
+| [[Minecraft:Chest]]/[[Minecraft:Copper Chest]]s
 |-
 | chiseled_bookshelf
@@ Line 60: / Line 60: @@
 |-
 | copper_golem_statue
-| [[Minecraft:Copper Golem Statue]]
+| [[Minecraft:Copper Golem Statue]]s
 |-
 | crafter
@@ Line 96: / Line 96: @@
 |-
 | hanging_sign
-| [[Minecraft:Hanging Sign]]
+| [[Minecraft:Hanging Sign]]s
 |-
 | hopper
@@ Line 115: / Line 115: @@
 | piston
 | [[Minecraft:Moving Piston]]
+|-
+| potent_sulfur
+| [[Minecraft:Potent Sulfur]]
+|-
+| shelf
+| [[Minecraft:Shelves]]
 |-
 | shulker_box
-| [[Minecraft:Shulker Box]]
+| [[Minecraft:Shulker Box]]es
 |-
 | sign
-| [[Minecraft:Sign]]
+| [[Minecraft:Sign]]s
 |-
 | skull
-| [[Minecraft:Mob head]]
+| [[Minecraft:Head]]s
 |-
 | sculk_catalyst
@@ Line 142: / Line 148: @@
 | structure_block
 | [[Minecraft:Structure Block]]
+|-
+| test_block
+| [[Minecraft:Test Block]]
+|-
+| test_instance_block
+| [[Minecraft:Test Instance Block]]
 |-
 | trapped_chest
@@ Line 171: / Line 183: @@
 {{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|beds|link=Bed|text='''bed'''}}|content={{#lst:Bed|block data}}}}
+{{collapse|title={{BlockSprite|beds|link=Bed|text='''bed'''}}{{until|JE 26.2|short=1}}|content={{#lst:Bed|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}}}}
@@ Line 198: / Line 210: @@
 {{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|jigsaw-block|link=Jigsaw Block|text='''jigsaw_block'''}}|content={{#lst:Jigsaw Block|block data}}}}
+{{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|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|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-sensor|link=Sculk Sensor|text='''sculk_sensor'''}}|content={{#lst:Sculk Sensor|block data}}}}
@@ Line 212: / Line 225: @@
 {{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|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|trial-spawner|link=Trial Spawner|text='''trial_spawner'''}}|content={{#lst:Trial Spawner|block data}}}}
@@ Line 218: / Line 233: @@
 == History ==
-{{empty section}}
+{{HistoryTable
+|{{HistoryLine|java beta}}
+|{{HistoryLine||1.2|Added <code>Trap</code> for dispensers.
+|Added <code>Music</code> note blocks.}}
+|{{HistoryLine||1.7|Added <code>Piston</code> for moving pistons.}}
+|{{HistoryLine||1.8|dev=Pre-release|<code>Chest</code> tile entity 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> and 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|java upcoming}}
+|{{HistoryLine||26.2|dev=snap3|<code>bed</code> has been removed.}}
+|{{HistoryLine|||dev=snap5|Added <code>potent_sulfur</code> for potent sulfur.}}
+}}
 == Navigation ==