View source for Minecraft:Block entity format

{{distinguish|Entity format}}
{{exclusive|java}}

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 [[Minecraft:Chunk format|chunk data]] and [[Minecraft:structure file]]s.

{| class="wikitable" style="position:relative; z-index:1; float:right; margin-right:0" data-description="Block entity IDs"
|-
! colspan="2" | Block Entities
|-
! Block Entity ID
! Associated Block
|-
| banner
| [[Minecraft:Banner]]
|-
| barrel
| [[Minecraft:Barrel]]
|-
| beacon
| [[Minecraft:Beacon]]
|-
| bed
| [[Minecraft:Bed]]
|-
| beehive
| [[Minecraft:Bee nest]]/[[Minecraft:beehive]]
|-
| bell
| [[Minecraft:Bell]]
|-
| blast_furnace
| [[Minecraft:Blast Furnace]]
|-
| brewing_stand
| [[Minecraft:Brewing Stand]]
|-
| brushable_block
| [[Minecraft:Suspicious Block]]
|-
| calibrated_sculk_sensor
| [[Minecraft:Calibrated Sculk Sensor]]
|-
| campfire
| [[Minecraft:Campfire]]
|-
| chest
| [[Minecraft:Chest]]
|-
| chiseled_bookshelf
| [[Minecraft:Chiseled Bookshelf]]
|-
| comparator
| [[Minecraft:Redstone Comparator]]
|-
| command_block
| [[Minecraft:Command Block]]
|-
| conduit
| [[Minecraft:Conduit]]
|-
| copper_golem_statue
| [[Minecraft:Copper Golem Statue]]
|-
| 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
| [[Minecraft:End Gateway (block)|End Gateway]]
|-
| end_portal
| [[Minecraft:End Portal (block)|End Portal]]
|-
| furnace
| [[Minecraft:Furnace]]
|-
| hanging_sign
| [[Minecraft:Hanging Sign]]
|-
| hopper
| [[Minecraft:Hopper]]
|-
| jigsaw
| [[Minecraft:Jigsaw Block]]
|-
| jukebox
| [[Minecraft:Jukebox]]
|-
| lectern
| [[Minecraft:Lectern]]
|-
| mob_spawner
| [[Minecraft:Monster Spawner]]
|-
| piston
| [[Minecraft:Moving Piston]]
|-
| shulker_box
| [[Minecraft:Shulker Box]]
|-
| sign
| [[Minecraft:Sign]]
|-
| skull
| [[Minecraft:Mob head]]
|-
| 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]]
|-
| 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:
<div class="treeview">
* {{nbt|compound}}: A block entity<section begin="nbt format" />
** {{nbt|string|id}}: {{#if:{{{id|}}}|<code>{{{id}}}</code>|Block entity ID}}
** {{nbt|bool|keepPacked}}: 1 or 0 ({{cd|true|false|d=/}}) - If <code>true</code>, this is an invalid block entity, and this block is not immediately placed when a loaded chunk is loaded. If <code>false</code>, this is a normal block entity that can be immediately placed.
** {{nbt|int|x}}: X coordinate of the block entity.
** {{nbt|int|y}}: Y coordinate of the block entity.
** {{nbt|int|z}}: Z coordinate of the block entity.
** {{nbt|compound|components}}: Optional map of data components that are not represented by additional fields.
*** See {{slink|Data component format|List of components}}.<section end="nbt format" />
** Additional fields depending on the block entity type ({{nbt|string|id}}), see {{slink|Block entity format|Types}}
</div>

== Types ==
{{collapse|title={{BlockSprite|banners|link=Banner|text='''banner'''}}|content={{#lst:Banner|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|beds|link=Bed|text='''bed'''}}|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}}}}
{{collapse|title={{BlockSprite|blast-furnace|link=Blast Furnace|text='''blast_furnace'''}}|content={{#lst:Blast Furnace|block data}}}}
{{collapse|title={{BlockSprite|brewing-stand|link=Brewing Stand|text='''brewing_stand'''}}|content={{#lst:Brewing Stand|block data}}}}
{{collapse|title={{BlockSprite|suspicious-block|link=Suspicious Block|text='''brushable_block'''}}|content={{#lst:Suspicious Sand|block data}}}}
{{collapse|title={{BlockSprite|calibrated-sculk-sensor|link=Calibrated Sculk Sensor|text='''calibrated_sculk_sensor'''}}|content={{#lst:Sculk Sensor|block data}}}}
{{collapse|title={{BlockSprite|campfire|link=Campfire|text='''campfire'''}}|content={{#lst:Campfire|block data}}}}
{{collapse|title={{BlockSprite|chiseled-bookshelf|link=Chiseled Bookshelf|text='''chiseled_bookshelf'''}}|content={{#lst:Chiseled Bookshelf|block data}}}}
{{collapse|title={{BlockSprite|chest|link=Chest|text='''chest'''}}|content={{#lst:Chest|block data}}}}
{{collapse|title={{BlockSprite|redstone-comparator|link=Redstone Comparator|text='''comparator'''}}|content={{#lst:Redstone Comparator|block data}}}}
{{collapse|title={{BlockSprite|command-blocks|link=Command Block|text='''command_block'''}}|content={{#lst:Command Block|block data}}}}
{{collapse|title={{BlockSprite|conduit|link=Conduit|text='''conduit'''}}|content={{#lst:Conduit|block data}}}}
{{collapse|title={{BlockSprite|copper-golem-statue|link=Copper Golem Statue|text='''copper_golem_statue'''}}|content={{#lst:Copper Golem Statue|block data}}}}
{{collapse|title={{BlockSprite|crafter|link=Crafter|text='''crafter'''}}|content={{#lst:Crafter|block data}}}}
{{collapse|title={{BlockSprite|creaking-heart|link=Creaking Heart|text='''creaking_heart'''}}|content={{#lst:Creaking Heart|block data}}}}
{{collapse|title={{BlockSprite|daylight-detector|link=Daylight Detector|text='''daylight_detector'''}}|content={{#lst:Daylight Detector|block data}}}}
{{collapse|title={{BlockSprite|decorated-pot|link=Decorated Pot|text='''decorated_pot'''}}|content={{#lst:Decorated Pot|block data}}}}
{{collapse|title={{BlockSprite|dispenser|link=Dispenser|text='''dispenser'''}}|content={{#lst:Dispenser|block data}}}}
{{collapse|title={{BlockSprite|dropper|link=Dropper|text='''dropper'''}}|content={{#lst:Dropper|block data}}}}
{{collapse|title={{BlockSprite|enchanting-table|link=Enchanting Table|text='''enchanting_table'''}}|content={{#lst:Enchanting Table|block data}}}}
{{collapse|title={{BlockSprite|ender-chest|link=Ender Chest|text='''ender_chest'''}}|content={{#lst:Ender Chest|block data}}}}
{{collapse|title={{BlockSprite|end-gateway|link=End Gateway (block)|text='''end_gateway'''}}|content={{#lst:End Gateway (block)|block data}}}}
{{collapse|title={{BlockSprite|end-portal|link=End Portal (block)|text='''end_portal'''}}|content={{#lst:End Portal (block)|block data}}}}
{{collapse|title={{BlockSprite|furnace|link=Furnace|text='''furnace'''}}|content={{#lst:Furnace|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|jigsaw-block|link=Jigsaw Block|text='''jigsaw_block'''}}|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|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-shrieker|link=Sculk Shrieker|text='''sculk_shrieker'''}}|content={{#lst:Sculk Shrieker|block data}}}}
{{collapse|title={{BlockSprite|shulker-box|link=Shulker Box|text='''shulker_box'''}}|content={{#lst:Shulker Box|block data}}}}
{{collapse|title={{BlockSprite|oak-sign|link=Sign|text='''sign'''}}|content={{#lst:Sign|block data}}}}
{{collapse|title={{BlockSprite|heads|link=Head|text='''skull'''}}|content={{#lst:Head|block data}}}}
{{collapse|title={{BlockSprite|smoker|link=Smoker|text='''smoker'''}}|content={{#lst:Smoker|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|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|vault|link=Vault|text='''vault'''}}|content={{#lst:Vault|block data}}}}
{{-}}

== History ==
{{empty section}}

== Navigation ==
{{Navbox Java Edition technical|general}}

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