{{distinguish|Entity}}
A '''block entity''' (also known as a '''tile entity''') is an additional object associated with certain [[block]]s.
== Usage ==
Block entities can store additional information about their block, beyond the finite set of [[block states]] that 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 model]]s is also achieved with block entities.
Blocks with block entities can be moved by [[piston]]s {{in|be}}, but not {{in|je}}.
== List of block entities ==
These are the current blocks that hold block entities.
{| class="wikitable list-style-none" data-description="Blocks with block entities"
! Block Entity
! Usage
|-
|
* {{BlockLink|Beehive}}
* {{BlockLink|Bee Nest}}
| Stores [[bee]]s and their entity data.
* Ticks regularly to determine when the bees should exit.
|-
|
* {{BlockLink|Signs|id=oak sign}}
* {{BlockLink|Hanging Signs|id=oak hanging sign}}
* {{BlockLink|Chalkboard}}{{Only|be|ee|short=1}}
* {{BlockLink|Poster}}{{Only|be|ee|short=1}}
* {{BlockLink|Slate}}{{Only|be|ee|short=1}}
| Stores written text.
* Renders the text and the sign itself.
|-
|
* {{BlockLink|Sculk Sensor}}
* {{BlockLink|Calibrated Sculk Sensor}}
| Stores the [[redstone]] signal strength.
* Listens for nearby vibrations.
|-
|
* {{BlockLink|Sculk Catalyst}}
| Stores [[Experience|xp levels]].
* Listens for nearby deaths, and spreads charges.
|-
|
* {{BlockLink|Sculk Shrieker}}
| Stores the number of activations.
* Listens for nearby vibrations.
|-
|
* {{BlockLink|Banners}}
| Stores color{{only|be|short=1}}, the patterns, and a custom name.
* Renders the banner with its patterns.
|-
|
* {{BlockLink|Chest}}
* {{BlockLink|Trapped Chest}}
* {{BlockLink|Shulker Box}}
* {{BlockLink|id=Shulker Boxes|Dyed Shulker Box}}
* {{BlockLink|Dispenser}}
* {{BlockLink|Dropper}}
* {{BlockLink|Barrel}}
* {{BlockLink|Chiseled Bookshelf}}
* {{BlockLink|Decorated Pot}}
| Stores its contents and a custom name for the interface.
* For [[chest]]s, [[trapped chest]]s and [[shulker box]]es, renders the opening and closing animation.
* For [[decorated pot]]s, renders the wobble animation.
|-
|
* {{BlockLink|Furnace}}
* {{BlockLink|Smoker}}
* {{BlockLink|Blast Furnace}}
* {{BlockLink|Brewing Stand}}
* {{BlockLink|Campfire}}
* {{BlockLink|Soul Campfire}}
| Stores its contents, the cooking and fuel times, and a custom name for the interface.
* Ticks regularly to advance the cooking time.
* For [[campfire]]s, renders the contained items.
|-
|
* {{BlockLink|Hopper}}
| Stores its contents, the transfer cooldown, and a custom name for the interface.
* Ticks regularly to advance the cooldown and search for items to pull.
|-
|
* {{BlockLink|Lectern}}
| Stores the page the book is currently on.
* Renders the book.
|-
|
* {{BlockLink|Crafter}}
| Stores which slots are disabled and the crafting cooldown.
* Ticks regularly to advance the cooldown.
|-
|
* {{BlockLink|Beacon}}
| Stores the pyramid level, active [[effect]]s, and contents.
* Ticks regularly to check for a valid pyramid, and apply effects to nearby players.
* Renders the [[beacon]] beam.
|-
|
* {{BlockLink|Monster Spawner}}
* {{BlockLink|Trial Spawner}}
| Stores:
* - the entity to be [[spawn]]ed
* - 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
* - additional data about the entity to be spawned (such as equipment, and [[status effects]])
* - the loot reward
* Ticks regularly to advance its cooldown, check for spawn conditions, and spawn mobs.
* Renders the spinning entity inside.
|-
|
* {{BlockLink|Vault}}
| Stores its loot configuration and tracked players.
* Renders the spinning items inside.
|-
|
* {{BlockLink|Note Block}}{{only|be|short=1}}
| Stores the note to be played.
|-
|
* {{BlockLink|Item Frame}}{{only|be|short=1}}
* {{BlockLink|Glow Item Frame}}{{only|be|short=1}}
| Stores the contained [[item]].
* Renders the item.
|-
|
* {{BlockLink|Piston}}
* {{BlockLink|Sticky Piston}}
| Stores the offset of block, and blocks that it should move or [[break]].{{only|bedrock|short=1}} Also stores the moving process.
|-
|
* {{BlockLink|Moving Piston}}
| Stores the offset of block{{only|java|short=1}}, direction of movement{{only|java|short=1}}, and ID of the moving block.
* Renders the block.
|-
|
* {{BlockLink|Jukebox}}
| Stores the contained [[music disc]]s.
* Regularly ticks to end the song when time has elapsed.
|-
|
* {{BlockLink|Enchanting Table}}
| Stores a custom name for the interface.
* Renders the book animation.
|-
|
* {{BlockLink|End Portal|link=End Portal (block)}}
* {{BlockLink|End Gateway|link=End Gateway (block)}}
| Stores the destination location.
* Renders the block.
|-
|
* {{BlockLink|Player Head}}
* {{BlockLink|Zombie Head}}
* {{BlockLink|Skeleton Skull}}
* {{BlockLink|Wither Skeleton Skull}}
* {{BlockLink|Creeper Head}}
* {{BlockLink|Dragon Head}}
* {{BlockLink|Piglin Head}}
| {{IN|be}}, stores the type of the head and rotation.
* For [[player head]]s, stores the player's skin information.
* Renders the block.
|-
|
* {{BlockSprite|command-block}} {{BlockSprite|chain-command-block}} {{BlockSprite|repeating-command-block}} [[Command Block]]
| Stores the [[command]] text, its output strength, and the output text.
|-
|
* {{BlockSprite|structure-block-save}} {{BlockSprite|structure-block-corner}} {{BlockSprite|structure-block-data}} {{BlockSprite|structure-block-load}} [[Structure Block]]
| Stores information about the structure.
|-
|
* {{BlockLink|Jigsaw Block}}
| Stores the structure pool and the block this jigsaw block becomes.
|-
|
* {{BlockLink|Nether Reactor Core}}{{only|be|short=1}}
| Stores whether the reaction started and the time remaining in the reaction.
|-
|
* {{BlockLink|id=All Daylight detectors|Daylight Detector}}
| Ticks regularly to update its output signal strength.
|-
|
* {{BlockLink|Flower Pot}}{{only|be|short=1}}
| Stores the ID and the data value of the block displayed inside of it.
|-
|
* {{BlockLink|Redstone Comparator}}
| Stores its output strength.
|-
|
* {{BlockLink|id=red-bed|Bed}}
| Stores its color{{only|bedrock|short=1}}.
* Renders the block.
|-
|
* {{BlockLink|Cauldron}}{{only|be|short=1}}
| Stores details about [[fluid|liquid]] content. Cauldrons containing [[Cauldron#Applying dye to cauldron water|dyed water]] store water color. Cauldrons containing [[Cauldron#Filling cauldrons with potions|potions]] store the potion's ID and a tag of whether it is a splash potion or not.
|-
|
* {{BlockLink|Conduit}}
| Ticks regularly to check its activation area for valid activation blocks and apply effects to nearby players.
* Renders the block.
|-
|
* {{BlockLink|Bell}}
| Ticks regularly to apply the [[glowing]] effect to nearby raiders when used.
* Renders the swaying animation.
|-
|
* {{BlockLink|Lodestone}}{{only|be|short=1}}
| To link with a [[compass]].
|-
|
* {{BlockLink|Suspicious Sand}}
* {{BlockLink|Suspicious Gravel}}
| Stores the [[loot table]] and contents.
* Renders the item while brushing.
|-
|
* {{BlockLink|Compound Creator}}{{only|be|ee|short=1}}
{{BlockLink|Element Constructor}}{{only|be|ee|short=1}}
{{BlockLink|Lab Table}}{{only|be|ee|short=1}}
{{BlockLink|Material Reducer}}{{only|be|ee|short=1}}
| Stores the items in the lab table and the process of lab experiment.
|}
== Render limits ==
{{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 [[Video Settings]].
Some effects related to block entities stop rendering beyond a different number of blocks:
* The [[beacon]] and [[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 [[structure block]] stop rendering beyond 96 blocks.
== See also ==
* [[Chunk format#Block entity format|Chunk format § 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 ==
{{Navbox Java Edition technical|general}}
{{Navbox Bedrock Edition}}
[[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:Entidade de bloco]]
[[ru:Блок-сущность]]
[[uk:Блок-сутність]]
[[zh:方块实体]]