Minecraft:Block entity: Difference between revisions
More actions
imported>SworderExert Reverted edits made by user Outrowed: Item frames and paintings are "entities" in Java Edition, not "block entities". |
Remove broken links to missing pages |
||
| Line 4: | Line 4: | ||
== Usage == | == Usage == | ||
Block entities can store additional information about their block, beyond the finite set of | Block entities can store additional information about their block, beyond the finite set of block states that a block may have. For example, all blocks that can store items use a block entity for this purpose. Block entities can also tick, running code regularly while loaded, even when not interacted with directly. | ||
Complex rendering not available to normal | Complex rendering not available to normal block models is also achieved with block entities. | ||
Blocks with block entities can be moved by [[Minecraft:piston]]s {{in|be}}, but not {{in|je}}. | Blocks with block entities can be moved by [[Minecraft:piston]]s {{in|be}}, but not {{in|je}}. | ||
| Line 18: | Line 18: | ||
* {{BlockLink|Beehive}} | * {{BlockLink|Beehive}} | ||
* {{BlockLink|Bee Nest}} | * {{BlockLink|Bee Nest}} | ||
| Stores | | Stores bees and their entity data. | ||
* Ticks regularly to determine when the bees should exit. | * Ticks regularly to determine when the bees should exit. | ||
|- | |- | ||
| Line 38: | Line 38: | ||
| | | | ||
* {{BlockLink|Sculk Catalyst}} | * {{BlockLink|Sculk Catalyst}} | ||
| Stores | | Stores xp levels. | ||
* Listens for nearby deaths, and spreads charges. | * Listens for nearby deaths, and spreads charges. | ||
|- | |- | ||
| Line 62: | Line 62: | ||
* {{BlockLink|Decorated Pot}} | * {{BlockLink|Decorated Pot}} | ||
| Stores its contents and a custom name for the interface. | | Stores its contents and a custom name for the interface. | ||
* For [[Minecraft:chest]]s, | * For [[Minecraft:chest]]s, trapped chests and shulker boxes, renders the opening and closing animation. | ||
* For | * For decorated pots, renders the wobble animation. | ||
|- | |- | ||
| | | | ||
| Line 93: | Line 93: | ||
| | | | ||
* {{BlockLink|Beacon}} | * {{BlockLink|Beacon}} | ||
| Stores the pyramid level, active | | Stores the pyramid level, active effects, and contents. | ||
* Ticks regularly to check for a valid pyramid, and apply effects to nearby players. | * Ticks regularly to check for a valid pyramid, and apply effects to nearby players. | ||
* Renders the [[Minecraft:beacon]] beam. | * Renders the [[Minecraft:beacon]] beam. | ||
| Line 105: | Line 105: | ||
* {{BlockLink|Trial Spawner}} | * {{BlockLink|Trial Spawner}} | ||
| Stores: | | Stores: | ||
* - the entity to be | * - the entity to be spawned | ||
* - the delay until the next entity is spawned, and the min and max values for the next spawn delay | * - the delay until the next entity is spawned, and the min and max values for the next spawn delay | ||
* - how many entities to spawn per spawn attempt | * - how many entities to spawn per spawn attempt | ||
* - additional data about the entity to be spawned (such as equipment, and | * - additional data about the entity to be spawned (such as equipment, and status effects) | ||
* - the loot reward for the trial spawner | * - the loot reward for the trial spawner | ||
* Ticks regularly to advance its cooldown, check for spawn conditions, and spawn mobs. | * Ticks regularly to advance its cooldown, check for spawn conditions, and spawn mobs. | ||
| Line 131: | Line 131: | ||
* {{BlockLink|Piston}} | * {{BlockLink|Piston}} | ||
* {{BlockLink|Sticky Piston}} | * {{BlockLink|Sticky Piston}} | ||
| Stores the offset of block, and blocks that it should move or | | Stores the offset of block, and blocks that it should move or break.{{only|bedrock|short=1}} Also stores the moving process. | ||
|- | |- | ||
| | | | ||
| Line 140: | Line 140: | ||
| | | | ||
* {{BlockLink|Jukebox}} | * {{BlockLink|Jukebox}} | ||
| Stores the contained | | Stores the contained music discs. | ||
* Regularly ticks to end the song when time has elapsed. | * Regularly ticks to end the song when time has elapsed. | ||
|- | |- | ||
| Line 162: | Line 162: | ||
* {{BlockLink|Dragon Head}} | * {{BlockLink|Dragon Head}} | ||
* {{BlockLink|Piglin Head}} | * {{BlockLink|Piglin Head}} | ||
| For | | For player heads, stores the player's skin information. | ||
* Renders the block. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{BlockSprite|command-block}} {{BlockSprite|chain-command-block}} {{BlockSprite|repeating-command-block}} [[Minecraft:Command Block]] | * {{BlockSprite|command-block}} {{BlockSprite|chain-command-block}} {{BlockSprite|repeating-command-block}} [[Minecraft:Command Block]] | ||
| Stores the | | Stores the command text, its output strength, and the output text. | ||
|- | |- | ||
| | | | ||
| Line 209: | Line 209: | ||
| | | | ||
* {{BlockLink|Bell}} | * {{BlockLink|Bell}} | ||
| Ticks regularly to apply the | | Ticks regularly to apply the glowing effect to nearby raiders when used. | ||
* Renders the swaying animation. | * Renders the swaying animation. | ||
|- | |- | ||
| Line 219: | Line 219: | ||
* {{BlockLink|Suspicious Sand}} | * {{BlockLink|Suspicious Sand}} | ||
* {{BlockLink|Suspicious Gravel}} | * {{BlockLink|Suspicious Gravel}} | ||
| Stores the | | Stores the loot table and contents. | ||
* Renders the item while brushing. | * Renders the item while brushing. | ||
|- | |- | ||
| Line 242: | Line 242: | ||
{{Exclusive|java|section=1}} | {{Exclusive|java|section=1}} | ||
Block entity rendering stops beyond a hard-coded block limit which is modeled after the radius of a sphere. This limit is ''not'' affected by the Render Distance nor the Entity Distance scale in the | Block entity rendering stops beyond a hard-coded block limit which is modeled after the radius of a sphere. This limit is ''not'' affected by the Render Distance nor the Entity Distance scale in the Video Settings. | ||
Some effects related to block entities stop rendering beyond a different number of blocks: | Some effects related to block entities stop rendering beyond a different number of blocks: | ||
* The [[Minecraft:beacon]] and [[Minecraft:End Gateway (block)|end gateway]] beams stop rendering beyond 256 blocks {{in|JE}} or 64 blocks {{in|BE}} or when the end gateway is out of frame. | * The [[Minecraft:beacon]] and [[Minecraft:End Gateway (block)|end gateway]] beams stop rendering beyond 256 blocks {{in|JE}} or 64 blocks {{in|BE}} or when the end gateway is out of frame. | ||
* The outlines created by a | * The outlines created by a structure block stop rendering beyond 96 blocks. | ||
== See also == | == See also == | ||
* | * Block entity format – describes the save format for block entities | ||
* | * Entities, which are all the dynamic, moving objects throughout the ''Minecraft'' world, plus several non-moving objects that resemble blocks. | ||
* | * Block states, which are, like block entities, extra pieces of data that further define a block. | ||
== Navigation == | == Navigation == | ||
| Line 259: | Line 259: | ||
[[Category:Block entities| ]] | [[Category:Block entities| ]] | ||
de:Blockobjektdaten | |||
el:Block entity | |||
es:Entidad de bloque | |||
fr:Entité de bloc | |||
hu:Blokkentitás | |||
ja:ブロックエンティティ | |||
ko:블록 개체 | |||
nl:Segment formaat | |||
pl:Byty bloków | |||
pt:Bloco-entidade | |||
ru:Блок-сущность | |||
uk:Блок-сутність | |||
zh:方块实体 | |||
Revision as of 15:39, 9 April 2026
A block entity (also known as a tile entity) is an additional object associated with certain Minecraft:blocks.
Usage
Block entities can store additional information about their block, beyond the finite set of block states that a block may have. For example, all blocks that can store items use a block entity for this purpose. Block entities can also tick, running code regularly while loaded, even when not interacted with directly. Complex rendering not available to normal block models is also achieved with block entities. Blocks with block entities can be moved by Minecraft:pistons Template:In, but not Template:In.
List of block entities
These are the current blocks that hold block entities.
| Block Entity | Usage |
|---|---|
Stores bees and their entity data.
| |
Stores written text.
| |
Stores the Minecraft:redstone signal strength.
| |
Stores xp levels.
| |
Stores the number of activations.
| |
Stores colorTemplate:Only, the patterns, and a custom name.
| |
Stores its contents and a custom name for the interface.
| |
Stores its contents, the cooking and fuel times, and a custom name for the interface.
| |
Stores its contents, the transfer cooldown, and a custom name for the interface.
| |
Stores the page the book is currently on.
| |
Stores its contents, which slots are disabled and the crafting cooldown.
| |
Stores the pyramid level, active effects, and contents.
| |
| Stores the UUID of the transient creaking associated with this creaking heart. | |
Stores:
| |
Stores its loot configuration and tracked players.
| |
| Stores the note to be played. | |
Stores the contained Minecraft:item.
| |
| Stores the offset of block, and blocks that it should move or break.Template:Only Also stores the moving process. | |
Stores the offset of blockTemplate:Only, direction of movementTemplate:Only, and ID of the moving block.
| |
Stores the contained music discs.
| |
Stores a custom name for the interface.
| |
Stores the destination location.
| |
For player heads, stores the player's skin information.
| |
| Stores the command text, its output strength, and the output text. | |
| Stores information about the structure. | |
| Stores the structure pool and the block this jigsaw block becomes. | |
| Stores whether the reaction started and the time remaining in the reaction. | |
| Ticks regularly to update its output signal strength. | |
| Stores the ID and the data value of the block displayed inside of it. | |
| Stores its output strength. | |
Stores its colorTemplate:Only.
| |
| Stores details about liquid content. Cauldrons containing dyed water store water color. Cauldrons containing potions store the potion's ID and a tag of whether it is a splash potion or not. | |
Ticks regularly to check its activation area for valid activation blocks and apply effects to nearby players.
| |
Ticks regularly to apply the glowing effect to nearby raiders when used.
| |
| To link with a Minecraft:compass. | |
Stores the loot table and contents.
| |
| Stores the items in the lab table and the process of lab experiment. | |
| Renders the opening and closing animation. | |
| Template:BlockLink | Stores and renders items.
|
| Template:BlockLink | Renders the block.
|
Render limits
Block entity rendering stops beyond a hard-coded block limit which is modeled after the radius of a sphere. This limit is not affected by the Render Distance nor the Entity Distance scale in the Video Settings.
Some effects related to block entities stop rendering beyond a different number of blocks:
- The Minecraft:beacon and end gateway beams stop rendering beyond 256 blocks Template:In or 64 blocks Template:In or when the end gateway is out of frame.
- The outlines created by a structure block stop rendering beyond 96 blocks.
See also
- Block entity format – describes the save format for block entities
- Entities, which are all the dynamic, moving objects throughout the Minecraft world, plus several non-moving objects that resemble blocks.
- Block states, which are, like block entities, extra pieces of data that further define a block.
Template:Navbox Java Edition technical Template:Navbox Bedrock Edition
de:Blockobjektdaten el:Block entity es:Entidad de bloque fr:Entité de bloc hu:Blokkentitás ja:ブロックエンティティ ko:블록 개체 nl:Segment formaat pl:Byty bloków pt:Bloco-entidade ru:Блок-сущность uk:Блок-сутність zh:方块实体