Package net.neoforged.neoforge.capabilities

Class CapabilityListenerHolder

java.lang.Object

net.neoforged.neoforge.capabilities.CapabilityListenerHolder

@Internal
public class CapabilityListenerHolder
extends Object

Holder for capability listeners associated to a level.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	CapabilityListenerHolder.ListenerReference

Field Summary

Fields

Modifier and Type	Field	Description
private final it.unimi.dsi.fastutil.longs.Long2ReferenceMap<it.unimi.dsi.fastutil.longs.Long2ReferenceMap<Set<CapabilityListenerHolder.ListenerReference>>>	byChunkThenBlock	Map of chunk pos -> block pos -> listeners map.
private final ReferenceQueue<ICapabilityInvalidationListener>	queue	Reference queue for the listener references.

Constructor Summary

Constructors

Constructor	Description
CapabilityListenerHolder()

Method Summary

Modifier and Type	Method	Description
void	addListener(BlockPos pos, ICapabilityInvalidationListener listener)	Adds a listener.
void	clean()	Poll the reference queue, and remove garbage-collected listener references entries from byChunkThenBlock.
void	invalidateChunk(ChunkPos chunkPos)	Invalidates listeners at a specific chunk position.
private void	invalidateList(Set<CapabilityListenerHolder.ListenerReference> caches)
void	invalidatePos(BlockPos pos)	Invalidates listeners at a specific block position.

Methods inherited from class java.lang.Object

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

Field Details

byChunkThenBlock

private final it.unimi.dsi.fastutil.longs.Long2ReferenceMap<it.unimi.dsi.fastutil.longs.Long2ReferenceMap<Set<CapabilityListenerHolder.ListenerReference>>> byChunkThenBlock

Map of chunk pos -> block pos -> listeners map.

We have a two-level map to efficiently invalidate entire chunks at once.

queue

private final ReferenceQueue<ICapabilityInvalidationListener> queue

Reference queue for the listener references. This allows us to listen to reference garbage collection, and remove empty entries from byChunkThenBlock.

Constructor Details

CapabilityListenerHolder

public CapabilityListenerHolder()

Method Details

addListener

public void addListener(BlockPos pos,
 ICapabilityInvalidationListener listener)

Adds a listener.

invalidatePos

public void invalidatePos(BlockPos pos)

Invalidates listeners at a specific block position.

invalidateChunk

public void invalidateChunk(ChunkPos chunkPos)

Invalidates listeners at a specific chunk position.

invalidateList

private void invalidateList(Set<CapabilityListenerHolder.ListenerReference> caches)

clean

public void clean()

Poll the reference queue, and remove garbage-collected listener references entries from byChunkThenBlock.