Package org.bukkit.generator

Interface ChunkGenerator.ChunkData

Enclosing class:

ChunkGenerator

public static interface ChunkGenerator.ChunkData

Data for a Chunk.

Method Summary

Modifier and Type	Method	Description
Biome	getBiome(int x, int y, int z)	Get the biome at x, y, z within chunk being generated
BlockData	getBlockData(int x, int y, int z)	Get the type and data of the block at x, y, z.
byte	getData(int x, int y, int z)	Deprecated. Uses magic values
int	getMaxHeight()	Get the maximum height for this ChunkData.
int	getMinHeight()	Get the minimum height for this ChunkData.
Material	getType(int x, int y, int z)	Get the type of the block at x, y, z.
MaterialData	getTypeAndData(int x, int y, int z)	Get the type and data of the block at x, y, z.
void	setBlock(int x, int y, int z, BlockData blockData)	Set the block at x,y,z in the chunk data to material.
void	setBlock(int x, int y, int z, Material material)	Set the block at x,y,z in the chunk data to material.
void	setBlock(int x, int y, int z, MaterialData material)	Set the block at x,y,z in the chunk data to material.
void	setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, BlockData blockData)	Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material.
void	setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, Material material)	Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material.
void	setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, MaterialData material)	Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material.

Method Details

getMinHeight

int getMinHeight()

Get the minimum height for this ChunkData.

It is not guaranteed that this method will return the same value as WorldInfo.getMinHeight().

Setting blocks below this height will do nothing.

Returns:

the minimum height

getMaxHeight

int getMaxHeight()

Get the maximum height for this ChunkData.

It is not guaranteed that this method will return the same value as WorldInfo.getMaxHeight().

Setting blocks at or above this height will do nothing.

Returns:

the maximum height

getBiome

@NotNull
Biome getBiome(int x,
 int y,
 int z)

Get the biome at x, y, z within chunk being generated

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minimum (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

Returns:

Biome value

setBlock

void setBlock(int x,
 int y,
 int z,
 @NotNull
 Material material)

Set the block at x,y,z in the chunk data to material. Note: setting blocks outside the chunk's bounds does nothing.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

material - the type to set the block to

setBlock

void setBlock(int x,
 int y,
 int z,
 @NotNull
 MaterialData material)

Set the block at x,y,z in the chunk data to material. Setting blocks outside the chunk's bounds does nothing.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

material - the type to set the block to

setBlock

void setBlock(int x,
 int y,
 int z,
 @NotNull
 BlockData blockData)

Set the block at x,y,z in the chunk data to material. Setting blocks outside the chunk's bounds does nothing.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

blockData - the type to set the block to

setRegion

void setRegion(int xMin,
 int yMin,
 int zMin,
 int xMax,
 int yMax,
 int zMax,
 @NotNull
 Material material)

Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material. Setting blocks outside the chunk's bounds does nothing.

Parameters:

xMin - minimum x location (inclusive) in the chunk to set

yMin - minimum y location (inclusive) in the chunk to set

zMin - minimum z location (inclusive) in the chunk to set

xMax - maximum x location (exclusive) in the chunk to set

yMax - maximum y location (exclusive) in the chunk to set

zMax - maximum z location (exclusive) in the chunk to set

material - the type to set the blocks to

setRegion

void setRegion(int xMin,
 int yMin,
 int zMin,
 int xMax,
 int yMax,
 int zMax,
 @NotNull
 MaterialData material)

Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material. Setting blocks outside the chunk's bounds does nothing.

Parameters:

xMin - minimum x location (inclusive) in the chunk to set

yMin - minimum y location (inclusive) in the chunk to set

zMin - minimum z location (inclusive) in the chunk to set

xMax - maximum x location (exclusive) in the chunk to set

yMax - maximum y location (exclusive) in the chunk to set

zMax - maximum z location (exclusive) in the chunk to set

material - the type to set the blocks to

setRegion

void setRegion(int xMin,
 int yMin,
 int zMin,
 int xMax,
 int yMax,
 int zMax,
 @NotNull
 BlockData blockData)

Set a region of this chunk from xMin, yMin, zMin (inclusive) to xMax, yMax, zMax (exclusive) to material. Setting blocks outside the chunk's bounds does nothing.

Parameters:

xMin - minimum x location (inclusive) in the chunk to set

yMin - minimum y location (inclusive) in the chunk to set

zMin - minimum z location (inclusive) in the chunk to set

xMax - maximum x location (exclusive) in the chunk to set

yMax - maximum y location (exclusive) in the chunk to set

zMax - maximum z location (exclusive) in the chunk to set

blockData - the type to set the blocks to

getType

@NotNull
Material getType(int x,
 int y,
 int z)

Get the type of the block at x, y, z. Getting blocks outside the chunk's bounds returns air.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

Returns:

the type of the block or Material.AIR if x, y or z are outside the chunk's bounds

getTypeAndData

@NotNull
MaterialData getTypeAndData(int x,
 int y,
 int z)

Get the type and data of the block at x, y, z. Getting blocks outside the chunk's bounds returns air.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

Returns:

the type and data of the block or the MaterialData for air if x, y or z are outside the chunk's bounds

getBlockData

@NotNull
BlockData getBlockData(int x,
 int y,
 int z)

Get the type and data of the block at x, y, z. Getting blocks outside the chunk's bounds returns air.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

Returns:

the data of the block or the BlockData for air if x, y or z are outside the chunk's bounds

getData

@Deprecated
byte getData(int x,
 int y,
 int z)

Deprecated.

Uses magic values

Get the block data at x,y,z in the chunk data. Getting blocks outside the chunk's bounds returns 0.

Parameters:

x - the x location in the chunk from 0-15 inclusive

y - the y location in the chunk from minHeight (inclusive) - maxHeight (exclusive)

z - the z location in the chunk from 0-15 inclusive

Returns:

the block data value or air if x, y or z are outside the chunk's bounds