Skip to main content

Register Block Entities

Simple Block Entity​

public static final BlockEntityTypeEntry<TimerBlockEntity> SIMPLE_TIMER_BE = REGISTRYLIB
        .blockEntity("simple_timer", TimerBlockEntity::new)
        .validBlock(FullBlockExample.STANDALONE_TIMER)
        .register();

Block Entity with Renderer​

public static final BlockEntityTypeEntry<TimerBlockEntity> TIMER_BLOCK_ENTITY = REGISTRYLIB
        .blockEntity("timer", TimerBlockEntity::new)
        .validBlocks(
                FullBlockExample.TIMER_TIER_1,
                FullBlockExample.TIMER_TIER_2,
                FullBlockExample.TIMER_TIER_3)
        .renderer(() -> TimerBlockEntityRenderer::new)
        .register();
warning

Renderer classes are client-only. Always wrap the renderer factory in a Supplier (as shown with () -> TimerBlockEntityRenderer::new) to keep client classes from loading on the dedicated server.

Common API Lookup​

MethodPurpose
blockEntity(name, factory)Create a BlockEntityBuilder
validBlock(entry)Bind a single host block
validBlocks(...)Bind multiple host blocks
renderer(supplier)Register the renderer factory (lazy-loaded)
register()Complete registration and return BlockEntityTypeEntry<T>

Common Patterns​

One BE, multiple blocks: Use .validBlocks(blockA, blockB, blockC) to attach the same logic to several host blocks.

No renderer needed: If the block entity has no visual behavior, omit .renderer(...) entirely.

Registration order: Register the block first (with its item, loot, tags), then attach the block entity afterward. This is the most stable order both to read and implement.

See Also​