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: Difference between revisions

From SAS Gaming Wiki
imported>SworderExert
Reverted edits made by user Outrowed: Item frames and paintings are "entities" in Java Edition, not "block entities".
 
SyncBot (talk | contribs)
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 [[Minecraft: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 [[Minecraft:block model]]s 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 {{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 [[Minecraft:bee]]s 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.
|-
|-
Line 38: Line 38:
|
|
* {{BlockLink|Sculk Catalyst}}
* {{BlockLink|Sculk Catalyst}}
| Stores [[Minecraft:Experience|xp levels]].
| 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, [[Minecraft:trapped chest]]s and [[Minecraft:shulker box]]es, renders the opening and closing animation.
* For [[Minecraft:chest]]s, trapped chests and shulker boxes, renders the opening and closing animation.
* For [[Minecraft:decorated pot]]s, renders the wobble animation.
* For decorated pots, renders the wobble animation.
|-
|-
|
|
Line 93: Line 93:
|
|
* {{BlockLink|Beacon}}
* {{BlockLink|Beacon}}
| Stores the pyramid level, active [[Minecraft:effect]]s, 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.
* 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 [[Minecraft:Mob spawning|spawn]]ed
* - 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 [[Minecraft:status effects]])
* - 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 [[Minecraft: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.
|-
|-
|
|
Line 140: Line 140:
|
|
* {{BlockLink|Jukebox}}
* {{BlockLink|Jukebox}}
| Stores the contained [[Minecraft:music disc]]s.
| 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 [[Minecraft:player head]]s, stores the player's skin information.
| 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 [[Minecraft:command]] text, its output strength, and the output text.
| Stores the command text, its output strength, and the output text.
|-
|-
|
|
Line 209: Line 209:
|
|
* {{BlockLink|Bell}}
* {{BlockLink|Bell}}
| Ticks regularly to apply the [[Minecraft: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.
|-
|-
Line 219: Line 219:
* {{BlockLink|Suspicious Sand}}
* {{BlockLink|Suspicious Sand}}
* {{BlockLink|Suspicious Gravel}}
* {{BlockLink|Suspicious Gravel}}
| Stores the [[Minecraft:loot table]] and contents.
| 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 [[Minecraft: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 {{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 [[Minecraft:structure block]] stop rendering beyond 96 blocks.
* The outlines created by a structure block stop rendering beyond 96 blocks.


== See also ==
== See also ==
* [[Minecraft:Block entity format]] – describes the save format for block entities
* Block entity format – describes the save format for block entities
* [[Minecraft:Entities]], which are all the dynamic, moving objects throughout the ''Minecraft'' world, plus several non-moving objects that resemble blocks.
* Entities, which are all the dynamic, moving objects throughout the ''Minecraft'' world, plus several non-moving objects that resemble blocks.
* [[Minecraft:Block states]], which are, like block entities, extra pieces of data that further define a block.
* 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| ]]


[[Minecraft:de:Blockobjektdaten]]
de:Blockobjektdaten
[[Minecraft:el:Block entity]]
el:Block entity
[[Minecraft:es:Entidad de bloque]]
es:Entidad de bloque
[[Minecraft:fr:Entité de bloc]]
fr:Entité de bloc
[[Minecraft:hu:Blokkentitás]]
hu:Blokkentitás
[[Minecraft:ja:ブロックエンティティ]]
ja:ブロックエンティティ
[[Minecraft:ko:블록 개체]]
ko:블록 개체
[[Minecraft:nl:Segment formaat]]
nl:Segment formaat
[[Minecraft:pl:Byty bloków]]
pl:Byty bloków
[[Minecraft:pt:Bloco-entidade]]
pt:Bloco-entidade
[[Minecraft:ru:Блок-сущность]]
ru:Блок-сущность
[[Minecraft:uk:Блок-сутність]]
uk:Блок-сутність
[[Minecraft:zh:方块实体]]
zh:方块实体

Revision as of 15:39, 9 April 2026

Template:Distinguish

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.
  • Ticks regularly to determine when the bees should exit.
Stores written text.
  • Renders the text and the sign itself.
Stores the Minecraft:redstone signal strength.
  • Listens for nearby vibrations.
Stores xp levels.
  • Listens for nearby deaths, and spreads charges.
Stores the number of activations.
  • Listens for nearby vibrations.
Stores colorTemplate:Only, the patterns, and a custom name.
  • Renders the banner with its patterns.
Stores its contents and a custom name for the interface.
  • For Minecraft:chests, trapped chests and shulker boxes, renders the opening and closing animation.
  • For decorated pots, renders the wobble animation.
Stores its contents, the cooking and fuel times, and a custom name for the interface.
  • Ticks regularly to advance the cooking time.
  • For Minecraft:campfires, renders the contained items.
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.
Stores the page the book is currently on.
  • Renders the book.
Stores its contents, which slots are disabled and the crafting cooldown.
  • Ticks regularly to advance the cooldown.
Stores the pyramid level, active effects, and contents.
  • Ticks regularly to check for a valid pyramid, and apply effects to nearby players.
  • Renders the Minecraft:beacon beam.
Stores the UUID of the transient creaking associated with this creaking heart.
Stores:
  • - the entity to be spawned
  • - 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 for the trial spawner
  • Ticks regularly to advance its cooldown, check for spawn conditions, and spawn mobs.
  • Renders the spinning entity inside.
Stores its loot configuration and tracked players.
  • Renders the spinning items inside.
Stores the note to be played.
Stores the contained Minecraft:item.
  • Renders the 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.
  • Renders the block.
Stores the contained music discs.
  • Regularly ticks to end the song when time has elapsed.
Stores a custom name for the interface.
  • Renders the book animation.
Stores the destination location.
  • Renders the block.
For player heads, stores the player's skin information.
  • Renders the block.
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.
  • Renders the block.
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.
  • Renders the block.
Ticks regularly to apply the glowing effect to nearby raiders when used.
  • Renders the swaying animation.
To link with a Minecraft:compass.
Stores the loot table and contents.
  • Renders the item while brushing.
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.
  • Stores whether items should be centered or aligned to the bottom.
Template:BlockLink Renders the block.
  • Stores the golem's custom name.

Render limits

Template: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:

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

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:方块实体