程序包 net.neoforged.neoforge.capabilities

类 BlockCapabilityCache<T,C extends @Nullable Object>

java.lang.Object

net.neoforged.neoforge.capabilities.BlockCapabilityCache<T,C>

public final class BlockCapabilityCache<T,C extends @Nullable Object>
extends Object

A cache for block capabilities, to be used to track capabilities at a specific position, with a specific context.

The cache is invalidated when the level is notified of a change via ILevelExtension.invalidateCapabilities(BlockPos).

Instances are automatically cleared by the garbage collector when they are no longer in use.

字段概要

字段

修饰符和类型	字段	说明
private T	cachedCap
private boolean	cacheValid	true if notifications received by the cache will be forwarded to listener.
private boolean	canQuery
private final BlockCapability<T,C>	capability
private final C	context
private final ServerLevel	level
private final ICapabilityInvalidationListener	listener
private final BlockPos	pos

构造器概要

构造器

限定符	构造器	说明
private	BlockCapabilityCache(BlockCapability<T,C> capability, ServerLevel level, BlockPos pos, C context, BooleanSupplier isValid, Runnable invalidationListener)

方法概要

修饰符和类型	方法	说明
C	context()
static <T, C extends @Nullable Object> BlockCapabilityCache<T,C>	create(BlockCapability<T,C> capability, ServerLevel level, BlockPos pos, C context)	Creates a new cache instance and registers it to the level.
static <T, C extends @Nullable Object> BlockCapabilityCache<T,C>	create(BlockCapability<T,C> capability, ServerLevel level, BlockPos pos, C context, BooleanSupplier isValid, Runnable invalidationListener)	Creates a new cache instance with an invalidation listener, and registers it to the level.
T	getCapability()	Gets the capability instance, or null if the capability is not present.
ServerLevel	level()
BlockPos	pos()

从类继承的方法 java.lang.Object

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

字段详细资料

capability

private final BlockCapability<T,C extends @Nullable Object> capability

level

private final ServerLevel level

pos

private final BlockPos pos

context

private final C extends @Nullable Object context

cacheValid

private boolean cacheValid

true if notifications received by the cache will be forwarded to listener. By default and after each invalidation, this is set to false. Calling getCapability() sets it to true.

cachedCap

@Nullable
private T cachedCap

canQuery

private boolean canQuery

listener

private final ICapabilityInvalidationListener listener

构造器详细资料

BlockCapabilityCache

private BlockCapabilityCache(BlockCapability<T,C> capability,
 ServerLevel level,
 BlockPos pos,
 C context,
 BooleanSupplier isValid,
 Runnable invalidationListener)

方法详细资料

create

public static <T,
C extends @Nullable Object>
BlockCapabilityCache<T,C> create(BlockCapability<T,C> capability,
 ServerLevel level,
 BlockPos pos,
 C context)

Creates a new cache instance and registers it to the level.

参数:

capability - the capability

level - the level

pos - the position

context - extra context for the query

create

public static <T,
C extends @Nullable Object>
BlockCapabilityCache<T,C> create(BlockCapability<T,C> capability,
 ServerLevel level,
 BlockPos pos,
 C context,
 BooleanSupplier isValid,
 Runnable invalidationListener)

Creates a new cache instance with an invalidation listener, and registers it to the level.

A few details regarding the system:

• Calling getCapability() from the invalidation listener is not supported, as the block being invalidated might not be ready to be queried again yet. If you receive an invalidation notification, you should wait for some time (e.g. until your own tick) before checking getCapability() again.
• In general, do not perform any level access for the listener. The listener itself might be in a chunk that is being unloaded, for example.
• The listener does not receive notifications before getCapability() is called. After each invalidation, getCapability() must be called again to enable further notifications.

参数:

capability - the capability

level - the level

pos - the position

context - extra context for the query

isValid - a function to check if the listener still wants to receive notifications. A typical example would be () -> !this.isRemoved() for a block entity that should not receive invalidation notifications anymore once it is removed.

invalidationListener - the invalidation listener. Will be called whenever the capability of the cache might have changed.

level

public ServerLevel level()

pos

public BlockPos pos()

context

public C context()

getCapability

@Nullable
public T getCapability()

Gets the capability instance, or null if the capability is not present.

If the target position is not loaded, this method will return null.