Class DynamicChunk

java.lang.Object

net.minestom.server.instance.Chunk

net.minestom.server.instance.DynamicChunk

All Implemented Interfaces:

Block.Getter, Block.Setter, Snapshotable, Taggable, TagReadable, TagWritable, Tickable, Viewable, Biome.Getter, Biome.Setter

Direct Known Subclasses:

LightingChunk

public class DynamicChunk
extends Chunk

Represents a Chunk which store each individual block in memory.

WARNING: not thread-safe.

Nested Class Summary

Nested classes/interfaces inherited from interface Block.Getter

Block.Getter.Condition

Field Summary

Fields

Modifier and Type	Field	Description
protected final it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap<Block>	entries
protected Heightmap	motionBlocking
protected final List<Section>	sections
protected final it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap<Block>	tickableMap
protected Heightmap	worldSurface

Fields inherited from class Chunk

CHUNK_SECTION_SIZE, CHUNK_SIZE_X, CHUNK_SIZE_Z, chunkX, chunkZ, instance, loaded, maxSection, minSection

Constructor Summary

Constructors

Modifier	Constructor	Description
	DynamicChunk(Instance instance, int chunkX, int chunkZ)
protected	DynamicChunk(Instance instance, int chunkX, int chunkZ, List<Section> sections)

Method Summary

Modifier and Type	Method	Description
Chunk	copy(Instance instance, int chunkX, int chunkZ)	Creates a copy of this chunk, including blocks state id, custom block id, biomes, update data.
protected LightData	createLightData(boolean requiredFullChunk)
RegistryKey<Biome>	getBiome(int x, int y, int z)
@Nullable Block	getBlock(int x, int y, int z, Block.Getter.Condition condition)
SendablePacket	getFullDataPacket()
protected Map<Heightmap.Type, long[]>	getHeightmaps()
Section	getSection(int section)
List<Section>	getSections()
void	invalidate()	Invalidate the chunk caches
void	loadHeightmapsFromNBT(CompoundBinaryTag heightmapsNBT)
Heightmap	motionBlockingHeightmap()
void	reset()	Resets the chunk, this means clearing all the data making it empty.
void	setBiome(int x, int y, int z, RegistryKey<Biome> biome)
void	setBlock(int x, int y, int z, Block block, BlockHandler.Placement placement, BlockHandler.Destroy destroy)
void	tick(long time)	Executes a chunk tick.
ChunkSnapshot	updateSnapshot(SnapshotUpdater updater)	Updates the currently cached snapshot if required.
Heightmap	worldSurfaceHeightmap()

Methods inherited from class Chunk

addViewer, getChunkX, getChunkZ, getIdentifier, getInstance, getMaxSection, getMinSection, getSectionAt, getViewers, isLoaded, isReadOnly, onGenerate, onLoad, removeViewer, sendChunk, sendChunk, setBlock, setReadOnly, shouldGenerate, tagHandler, toPosition, toString, unload

Methods inherited from class Object

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

Methods inherited from interface Biome.Getter

getBiome

Methods inherited from interface Biome.Setter

setBiome

Methods inherited from interface Block.Getter

getBlock, getBlock, getBlock

Methods inherited from interface Block.Setter

setBlock, setBlockArea

Methods inherited from interface Taggable

getAndSetTag, getAndUpdateTag, getTag, hasTag, removeTag, setTag, updateAndGetTag, updateTag

Methods inherited from interface Viewable

getViewersAsAudience, getViewersAsAudiences, isViewer, sendPacketsToViewers, sendPacketsToViewers, sendPacketToViewers, sendPacketToViewersAndSelf

Field Details

sections

protected final List<Section> sections

motionBlocking

protected Heightmap motionBlocking

worldSurface

protected Heightmap worldSurface

entries

protected final it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap<Block> entries

tickableMap

protected final it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap<Block> tickableMap

Constructor Details

DynamicChunk

public DynamicChunk(Instance instance,
 int chunkX,
 int chunkZ)

DynamicChunk

protected DynamicChunk(Instance instance,
 int chunkX,
 int chunkZ,
 List<Section> sections)

Method Details

setBlock

public void setBlock(int x,
 int y,
 int z,
 Block block,
 @Nullable
 BlockHandler.Placement placement,
 @Nullable
 BlockHandler.Destroy destroy)

Specified by:

setBlock in class Chunk

setBiome

public void setBiome(int x,
 int y,
 int z,
 RegistryKey<Biome> biome)

getSections

public List<Section> getSections()

Specified by:

getSections in class Chunk

getSection

public Section getSection(int section)

Specified by:

getSection in class Chunk

motionBlockingHeightmap

public Heightmap motionBlockingHeightmap()

Specified by:

motionBlockingHeightmap in class Chunk

worldSurfaceHeightmap

public Heightmap worldSurfaceHeightmap()

Specified by:

worldSurfaceHeightmap in class Chunk

loadHeightmapsFromNBT

public void loadHeightmapsFromNBT(CompoundBinaryTag heightmapsNBT)

Specified by:

loadHeightmapsFromNBT in class Chunk

tick

public void tick(long time)

Description copied from class: Chunk

Executes a chunk tick.

Should be used to update all the blocks in the chunk.

WARNING: this method doesn't necessary have to be thread-safe, proceed with caution.

Specified by:

tick in interface Tickable

Specified by:

tick in class Chunk

Parameters:

time - the time of the update in milliseconds

getBlock

@Nullable
public @Nullable Block getBlock(int x,
 int y,
 int z,
 Block.Getter.Condition condition)

getBiome

public RegistryKey<Biome> getBiome(int x,
 int y,
 int z)

getFullDataPacket

public SendablePacket getFullDataPacket()

Specified by:

getFullDataPacket in class Chunk

copy

public Chunk copy(Instance instance,
 int chunkX,
 int chunkZ)

Description copied from class: Chunk

Creates a copy of this chunk, including blocks state id, custom block id, biomes, update data.

The chunk position (X/Z) can be modified using the given arguments.

Specified by:

copy in class Chunk

Parameters:

instance - the chunk owner

chunkX - the chunk X of the copy

chunkZ - the chunk Z of the copy

Returns:

a copy of this chunk with a potentially new instance and position

reset

public void reset()

Description copied from class: Chunk

Resets the chunk, this means clearing all the data making it empty.

Specified by:

reset in class Chunk

invalidate

public void invalidate()

Description copied from class: Chunk

Invalidate the chunk caches

Specified by:

invalidate in class Chunk

createLightData

protected LightData createLightData(boolean requiredFullChunk)

getHeightmaps

protected Map<Heightmap.Type, long[]> getHeightmaps()

updateSnapshot

public ChunkSnapshot updateSnapshot(SnapshotUpdater updater)

Description copied from interface: Snapshotable

Updates the currently cached snapshot if required. The updater can be used to retrieve references to other snapshots while avoiding circular dependency. Be careful to do not store updater anywhere as its data will change when building requested references.

This method is not thread-safe, and targeted at internal use since its execution rely on safe-points (e.g. end of ticks)

Parameters:

updater - the snapshot updater/context

Returns:

the updated snapshot