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

Minecraft:Bedrock Edition level format/Block entity format: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Remove broken links to missing pages
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Missing information|Missing entity data from new [[Minecraft:Creaking Heart]]}}
{{exclusive|bedrock}}
{{exclusive|bedrock}}
This page lists NBT structures of block entities {{in|bedrock}}.
This page lists NBT structures of block entities {{in|bedrock}}.
Line 5: Line 4:
A [[Minecraft:block entity]] is used by ''Minecraft'' to store information about a block that can't be stored in the block's block states.
A [[Minecraft:block entity]] is used by ''Minecraft'' to store information about a block that can't be stored in the block's block states.
__TOC__
__TOC__
<div class="treeview">


== Block Entity ==
== Block Entity ==
<div class="treeview">
All block entities share this base:
All block entities share this base:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
<section begin="blockentity format" />
** {{nbt|int|BlockEntityVersion}}: Block entity version.{{upcoming|Bedrock 26.30}}
** {{nbt|string|CustomName}}: (May not exist) The custom name of the block entity.
** {{nbt|string|CustomName}}: (May not exist) The custom name of the block entity.
** {{nbt|string|id}}: The savegame ID of the block entity.
** {{nbt|string|id}}: The savegame ID of the block entity.
** {{nbt|byte|isMovable}}: 1 or 0 (true/false) - true if the block entity is movable with a piston.
** {{nbt|byte|isMovable}}: 1 or 0 (true/false) - true if the block entity is movable with a piston.{{until|Bedrock 26.30}}
** {{nbt|int|x}}: X coordinate of the block entity.
** {{nbt|int|x}}: X coordinate of the block entity.
** {{nbt|int|y}}: Y coordinate of the block entity.
** {{nbt|int|y}}: Y coordinate of the block entity.
** {{nbt|int|z}}: Z coordinate of the block entity.
** {{nbt|int|z}}: Z coordinate of the block entity.<section end="blockentity format" />
</div>


== Additional fields for block entity types ==
== Additional fields for block entity types ==
<div class="treeview">
=== Banner ===
=== Banner ===
Additional fields for [[Minecraft:banner]]:
Additional fields for [[Minecraft:banner]]:
Line 31: Line 34:
Additional fields for [[Minecraft:beacon]]:
Additional fields for [[Minecraft:beacon]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|primary}}: The primary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected.
** {{nbt|int|primary}}: The primary effect selected, see [[Minecraft:Status_effect|Potion effects]] for IDs. Set to 0 when no effect is selected.
** {{nbt|int|secondary}}: The secondary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected. When set without a primary effect, does nothing. When set to the same as the primary, the effect is given at level 2 (the normally available behavior for 5 effects). When set to a different value than the primary (normally only Regeneration), gives the effect at level 1.{{needs testing}}
** {{nbt|int|secondary}}: The secondary effect selected, see [[Minecraft:Status_effect|Potion effects]] for IDs. Set to 0 when no effect is selected. When set without a primary effect, does nothing. When set to the same as the primary, the effect is given at level 2 (the normally available behavior for 5 effects). When set to a different value than the primary (normally only Regeneration), gives the effect at level 1.{{needs testing}}


=== Bed ===
=== Bed ===
Line 59: Line 62:


=== Brewing Stand ===
=== Brewing Stand ===
Additional fields for brewing stand:
Additional fields for [[Minecraft:brewing stand]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|short|CookTime}}: The number of ticks until the potions are finished.
** {{nbt|short|CookTime}}: The number of ticks until the potions are finished.
Line 70: Line 73:


=== Campfire and Soul Campfire ===
=== Campfire and Soul Campfire ===
Additional fields for [[Minecraft:campfire]] and soul campfire:
Additional fields for [[Minecraft:campfire]] and [[Minecraft:soul campfire]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|Item<''num''>}}: (May not exist) An items currently cooking. <code><''num''></code> is 1, 2, 3, and 4.
** {{nbt|compound|Item<''num''>}}: (May not exist) An items currently cooking. <code><''num''></code> is 1, 2, 3, and 4.
Line 100: Line 103:


=== Chemistry Tables ===
=== Chemistry Tables ===
Additional fields for chemistry tables (compound creator, element constructor, lab table, material reducer):
Additional fields for chemistry tables ([[Minecraft:compound creator]], [[Minecraft:element constructor]], [[Minecraft:lab table]], [[Minecraft:material reducer]]):
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|short|itemAux}}: (Only for Lab Table) The Aux value of the item to be spawned.
** {{nbt|short|itemAux}}: (Only for Lab Table) The Aux value of the item to be spawned.
Line 107: Line 110:


=== Chests ===
=== Chests ===
Additional fields for [[Minecraft:chest]], trapped chest, [[Minecraft:barrel]], and ender chest:
Additional fields for [[Minecraft:chest]], [[Minecraft:trapped chest]], [[Minecraft:barrel]], and [[Minecraft:ender chest]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|byte|Findable}}: Unknown.
** {{nbt|byte|Findable}}: Unknown.
Line 122: Line 125:


=== Chiseled Bookshelf ===
=== Chiseled Bookshelf ===
Additional fields for chiseled bookshelf:
Additional fields for [[Minecraft:chiseled bookshelf]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|list|Items}}: List of books in the bookshelf.
** {{nbt|list|Items}}: List of books in the bookshelf.
Line 129: Line 132:
** {{nbt|int|LastInteractedSlot}}: Last interacted slot (1-6), or 0 if no slot has been interacted with yet.
** {{nbt|int|LastInteractedSlot}}: Last interacted slot (1-6), or 0 if no slot has been interacted with yet.


=== Command Block ===
=== Command Blocks ===
Additional fields for command block:
Additional fields for [[Minecraft:command block]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{bedrock nbt|Command Block}}
** {{bedrock nbt|Command Block}}
Line 142: Line 145:


=== Comparator ===
=== Comparator ===
Additional fields for comparator:
Additional fields for [[Minecraft:comparator]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|OutputSignal}}: Represents the strength of the analog signal output of this redstone comparator.
** {{nbt|int|OutputSignal}}: Represents the strength of the analog signal output of this redstone comparator.
Line 152: Line 155:
** {{nbt|long|Target}}: The Unique ID of the hostile mob the conduit is currently attacking. If there's no target, defaults to -1.
** {{nbt|long|Target}}: The Unique ID of the hostile mob the conduit is currently attacking. If there's no target, defaults to -1.


=== Copper Golem Statue ===
=== Copper Golem Statues ===
Additional fields for copper golem statue:
Additional fields for [[Minecraft:copper golem statue]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|Actor}}: Data for the entity associated with the statue.
** {{nbt|compound|Actor}}: Data for the entity associated with the statue.
Line 169: Line 172:
**** {{nbt|byte|Slot}}: The inventory slot the item is in.
**** {{nbt|byte|Slot}}: The inventory slot the item is in.
**** {{bedrock nbt|Item Stack|item}}
**** {{bedrock nbt|Item Stack|item}}
=== Creaking Heart ===
Additional fields for [[Minecraft:creaking heart]]:
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|Cooldown}}: {{more info}}
** {{nbt|long|SpawnedCreakingID}}: The unique identifier of the [[Minecraft:creaking]] associated with this creaking heart. If there is no linked creaking, this field is absent.


=== Decorated Pot ===
=== Decorated Pot ===
Additional fields for decorated pot:
Additional fields for [[Minecraft:decorated pot]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|string|LootTable}}: (May not exist) Loot table to be used to fill the decorated pot when it is next opened, or the items are otherwise interacted with.
** {{nbt|string|LootTable}}: (May not exist) Loot table to be used to fill the decorated pot when it is next opened, or the items are otherwise interacted with.
Line 191: Line 200:
** {{nbt|int|LootTableSeed}}: (May not exist) Seed for generating the loot table. 0 or omitted use a random seed.
** {{nbt|int|LootTableSeed}}: (May not exist) Seed for generating the loot table. 0 or omitted use a random seed.


=== Enchantment Table ===
=== Enchanting Table ===
Additional fields for Enchantment table:
Additional fields for [[Minecraft:Enchanting table]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|string|CustomName}}: (May not exist) The name of this enchantment table.
** {{nbt|string|CustomName}}: (May not exist) The name of this enchanting table.
** {{nbt|float|rott}}: The clockwise rotation of the book in radians. Top of the book points West when 0.
** {{nbt|float|rott}}: The clockwise rotation of the book in radians. Top of the book points West when 0.


=== End Gateway ===
=== End Gateway ===
Additional fields for end gateway:
Additional fields for [[Minecraft:end gateway]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|Age}}: Age of the portal, in ticks. This is used to determine when the beam is rendered.
** {{nbt|int|Age}}: Age of the portal, in ticks. This is used to determine when the beam is rendered.
Line 207: Line 216:


=== Flower Pot ===
=== Flower Pot ===
Additional fields for flower pot:
Additional fields for [[Minecraft:flower pot]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|PlantBlock}}: (May not exist) The block in the pot.
** {{nbt|compound|PlantBlock}}: (May not exist) The block in the pot.
Line 213: Line 222:


=== Furnace ===
=== Furnace ===
Additional fields for [[Minecraft:furnace]], [[Minecraft:smoker]], and blast furnace:
Additional fields for [[Minecraft:furnace]], [[Minecraft:smoker]], and [[Minecraft:blast furnace]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|short|BurnDuration}}: The total time that in ticks that the currently used fuel can burn.
** {{nbt|short|BurnDuration}}: The total time that in ticks that the currently used fuel can burn.
Line 234: Line 243:


=== Item Frame ===
=== Item Frame ===
Additional fields for item frame:
Additional fields for [[Minecraft:item frame]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|Item}}: The items in this item frame.
** {{nbt|compound|Item}}: The items in this item frame.
Line 241: Line 250:
** {{nbt|float|ItemRotation}}: (May not exist) The rotation of the item in the item frame.
** {{nbt|float|ItemRotation}}: (May not exist) The rotation of the item in the item frame.


=== Jigsaw ===
=== Jigsaw Block ===
Additional fields for jigsaw:
Additional fields for [[Minecraft:jigsaw block]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|string|final_state}}: The block that this jigsaw block becomes.
** {{nbt|string|final_state}}: The block that this jigsaw block becomes.
Line 271: Line 280:


=== Monster Spawner ===
=== Monster Spawner ===
Additional fields for monster spawner:
Additional fields for [[Minecraft:monster spawner]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{bedrock nbt|Monster Spawner}}
** {{bedrock nbt|Monster Spawner}}


=== Moving Block ===
=== Moving Block ===
Additional fields for moving block:
Additional fields for [[Minecraft:moving block]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|movingBlock}}: The main layer of moving block represented by this block entity.
** {{nbt|compound|movingBlock}}: The main layer of moving block represented by this block entity.
*** {{bedrock nbt|Block}}
*** {{bedrock nbt|Block}}
** {{nbt|compound|movingBlockExtra}}: The extra moving block layer represented by this block entity.
** {{nbt|compound|movingBlockExtra}}: The [[Minecraft:Waterlogging|extra moving block layer]] represented by this block entity.
*** {{bedrock nbt|Block}}
*** {{bedrock nbt|Block}}
** {{nbt|compound|movingEntity}}: (May not exist) The block entity stored in this moving block.
** {{nbt|compound|movingEntity}}: (May not exist) The block entity stored in this moving block.
Line 289: Line 298:


=== Note Block ===
=== Note Block ===
Additional fields for note block:
Additional fields for [[Minecraft:note block]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|byte|note}}: The pitch of the note block.
** {{nbt|byte|note}}: The pitch of the note block.


=== Nether Reactor ===
=== Nether Reactor Core ===
Additional fields for nether reactor:
Additional fields for [[Minecraft:nether reactor core]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|byte|HasFinished}}: 1 or 0 (true/false) - true if the reactor has completed its activation phase, and has gone dark.
** {{nbt|byte|HasFinished}}: 1 or 0 (true/false) - true if the reactor has completed its activation phase, and has gone dark.
Line 326: Line 335:


=== Sculk Catalyst ===
=== Sculk Catalyst ===
Additional fields for sculk catalyst:
Additional fields for [[Minecraft:sculk catalyst]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|list|cursors}}: List of charges associated with the sculk catalyst.
** {{nbt|list|cursors}}: List of charges associated with the sculk catalyst.
Line 339: Line 348:


=== Sculk Shrieker, Sculk Sensor, and Calibrated Sculk Sensor ===
=== Sculk Shrieker, Sculk Sensor, and Calibrated Sculk Sensor ===
Additional fields for sculk shrieker, sculk sensor, and calibrated sculk sensor:
Additional fields for [[Minecraft:sculk shrieker]], [[Minecraft:sculk sensor]], and [[Minecraft:calibrated sculk sensor]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|VibrationListener}}: The vibration event listener of the sculk shrieker, sculk sensor, and calibrated sculk sensor.
** {{nbt|compound|VibrationListener}}: The vibration event listener of the sculk shrieker, sculk sensor, and calibrated sculk sensor.
Line 361: Line 370:


=== Shulker Box ===
=== Shulker Box ===
Additional fields for shulker box:
Additional fields for [[Minecraft:shulker box]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{bedrock nbt|Chests|block}}
** {{bedrock nbt|Chests|block}}
Line 372: Line 381:
** {{nbt|compound|FrontText}}: A compound which discribes front text.
** {{nbt|compound|FrontText}}: A compound which discribes front text.
*** {{nbt|byte|HideGlowOutline}}: 1 or 0 (true/false) - true if the outer glow of a sign with glowing text does not show.
*** {{nbt|byte|HideGlowOutline}}: 1 or 0 (true/false) - true if the outer glow of a sign with glowing text does not show.
*** {{nbt|byte|IgnoreLighting}}: 1 or 0 (true/false) - true if the sign has been dyed with a glow ink sac.
*** {{nbt|byte|IgnoreLighting}}: 1 or 0 (true/false) - true if the sign has been dyed with a [[Minecraft:glow ink sac]].
*** {{nbt|byte|PersistFormatting}}: Unknown. Defaults to 1.
*** {{nbt|byte|PersistFormatting}}: Unknown. Defaults to 1.
*** {{nbt|int|SignTextColor}}: The color that has been used to dye the sign. Is a 32-bit encoded color, defaults to <code>-16777216</code> (black). One of <code>-986896</code> for "White", <code>-425955</code> for "Orange", <code>-3715395</code> for "Magenta", <code>-12930086</code> for "Light Blue", <code>-75715</code> for "Yellow", <code>-8337633</code> for "Lime", <code>-816214</code> for "Pink", <code>-12103854</code> for "Gray", <code>-6447721</code> for "Light Gray", <code>-15295332</code> for "Cyan", <code>-7785800</code> for "Purple", <code>-12827478</code> for "Blue", <code>-8170446</code> for "Brown", <code>-10585066</code> for "Green", <code>-5231066</code> for "Red", and <code>-16777216</code> for "Black".
*** {{nbt|int|SignTextColor}}: The color that has been used to dye the sign. Is a 32-bit encoded color, defaults to <code>-16777216</code> (black). One of <code>-986896</code> for "White", <code>-425955</code> for "Orange", <code>-3715395</code> for "Magenta", <code>-12930086</code> for "Light Blue", <code>-75715</code> for "Yellow", <code>-8337633</code> for "Lime", <code>-816214</code> for "Pink", <code>-12103854</code> for "Gray", <code>-6447721</code> for "Light Gray", <code>-15295332</code> for "Cyan", <code>-7785800</code> for "Purple", <code>-12827478</code> for "Blue", <code>-8170446</code> for "Brown", <code>-10585066</code> for "Green", <code>-5231066</code> for "Red", and <code>-16777216</code> for "Black".
Line 380: Line 389:


=== Skull ===
=== Skull ===
Additional fields for skull:
Additional fields for [[Minecraft:skull]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|byte|MouthMoving}}: 1 or 0 (true/false) - true if this dragon head's mouth is moving.
** {{nbt|byte|MouthMoving}}: 1 or 0 (true/false) - true if this dragon head's mouth is moving.
** {{nbt|int|MouthTickCount}}: The animation frame of the dragon head's mouth movement.{{needs testing}}
** {{nbt|int|MouthTickCount}}: The animation frame of the dragon head's mouth movement.{{needs testing}}
** {{nbt|float|Rotation}}: The rotation of this skull.{{more info}}
** {{nbt|float|Rotation}}: The rotation of this skull.{{more info}}
** {{nbt|byte|SkullType}}: The type of this skull. (unused, only exists for backwards compatibility for flattened IDs) 0 = Skeleton, 1 = Wither Skeleton, 2 = [[Minecraft:Zombie]], 3 = Player, 4 = Creeper, 5 = Ender Dragon, 6 = [[Minecraft:Piglin]].
** {{nbt|byte|SkullType}}: The type of this skull. (unused, only exists for backwards compatibility for flattened IDs) 0 = [[Minecraft:Skeleton]], 1 = [[Minecraft:Wither Skeleton]], 2 = [[Minecraft:Zombie]], 3 = [[Minecraft:Player]], 4 = [[Minecraft:Creeper]], 5 = [[Minecraft:Ender Dragon]], 6 = [[Minecraft:Piglin]].


=== Structure Block ===
=== Structure Block ===
Additional fields for structure block:
Additional fields for [[Minecraft:structure block]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|byte|animationMode}}: The mode of animation.{{more info}}
** {{nbt|byte|animationMode}}: The mode of animation.{{more info}}
Line 412: Line 421:


=== Suspicious Block ===
=== Suspicious Block ===
Additional fields for suspicious sand and suspicious gravel:
Additional fields for [[Minecraft:suspicious sand]] and [[Minecraft:suspicious gravel]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|brush_count}}: The number of times the suspicious block is being brushed by the player, from 1 to 10 (the item will be extracted when it reaches 10). If the player stops brushing, it will progressively return to 0. And if it hasn't been brushed yet, defaults to 0.
** {{nbt|int|brush_count}}: The number of times the suspicious block is being brushed by the player, from 1 to 10 (the item will be extracted when it reaches 10). If the player stops brushing, it will progressively return to 0. And if it hasn't been brushed yet, defaults to 0.
Line 423: Line 432:


=== Trial Spawner ===
=== Trial Spawner ===
Additional fields for trial spawner and ominous trial spawner:
Additional fields for [[Minecraft:trial spawner]] and [[Minecraft:ominous trial spawner]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|int|required_player_range}}: Between 1 and 128. Defaults to 14. &mdash; Maximum distance in blocks for players to join the battle.
** {{nbt|int|required_player_range}}: Between 1 and 128. Defaults to 14. &mdash; Maximum distance in blocks for players to join the battle.
Line 441: Line 450:
******* {{nbt|string|id}}: An entity ID.
******* {{nbt|string|id}}: An entity ID.
****** {{nbt|compound|equipment}}: Optional. Determines the equipment the entity will wear.
****** {{nbt|compound|equipment}}: Optional. Determines the equipment the entity will wear.
******* {{nbt|string|loot_table}}: A path to a loot table.
******* {{nbt|string|loot_table}}: A path to a [[Minecraft:loot table]].
******* {{nbt|compound|slot_drop_chances}}: Optional. Chances for the equipment to drop upon death.
******* {{nbt|compound|slot_drop_chances}}: Optional. Chances for the equipment to drop upon death.
******** {{nbt|float|head}}: Chance (0.0–1.0) for the head slot item to drop.
******** {{nbt|float|head}}: Chance (0.0–1.0) for the head slot item to drop.
Line 452: Line 461:
**** {{nbt|compound}}: A potential loot table.
**** {{nbt|compound}}: A potential loot table.
***** {{nbt|int|weight}}: The chance that this loot table gets picked in comparison to other loot table weights. Must be positive and at least 1.
***** {{nbt|int|weight}}: The chance that this loot table gets picked in comparison to other loot table weights. Must be positive and at least 1.
***** {{nbt|string|data}}: A path to a loot table.
***** {{nbt|string|data}}: A path to a [[Minecraft:loot table]].
*** {{nbt|string|items_to_drop_when_ominous}}: Defaults to <code>loot_tables/spawners/trial_chamber/items_to_drop_when_ominous.json</code> &mdash; A path to a loot table. Determines the items used by ominous item spawners spawned during the active phase when ominous. Ignored in normal mode.
*** {{nbt|string|items_to_drop_when_ominous}}: Defaults to <code>loot_tables/spawners/trial_chamber/items_to_drop_when_ominous.json</code> &mdash; A path to a [[Minecraft:loot table]]. Determines the items used by [[Minecraft:ominous item spawner]]s spawned during the active phase when ominous. Ignored in normal mode.
** {{nbt|compound|ominous_config}}: Optional, defaults to {{nbt|compound|normal_config}}. When individual entries are omitted, they also default to their setting in {{nbt|compound|normal_config}}. &mdash; The configuration to use when ominous.
** {{nbt|compound|ominous_config}}: Optional, defaults to {{nbt|compound|normal_config}}. When individual entries are omitted, they also default to their setting in {{nbt|compound|normal_config}}. &mdash; The configuration to use when ominous.
** {{nbt|list|registered_players}}: A set of player UUIDs. &mdash; All the players that have joined the battle.
** {{nbt|list|registered_players}}: A set of player UUIDs. &mdash; All the players that have joined the battle.
Line 467: Line 476:
*** {{nbt|int|Weight}}: Selection weight for the current active spawn.
*** {{nbt|int|Weight}}: Selection weight for the current active spawn.
*** {{nbt|compound|equipment}}: Optional. Same structure as the equipment found in {{nbt|list|spawn_potentials}}.
*** {{nbt|compound|equipment}}: Optional. Same structure as the equipment found in {{nbt|list|spawn_potentials}}.
** {{nbt|string|selected_loot_table}}: A path to the loot table that is given as reward. Unset if not currently giving rewards. Selected from {{nbt|list|loot_tables_to_eject}} after all mobs are defeated.
** {{nbt|string|selected_loot_table}}: A path to the [[Minecraft:loot table]] that is given as reward. Unset if not currently giving rewards. Selected from {{nbt|list|loot_tables_to_eject}} after all mobs are defeated.


=== Vault ===
=== Vault ===
Additional fields for [[Minecraft:vault]] and ominous vault:
Additional fields for [[Minecraft:vault]] and [[Minecraft:ominous vault]]:
* {{nbt|compound}}: The block entity's root tag.
* {{nbt|compound}}: The block entity's root tag.
** {{nbt|compound|config}}: Configuration data that does not automatically change. All fields are optional.
** {{nbt|compound|config}}: Configuration data that does not automatically change. All fields are optional.
*** {{nbt|float|activation_range}}: The range in blocks when the vault should activate. Defaults to 4.
*** {{nbt|float|activation_range}}: The range in blocks when the vault should activate. Defaults to 4.
*** {{nbt|float|deactivation_range}}: The range in blocks when the vault should deactivate. Defaults to 4.5.
*** {{nbt|float|deactivation_range}}: The range in blocks when the vault should deactivate. Defaults to 4.5.
*** {{nbt|string|loot_table}}: A path to the loot table that is ejected when unlocking the vault. Defaults to <code>loot_tables/chests/trial_chambers/reward.json</code> for ''normal'' vaults and <code>loot_tables/chests/trial_chambers/reward_ominous.json</code> for ''ominous'' vaults.
*** {{nbt|string|loot_table}}: A path to the [[Minecraft:loot table]] that is ejected when unlocking the vault. Defaults to <code>loot_tables/chests/trial_chambers/reward.json</code> for ''normal'' vaults and <code>loot_tables/chests/trial_chambers/reward_ominous.json</code> for ''ominous'' vaults.
*** {{nbt|string|override_loot_table_to_display}}: A path to the loot table that is used to display items in the vault. If not present, the game will use the {{nbt|string|loot_table}} field.
*** {{nbt|string|override_loot_table_to_display}}: A path to the loot table that is used to display items in the vault. If not present, the game will use the {{nbt|string|loot_table}} field.
*** {{nbt|compound|key_item}}: The key item that is used to check for valid keys. Defaults to <code>minecraft:trial_key</code> for ''normal'' vaults and <code>minecraft:ominous_trial_key</code> for ''ominous'' vaults.
*** {{nbt|compound|key_item}}: The key item that is used to check for valid keys. Defaults to <code>minecraft:trial_key</code> for ''normal'' vaults and <code>minecraft:ominous_trial_key</code> for ''ominous'' vaults.
Line 491: Line 500:
</div>
</div>


pt:Formato de nível da Edição Bedrock/Formatos de bloco-entidade
[[Minecraft:pt:Formato de nível da Edição Bedrock/Formatos de bloco-entidade]]
zh:基岩版存档格式/方块实体格式
[[Minecraft:zh:基岩版存档格式/方块实体格式]]
 
== History ==
{{HistoryTable
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||26.30|dev=Preview 26.30.27|The {{nbt|byte|isMovable}} field has been removed from all block entities.}}
|{{HistoryLine|||dev=Preview 26.30.28|The field {{nbt|int|BlockEntityVersion}} has been added to all block entities.|Added the DataDriven block-entity that controls all custom block entities.}}
}}

Latest revision as of 11:02, 16 May 2026

Template:Exclusive This page lists NBT structures of block entities Template:In.

A Minecraft:block entity is used by Minecraft to store information about a block that can't be stored in the block's block states.

Block Entity

All block entities share this base:

<section begin="blockentity format" />

Additional fields for block entity types

Additional fields for Minecraft:banner:

Beacon

Additional fields for Minecraft:beacon:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: The primary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected.
    • Template:Nbt: The secondary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected. When set without a primary effect, does nothing. When set to the same as the primary, the effect is given at level 2 (the normally available behavior for 5 effects). When set to a different value than the primary (normally only Regeneration), gives the effect at level 1.Template:Needs testing

Bed

Additional fields for Minecraft:bed:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: The data value that determines the color of the half-bed block. When a bed is broken, the color of the block entity at the bed's head becomes the color of the bed item when it drops. See Minecraft:Bed#Metadata.

Beehive and Bee Nest

Additional fields for Minecraft:beehive and bee nest:

Bell

Additional fields for Minecraft:bell:

Brewing Stand

Additional fields for Minecraft:brewing stand:

Campfire and Soul Campfire

Additional fields for Minecraft:campfire and Minecraft:soul campfire:

Cauldron

Additional fields for Minecraft:cauldron:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: (May not exist) This tag exists only if the cauldron stores dyed water; stores a 32-bit ARGB encoded color.
    • Template:Nbt: List of items in this container.
    • Template:Nbt: If the cauldron contains a potion, this tag stores the ID of that potion. If there is no potion stored, then this tag is set to -1.
    • Template:Nbt: If the cauldron contains a potion, this tag stores the type of that potion. 0 is normal, 1 is splash, 2 is lingering. If there is no potion stored, then this tag is set to -1.

Chalkboard

Additional fields for Minecraft:chalkboard:

Chemistry Tables

Additional fields for chemistry tables (Minecraft:compound creator, Minecraft:element constructor, Minecraft:lab table, Minecraft:material reducer):

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: (Only for Lab Table) The Aux value of the item to be spawned.
    • Template:Nbt: (Only for Lab Table) The numeral ID value of the item to be spawned.
    • Template:Nbt: (Only for Lab Table) The item stack amount of the item to be spawned.

Chests

Additional fields for Minecraft:chest, Minecraft:trapped chest, Minecraft:barrel, and Minecraft:ender chest:

Chiseled Bookshelf

Additional fields for Minecraft:chiseled bookshelf:

Command Blocks

Additional fields for Minecraft:command block:

Comparator

Additional fields for Minecraft:comparator:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: Represents the strength of the analog signal output of this redstone comparator.

Conduit

Additional fields for Minecraft:conduit:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: 1 or 0 (true/false) - true if it is active.
    • Template:Nbt: The Unique ID of the hostile mob the conduit is currently attacking. If there's no target, defaults to -1.

Copper Golem Statues

Additional fields for Minecraft:copper golem statue:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: Data for the entity associated with the statue.
    • Template:Nbt: The current visual pose of the statue from 0 to 3, 0 for standing pose, 1 for sitting pose, 2 for running pose and 3 for star pose.

Crafter

Additional fields for Minecraft:crafter:

Creaking Heart

Additional fields for Minecraft:creaking heart:

Decorated Pot

Additional fields for Minecraft:decorated pot:

Dispenser and Dropper

Additional fields for Minecraft:dispenser and Minecraft:dropper:

Enchanting Table

Additional fields for Minecraft:Enchanting table:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: (May not exist) The name of this enchanting table.
    • Template:Nbt: The clockwise rotation of the book in radians. Top of the book points West when 0.

End Gateway

Additional fields for Minecraft:end gateway:

Flower Pot

Additional fields for Minecraft:flower pot:

Furnace

Additional fields for Minecraft:furnace, Minecraft:smoker, and Minecraft:blast furnace:

Hopper

Additional fields for Minecraft:hopper:

Item Frame

Additional fields for Minecraft:item frame:

Jigsaw Block

Additional fields for Minecraft:jigsaw block:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: The block that this jigsaw block becomes.
    • Template:Nbt: The joint option value, either "rollable" or "aligned".
    • Template:Nbt: The jigsaw block's name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the target tag.
    • Template:Nbt: The jigsaw block's target name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the name tag.
    • Template:Nbt: The jigsaw block's target pool to select a structure from.

Jukebox

Additional fields for Minecraft:jukebox:

Lectern

Additional fields for Minecraft:lectern:

Lodestone

Additional fields for Minecraft:lodestone:

Monster Spawner

Additional fields for Minecraft:monster spawner:

Moving Block

Additional fields for Minecraft:moving block:

Note Block

Additional fields for Minecraft:note block:

Nether Reactor Core

Additional fields for Minecraft:nether reactor core:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: 1 or 0 (true/false) - true if the reactor has completed its activation phase, and has gone dark.
    • Template:Nbt: 1 or 0 (true/false) - true if the reactor has been activated, and has turned red.
    • Template:Nbt: Number of ticks the reactor has been active for. It finishes after 900 game ticks (45 seconds).

Piston

Additional fields for Minecraft:piston:

Sculk Catalyst

Additional fields for Minecraft:sculk catalyst:

Sculk Shrieker, Sculk Sensor, and Calibrated Sculk Sensor

Additional fields for Minecraft:sculk shrieker, Minecraft:sculk sensor, and Minecraft:calibrated sculk sensor:

Shelf

Additional fields for Minecraft:shelf:

Shulker Box

Additional fields for Minecraft:shulker box:

Sign and Hanging Sign

Additional fields for Minecraft:sign and hanging sign:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: A compound which discribes back text. The same structure as Template:Nbt.
    • Template:Nbt: A compound which discribes front text.
      • Template:Nbt: 1 or 0 (true/false) - true if the outer glow of a sign with glowing text does not show.
      • Template:Nbt: 1 or 0 (true/false) - true if the sign has been dyed with a Minecraft:glow ink sac.
      • Template:Nbt: Unknown. Defaults to 1.
      • Template:Nbt: The color that has been used to dye the sign. Is a 32-bit encoded color, defaults to -16777216 (black). One of -986896 for "White", -425955 for "Orange", -3715395 for "Magenta", -12930086 for "Light Blue", -75715 for "Yellow", -8337633 for "Lime", -816214 for "Pink", -12103854 for "Gray", -6447721 for "Light Gray", -15295332 for "Cyan", -7785800 for "Purple", -12827478 for "Blue", -8170446 for "Brown", -10585066 for "Green", -5231066 for "Red", and -16777216 for "Black".
      • Template:Nbt: The text on it.
      • Template:Nbt: Unknown.
    • Template:Nbt: 1 or 0 (true/false) - true if the text is locked with Minecraft:honeycomb.

Skull

Additional fields for Minecraft:skull:

Structure Block

Additional fields for Minecraft:structure block:

Suspicious Block

Additional fields for Minecraft:suspicious sand and Minecraft:suspicious gravel:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: The number of times the suspicious block is being brushed by the player, from 1 to 10 (the item will be extracted when it reaches 10). If the player stops brushing, it will progressively return to 0. And if it hasn't been brushed yet, defaults to 0.
    • Template:Nbt: The direction of the suspicious block that was brushed. 0 = Down, 1 = Up, 2 = North, 3 = South, 4 = West, 5 = East, or 6 if it has not been brushed yet.
    • Template:Nbt: (May not exist) The item in the suspicious block.
    • Template:Nbt: (May not exist) Loot table to be used to generate the hidden item when brushed.
    • Template:Nbt: (May not exist) Seed for generating the loot table. 0 or omitted use a random seed.
    • Template:Nbt: The type of suspicious block. Valid types are minecraft:suspicious_sand and minecraft:suspicious_gravel.

Trial Spawner

Additional fields for Minecraft:trial spawner and Minecraft:ominous trial spawner:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: Between 1 and 128. Defaults to 14. — Maximum distance in blocks for players to join the battle.
    • Template:Nbt: Optional, see configuration for defaults. — The configuration to use when not ominous.
      • Template:Nbt: Between 1 and 128. Defaults to 4. — Maximum distance in blocks that mobs can spawn.
      • Template:Nbt: Defaults to 6. — Total amount of mobs spawned before cooldown for a single player.
      • Template:Nbt: Defaults to 2. — The amount of spawned mobs from this spawner that are allowed to exist simultaneously.
      • Template:Nbt: Defaults to 2. — Amount of total mobs added for each additional player.
      • Template:Nbt: Defaults to 1. — Amount of simultaneous mobs added for each additional player.
      • Template:Nbt: Defaults to 20. — Time in ticks between spawn attempts.
      • Template:Nbt: Defaults to 36000. — Time in ticks of the cooldown period. Includes the time spend dispensing the reward.
      • Template:Nbt: List of possible entities to spawn.
      • Template:Nbt: List of possible loot tables to give as reward.
      • Template:Nbt: Defaults to loot_tables/spawners/trial_chamber/items_to_drop_when_ominous.json — A path to a Minecraft:loot table. Determines the items used by Minecraft:ominous item spawners spawned during the active phase when ominous. Ignored in normal mode.
    • Template:Nbt: Optional, defaults to Template:Nbt. When individual entries are omitted, they also default to their setting in Template:Nbt. — The configuration to use when ominous.
    • Template:Nbt: A set of player UUIDs. — All the players that have joined the battle.
    • Template:Nbt: A set of mob UUIDs. — The mobs that were spawned by this spawner and are still alive.
    • Template:Nbt: Gametime in ticks when the cooldown ends. 0 if not currently in cooldown.
    • Template:Nbt: Gametime in ticks when the next spawn attempt happens. 0 if not currently active.
    • Template:Nbt: The next mob to attempt to spawn. Selected from Template:Nbt after the last attempt. Determines the mob displayed in the spawner.
    • Template:Nbt: A path to the Minecraft:loot table that is given as reward. Unset if not currently giving rewards. Selected from Template:Nbt after all mobs are defeated.

Vault

Additional fields for Minecraft:vault and Minecraft:ominous vault:

  • Template:Nbt: The block entity's root tag.
    • Template:Nbt: Configuration data that does not automatically change. All fields are optional.
      • Template:Nbt: The range in blocks when the vault should activate. Defaults to 4.
      • Template:Nbt: The range in blocks when the vault should deactivate. Defaults to 4.5.
      • Template:Nbt: A path to the Minecraft:loot table that is ejected when unlocking the vault. Defaults to loot_tables/chests/trial_chambers/reward.json for normal vaults and loot_tables/chests/trial_chambers/reward_ominous.json for ominous vaults.
      • Template:Nbt: A path to the loot table that is used to display items in the vault. If not present, the game will use the Template:Nbt field.
      • Template:Nbt: The key item that is used to check for valid keys. Defaults to minecraft:trial_key for normal vaults and minecraft:ominous_trial_key for ominous vaults.
    • Template:Nbt: Data that is used to keep track of the current state of the vault.

Minecraft:pt:Formato de nível da Edição Bedrock/Formatos de bloco-entidade Minecraft:zh:基岩版存档格式/方块实体格式

History

Template:HistoryTable