Package net.minecraft.server.level

Class ChunkMap

java.lang.Object

net.minecraft.world.level.chunk.storage.ChunkStorage

net.minecraft.server.level.ChunkMap

All Implemented Interfaces:

AutoCloseable, ChunkHolder.PlayerProvider, GeneratingChunkMap

public class ChunkMap
extends ChunkStorage
implements ChunkHolder.PlayerProvider, GeneratingChunkMap

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) class	ChunkMap.DistanceManager
(package private) class	ChunkMap.TrackedEntity

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	CHUNK_SAVED_EAGERLY_PER_TICK
private static final int	CHUNK_SAVED_PER_TICK
private static final byte	CHUNK_TYPE_FULL
private static final byte	CHUNK_TYPE_REPLACEABLE
private static final byte	CHUNK_TYPE_UNKNOWN
private final ChunkGeneratorStructureState	chunkGeneratorState
private final it.unimi.dsi.fastutil.longs.Long2LongMap	chunkSaveCooldowns
private final ChunkStatusUpdateListener	chunkStatusListener
private final it.unimi.dsi.fastutil.longs.Long2ByteMap	chunkTypeCache
private final ChunkMap.DistanceManager	distanceManager
private static final int	EAGER_CHUNK_SAVE_COOLDOWN_IN_MILLIS
private final it.unimi.dsi.fastutil.ints.Int2ObjectMap<ChunkMap.TrackedEntity>	entityMap
static final int	FORCED_TICKET_LEVEL
(package private) final ServerLevel	level
private final ThreadedLevelLightEngine	lightEngine
private static final org.slf4j.Logger	LOGGER
private final BlockableEventLoop<Runnable>	mainThreadExecutor
private final ProcessorHandle<ChunkTaskPriorityQueueSorter.Message<Runnable>>	mainThreadMailbox
static final int	MAX_VIEW_DISTANCE
static final int	MIN_VIEW_DISTANCE
private boolean	modified
private final Supplier<DimensionDataStorage>	overworldDataStorage
private final List<ChunkGenerationTask>	pendingGenerationTasks
private final it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder>	pendingUnloads
private final PlayerMap	playerMap
private final PoiManager	poiManager
private final ChunkProgressListener	progressListener
private final ChunkTaskPriorityQueueSorter	queueSorter
private final RandomState	randomState
private int	serverViewDistance
private final String	storageName
private final AtomicInteger	tickingGenerated
(package private) final it.unimi.dsi.fastutil.longs.LongSet	toDrop
private static final CompletableFuture<ChunkResult<List<ChunkAccess>>>	UNLOADED_CHUNK_LIST_FUTURE
private static final ChunkResult<List<ChunkAccess>>	UNLOADED_CHUNK_LIST_RESULT
private final Queue<Runnable>	unloadQueue
private final it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder>	updatingChunkMap
private it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder>	visibleChunkMap
private final WorldGenContext	worldGenContext
private final ProcessorHandle<ChunkTaskPriorityQueueSorter.Message<Runnable>>	worldgenMailbox

Fields inherited from class net.minecraft.world.level.chunk.storage.ChunkStorage

fixerUpper, LAST_MONOLYTH_STRUCTURE_DATA_VERSION

Constructor Summary

Constructors

Constructor

Description

ChunkMap(ServerLevel p_214836_, LevelStorageSource.LevelStorageAccess p_214837_, com.mojang.datafixers.DataFixer p_214838_, StructureTemplateManager p_214839_, Executor p_214840_, BlockableEventLoop<Runnable> p_214841_, LightChunkGetter p_214842_, ChunkGenerator p_214843_, ChunkProgressListener p_214844_, ChunkStatusUpdateListener p_214845_, Supplier<DimensionDataStorage> p_214846_, int p_214847_, boolean p_214848_)

Method Summary

Modifier and Type	Method	Description
GenerationChunkHolder	acquireGeneration(long p_347661_)
protected void	addEntity(Entity p_140200_)
(package private) boolean	anyPlayerCloseEnoughForSpawning(ChunkPos p_183880_)
private void	applyChunkTrackingView(ServerPlayer p_294188_, ChunkTrackingView p_294174_)
CompletableFuture<ChunkAccess>	applyStep(GenerationChunkHolder p_347627_, ChunkStep p_347638_, StaticCache2D<GenerationChunkHolder> p_347552_)
void	broadcast(Entity p_140202_, Packet<?> p_140203_)
protected void	broadcastAndSend(Entity p_140334_, Packet<?> p_140335_)
void	close()
private ChunkAccess	createEmptyChunk(ChunkPos p_214962_)
ReportedException	debugFuturesAndCreateReportedException(IllegalStateException p_203752_, String p_203753_)
private static void	dropChunk(ServerPlayer p_294215_, ChunkPos p_294758_)
(package private) void	dumpChunks(Writer p_140275_)
private static double	euclideanDistanceSquared(ChunkPos p_140227_, Entity p_140228_)
protected ChunkGenerator	generator()
protected ChunkGeneratorStructureState	generatorState()
String	getChunkDebugData(ChunkPos p_140205_)
protected IntSupplier	getChunkQueueLevel(long p_140372_)
private CompletableFuture<ChunkResult<List<ChunkAccess>>>	getChunkRangeFuture(ChunkHolder p_281446_, int p_282030_, IntFunction<ChunkStatus> p_282923_)
protected Iterable<ChunkHolder>	getChunks()
LevelChunk	getChunkToSend(long p_300929_)
DistanceManager	getDistanceManager()
protected ThreadedLevelLightEngine	getLightEngine()
List<ServerPlayer>	getPlayers(ChunkPos p_183801_, boolean p_183802_)
List<ServerPlayer>	getPlayersCloseForSpawning(ChunkPos p_183889_)
(package private) int	getPlayerViewDistance(ServerPlayer p_295024_)
protected PoiManager	getPoiManager()
String	getStorageName()
int	getTickingGenerated()
protected ChunkHolder	getUpdatingChunkIfPresent(long p_140175_)
ChunkHolder	getVisibleChunkIfPresent(long p_140328_)
private ChunkAccess	handleChunkLoadFailure(Throwable p_214902_, ChunkPos p_214903_)
boolean	hasWork()
private static boolean	isChunkDataValid(CompoundTag p_214941_)
private boolean	isChunkOnTrackedBorder(ServerPlayer p_295596_, int p_294838_, int p_295212_)
(package private) boolean	isChunkTracked(ServerPlayer p_295366_, int p_294911_, int p_296247_)
private boolean	isExistingChunkFull(ChunkPos p_140426_)
private static void	markChunkPendingToSend(ServerPlayer p_295834_, LevelChunk p_296281_)
private void	markChunkPendingToSend(ServerPlayer p_294638_, ChunkPos p_296183_)
private byte	markPosition(ChunkPos p_140230_, ChunkType p_332120_)
private void	markPositionReplaceable(ChunkPos p_140423_)
void	move(ServerPlayer p_140185_)
private void	onChunkReadyToSend(LevelChunk p_296003_)
(package private) void	onFullChunkStatusChange(ChunkPos p_287612_, FullChunkStatus p_287685_)
private boolean	playerIsCloseEnoughForSpawning(ServerPlayer p_183752_, ChunkPos p_183753_)
CompletableFuture<ChunkResult<LevelChunk>>	prepareAccessibleChunk(ChunkHolder p_143110_)
CompletableFuture<ChunkResult<LevelChunk>>	prepareEntityTickingChunk(ChunkHolder p_281455_)
CompletableFuture<ChunkResult<LevelChunk>>	prepareTickingChunk(ChunkHolder p_143054_)
private static String	printFuture(CompletableFuture<ChunkResult<LevelChunk>> p_140279_)
private void	processUnloads(BooleanSupplier p_140354_)
protected boolean	promoteChunkMap()
protected RandomState	randomState()
private CompletableFuture<Optional<CompoundTag>>	readChunk(ChunkPos p_214964_)
void	releaseGeneration(GenerationChunkHolder p_347698_)
protected void	removeEntity(Entity p_140332_)
void	resendBiomesForChunks(List<ChunkAccess> p_275577_)
private void	runGenerationTask(ChunkGenerationTask p_347721_)
void	runGenerationTasks()
private boolean	save(ChunkAccess p_140259_)
protected void	saveAllChunks(boolean p_140319_)
private boolean	saveChunkIfNeeded(ChunkHolder p_198875_)
private CompletableFuture<ChunkAccess>	scheduleChunkLoad(ChunkPos p_140418_)
ChunkGenerationTask	scheduleGenerationTask(ChunkStatus p_347605_, ChunkPos p_347675_)
void	scheduleOnMainThreadMailbox(ChunkTaskPriorityQueueSorter.Message<Runnable> msg)	Neo: PR #937 This is for mainly pre-generation usage such as Neoforge's generate command.
private void	scheduleUnload(long p_140182_, ChunkHolder p_140183_)
protected void	setServerViewDistance(int p_295758_)
int	size()
private boolean	skipPlayer(ServerPlayer p_140330_)
protected void	tick()
protected void	tick(BooleanSupplier p_140281_)
(package private) ChunkHolder	updateChunkScheduling(long p_140177_, int p_140178_, ChunkHolder p_140179_, int p_140180_)
private void	updateChunkTracking(ServerPlayer p_183755_)
private void	updatePlayerPos(ServerPlayer p_140374_)
(package private) void	updatePlayerStatus(ServerPlayer p_140193_, boolean p_140194_)
private CompoundTag	upgradeChunkTag(CompoundTag p_214948_)
void	waitForLightBeforeSending(ChunkPos p_301194_, int p_301130_)

Methods inherited from class net.minecraft.world.level.chunk.storage.ChunkStorage

chunkScanner, flushWorker, getVersion, handleLegacyStructureIndex, injectDatafixingContext, isOldChunkAround, read, storageInfo, upgradeChunkTag, write

Methods inherited from class java.lang.Object

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

Field Details

UNLOADED_CHUNK_LIST_RESULT

private static final ChunkResult<List<ChunkAccess>> UNLOADED_CHUNK_LIST_RESULT

UNLOADED_CHUNK_LIST_FUTURE

private static final CompletableFuture<ChunkResult<List<ChunkAccess>>> UNLOADED_CHUNK_LIST_FUTURE

CHUNK_TYPE_REPLACEABLE

private static final byte CHUNK_TYPE_REPLACEABLE

See Also:

• Constant Field Values

CHUNK_TYPE_UNKNOWN

private static final byte CHUNK_TYPE_UNKNOWN

See Also:

• Constant Field Values

CHUNK_TYPE_FULL

private static final byte CHUNK_TYPE_FULL

See Also:

• Constant Field Values

LOGGER

private static final org.slf4j.Logger LOGGER

CHUNK_SAVED_PER_TICK

private static final int CHUNK_SAVED_PER_TICK

See Also:

• Constant Field Values

CHUNK_SAVED_EAGERLY_PER_TICK

private static final int CHUNK_SAVED_EAGERLY_PER_TICK

See Also:

• Constant Field Values

EAGER_CHUNK_SAVE_COOLDOWN_IN_MILLIS

private static final int EAGER_CHUNK_SAVE_COOLDOWN_IN_MILLIS

See Also:

• Constant Field Values

MIN_VIEW_DISTANCE

public static final int MIN_VIEW_DISTANCE

See Also:

• Constant Field Values

MAX_VIEW_DISTANCE

public static final int MAX_VIEW_DISTANCE

See Also:

• Constant Field Values

FORCED_TICKET_LEVEL

public static final int FORCED_TICKET_LEVEL

updatingChunkMap

private final it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder> updatingChunkMap

visibleChunkMap

private volatile it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder> visibleChunkMap

pendingUnloads

private final it.unimi.dsi.fastutil.longs.Long2ObjectLinkedOpenHashMap<ChunkHolder> pendingUnloads

pendingGenerationTasks

private final List<ChunkGenerationTask> pendingGenerationTasks

level

final ServerLevel level

lightEngine

private final ThreadedLevelLightEngine lightEngine

mainThreadExecutor

private final BlockableEventLoop<Runnable> mainThreadExecutor

randomState

private final RandomState randomState

chunkGeneratorState

private final ChunkGeneratorStructureState chunkGeneratorState

overworldDataStorage

private final Supplier<DimensionDataStorage> overworldDataStorage

poiManager

private final PoiManager poiManager

toDrop

final it.unimi.dsi.fastutil.longs.LongSet toDrop

modified

private boolean modified

queueSorter

private final ChunkTaskPriorityQueueSorter queueSorter

worldgenMailbox

private final ProcessorHandle<ChunkTaskPriorityQueueSorter.Message<Runnable>> worldgenMailbox

mainThreadMailbox

private final ProcessorHandle<ChunkTaskPriorityQueueSorter.Message<Runnable>> mainThreadMailbox

progressListener

private final ChunkProgressListener progressListener

chunkStatusListener

private final ChunkStatusUpdateListener chunkStatusListener

distanceManager

private final ChunkMap.DistanceManager distanceManager

tickingGenerated

private final AtomicInteger tickingGenerated

storageName

private final String storageName

playerMap

private final PlayerMap playerMap

entityMap

private final it.unimi.dsi.fastutil.ints.Int2ObjectMap<ChunkMap.TrackedEntity> entityMap

chunkTypeCache

private final it.unimi.dsi.fastutil.longs.Long2ByteMap chunkTypeCache

chunkSaveCooldowns

private final it.unimi.dsi.fastutil.longs.Long2LongMap chunkSaveCooldowns

unloadQueue

private final Queue<Runnable> unloadQueue

serverViewDistance

private int serverViewDistance

worldGenContext

private final WorldGenContext worldGenContext

Constructor Details

ChunkMap

public ChunkMap(ServerLevel p_214836_,
 LevelStorageSource.LevelStorageAccess p_214837_,
 com.mojang.datafixers.DataFixer p_214838_,
 StructureTemplateManager p_214839_,
 Executor p_214840_,
 BlockableEventLoop<Runnable> p_214841_,
 LightChunkGetter p_214842_,
 ChunkGenerator p_214843_,
 ChunkProgressListener p_214844_,
 ChunkStatusUpdateListener p_214845_,
 Supplier<DimensionDataStorage> p_214846_,
 int p_214847_,
 boolean p_214848_)

Method Details

generator

protected ChunkGenerator generator()

generatorState

protected ChunkGeneratorStructureState generatorState()

randomState

protected RandomState randomState()

euclideanDistanceSquared

private static double euclideanDistanceSquared(ChunkPos p_140227_,
 Entity p_140228_)

isChunkTracked

boolean isChunkTracked(ServerPlayer p_295366_,
 int p_294911_,
 int p_296247_)

isChunkOnTrackedBorder

private boolean isChunkOnTrackedBorder(ServerPlayer p_295596_,
 int p_294838_,
 int p_295212_)

getLightEngine

protected ThreadedLevelLightEngine getLightEngine()

getUpdatingChunkIfPresent

@Nullable
protected ChunkHolder getUpdatingChunkIfPresent(long p_140175_)

getVisibleChunkIfPresent

@Nullable
public ChunkHolder getVisibleChunkIfPresent(long p_140328_)

getChunkQueueLevel

protected IntSupplier getChunkQueueLevel(long p_140372_)

getChunkDebugData

public String getChunkDebugData(ChunkPos p_140205_)

getChunkRangeFuture

private CompletableFuture<ChunkResult<List<ChunkAccess>>> getChunkRangeFuture(ChunkHolder p_281446_,
 int p_282030_,
 IntFunction<ChunkStatus> p_282923_)

debugFuturesAndCreateReportedException

public ReportedException debugFuturesAndCreateReportedException(IllegalStateException p_203752_,
 String p_203753_)

prepareEntityTickingChunk

public CompletableFuture<ChunkResult<LevelChunk>> prepareEntityTickingChunk(ChunkHolder p_281455_)

updateChunkScheduling

@Nullable
ChunkHolder updateChunkScheduling(long p_140177_,
 int p_140178_,
 @Nullable
 ChunkHolder p_140179_,
 int p_140180_)

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Overrides:

close in class ChunkStorage

Throws:

IOException

saveAllChunks

protected void saveAllChunks(boolean p_140319_)

tick

protected void tick(BooleanSupplier p_140281_)

hasWork

public boolean hasWork()

processUnloads

private void processUnloads(BooleanSupplier p_140354_)

scheduleUnload

private void scheduleUnload(long p_140182_,
 ChunkHolder p_140183_)

promoteChunkMap

protected boolean promoteChunkMap()

scheduleChunkLoad

private CompletableFuture<ChunkAccess> scheduleChunkLoad(ChunkPos p_140418_)

isChunkDataValid

private static boolean isChunkDataValid(CompoundTag p_214941_)

handleChunkLoadFailure

private ChunkAccess handleChunkLoadFailure(Throwable p_214902_,
 ChunkPos p_214903_)

createEmptyChunk

private ChunkAccess createEmptyChunk(ChunkPos p_214962_)

markPositionReplaceable

private void markPositionReplaceable(ChunkPos p_140423_)

markPosition

private byte markPosition(ChunkPos p_140230_,
 ChunkType p_332120_)

acquireGeneration

public GenerationChunkHolder acquireGeneration(long p_347661_)

Specified by:

acquireGeneration in interface GeneratingChunkMap

releaseGeneration

public void releaseGeneration(GenerationChunkHolder p_347698_)

Specified by:

releaseGeneration in interface GeneratingChunkMap

applyStep

public CompletableFuture<ChunkAccess> applyStep(GenerationChunkHolder p_347627_,
 ChunkStep p_347638_,
 StaticCache2D<GenerationChunkHolder> p_347552_)

Specified by:

applyStep in interface GeneratingChunkMap

scheduleGenerationTask

public ChunkGenerationTask scheduleGenerationTask(ChunkStatus p_347605_,
 ChunkPos p_347675_)

Specified by:

scheduleGenerationTask in interface GeneratingChunkMap

runGenerationTask

private void runGenerationTask(ChunkGenerationTask p_347721_)

runGenerationTasks

public void runGenerationTasks()

Specified by:

runGenerationTasks in interface GeneratingChunkMap

prepareTickingChunk

public CompletableFuture<ChunkResult<LevelChunk>> prepareTickingChunk(ChunkHolder p_143054_)

onChunkReadyToSend

private void onChunkReadyToSend(LevelChunk p_296003_)

prepareAccessibleChunk

public CompletableFuture<ChunkResult<LevelChunk>> prepareAccessibleChunk(ChunkHolder p_143110_)

getTickingGenerated

public int getTickingGenerated()

saveChunkIfNeeded

private boolean saveChunkIfNeeded(ChunkHolder p_198875_)

save

private boolean save(ChunkAccess p_140259_)

isExistingChunkFull

private boolean isExistingChunkFull(ChunkPos p_140426_)

setServerViewDistance

protected void setServerViewDistance(int p_295758_)

getPlayerViewDistance

int getPlayerViewDistance(ServerPlayer p_295024_)

markChunkPendingToSend

private void markChunkPendingToSend(ServerPlayer p_294638_,
 ChunkPos p_296183_)

markChunkPendingToSend

private static void markChunkPendingToSend(ServerPlayer p_295834_,
 LevelChunk p_296281_)

dropChunk

private static void dropChunk(ServerPlayer p_294215_,
 ChunkPos p_294758_)

getChunkToSend

@Nullable
public LevelChunk getChunkToSend(long p_300929_)

size

public int size()

getDistanceManager

public DistanceManager getDistanceManager()

getChunks

protected Iterable<ChunkHolder> getChunks()

dumpChunks

void dumpChunks(Writer p_140275_)
         throws IOException

Throws:

IOException

printFuture

private static String printFuture(CompletableFuture<ChunkResult<LevelChunk>> p_140279_)

readChunk

private CompletableFuture<Optional<CompoundTag>> readChunk(ChunkPos p_214964_)

upgradeChunkTag

private CompoundTag upgradeChunkTag(CompoundTag p_214948_)

anyPlayerCloseEnoughForSpawning

boolean anyPlayerCloseEnoughForSpawning(ChunkPos p_183880_)

getPlayersCloseForSpawning

public List<ServerPlayer> getPlayersCloseForSpawning(ChunkPos p_183889_)

playerIsCloseEnoughForSpawning

private boolean playerIsCloseEnoughForSpawning(ServerPlayer p_183752_,
 ChunkPos p_183753_)

skipPlayer

private boolean skipPlayer(ServerPlayer p_140330_)

updatePlayerStatus

void updatePlayerStatus(ServerPlayer p_140193_,
 boolean p_140194_)

updatePlayerPos

private void updatePlayerPos(ServerPlayer p_140374_)

move

public void move(ServerPlayer p_140185_)

updateChunkTracking

private void updateChunkTracking(ServerPlayer p_183755_)

applyChunkTrackingView

private void applyChunkTrackingView(ServerPlayer p_294188_,
 ChunkTrackingView p_294174_)

getPlayers

public List<ServerPlayer> getPlayers(ChunkPos p_183801_,
 boolean p_183802_)

Specified by:

getPlayers in interface ChunkHolder.PlayerProvider

addEntity

protected void addEntity(Entity p_140200_)

removeEntity

protected void removeEntity(Entity p_140332_)

tick

protected void tick()

broadcast

public void broadcast(Entity p_140202_,
 Packet<?> p_140203_)

broadcastAndSend

protected void broadcastAndSend(Entity p_140334_,
 Packet<?> p_140335_)

resendBiomesForChunks

public void resendBiomesForChunks(List<ChunkAccess> p_275577_)

getPoiManager

protected PoiManager getPoiManager()

getStorageName

public String getStorageName()

onFullChunkStatusChange

void onFullChunkStatusChange(ChunkPos p_287612_,
 FullChunkStatus p_287685_)

waitForLightBeforeSending

public void waitForLightBeforeSending(ChunkPos p_301194_,
 int p_301130_)

scheduleOnMainThreadMailbox

public void scheduleOnMainThreadMailbox(ChunkTaskPriorityQueueSorter.Message<Runnable> msg)

Neo: PR #937 This is for mainly pre-generation usage such as Neoforge's generate command. Use this to schedule chunk load tasks into ChunkTaskPriorityQueueSorter so a chunk is fully finished all of their tasks before scheduling more chunks to load. Reason for this is when scheduling a huge ton of Full Status chunk tasks to the server (to load chunks), you could cause the server to only process those loading tasks and never reach the two chunk tasks that are automatically scheduled to run after the chunk is loaded to Full. As a result of flooding the system with Full Status chunk tasks, the queue for the two kind of successor chunk tasks will grow and become a memory leak of lambdas and chunk references. Use this method to schedule tasks for loading chunks in your whenCompleteAsync method call so the tasks gets processed properly over time and not leak. See GenerationTask.enqueueChunks(it.unimi.dsi.fastutil.longs.LongList) as an example usage of this method.