Struct BlockEntityRegistry 

pub struct BlockEntityRegistry {
    entries: Vec<BlockEntityEntry>,
}

Registry for block entity factories.

Maps BlockEntityType to factory functions that can create block entity instances. This is used when loading block entities from disk or when blocks with entities are placed.

Fields

entries: Vec<BlockEntityEntry>

Implementations

impl BlockEntityRegistry

pub fn new() -> Self

Creates a new empty registry with entries for all block entity types.

pub fn register( &mut self, block_entity_type: BlockEntityTypeRef, factory: BlockEntityFactory, )

Registers a factory function for a block entity type.

pub fn create( &self, block_entity_type: BlockEntityTypeRef, level: Weak<World>, pos: BlockPos, state: BlockStateId, ) -> Option<SharedBlockEntity>

Creates a new block entity instance.

Returns None if no factory is registered for the given type.

pub fn create_or_raw( &self, block_entity_type: BlockEntityTypeRef, level: Weak<World>, pos: BlockPos, state: BlockStateId, ) -> SharedBlockEntity

Creates a block entity, falling back to an NBT-preserving raw entity.

Use this for disk/worldgen paths where an unimplemented block entity type must still survive save/load. Gameplay paths that require concrete behavior should call Self::create and handle None.

pub fn create_and_load_or_raw( &self, block_entity_type: BlockEntityTypeRef, level: Weak<World>, pos: BlockPos, state: BlockStateId, nbt: &BorrowedNbtCompound<'_>, ) -> SharedBlockEntity

Creates a block entity and loads borrowed NBT, falling back to raw preservation.

pub fn create_and_load_owned_or_raw( &self, block_entity_type: BlockEntityTypeRef, level: Weak<World>, pos: BlockPos, state: BlockStateId, nbt: NbtCompound, ) -> SharedBlockEntity

Creates a block entity and loads owned NBT, falling back to raw preservation.

pub fn has_factory(&self, block_entity_type: BlockEntityTypeRef) -> bool

Returns whether a factory is registered for the given type.

Trait Implementations

impl Default for BlockEntityRegistry

fn default() -> Self

Returns the “default value” for a type.