Differences

This shows you the differences between two versions of the page.

--- tutorial:blockentity [2024/08/26 01:35] – solidblock
+++ tutorial:blockentity [2025/12/05 16:43] (current) – redirect to docs cassiancc
@@ Line 1: / Line 1: @@
+~~REDIRECT>https://docs.fabricmc.net/develop/blocks/block-entities~~
 ====== Adding a BlockEntity ======
@@ Line 29: / Line 31: @@
     [...]
-    public static final DemoBlock DEMO_BLOCK = register("demo_block", new DemoBlock(AbstractBlock.Settings.create()));
+    // For versions before 1.21.2
+    // public static final DemoBlock DEMO_BLOCK = register("demo_block", new DemoBlock(AbstractBlock.Settings.create()));
+    // For version 1.21.2 and later
+    public static final DemoBlock DEMO_BLOCK = register("demo_block", DemoBlock::new, AbstractBlock.Settings.create());
     [...]
@@ Line 43: / Line 49: @@
   public static final BlockEntityType<DemoBlockEntity> DEMO_BLOCK = register(
       "demo_block",
-      BlockEntityType.Builder.create(DemoBlockEntity::new, TutorialBlocks.DEMO_BLOCK).build()
+      // For versions before 1.21.2, please use BlockEntityType.Builder.
+      FabricBlockEntityTypeBuilder.create(DemoBlockEntity::new, TutorialBlocks.DEMO_BLOCK).build()
   );
@@ Line 68: / Line 75: @@
 For old versions, if you cannot access ''BlockEntityType.Builder.create'', try ''FabricBlockEntityTypeBuilder.create''.
-The block entity type defines that only the ''TutorialBlocks.DEMO_BLOCK'' can have this block entity type. If you want the block entity type to support more blocks, just add them in the parameters of ''BlockEntityType.Builder.create''. If the method reference ''DemoBlockEntity::new'' does not parse, check if the constructor of ''DemoBlockEntity'' has the correct parameters.
+The block entity type defines that only the ''TutorialBlocks.DEMO_BLOCK'' can have this block entity type. If you want the block entity type to support more blocks, just add them in the parameters of ''FabricBlockEntityTypeBuilder.create''. If the method reference ''DemoBlockEntity::new'' does not parse, check if the constructor of ''DemoBlockEntity'' has the correct parameters.
-==== Connecting the block entity and the block ====
+> **Note:** Like other blocks, the block also needs a block model and an item model, and may also need a loot table, see [[blocks]] for how to create them. As for loot tables, [[blockentity_sync_itemstack|subsequent tutorials]] will cover how to improve the loot tables to include block entity data.
-Once your ''BlockEntityType'' has been created and registered, you'll need a block that is associated with it. You can do this by extending ''BlockWithEntity'' (or implementing ''BlockEntityProvider'') and overriding ''createBlockEntity''. Each time your block is placed, your Block Entity will spawn alongside it.
+===== Connecting the block entity and the block =====
+Once your ''BlockEntityType'' has been created and registered, you'll need a block that is associated with it. You can do this by extending ''BlockWithEntity'' (or implementing ''BlockEntityProvider'') and overriding ''createBlockEntity''. Each time your block is placed, your block entity will be created.
 <code java DemoBlock.java>
@@ Line 88: / Line 97: @@
     public BlockEntity createBlockEntity(BlockPos pos, BlockState state) {
         return new DemoBlockEntity(pos, state);
+    }
+    @Override
+    protected BlockRenderType getRenderType(BlockState state) {
+        return BlockRenderType.MODEL;
     }
 }
 </code>
+Overriding ''getRenderType'' is because ''BlockWithEntity'' makes it invisible by default.
 ===== Block entity ticking =====
@@ Line 109: / Line 125: @@
 And in your ''BlockEntity'' class:
 <code java DemoBlockEntity.java>
-public class DemoBlockEntity extends BlockEntity {
+public class DemoBlockEntity extends BlockEntity implements BlockEntityTicker<DemoBlockEntity> {
     [...]