Package cn.nukkit.level.format.anvil

Class ChunkSection

java.lang.Object

cn.nukkit.level.format.anvil.ChunkSection

All Implemented Interfaces:

ChunkSection, ChunkSection3DBiome

@ParametersAreNonnullByDefault
public class ChunkSection
extends Object
implements ChunkSection, ChunkSection3DBiome

Author:

MagicDroidX (Nukkit Project)

Field Summary

Fields

Modifier and Type	Field	Description
protected byte[]	biomeId
protected byte[]	blockLight
protected byte[]	compressedLight
protected boolean	hasBlockLight
protected boolean	hasSkyLight
protected boolean	invalidCustomBlockWhenLoad
static final int	SAVE_STORAGE_VERSION
protected final ReentrantReadWriteLock	sectionLock
protected byte[]	skyLight
static final int	STREAM_STORAGE_VERSION

Constructor Summary

Constructors

Constructor	Description
ChunkSection(int y)
ChunkSection(CompoundTag nbt)
ChunkSection(CompoundTag nbt, byte[] default2DBiomeId)

Method Summary

Modifier and Type	Method	Description
boolean	compress()
void	compressStorageLayers()
ChunkSection	copy()
void	delayPaletteUpdates()
byte[]	get3DBiomeDataArray()
Block	getAndSetBlock(int x, int y, int z, int layer, Block block)
Block	getAndSetBlock(int x, int y, int z, Block block)
BlockState	getAndSetBlockState(int x, int y, int z, int layer, BlockState state)
int	getBiomeId(int x, int y, int z)	获取子区块中某个特定位置的生物群系id
int	getBlockChangeStateAbove(int x, int y, int z)
int	getBlockData(int x, int y, int z)	Deprecated.
int	getBlockData(int x, int y, int z, int layer)	Deprecated.
int	getBlockId(int x, int y, int z)
int	getBlockId(int x, int y, int z, int layer)
int	getBlockLight(int x, int y, int z)
int	getBlockSkyLight(int x, int y, int z)
BlockState	getBlockState(int x, int y, int z, int layer)
int	getContentVersion()
int	getFullBlock(int x, int y, int z)	Deprecated.
int	getFullBlock(int x, int y, int z, int layer)	Deprecated.
byte[]	getLightArray()
int	getMaximumLayer()
byte[]	getSkyLightArray()
int	getY()
boolean	hasBlocks()
boolean	isEmpty()
List<Block>	scanBlocks(LevelProvider provider, int offsetX, int offsetZ, BlockVector3 min, BlockVector3 max, BiPredicate<BlockVector3,BlockState> condition)
void	set3DBiomeDataArray(byte[] data)	设置3D生物群系字节数据
void	setBiomeId(int x, int y, int z, byte id)	设置子区块中某个特定位置的生物群系id
boolean	setBlock(int x, int y, int z, int blockId)
boolean	setBlock(int x, int y, int z, int blockId, int meta)	Deprecated.
boolean	setBlockAtLayer(int x, int y, int z, int layer, int blockId)
boolean	setBlockAtLayer(int x, int y, int z, int layer, int blockId, int meta)	Deprecated.
void	setBlockData(int x, int y, int z, int data)	Deprecated.
void	setBlockData(int x, int y, int z, int layer, int data)	Deprecated.
void	setBlockId(int x, int y, int z, int id)
void	setBlockId(int x, int y, int z, int layer, int id)
void	setBlockLight(int x, int y, int z, int level)
void	setBlockSkyLight(int x, int y, int z, int level)
boolean	setBlockStateAtLayer(int x, int y, int z, int layer, BlockState state)
void	setContentVersion(int contentVersion)
boolean	setFullBlockId(int x, int y, int z, int fullId)	Deprecated.
boolean	setFullBlockId(int x, int y, int z, int layer, int fullId)	Deprecated.
void	setNeedReObfuscate()
CompoundTag	toNBT()
String	toString()
void	writeObfuscatedTo(BinaryStream stream, Level level)	以混淆方式将子区块写入二进制流，通常用于反矿透
void	writeTo(BinaryStream stream)

Methods inherited from class java.lang.Object

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

Methods inherited from interface cn.nukkit.level.format.ChunkSection

getAndSetBlockState, getBlockState, setBlockState

Field Details

STREAM_STORAGE_VERSION

@PowerNukkitOnly
public static final int STREAM_STORAGE_VERSION

See Also:

• Constant Field Values

SAVE_STORAGE_VERSION

@PowerNukkitOnly
public static final int SAVE_STORAGE_VERSION

See Also:

• Constant Field Values

sectionLock

protected final ReentrantReadWriteLock sectionLock

biomeId

protected byte[] biomeId

blockLight

protected byte[] blockLight

skyLight

protected byte[] skyLight

compressedLight

protected byte[] compressedLight

hasBlockLight

protected boolean hasBlockLight

hasSkyLight

protected boolean hasSkyLight

invalidCustomBlockWhenLoad

@PowerNukkitXOnly
@Since("1.19.21-r1")
protected boolean invalidCustomBlockWhenLoad

Constructor Details

ChunkSection

public ChunkSection(int y)

ChunkSection

public ChunkSection(CompoundTag nbt)

ChunkSection

public ChunkSection(CompoundTag nbt,
 @Nullable
 byte[] default2DBiomeId)

Method Details

getY

public int getY()

Specified by:

getY in interface ChunkSection

getBlockId

public int getBlockId(int x,
 int y,
 int z)

Specified by:

getBlockId in interface ChunkSection

getBlockId

@PowerNukkitOnly
public int getBlockId(int x,
 int y,
 int z,
 int layer)

Specified by:

getBlockId in interface ChunkSection

setBlockId

public void setBlockId(int x,
 int y,
 int z,
 int id)

Specified by:

setBlockId in interface ChunkSection

setBlockId

@PowerNukkitOnly
public void setBlockId(int x,
 int y,
 int z,
 int layer,
 int id)

Specified by:

setBlockId in interface ChunkSection

setFullBlockId

@Deprecated
@DeprecationDetails(reason="The meta is limited to 32 bits",
                    since="1.4.0.0-PN")
public boolean setFullBlockId(int x,
 int y,
 int z,
 int fullId)

Deprecated.

Specified by:

setFullBlockId in interface ChunkSection

setFullBlockId

@Deprecated
@DeprecationDetails(reason="The meta is limited to 32 bits",
                    since="1.4.0.0-PN")
@PowerNukkitOnly
public boolean setFullBlockId(int x,
 int y,
 int z,
 int layer,
 int fullId)

Deprecated.

Specified by:

setFullBlockId in interface ChunkSection

getBlockData

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
public int getBlockData(int x,
 int y,
 int z)

Deprecated.

Specified by:

getBlockData in interface ChunkSection

getBlockData

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
@PowerNukkitOnly
public int getBlockData(int x,
 int y,
 int z,
 int layer)

Deprecated.

Specified by:

getBlockData in interface ChunkSection

setBlockData

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
public void setBlockData(int x,
 int y,
 int z,
 int data)

Deprecated.

Specified by:

setBlockData in interface ChunkSection

setBlockData

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
@PowerNukkitOnly
public void setBlockData(int x,
 int y,
 int z,
 int layer,
 int data)

Deprecated.

Specified by:

setBlockData in interface ChunkSection

getFullBlock

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
public int getFullBlock(int x,
 int y,
 int z)

Deprecated.

Specified by:

getFullBlock in interface ChunkSection

getBlockState

@PowerNukkitOnly
@Nonnull
public BlockState getBlockState(int x,
 int y,
 int z,
 int layer)

Specified by:

getBlockState in interface ChunkSection

getFullBlock

@PowerNukkitOnly
@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
public int getFullBlock(int x,
 int y,
 int z,
 int layer)

Deprecated.

Specified by:

getFullBlock in interface ChunkSection

setBlock

public boolean setBlock(int x,
 int y,
 int z,
 int blockId)

Specified by:

setBlock in interface ChunkSection

setBlockAtLayer

@PowerNukkitOnly
public boolean setBlockAtLayer(int x,
 int y,
 int z,
 int layer,
 int blockId)

Specified by:

setBlockAtLayer in interface ChunkSection

getAndSetBlock

@Nonnull
public Block getAndSetBlock(int x,
 int y,
 int z,
 Block block)

Specified by:

getAndSetBlock in interface ChunkSection

getAndSetBlock

@PowerNukkitOnly
@Nonnull
public Block getAndSetBlock(int x,
 int y,
 int z,
 int layer,
 Block block)

Specified by:

getAndSetBlock in interface ChunkSection

getAndSetBlockState

@PowerNukkitOnly
@Since("1.4.0.0-PN")
public BlockState getAndSetBlockState(int x,
 int y,
 int z,
 int layer,
 BlockState state)

Specified by:

getAndSetBlockState in interface ChunkSection

setBlock

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
public boolean setBlock(int x,
 int y,
 int z,
 int blockId,
 int meta)

Deprecated.

Specified by:

setBlock in interface ChunkSection

setBlockAtLayer

@Deprecated
@DeprecationDetails(reason="The data is limited to 32 bits",
                    replaceWith="getBlockState",
                    since="1.4.0.0-PN")
@PowerNukkitOnly
public boolean setBlockAtLayer(int x,
 int y,
 int z,
 int layer,
 int blockId,
 int meta)

Deprecated.

Specified by:

setBlockAtLayer in interface ChunkSection

setBlockStateAtLayer

@PowerNukkitOnly
public boolean setBlockStateAtLayer(int x,
 int y,
 int z,
 int layer,
 BlockState state)

Specified by:

setBlockStateAtLayer in interface ChunkSection

getBlockChangeStateAbove

@PowerNukkitOnly
public int getBlockChangeStateAbove(int x,
 int y,
 int z)

Specified by:

getBlockChangeStateAbove in interface ChunkSection

delayPaletteUpdates

@Since("1.4.0.0-PN")
@PowerNukkitOnly
public void delayPaletteUpdates()

Specified by:

delayPaletteUpdates in interface ChunkSection

getBlockSkyLight

public int getBlockSkyLight(int x,
 int y,
 int z)

Specified by:

getBlockSkyLight in interface ChunkSection

setBlockSkyLight

public void setBlockSkyLight(int x,
 int y,
 int z,
 int level)

Specified by:

setBlockSkyLight in interface ChunkSection

getBlockLight

public int getBlockLight(int x,
 int y,
 int z)

Specified by:

getBlockLight in interface ChunkSection

setBlockLight

public void setBlockLight(int x,
 int y,
 int z,
 int level)

Specified by:

setBlockLight in interface ChunkSection

getSkyLightArray

public byte[] getSkyLightArray()

Specified by:

getSkyLightArray in interface ChunkSection

getLightArray

public byte[] getLightArray()

Specified by:

getLightArray in interface ChunkSection

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface ChunkSection

writeTo

public void writeTo(@Nonnull
 BinaryStream stream)

Specified by:

writeTo in interface ChunkSection

writeObfuscatedTo

@Since("1.19.21-r1")
public void writeObfuscatedTo(BinaryStream stream,
 Level level)

Description copied from interface: ChunkSection

以混淆方式将子区块写入二进制流，通常用于反矿透

Specified by:

writeObfuscatedTo in interface ChunkSection

Parameters:

stream - 二进制流

level - 子区块所在世界，包含混淆所用数据

toNBT

@PowerNukkitOnly
@Nonnull
public CompoundTag toNBT()

Specified by:

toNBT in interface ChunkSection

compressStorageLayers

@PowerNukkitOnly
@Since("1.4.0.0-PN")
public void compressStorageLayers()

Specified by:

compressStorageLayers in interface ChunkSection

compress

public boolean compress()

scanBlocks

@Since("1.4.0.0-PN")
@PowerNukkitOnly
public List<Block> scanBlocks(LevelProvider provider,
 int offsetX,
 int offsetZ,
 BlockVector3 min,
 BlockVector3 max,
 BiPredicate<BlockVector3,BlockState> condition)

Specified by:

scanBlocks in interface ChunkSection

copy

@Nonnull
public ChunkSection copy()

Specified by:

copy in interface ChunkSection

getMaximumLayer

@PowerNukkitOnly
public int getMaximumLayer()

Specified by:

getMaximumLayer in interface ChunkSection

getContentVersion

@PowerNukkitOnly("Needed for level backward compatibility")
@Since("1.3.0.0-PN")
public int getContentVersion()

Specified by:

getContentVersion in interface ChunkSection

setContentVersion

@PowerNukkitOnly("Needed for level backward compatibility")
@Since("1.3.1.0-PN")
public void setContentVersion(int contentVersion)

Specified by:

setContentVersion in interface ChunkSection

hasBlocks

@PowerNukkitOnly
public boolean hasBlocks()

Specified by:

hasBlocks in interface ChunkSection

getBiomeId

public int getBiomeId(int x,
 int y,
 int z)

Description copied from interface: ChunkSection3DBiome

获取子区块中某个特定位置的生物群系id

Specified by:

getBiomeId in interface ChunkSection3DBiome

Parameters:

x - [0, 16)

y - [0, 16)

z - [0, 16)

Returns:

特定位置的生物群系id

setBiomeId

public void setBiomeId(int x,
 int y,
 int z,
 byte id)

Description copied from interface: ChunkSection3DBiome

设置子区块中某个特定位置的生物群系id

Specified by:

setBiomeId in interface ChunkSection3DBiome

Parameters:

x - [0, 16)

y - [0, 16)

z - [0, 16)

id - 生物群系id

get3DBiomeDataArray

public byte[] get3DBiomeDataArray()

Specified by:

get3DBiomeDataArray in interface ChunkSection3DBiome

Returns:

3D生物群系字节数据

set3DBiomeDataArray

public void set3DBiomeDataArray(byte[] data)

Description copied from interface: ChunkSection3DBiome

设置3D生物群系字节数据

Specified by:

set3DBiomeDataArray in interface ChunkSection3DBiome

setNeedReObfuscate

@PowerNukkitXOnly
@Since("1.19.21-r1")
public void setNeedReObfuscate()

Specified by:

setNeedReObfuscate in interface ChunkSection

toString

public String toString()

Overrides:

toString in class Object