Class InstanceContainer

java.lang.Object

net.minestom.server.instance.Instance

net.minestom.server.instance.InstanceContainer

All Implemented Interfaces:

Audience, ForwardingAudience, Identified, Pointered, PacketGroupingAudience, EventHandler<InstanceEvent>, Block.Getter, Block.Setter, Snapshotable, Taggable, TagReadable, TagWritable, Tickable, Schedulable

public class InstanceContainer
extends Instance

InstanceContainer is an instance that contains chunks in contrary to SharedInstance.

Nested Class Summary

Nested classes/interfaces inherited from interface Block.Getter

Block.Getter.Condition

Nested classes/interfaces inherited from interface ForwardingAudience

ForwardingAudience.Single

Field Summary

Fields

Modifier and Type	Field	Description
protected InstanceContainer	srcInstance

Fields inherited from class Instance

chunkViewDistance, INSTANCE_POINTERS_SUPPLIER, tagHandler, uuid

Constructor Summary

Constructors

Constructor	Description
InstanceContainer(UUID uuid, RegistryKey<DimensionType> dimensionType)
InstanceContainer(UUID uuid, RegistryKey<DimensionType> dimensionType, Key dimensionName)
InstanceContainer(UUID uuid, RegistryKey<DimensionType> dimensionType, @Nullable ChunkLoader loader)
InstanceContainer(UUID uuid, RegistryKey<DimensionType> dimensionType, @Nullable ChunkLoader loader, Key dimensionName)
InstanceContainer(DynamicRegistry<DimensionType> dimensionTypeRegistry, UUID uuid, RegistryKey<DimensionType> dimensionType, @Nullable ChunkLoader loader, Key dimensionName)

Method Summary

Modifier and Type	Method	Description
protected void	addSharedInstance(SharedInstance sharedInstance)	Assigns a SharedInstance to this container.
boolean	breakBlock(Player player, Point blockPosition, BlockFace blockFace, boolean doBlockUpdates)	Does call PlayerBlockBreakEvent and send particle packets
InstanceContainer	copy()	Copies all the chunks of this instance and create a new instance container with all of them.
protected Chunk	createChunk(int chunkX, int chunkZ)
void	enableAutoChunkLoad(boolean enable)	When set to true, chunks will load automatically when requested.
CompletableFuture<Void>	generateChunk(int chunkX, int chunkZ, Generator generator)	Runs the provided Generator to generate a chunk at the given position.
protected void	generateChunk(Chunk chunk, Generator generator)
@Nullable Generator	generator()	Gets the generator associated with the instance
@Nullable Chunk	getChunk(int chunkX, int chunkZ)	Gets the loaded Chunk at a position.
ChunkLoader	getChunkLoader()	Gets the ChunkLoader of this instance.
Collection<Chunk>	getChunks()	Gets all the instance chunks.
ChunkSupplier	getChunkSupplier()	Gets the current ChunkSupplier.
long	getLastBlockChangeTime()	Gets the last time at which a block changed.
List<SharedInstance>	getSharedInstances()	Gets all the SharedInstance linked to this container.
@Nullable InstanceContainer	getSrcInstance()	Gets the instance from which this one has been copied.
boolean	hasEnabledAutoChunkLoad()	Gets if the instance should auto load chunks.
boolean	hasSharedInstances()	Gets if this instance has SharedInstance linked to it.
boolean	isInVoid(Point point)	Determines whether a position in the void.
CompletableFuture<Chunk>	loadChunk(int chunkX, int chunkZ)	Forces the generation of a Chunk, even if no file and Generator are defined.
CompletableFuture<Chunk>	loadOptionalChunk(int chunkX, int chunkZ)	Loads the chunk if the chunk is already loaded or if Instance.hasEnabledAutoChunkLoad() returns true.
boolean	placeBlock(BlockHandler.Placement placement, boolean doBlockUpdates)
void	refreshLastBlockChangeTime()	Signals the instance that a block changed.
protected CompletableFuture<Chunk>	retrieveChunk(int chunkX, int chunkZ)
CompletableFuture<Void>	saveChunksToStorage()	Saves multiple chunks to permanent storage.
CompletableFuture<Void>	saveChunkToStorage(Chunk chunk)	Saves a Chunk to permanent storage.
CompletableFuture<Void>	saveInstance()	Saves the current instance tags.
void	setBlock(int x, int y, int z, Block block, boolean doBlockUpdates)
void	setChunkLoader(ChunkLoader chunkLoader)	Changes the ChunkLoader of this instance (to change how chunks are retrieved when not already loaded).
void	setChunkSupplier(ChunkSupplier chunkSupplier)	Changes which type of Chunk implementation to use once one needs to be loaded.
void	setGenerator(@Nullable Generator generator)	Changes the generator of the instance
void	tick(long time)	Performs a single tick in the instance, including scheduled tasks from Instance.scheduleNextTick(Consumer).
void	unloadChunk(Chunk chunk)	Schedules the removal of a Chunk, this method does not promise when it will be done.

Methods inherited from class Instance

bossBars, breakBlock, createInitializeWorldBorderPacket, createTimePacket, eventNode, explode, explode, getBlock, getBlockLight, getCachedDimensionType, getChunkAt, getChunkAt, getChunkEntities, getCreatures, getDimensionName, getDimensionType, getEntities, getEntityById, getEntityByUuid, getEntityTracker, getExperienceOrbs, getExplosionSupplier, getNearbyEntities, getPlayerByUuid, getPlayers, getSkyLight, getTime, getTimeRate, getTimeSynchronizationTicks, getUniqueId, getUuid, getWeather, getWorldAge, getWorldBorder, hideBossBar, identity, invalidateSection, isChunkLoaded, isChunkLoaded, isRegistered, loadChunk, loadOptionalChunk, placeBlock, playSoundExcept, playSoundExcept, playSoundExcept, pointers, scheduleNextTick, scheduler, sendBlockAction, setBlock, setBlock, setExplosionSupplier, setRegistered, setTime, setTimeRate, setTimeSynchronizationTicks, setWeather, setWeather, setWorldAge, setWorldBorder, setWorldBorder, showBossBar, tagHandler, unloadChunk, updateSnapshot, viewDistance, viewDistance

Methods inherited from class Object

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

Methods inherited from interface Audience

deleteMessage, openBook, removeResourcePacks, removeResourcePacks, removeResourcePacks, sendActionBar, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendPlayerListFooter, sendPlayerListHeader, sendPlayerListHeaderAndFooter, sendResourcePacks, sendResourcePacks, showTitle, stopSound

Methods inherited from interface Block.Getter

getBlock, getBlock, getBlock

Methods inherited from interface Block.Setter

setBlock, setBlockArea

Methods inherited from interface ForwardingAudience

clearResourcePacks, closeDialog, deleteMessage, filterAudience, forEachAudience, openBook, playSound, removeResourcePacks, removeResourcePacks, sendMessage, sendMessage, sendMessage, sendMessage, sendPlayerListFooter, sendPlayerListHeader, sendResourcePacks, showDialog

Methods inherited from interface PacketGroupingAudience

audiences, clearTitle, playSound, playSound, playSound, resetTitle, sendActionBar, sendGroupedPacket, sendMessage, sendNotification, sendPlayerListHeaderAndFooter, sendTitlePart, stopSound

Methods inherited from interface Pointered

get, getOrDefault, getOrDefaultFrom

Methods inherited from interface Taggable

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

Field Details

srcInstance

protected InstanceContainer srcInstance

Constructor Details

InstanceContainer

public InstanceContainer(UUID uuid,
 RegistryKey<DimensionType> dimensionType)

InstanceContainer

public InstanceContainer(UUID uuid,
 RegistryKey<DimensionType> dimensionType,
 Key dimensionName)

InstanceContainer

public InstanceContainer(UUID uuid,
 RegistryKey<DimensionType> dimensionType,
 @Nullable
 @Nullable ChunkLoader loader)

InstanceContainer

public InstanceContainer(UUID uuid,
 RegistryKey<DimensionType> dimensionType,
 @Nullable
 @Nullable ChunkLoader loader,
 Key dimensionName)

InstanceContainer

public InstanceContainer(DynamicRegistry<DimensionType> dimensionTypeRegistry,
 UUID uuid,
 RegistryKey<DimensionType> dimensionType,
 @Nullable
 @Nullable ChunkLoader loader,
 Key dimensionName)

Method Details

setBlock

public void setBlock(int x,
 int y,
 int z,
 Block block,
 boolean doBlockUpdates)

Specified by:

setBlock in class Instance

placeBlock

public boolean placeBlock(BlockHandler.Placement placement,
 boolean doBlockUpdates)

Specified by:

placeBlock in class Instance

breakBlock

public boolean breakBlock(Player player,
 Point blockPosition,
 BlockFace blockFace,
 boolean doBlockUpdates)

Description copied from class: Instance

Does call PlayerBlockBreakEvent and send particle packets

Specified by:

breakBlock in class Instance

Parameters:

player - the Player who break the block

blockPosition - the position of the broken block

doBlockUpdates - true to do block updates, false otherwise

Returns:

true if the block has been broken, false if it has been cancelled

loadChunk

public CompletableFuture<Chunk> loadChunk(int chunkX,
 int chunkZ)

Description copied from class: Instance

Forces the generation of a Chunk, even if no file and Generator are defined.

Specified by:

loadChunk in class Instance

Parameters:

chunkX - the chunk X

chunkZ - the chunk Z

Returns:

a CompletableFuture completed once the chunk has been loaded

loadOptionalChunk

public CompletableFuture<Chunk> loadOptionalChunk(int chunkX,
 int chunkZ)

Description copied from class: Instance

Loads the chunk if the chunk is already loaded or if Instance.hasEnabledAutoChunkLoad() returns true.

Specified by:

loadOptionalChunk in class Instance

Parameters:

chunkX - the chunk X

chunkZ - the chunk Z

Returns:

a CompletableFuture completed once the chunk has been processed, can be null if not loaded

unloadChunk

public void unloadChunk(Chunk chunk)

Description copied from class: Instance

Schedules the removal of a Chunk, this method does not promise when it will be done.

WARNING: during unloading, all entities other than Player will be removed.

Specified by:

unloadChunk in class Instance

Parameters:

chunk - the chunk to unload

getChunk

@Nullable
public @Nullable Chunk getChunk(int chunkX,
 int chunkZ)

Description copied from class: Instance

Gets the loaded Chunk at a position.

WARNING: this should only return already-loaded chunk, use Instance.loadChunk(int, int) or similar to load one instead.

Specified by:

getChunk in class Instance

Parameters:

chunkX - the chunk X

chunkZ - the chunk Z

Returns:

the chunk at the specified position, null if not loaded

saveInstance

public CompletableFuture<Void> saveInstance()

Description copied from class: Instance

Saves the current instance tags.

Warning: only the global instance data will be saved, not chunks. You would need to call Instance.saveChunksToStorage() too.

Specified by:

saveInstance in class Instance

Returns:

the future called once the instance data has been saved

saveChunkToStorage

public CompletableFuture<Void> saveChunkToStorage(Chunk chunk)

Description copied from class: Instance

Saves a Chunk to permanent storage.

Specified by:

saveChunkToStorage in class Instance

Parameters:

chunk - the Chunk to save

Returns:

future called when the chunk is done saving

saveChunksToStorage

public CompletableFuture<Void> saveChunksToStorage()

Description copied from class: Instance

Saves multiple chunks to permanent storage.

Specified by:

saveChunksToStorage in class Instance

Returns:

future called when the chunks are done saving

retrieveChunk

protected CompletableFuture<Chunk> retrieveChunk(int chunkX,
 int chunkZ)

createChunk

protected Chunk createChunk(int chunkX,
 int chunkZ)

generateChunk

protected void generateChunk(Chunk chunk,
 Generator generator)

enableAutoChunkLoad

public void enableAutoChunkLoad(boolean enable)

Description copied from class: Instance

When set to true, chunks will load automatically when requested. Otherwise using Instance.loadChunk(int, int) will be required to even spawn a player

Specified by:

enableAutoChunkLoad in class Instance

Parameters:

enable - enable the auto chunk load

hasEnabledAutoChunkLoad

public boolean hasEnabledAutoChunkLoad()

Description copied from class: Instance

Gets if the instance should auto load chunks.

Specified by:

hasEnabledAutoChunkLoad in class Instance

Returns:

true if auto chunk load is enabled, false otherwise

isInVoid

public boolean isInVoid(Point point)

Description copied from class: Instance

Determines whether a position in the void.

Specified by:

isInVoid in class Instance

Parameters:

point - the point in the world

Returns:

true if the point is inside the void

setChunkSupplier

public void setChunkSupplier(ChunkSupplier chunkSupplier)

Changes which type of Chunk implementation to use once one needs to be loaded.

Uses DynamicChunk by default.

WARNING: if you need to save this instance's chunks later, the code needs to be predictable for ChunkLoader.loadChunk(Instance, int, int) to create the correct type of Chunk. tl;dr: Need chunk save = no random type.

Specified by:

setChunkSupplier in class Instance

Parameters:

chunkSupplier - the new ChunkSupplier of this instance, chunks need to be non-null

Throws:

NullPointerException - if chunkSupplier is null

getChunkSupplier

public ChunkSupplier getChunkSupplier()

Gets the current ChunkSupplier.

You shouldn't use it to generate a new chunk, but as a way to view which one is currently in use.

Specified by:

getChunkSupplier in class Instance

Returns:

the current ChunkSupplier

getSharedInstances

public List<SharedInstance> getSharedInstances()

Gets all the SharedInstance linked to this container.

Returns:

an unmodifiable List containing all the SharedInstance linked to this container

hasSharedInstances

public boolean hasSharedInstances()

Gets if this instance has SharedInstance linked to it.

Returns:

true if getSharedInstances() is not empty

addSharedInstance

protected void addSharedInstance(SharedInstance sharedInstance)

Assigns a SharedInstance to this container.

Only used by InstanceManager, mostly unsafe.

Parameters:

sharedInstance - the shared instance to assign to this container

copy

public InstanceContainer copy()

Copies all the chunks of this instance and create a new instance container with all of them.

Chunks are copied with Chunk.copy(Instance, int, int), UUID is randomized and DimensionType is passed over.

Returns:

an InstanceContainer with the exact same chunks as 'this'

See Also:

• to retrieve the "creation source" of the copied instance

getSrcInstance

@Nullable
public @Nullable InstanceContainer getSrcInstance()

Gets the instance from which this one has been copied.

Only present if this instance has been created with copy().

Returns:

the instance source, null if not created by a copy

See Also:

• to create a copy of this instance with 'this' as the source

getLastBlockChangeTime

public long getLastBlockChangeTime()

Gets the last time at which a block changed.

Returns:

the time at which the last block changed in nanoseconds. Only use this to calculate delta times

refreshLastBlockChangeTime

public void refreshLastBlockChangeTime()

Signals the instance that a block changed.

Useful if you change blocks values directly using a Chunk object.

generator

@Nullable
public @Nullable Generator generator()

Description copied from class: Instance

Gets the generator associated with the instance

Specified by:

generator in class Instance

Returns:

the generator if any

setGenerator

public void setGenerator(@Nullable
 @Nullable Generator generator)

Description copied from class: Instance

Changes the generator of the instance

Specified by:

setGenerator in class Instance

Parameters:

generator - the new generator, or null to disable generation

generateChunk

@Experimental
public CompletableFuture<Void> generateChunk(int chunkX,
 int chunkZ,
 Generator generator)

Description copied from class: Instance

Runs the provided Generator to generate a chunk at the given position.

Loads the chunk if not already loaded.

Specified by:

generateChunk in class Instance

Parameters:

chunkX - the chunk X

chunkZ - the chunk Z

generator - the generator to use

Returns:

a future called once the generation is complete

getChunks

public Collection<Chunk> getChunks()

Gets all the instance chunks.

Specified by:

getChunks in class Instance

Returns:

the chunks of this instance

getChunkLoader

public ChunkLoader getChunkLoader()

Gets the ChunkLoader of this instance.

Returns:

the ChunkLoader of this instance

setChunkLoader

public void setChunkLoader(ChunkLoader chunkLoader)

Changes the ChunkLoader of this instance (to change how chunks are retrieved when not already loaded).

ChunkLoader.noop() can be used to do nothing.

Parameters:

chunkLoader - the new ChunkLoader

tick

public void tick(long time)

Description copied from class: Instance

Performs a single tick in the instance, including scheduled tasks from Instance.scheduleNextTick(Consumer).

Warning: this does not update chunks and entities.

Specified by:

tick in interface Tickable

Overrides:

tick in class Instance

Parameters:

time - the tick time in milliseconds, which may only be used as a delta and has no meaning in real life