Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Block entity format: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Sync: updated from Minecraft
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
(4 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 19: Line 20:
| beacon
| beacon
| [[Minecraft:Beacon]]
| [[Minecraft:Beacon]]
|-
| bed
| [[Minecraft:Bed]]s
|-
|-
| beehive
| beehive
Line 183: 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|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|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 233: Line 230:


== History ==
== History ==
{{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
{{HistoryTable
|{{HistoryLine|java beta}}
|{{HistoryLine|java beta}}
|{{HistoryLine||1.2|Added <code>Trap</code> for dispensers.
|{{HistoryLine||1.2|Added <code>Trap</code> for dispensers.
|Added <code>Music</code> note blocks.}}
|Added <code>Music</code> for note blocks.}}
|{{HistoryLine||1.7|Added <code>Piston</code> for moving pistons.}}
|{{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||1.8|dev=Pre-release|<code>Chest</code> is now used to render chests newly changed model.}}
|{{HistoryLine|java}}
|{{HistoryLine|java}}
|{{HistoryLine||1.0.0|dev=Beta 1.9 Prerelease 3|Added <code>Cauldron</code> for brewing stands.
|{{HistoryLine||1.0.0|dev=Beta 1.9 Prerelease 3|Added <code>Cauldron</code> for brewing stands.
Line 295: Line 293:
|{{HistoryLine||1.20.5|exp=Update 1.21|dev=24w05a|Added <code>vault</code> for vaults.}}
|{{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||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|||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:
|{{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>CookTime</code> to <code>cooking_time_spent</code>.
Line 317: Line 315:
|Added <code>shelf</code> for shelves.}}
|Added <code>shelf</code> for shelves.}}
|{{HistoryLine|||dev=25w34a|Added <code>align_items_to_bottom</code> to <code>shelf</code>.}}
|{{HistoryLine|||dev=25w34a|Added <code>align_items_to_bottom</code> to <code>shelf</code>.}}
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.2|dev=snap3|Removed <code>bed</code> for beds.}}
|{{HistoryLine||26.2|dev=snap3|<code>bed</code> has been removed.}}
|{{HistoryLine|||dev=snap5|Added <code>potent_sulfur</code> for potent sulfur.}}
|{{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.}}
}}
}}



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.

Block Entities
Block Entity ID Associated Block
banner Minecraft:Banners
barrel Minecraft:Barrel
beacon Minecraft:Beacon
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.
    • 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:Info needed section Template:HistoryTable

Navigation

Template:Navbox Java Edition technical

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