Package net.minecraft.world.level.block.entity

Class BlockEntity

java.lang.Object

net.neoforged.neoforge.attachment.AttachmentHolder

net.minecraft.world.level.block.entity.BlockEntity

All Implemented Interfaces:

IAttachmentHolder, IBlockEntityExtension

Direct Known Subclasses:

BannerBlockEntity, BaseContainerBlockEntity, BeaconBlockEntity, BedBlockEntity, BeehiveBlockEntity, BellBlockEntity, BlockPropertyTests.LightBlockEntity, BrushableBlockEntity, CampfireBlockEntity, ChiseledBookShelfBlockEntity, CommandBlockEntity, ComparatorBlockEntity, ConduitBlockEntity, CustomItemDisplayContextTest.ItemHangerBlockEntity, DaylightDetectorBlockEntity, DecoratedPotBlockEntity, EnchantingTableBlockEntity, EnderChestBlockEntity, FullPotsAccessorDemo.DioriteFlowerPotBlockEntity, GameTestTest.EnergyBlockEntity, JigsawBlockEntity, JukeboxBlockEntity, LecternBlockEntity, MegaModelTest.TestBlock.Entity, PistonMovingBlockEntity, SculkCatalystBlockEntity, SculkSensorBlockEntity, SculkShriekerBlockEntity, SignBlockEntity, SkullBlockEntity, SpawnerBlockEntity, StructureBlockEntity, TheEndPortalBlockEntity, TrialSpawnerBlockEntity, VaultBlockEntity

public abstract class BlockEntity
extends AttachmentHolder
implements IBlockEntityExtension

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	BlockEntity.ComponentHelper
protected static interface	BlockEntity.DataComponentInput

Nested classes/interfaces inherited from class net.neoforged.neoforge.attachment.AttachmentHolder

AttachmentHolder.AsField

Field Summary

Fields

Modifier and Type	Field	Description
private BlockState	blockState
private DataComponentMap	components
private CompoundTag	customPersistentData
protected Level	level
private static final org.slf4j.Logger	LOGGER
protected boolean	remove
private final BlockEntityType<?>	type	Deprecated.
protected final BlockPos	worldPosition

Fields inherited from class net.neoforged.neoforge.attachment.AttachmentHolder

ATTACHMENTS_NBT_KEY

Constructor Summary

Constructors

Constructor	Description
BlockEntity(BlockEntityType<?> pType, BlockPos pPos, BlockState pBlockState)

Method Summary

Modifier and Type	Method	Description
static void	addEntityType(CompoundTag pTag, BlockEntityType<?> pEntityType)
final void	applyComponents(DataComponentMap pComponents, DataComponentPatch pPatch)
final void	applyComponentsFromItemStack(ItemStack pStack)
protected void	applyImplicitComponents(BlockEntity.DataComponentInput pComponentInput)
void	clearRemoved()
final DataComponentMap	collectComponents()
protected void	collectImplicitComponents(DataComponentMap.Builder pComponents)
DataComponentMap	components()
void	fillCrashReportCategory(CrashReportCategory pReportCategory)
BlockPos	getBlockPos()
BlockState	getBlockState()
Level	getLevel()
private String	getNameForReporting()
CompoundTag	getPersistentData()	Gets a CompoundTag that can be used to store custom data for this block entity.
static BlockPos	getPosFromTag(CompoundTag pTag)
BlockEntityType<?>	getType()
Packet<ClientGamePacketListener>	getUpdatePacket()
CompoundTag	getUpdateTag(HolderLookup.Provider pRegistries)
boolean	hasLevel()
boolean	isRemoved()
boolean	isValidBlockState(BlockState p_353131_)
protected void	loadAdditional(CompoundTag pTag, HolderLookup.Provider pRegistries)
final void	loadCustomOnly(CompoundTag pTag, HolderLookup.Provider pRegistries)
static BlockEntity	loadStatic(BlockPos pPos, BlockState pState, CompoundTag pTag, HolderLookup.Provider pRegistries)
final void	loadWithComponents(CompoundTag pTag, HolderLookup.Provider pRegistries)
boolean	onlyOpCanSetNbt()
static Component	parseCustomNameSafe(String pCustomName, HolderLookup.Provider pRegistries)
void	removeComponentsFromTag(CompoundTag pTag)	Deprecated.
final <T> T	removeData(AttachmentType<T> type)	Removes the data attachment of the given type.
protected void	saveAdditional(CompoundTag pTag, HolderLookup.Provider pRegistries)
final CompoundTag	saveCustomAndMetadata(HolderLookup.Provider pRegistries)
final CompoundTag	saveCustomOnly(HolderLookup.Provider pRegistries)
private void	saveId(CompoundTag pTag)
private void	saveMetadata(CompoundTag pTag)
void	saveToItem(ItemStack pStack, HolderLookup.Provider pRegistries)
final CompoundTag	saveWithFullMetadata(HolderLookup.Provider pRegistries)
final CompoundTag	saveWithId(HolderLookup.Provider pRegistries)
final CompoundTag	saveWithoutMetadata(HolderLookup.Provider pRegistries)
void	setBlockState(BlockState pBlockState)	Deprecated.
void	setChanged()
protected static void	setChanged(Level pLevel, BlockPos pPos, BlockState pState)
void	setComponents(DataComponentMap pComponents)
final <T> T	setData(AttachmentType<T> type, T data)	Sets the data attachment of the given type.
void	setLevel(Level pLevel)
void	setRemoved()
boolean	triggerEvent(int pId, int pType)
private void	validateBlockState(BlockState p_353132_)

Methods inherited from class net.neoforged.neoforge.attachment.AttachmentHolder

deserializeAttachments, getData, getExistingDataOrNull, hasAttachments, hasData, serializeAttachments

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.neoforged.neoforge.attachment.IAttachmentHolder

getData, getExistingData, getExistingData, getExistingDataOrNull, hasData, removeData, setData

Methods inherited from interface net.neoforged.neoforge.common.extensions.IBlockEntityExtension

getModelData, handleUpdateTag, hasCustomOutlineRendering, invalidateCapabilities, onChunkUnloaded, onDataPacket, onLoad, requestModelDataUpdate

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

type

@Deprecated
private final BlockEntityType<?> type

Deprecated.

level

@Nullable
protected Level level

worldPosition

protected final BlockPos worldPosition

remove

protected boolean remove

blockState

private BlockState blockState

components

private DataComponentMap components

customPersistentData

@Nullable
private CompoundTag customPersistentData

Constructor Details

BlockEntity

public BlockEntity(BlockEntityType<?> pType,
 BlockPos pPos,
 BlockState pBlockState)

Method Details

validateBlockState

private void validateBlockState(BlockState p_353132_)

isValidBlockState

public boolean isValidBlockState(BlockState p_353131_)

getPosFromTag

public static BlockPos getPosFromTag(CompoundTag pTag)

getLevel

@Nullable
public Level getLevel()

setLevel

public void setLevel(Level pLevel)

hasLevel

public boolean hasLevel()

loadAdditional

protected void loadAdditional(CompoundTag pTag,
 HolderLookup.Provider pRegistries)

loadWithComponents

public final void loadWithComponents(CompoundTag pTag,
 HolderLookup.Provider pRegistries)

loadCustomOnly

public final void loadCustomOnly(CompoundTag pTag,
 HolderLookup.Provider pRegistries)

saveAdditional

protected void saveAdditional(CompoundTag pTag,
 HolderLookup.Provider pRegistries)

saveWithFullMetadata

public final CompoundTag saveWithFullMetadata(HolderLookup.Provider pRegistries)

saveWithId

public final CompoundTag saveWithId(HolderLookup.Provider pRegistries)

saveWithoutMetadata

public final CompoundTag saveWithoutMetadata(HolderLookup.Provider pRegistries)

saveCustomOnly

public final CompoundTag saveCustomOnly(HolderLookup.Provider pRegistries)

saveCustomAndMetadata

public final CompoundTag saveCustomAndMetadata(HolderLookup.Provider pRegistries)

saveId

private void saveId(CompoundTag pTag)

addEntityType

public static void addEntityType(CompoundTag pTag,
 BlockEntityType<?> pEntityType)

saveToItem

public void saveToItem(ItemStack pStack,
 HolderLookup.Provider pRegistries)

saveMetadata

private void saveMetadata(CompoundTag pTag)

loadStatic

@Nullable
public static BlockEntity loadStatic(BlockPos pPos,
 BlockState pState,
 CompoundTag pTag,
 HolderLookup.Provider pRegistries)

setChanged

public void setChanged()

setChanged

protected static void setChanged(Level pLevel,
 BlockPos pPos,
 BlockState pState)

getBlockPos

public BlockPos getBlockPos()

getBlockState

public BlockState getBlockState()

getUpdatePacket

@Nullable
public Packet<ClientGamePacketListener> getUpdatePacket()

getUpdateTag

public CompoundTag getUpdateTag(HolderLookup.Provider pRegistries)

isRemoved

public boolean isRemoved()

setRemoved

public void setRemoved()

clearRemoved

public void clearRemoved()

triggerEvent

public boolean triggerEvent(int pId,
 int pType)

fillCrashReportCategory

public void fillCrashReportCategory(CrashReportCategory pReportCategory)

getNameForReporting

private String getNameForReporting()

onlyOpCanSetNbt

public boolean onlyOpCanSetNbt()

getType

public BlockEntityType<?> getType()

getPersistentData

public CompoundTag getPersistentData()

Description copied from interface: IBlockEntityExtension

Gets a CompoundTag that can be used to store custom data for this block entity. It will be written, and read from disc, so it persists over world saves.

Specified by:

getPersistentData in interface IBlockEntityExtension

Returns:

A compound tag for custom persistent data

setData

@Nullable
public final <T> T setData(AttachmentType<T> type,
 T data)

Description copied from interface: IAttachmentHolder

Sets the data attachment of the given type.

Specified by:

setData in interface IAttachmentHolder

Overrides:

setData in class AttachmentHolder

Returns:

the previous value for that attachment type, if any, or null if there was none

removeData

@Nullable
public final <T> T removeData(AttachmentType<T> type)

Description copied from interface: IAttachmentHolder

Removes the data attachment of the given type.

Specified by:

removeData in interface IAttachmentHolder

Overrides:

removeData in class AttachmentHolder

Returns:

the previous value for that attachment type, if any, or null if there was none

setBlockState

@Deprecated
public void setBlockState(BlockState pBlockState)

Deprecated.

applyImplicitComponents

protected void applyImplicitComponents(BlockEntity.DataComponentInput pComponentInput)

applyComponentsFromItemStack

public final void applyComponentsFromItemStack(ItemStack pStack)

applyComponents

public final void applyComponents(DataComponentMap pComponents,
 DataComponentPatch pPatch)

collectImplicitComponents

protected void collectImplicitComponents(DataComponentMap.Builder pComponents)

removeComponentsFromTag

@Deprecated
public void removeComponentsFromTag(CompoundTag pTag)

Deprecated.

collectComponents

public final DataComponentMap collectComponents()

components

public DataComponentMap components()

setComponents

public void setComponents(DataComponentMap pComponents)

parseCustomNameSafe

@Nullable
public static Component parseCustomNameSafe(String pCustomName,
 HolderLookup.Provider pRegistries)