Minecraft:Block entity: Difference between revisions
More actions
Remove broken links to missing pages |
Fix template calls: add MC/ prefix |
||
| Line 1: | Line 1: | ||
{{ | {{MC/Distinguish|Entity}} | ||
A '''block entity''' (also known as a '''tile entity''') is an additional object associated with certain [[Minecraft:block]]s. | A '''block entity''' (also known as a '''tile entity''') is an additional object associated with certain [[Minecraft:block]]s. | ||
| Line 6: | Line 6: | ||
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. | 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. | 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 {{ | Blocks with block entities can be moved by [[Minecraft:piston]]s {{MC/In|be}}, but not {{MC/In|je}}. | ||
== List of block entities == | == List of block entities == | ||
| Line 16: | Line 16: | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Beehive}} | ||
* {{ | * {{MC/Blocklink|Bee Nest}} | ||
| Stores bees and their entity data. | | Stores bees and their entity data. | ||
* Ticks regularly to determine when the bees should exit. | * Ticks regularly to determine when the bees should exit. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Signs|id=oak sign}} | ||
* {{ | * {{MC/Blocklink|Hanging Signs|id=oak hanging sign}} | ||
* {{ | * {{MC/Blocklink|Chalkboard}}{{Only|be|ee|short=1}} | ||
* {{ | * {{MC/Blocklink|Poster}}{{Only|be|ee|short=1}} | ||
* {{ | * {{MC/Blocklink|Slate}}{{Only|be|ee|short=1}} | ||
| Stores written text. | | Stores written text. | ||
* Renders the text and the sign itself. | * Renders the text and the sign itself. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Sculk Sensor}} | ||
* {{ | * {{MC/Blocklink|Calibrated Sculk Sensor}} | ||
| Stores the [[Minecraft:redstone]] signal strength. | | Stores the [[Minecraft:redstone]] signal strength. | ||
* Listens for nearby vibrations. | * Listens for nearby vibrations. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Sculk Catalyst}} | ||
| Stores xp levels. | | Stores xp levels. | ||
* Listens for nearby deaths, and spreads charges. | * Listens for nearby deaths, and spreads charges. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Sculk Shrieker}} | ||
| Stores the number of activations. | | Stores the number of activations. | ||
* Listens for nearby vibrations. | * Listens for nearby vibrations. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Banners}} | ||
| Stores color{{only|be|short=1}}, the patterns, and a custom name. | | Stores color{{only|be|short=1}}, the patterns, and a custom name. | ||
* Renders the banner with its patterns. | * Renders the banner with its patterns. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Chest}} | ||
* {{ | * {{MC/Blocklink|Trapped Chest}} | ||
* {{ | * {{MC/Blocklink|Shulker Box}} | ||
* {{ | * {{MC/Blocklink|id=Shulker Boxes|Dyed Shulker Box}} | ||
* {{ | * {{MC/Blocklink|Dispenser}} | ||
* {{ | * {{MC/Blocklink|Dropper}} | ||
* {{ | * {{MC/Blocklink|Barrel}} | ||
* {{ | * {{MC/Blocklink|Chiseled Bookshelf}} | ||
* {{ | * {{MC/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, trapped chests and shulker boxes, renders the opening and closing animation. | * For [[Minecraft:chest]]s, trapped chests and shulker boxes, renders the opening and closing animation. | ||
| Line 66: | Line 66: | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Furnace}} | ||
* {{ | * {{MC/Blocklink|Smoker}} | ||
* {{ | * {{MC/Blocklink|Blast Furnace}} | ||
* {{ | * {{MC/Blocklink|Brewing Stand}} | ||
* {{ | * {{MC/Blocklink|Campfire}} | ||
* {{ | * {{MC/Blocklink|Soul Campfire}} | ||
| Stores its contents, the cooking and fuel times, and a custom name for the interface. | | Stores its contents, the cooking and fuel times, and a custom name for the interface. | ||
* Ticks regularly to advance the cooking time. | * Ticks regularly to advance the cooking time. | ||
| Line 77: | Line 77: | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Hopper}} | ||
| Stores its contents, the transfer cooldown, and a custom name for the interface. | | 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. | * Ticks regularly to advance the cooldown and search for items to pull. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Lectern}} | ||
| Stores the page the book is currently on. | | Stores the page the book is currently on. | ||
* Renders the book. | * Renders the book. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Crafter}} | ||
| Stores its contents, which slots are disabled and the crafting cooldown. | | Stores its contents, which slots are disabled and the crafting cooldown. | ||
* Ticks regularly to advance the cooldown. | * Ticks regularly to advance the cooldown. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Beacon}} | ||
| Stores the pyramid level, active effects, and contents. | | 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. | ||
| Line 98: | Line 98: | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Creaking Heart}} | ||
| Stores the UUID of the transient creaking associated with this creaking heart. | | Stores the UUID of the transient creaking associated with this creaking heart. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Monster Spawner}} | ||
* {{ | * {{MC/Blocklink|Trial Spawner}} | ||
| Stores: | | Stores: | ||
* - the entity to be spawned | * - the entity to be spawned | ||
| Line 114: | Line 114: | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Vault}} | ||
| Stores its loot configuration and tracked players. | | Stores its loot configuration and tracked players. | ||
* Renders the spinning items inside. | * Renders the spinning items inside. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Note Block}}{{only|be|short=1}} | ||
| Stores the note to be played. | | Stores the note to be played. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Item Frame}}{{only|be|short=1}} | ||
* {{ | * {{MC/Blocklink|Glow Item Frame}}{{only|be|short=1}} | ||
| Stores the contained [[Minecraft:item]]. | | Stores the contained [[Minecraft:item]]. | ||
* Renders the item. | * Renders the item. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Piston}} | ||
* {{ | * {{MC/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. | | Stores the offset of block, and blocks that it should move or break.{{only|bedrock|short=1}} Also stores the moving process. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/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. | | 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. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Jukebox}} | ||
| Stores the contained music discs. | | 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. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Enchanting Table}} | ||
| Stores a custom name for the interface. | | Stores a custom name for the interface. | ||
* Renders the book animation. | * Renders the book animation. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|End Portal|link=End Portal (block)}} | ||
* {{ | * {{MC/Blocklink|End Gateway|link=End Gateway (block)}} | ||
| Stores the destination location. | | Stores the destination location. | ||
* Renders the block. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Player Head}} | ||
* {{ | * {{MC/Blocklink|Zombie Head}} | ||
* {{ | * {{MC/Blocklink|Skeleton Skull}} | ||
* {{ | * {{MC/Blocklink|Wither Skeleton Skull}} | ||
* {{ | * {{MC/Blocklink|Creeper Head}} | ||
* {{ | * {{MC/Blocklink|Dragon Head}} | ||
* {{ | * {{MC/Blocklink|Piglin Head}} | ||
| For player heads, stores the player's skin information. | | For player heads, stores the player's skin information. | ||
* Renders the block. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocksprite|command-block}} {{MC/Blocksprite|chain-command-block}} {{MC/Blocksprite|repeating-command-block}} [[Minecraft:Command Block]] | ||
| Stores the command text, its output strength, and the output text. | | Stores the command text, its output strength, and the output text. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocksprite|structure-block-save}} {{MC/Blocksprite|structure-block-corner}} {{MC/Blocksprite|structure-block-data}} {{MC/Blocksprite|structure-block-load}} [[Minecraft:Structure Block]] | ||
| Stores information about the structure. | | Stores information about the structure. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Jigsaw Block}} | ||
| Stores the structure pool and the block this jigsaw block becomes. | | Stores the structure pool and the block this jigsaw block becomes. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Nether Reactor Core}}{{only|be|short=1}} | ||
| Stores whether the reaction started and the time remaining in the reaction. | | Stores whether the reaction started and the time remaining in the reaction. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|id=Daylight Detectors|Daylight Detector}} | ||
| Ticks regularly to update its output signal strength. | | Ticks regularly to update its output signal strength. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Flower Pot}}{{only|be|short=1}} | ||
| Stores the ID and the data value of the block displayed inside of it. | | Stores the ID and the data value of the block displayed inside of it. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Redstone Comparator}} | ||
| Stores its output strength. | | Stores its output strength. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|id=red-bed|Bed}} | ||
| Stores its color{{only|bedrock|short=1}}. | | Stores its color{{only|bedrock|short=1}}. | ||
* Renders the block. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Cauldron}}{{only|be|short=1}} | ||
| Stores details about [[Minecraft:fluid|liquid]] content. Cauldrons containing [[Minecraft:Cauldron#Applying dye to cauldron water|dyed water]] store water color. Cauldrons containing [[Minecraft:Cauldron#Filling cauldrons with potions|potions]] store the potion's ID and a tag of whether it is a splash potion or not. | | Stores details about [[Minecraft:fluid|liquid]] content. Cauldrons containing [[Minecraft:Cauldron#Applying dye to cauldron water|dyed water]] store water color. Cauldrons containing [[Minecraft:Cauldron#Filling cauldrons with potions|potions]] store the potion's ID and a tag of whether it is a splash potion or not. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Conduit}} | ||
| Ticks regularly to check its activation area for valid activation blocks and apply effects to nearby players. | | Ticks regularly to check its activation area for valid activation blocks and apply effects to nearby players. | ||
* Renders the block. | * Renders the block. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Bell}} | ||
| Ticks regularly to apply the glowing effect to nearby raiders when used. | | Ticks regularly to apply the glowing effect to nearby raiders when used. | ||
* Renders the swaying animation. | * Renders the swaying animation. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Lodestone}}{{only|be|short=1}} | ||
| To link with a [[Minecraft:compass]]. | | To link with a [[Minecraft:compass]]. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Suspicious Sand}} | ||
* {{ | * {{MC/Blocklink|Suspicious Gravel}} | ||
| Stores the loot table and contents. | | Stores the loot table and contents. | ||
* Renders the item while brushing. | * Renders the item while brushing. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Compound Creator}}{{only|be|ee|short=1}}<br>{{MC/Blocklink|Element Constructor}}{{only|be|ee|short=1}}<br>{{MC/Blocklink|Lab Table}}{{only|be|ee|short=1}}<br>{{MC/Blocklink|Material Reducer}}{{only|be|ee|short=1}} | ||
| Stores the items in the lab table and the process of lab experiment. | | Stores the items in the lab table and the process of lab experiment. | ||
|- | |- | ||
| | | | ||
* {{ | * {{MC/Blocklink|Ender chest}} | ||
| Renders the opening and closing animation. | | Renders the opening and closing animation. | ||
|- | |- | ||
|{{ | |{{MC/Blocklink|Shelf}} | ||
| Stores and renders items. | | Stores and renders items. | ||
* Stores whether items should be centered or aligned to the bottom. | * Stores whether items should be centered or aligned to the bottom. | ||
|- | |- | ||
|{{ | |{{MC/Blocklink|Copper Golem Statue}} | ||
| Renders the block. | | Renders the block. | ||
* Stores the golem's custom name. | * Stores the golem's custom name. | ||
| Line 240: | Line 240: | ||
== Render limits == | == Render limits == | ||
{{Exclusive|java|section=1}} | {{MC/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. | 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 {{ | * The [[Minecraft:beacon]] and [[Minecraft:End Gateway (block)|end gateway]] beams stop rendering beyond 256 blocks {{MC/In|JE}} or 64 blocks {{MC/In|BE}} or when the end gateway is out of frame. | ||
* The outlines created by a structure block stop rendering beyond 96 blocks. | * The outlines created by a structure block stop rendering beyond 96 blocks. | ||
| Line 254: | Line 254: | ||
== Navigation == | == Navigation == | ||
{{Navbox Java Edition technical|general}} | {{MC/Navbox Java Edition technical|general}} | ||
{{Navbox Bedrock Edition}} | {{MC/Navbox Bedrock Edition}} | ||
[[Category:Block entities| ]] | [[Category:Block entities| ]] | ||
Revision as of 19:54, 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 in Template:Editions, but not in Template:Editions.
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. |
|
Stores and renders items.
|
|
Renders the block.
|
Render limits
Script error: No such module "Exclusive".
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 in Template:Editions or 64 blocks in Template:Editions 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.
| Editions |
| ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Development |
| ||||||||
| Technical |
| ||||||||
| Multiplayer | |||||||||
| Exclusive features |
| ||||||||
| Removed |
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:方块实体