Package org.bukkit

Interface ChunkSnapshot

public interface ChunkSnapshot

Represents a static, thread-safe snapshot of chunk of blocks.

Purpose is to allow clean, efficient copy of a chunk data to be made, and then handed off for processing in another thread (e.g. map rendering)

Method Summary

Modifier and Type	Method	Description
Biome	getBiome(int x, int z)	Get biome at given coordinates
int	getBlockData(int x, int y, int z)	Deprecated. Magic value
int	getBlockEmittedLight(int x, int y, int z)	Get light level emitted by block at corresponding coordinate in the chunk
int	getBlockSkyLight(int x, int y, int z)	Get sky light level for block at corresponding coordinate in the chunk
Material	getBlockType(int x, int y, int z)	Get block type for block at corresponding coordinate in the chunk
int	getBlockTypeId(int x, int y, int z)	Deprecated. Magic value
long	getCaptureFullTime()	Get world full time when chunk snapshot was captured
int	getHighestBlockYAt(int x, int z)	Gets the highest non-air coordinate at the given coordinates
double	getRawBiomeRainfall(int x, int z)	Deprecated. this is not a chunk property in current Minecraft versions
double	getRawBiomeTemperature(int x, int z)	Get raw biome temperature (0.0-1.0) at given coordinate
java.lang.String	getWorldName()	Gets name of the world containing this chunk
int	getX()	Gets the X-coordinate of this chunk
int	getZ()	Gets the Z-coordinate of this chunk
boolean	isSectionEmpty(int sy)	Test if section is empty

Method Detail

getX

int getX()

Gets the X-coordinate of this chunk

Returns:

X-coordinate

getZ

int getZ()

Gets the Z-coordinate of this chunk

Returns:

Z-coordinate

getWorldName

java.lang.String getWorldName()

Gets name of the world containing this chunk

Returns:

Parent World Name

getBlockType

Material getBlockType(int x,
                      int y,
                      int z)

Get block type for block at corresponding coordinate in the chunk

Parameters:

x - 0-15

y - 0-127

z - 0-15

Returns:

block material type

getBlockTypeId

@Deprecated
int getBlockTypeId(int x,
                   int y,
                   int z)

Deprecated.

Magic value

Get block type for block at corresponding coordinate in the chunk

Parameters:

x - 0-15

y - 0-127

z - 0-15

Returns:

0-255

getBlockData

@Deprecated
int getBlockData(int x,
                 int y,
                 int z)

Deprecated.

Magic value

Get block data for block at corresponding coordinate in the chunk

Parameters:

x - 0-15

y - 0-127

z - 0-15

Returns:

0-15

getBlockSkyLight

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

Get sky light level for block at corresponding coordinate in the chunk

Parameters:

x - 0-15

y - 0-127

z - 0-15

Returns:

0-15

getBlockEmittedLight

int getBlockEmittedLight(int x,
                         int y,
                         int z)

Get light level emitted by block at corresponding coordinate in the chunk

Parameters:

x - 0-15

y - 0-127

z - 0-15

Returns:

0-15

getHighestBlockYAt

int getHighestBlockYAt(int x,
                       int z)

Gets the highest non-air coordinate at the given coordinates

Parameters:

x - X-coordinate of the blocks

z - Z-coordinate of the blocks

Returns:

Y-coordinate of the highest non-air block

getBiome

Biome getBiome(int x,
               int z)

Get biome at given coordinates

Parameters:

x - X-coordinate

z - Z-coordinate

Returns:

Biome at given coordinate

getRawBiomeTemperature

double getRawBiomeTemperature(int x,
                              int z)

Get raw biome temperature (0.0-1.0) at given coordinate

Parameters:

x - X-coordinate

z - Z-coordinate

Returns:

temperature at given coordinate

getRawBiomeRainfall

@Deprecated
double getRawBiomeRainfall(int x,
                           int z)

Deprecated.

this is not a chunk property in current Minecraft versions

Get raw biome rainfall (0.0-1.0) at given coordinate

Parameters:

x - X-coordinate

z - Z-coordinate

Returns:

rainfall at given coordinate

getCaptureFullTime

long getCaptureFullTime()

Get world full time when chunk snapshot was captured

Returns:

time in ticks

isSectionEmpty

boolean isSectionEmpty(int sy)

Test if section is empty

Parameters:

sy - - section Y coordinate (block Y / 16)

Returns:

true if empty, false if not