Package net.minecraft.block

Class BlockWithEntity

java.lang.Object

net.minecraft.block.AbstractBlock

net.minecraft.block.Block

net.minecraft.block.BlockWithEntity

All Implemented Interfaces:

BlockEntityProvider, ItemConvertible, ToggleableFeature

Direct Known Subclasses:

AbstractBannerBlock, AbstractChestBlock, AbstractFurnaceBlock, AbstractSignBlock, AbstractSkullBlock, BarrelBlock, BeaconBlock, BeehiveBlock, BellBlock, BrewingStandBlock, CampfireBlock, ChiseledBookshelfBlock, CommandBlock, ConduitBlock, DaylightDetectorBlock, DispenserBlock, EnchantingTableBlock, EndGatewayBlock, EndPortalBlock, HopperBlock, JukeboxBlock, LecternBlock, PistonExtensionBlock, SculkCatalystBlock, SculkSensorBlock, SculkShriekerBlock, ShulkerBoxBlock, SpawnerBlock, StructureBlock

public abstract class BlockWithEntity
extends Block
implements BlockEntityProvider

A convenience class for a block with a BlockEntity. While blocks with block entity only have to implement BlockEntityProvider and do not have to subclass this, it overrides several methods to delegate its logic to the block entity. However, it is generally easier to just implement BlockEntityProvider.

Subclasses must override getRenderType(net.minecraft.block.BlockState) to render the block entity. By default, all block entities are rendered invisible, which is not intended in most, if not all, cases.

See Also:

• BlockEntity
• BlockEntityProvider

Mappings:

Namespace	Name
official	cno
intermediary	net/minecraft/class_2237
named	net/minecraft/block/BlockWithEntity

Nested Class Summary

Nested classes/interfaces inherited from class net.minecraft.block.Block

Block.NeighborGroup

Nested classes/interfaces inherited from class net.minecraft.block.AbstractBlock

AbstractBlock.AbstractBlockState, AbstractBlock.ContextPredicate, AbstractBlock.OffsetType, AbstractBlock.Settings, AbstractBlock.TypedContextPredicate<A>

Field Summary

Fields inherited from class net.minecraft.block.Block

field_31022, field_31023, field_31024, field_31025, field_31035, FORCE_STATE, MOVED, NO_REDRAW, NOTIFY_ALL, NOTIFY_LISTENERS, NOTIFY_NEIGHBORS, REDRAW_ON_MAIN_THREAD, SKIP_DROPS, SKIP_LIGHTING_UPDATES, STATE_IDS, stateManager

Fields inherited from class net.minecraft.block.AbstractBlock

collidable, DIRECTIONS, dynamicBounds, jumpVelocityMultiplier, lootTableId, material, randomTicks, requiredFeatures, resistance, settings, slipperiness, soundGroup, velocityMultiplier

Fields inherited from interface net.minecraft.resource.featuretoggle.ToggleableFeature

FEATURE_ENABLED_REGISTRY_KEYS

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BlockWithEntity(AbstractBlock.Settings settings)

Method Summary

Modifier and Type	Method	Description
protected static <E extends BlockEntity, A extends BlockEntity> @Nullable BlockEntityTicker<A>	checkType(BlockEntityType<A> givenType, BlockEntityType<E> expectedType, BlockEntityTicker<? super E> ticker)	Returns the ticker if the given type and expected type are the same, or null if they are different.
@Nullable NamedScreenHandlerFactory	createScreenHandlerFactory(BlockState state, World world, BlockPos pos)	Returns the screen handler factory or null if screen handler cannot be created.
BlockRenderType	getRenderType(BlockState state)	Returns the block's render type (invisible, animated, model).
boolean	onSyncedBlockEvent(BlockState state, World world, BlockPos pos, int type, int data)	Handles the block event, which is an event specific to a block with an integer ID and data.

Methods inherited from class net.minecraft.block.Block

afterBreak, appendProperties, appendTooltip, asBlock, asItem, canMobSpawnInside, cannotConnect, createCuboidShape, dropExperience, dropExperienceWhenMined, dropStack, dropStack, dropStacks, dropStacks, dropStacks, dropStacks, getBlastResistance, getBlockFromItem, getDefaultState, getDroppedStacks, getDroppedStacks, getJumpVelocityMultiplier, getName, getPickStack, getPlacementState, getRawIdFromState, getRegistryEntry, getShapesForStates, getSlipperiness, getSoundGroup, getStateFromRawId, getStateManager, getStateWithProperties, getTranslationKey, getVelocityMultiplier, hasDynamicBounds, hasRandomTicks, hasTopRim, isFaceFullSquare, isShapeFullCube, isTranslucent, onBreak, onBroken, onDestroyedByExplosion, onEntityLand, onLandedUpon, onPlaced, onSteppedOn, postProcessState, precipitationTick, pushEntitiesUpBeforeBlockChange, randomDisplayTick, replace, replace, setDefaultState, shouldDrawSide, shouldDropItemsOnExplosion, sideCoversSmallSquare, spawnBreakParticles, toString

Methods inherited from class net.minecraft.block.AbstractBlock

calcBlockBreakingDelta, canBucketPlace, canPathfindThrough, canPlaceAt, canReplace, emitsRedstonePower, getAmbientOcclusionLightLevel, getCameraCollisionShape, getCollisionShape, getComparatorOutput, getCullingShape, getDefaultMapColor, getDroppedStacks, getFluidState, getHardness, getLootTableId, getMaxHorizontalModelOffset, getOpacity, getOutlineShape, getPistonBehavior, getRaycastShape, getRenderingSeed, getRequiredFeatures, getSidesShape, getStateForNeighborUpdate, getStrongRedstonePower, getVerticalModelOffsetMultiplier, getWeakRedstonePower, hasComparatorOutput, hasSidedTransparency, isCullingShapeFullCube, isShapeFullCube, isSideInvisible, mirror, neighborUpdate, onBlockAdded, onBlockBreakStart, onEntityCollision, onProjectileHit, onStacksDropped, onStateReplaced, onUse, prepare, randomTick, rotate, scheduledTick

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.minecraft.block.BlockEntityProvider

createBlockEntity, getGameEventListener, getTicker

Methods inherited from interface net.minecraft.resource.featuretoggle.ToggleableFeature

isEnabled

Constructor Details

BlockWithEntity

protected BlockWithEntity(AbstractBlock.Settings settings)

Mappings:

Namespace	Name	Mixin selector
official	<init>	Ldaa;<init>(Ldaa$c;)V
intermediary	<init>	Lnet/minecraft/class_4970;<init>(Lnet/minecraft/class_4970$class_2251;)V
named	<init>	Lnet/minecraft/block/AbstractBlock;<init>(Lnet/minecraft/block/AbstractBlock$Settings;)V

Method Details

getRenderType

public BlockRenderType getRenderType(BlockState state)

Returns the block's render type (invisible, animated, model).

Overrides:

getRenderType in class AbstractBlock

Returns:

the block's render type (invisible, animated, model)

Mappings:

Namespace	Name	Mixin selector
official	b_	Ldaa;b_(Ldab;)Lcua;
intermediary	method_9604	Lnet/minecraft/class_4970;method_9604(Lnet/minecraft/class_2680;)Lnet/minecraft/class_2464;
named	getRenderType	Lnet/minecraft/block/AbstractBlock;getRenderType(Lnet/minecraft/block/BlockState;)Lnet/minecraft/block/BlockRenderType;

onSyncedBlockEvent

public boolean onSyncedBlockEvent(BlockState state,
 World world,
 BlockPos pos,
 int type,
 int data)

Handles the block event, which is an event specific to a block with an integer ID and data.

Overrides:

onSyncedBlockEvent in class AbstractBlock

Returns:

whether the event was handled successfully

See Also:

• World.addSyncedBlockEvent(net.minecraft.util.math.BlockPos, net.minecraft.block.Block, int, int)

Mappings:

Namespace	Name	Mixin selector
official	a	Ldaa;a(Ldab;Lcle;Lgp;II)Z
intermediary	method_9592	Lnet/minecraft/class_4970;method_9592(Lnet/minecraft/class_2680;Lnet/minecraft/class_1937;Lnet/minecraft/class_2338;II)Z
named	onSyncedBlockEvent	Lnet/minecraft/block/AbstractBlock;onSyncedBlockEvent(Lnet/minecraft/block/BlockState;Lnet/minecraft/world/World;Lnet/minecraft/util/math/BlockPos;II)Z

createScreenHandlerFactory

@Nullable
public @Nullable NamedScreenHandlerFactory createScreenHandlerFactory(BlockState state,
 World world,
 BlockPos pos)

Returns the screen handler factory or null if screen handler cannot be created.

This method should be overridden for blocks with screen handlers, such as anvils. The created screen handler is usually passed to PlayerEntity.openHandledScreen(net.minecraft.screen.NamedScreenHandlerFactory). See AnvilBlock.createScreenHandlerFactory(net.minecraft.block.BlockState, net.minecraft.world.World, net.minecraft.util.math.BlockPos) for basic usage. BlockWithEntity delegates this logic to the block entity implementing NamedScreenHandlerFactory. For example, any BlockWithEntity whose block entity extends LockableContainerBlockEntity needs to override LockableContainerBlockEntity.createScreenHandler(int, net.minecraft.entity.player.PlayerInventory) instead of this method.

This method is called on both the logical client and logical server, so take caution when overriding this method. The logical side can be checked using World.isClient.

Overrides:

createScreenHandlerFactory in class AbstractBlock

Returns:

the screen handler factory or null if screen handler cannot be created

See Also:

• SimpleNamedScreenHandlerFactory
• LockableContainerBlockEntity

Mappings:

Namespace	Name	Mixin selector
official	b	Ldaa;b(Ldab;Lcle;Lgp;)Lbdj;
intermediary	method_17454	Lnet/minecraft/class_4970;method_17454(Lnet/minecraft/class_2680;Lnet/minecraft/class_1937;Lnet/minecraft/class_2338;)Lnet/minecraft/class_3908;
named	createScreenHandlerFactory	Lnet/minecraft/block/AbstractBlock;createScreenHandlerFactory(Lnet/minecraft/block/BlockState;Lnet/minecraft/world/World;Lnet/minecraft/util/math/BlockPos;)Lnet/minecraft/screen/NamedScreenHandlerFactory;

checkType

@Nullable
protected static <E extends BlockEntity,
A extends BlockEntity>
@Nullable BlockEntityTicker<A> checkType(BlockEntityType<A> givenType,
 BlockEntityType<E> expectedType,
 BlockEntityTicker<? super E> ticker)

Returns the ticker if the given type and expected type are the same, or null if they are different.

Returns:

the ticker if the given type and expected type are the same, or null if they are different

Mappings:

Namespace	Name	Mixin selector
official	a	Lcno;a(Lcxv;Lcxv;Lcxu;)Lcxu;
intermediary	method_31618	Lnet/minecraft/class_2237;method_31618(Lnet/minecraft/class_2591;Lnet/minecraft/class_2591;Lnet/minecraft/class_5558;)Lnet/minecraft/class_5558;
named	checkType	Lnet/minecraft/block/BlockWithEntity;checkType(Lnet/minecraft/block/entity/BlockEntityType;Lnet/minecraft/block/entity/BlockEntityType;Lnet/minecraft/block/entity/BlockEntityTicker;)Lnet/minecraft/block/entity/BlockEntityTicker;