package org.bukkit.generator; import java.util.ArrayList; import java.util.List; import java.util.Random; import org.bukkit.Bukkit; import org.bukkit.Location; import org.bukkit.Material; import org.bukkit.World; import org.bukkit.block.Biome; import org.bukkit.block.Block; import org.bukkit.material.MaterialData; /** * A chunk generator is responsible for the initial shaping of an entire * chunk. For example, the nether chunk generator should shape netherrack and * soulsand */ public abstract class ChunkGenerator { /** * Interface to biome section for chunk to be generated: initialized with * default values for world type and seed. *
* Custom generator is free to access and tailor values during * generateBlockSections() or generateExtBlockSections(). */ public interface BiomeGrid { /** * Get biome at x, z within chunk being generated * * @param x - 0-15 * @param z - 0-15 * @return Biome value */ Biome getBiome(int x, int z); /** * Set biome at x, z within chunk being generated * * @param x - 0-15 * @param z - 0-15 * @param bio - Biome value */ void setBiome(int x, int z, Biome bio); } @Deprecated /** * Shapes the chunk for the given coordinates. *
* This method should return a byte[32768] in the following format: *
* for (int x = 0; x < 16; x++) { * for (int z = 0; z < 16; z++) { * for (int y = 0; y < 128; y++) { * // result[(x * 16 + z) * 128 + y] = ??; * } * } * } **
* Note that this method should never attempt to get the Chunk at * the passed coordinates, as doing so may cause an infinite loop *
* Note this deprecated method will only be called when both * generateExtBlockSections() and generateBlockSections() are * unimplemented and return null. * * @param world The world this chunk will be used for * @param random The random generator to use * @param x The X-coordinate of the chunk * @param z The Z-coordinate of the chunk * @return byte[] containing the types for each block created by this * generator */ public byte[] generate(World world, Random random, int x, int z) { throw new UnsupportedOperationException("Custom generator is missing required methods: generate(), generateBlockSections() and generateExtBlockSections()"); } /** * Shapes the chunk for the given coordinates, with extended block IDs * supported (0-4095). *
* As of 1.2, chunks are represented by a vertical array of chunk * sections, each of which is 16 x 16 x 16 blocks. If a section is empty * (all zero), the section does not need to be supplied, reducing memory * usage. *
* This method must return a short[][] array in the following format: *
* short[][] result = new short[world-height / 16][]; ** Each section {@code (sectionID = (Y>>4))} that has blocks needs to be allocated * space for the 4096 blocks in that section: *
* result[sectionID] = new short[4096]; ** while sections that are not populated can be left null. *
* Setting a block at X, Y, Z within the chunk can be done with the * following mapping function: *
* void setBlock(short[][] result, int x, int y, int z, short blkid) { * {@code if (result[y >> 4] == null) {} * {@code result[y >> 4] = new short[4096];} * } * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } ** while reading a block ID can be done with the following mapping * function: *
* short getBlock(short[][] result, int x, int y, int z) { * {@code if (result[y >> 4] == null) {} * return (short)0; * } * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } ** while sections that are not populated can be left null. *
* Setting a block at X, Y, Z within the chunk can be done with the * following mapping function: *
* void setBlock(short[][] result, int x, int y, int z, short blkid) { * {@code if (result[y >> 4) == null) {} * {@code result[y >> 4] = new short[4096];} * } * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } ** while reading a block ID can be done with the following mapping * function: *
* short getBlock(short[][] result, int x, int y, int z) { * {@code if (result[y >> 4) == null) {} * return (short)0; * } * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } **
* Note that this method should never attempt to get the Chunk at * the passed coordinates, as doing so may cause an infinite loop *
* Note generators that do not return block IDs above 255 should not * implement this method, or should have it return null (which will result * in the generateBlockSections() method being called). * * @param world The world this chunk will be used for * @param random The random generator to use * @param x The X-coordinate of the chunk * @param z The Z-coordinate of the chunk * @param biomes Proposed biome values for chunk - can be updated by * generator * @return short[][] containing the types for each block created by this * generator * @deprecated Magic value */ @Deprecated public short[][] generateExtBlockSections(World world, Random random, int x, int z, BiomeGrid biomes) { return null; // Default - returns null, which drives call to generateBlockSections() } /** * Shapes the chunk for the given coordinates. *
* As of 1.2, chunks are represented by a vertical array of chunk * sections, each of which is 16 x 16 x 16 blocks. If a section is empty * (all zero), the section does not need to be supplied, reducing memory * usage. *
* This method must return a byte[][] array in the following format: *
* byte[][] result = new byte[world-height / 16][]; ** Each section {@code (sectionID = (Y>>4))} that has blocks needs to be allocated * space for the 4096 blocks in that section: *
* result[sectionID] = new byte[4096]; ** while sections that are not populated can be left null. *
* Setting a block at X, Y, Z within the chunk can be done with the * following mapping function: *
* void setBlock(byte[][] result, int x, int y, int z, byte blkid) { * {@code if (result[y >> 4) == null) {} * {@code result[y >> 4] = new byte[4096];} * } * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } ** while reading a block ID can be done with the following mapping * function: *
* byte getBlock(byte[][] result, int x, int y, int z) { * {@code if (result[y >> 4) == null) {} * return (byte)0; * } * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } ** * Note that this method should never attempt to get the Chunk at * the passed coordinates, as doing so may cause an infinite loop * * @param world The world this chunk will be used for * @param random The random generator to use * @param x The X-coordinate of the chunk * @param z The Z-coordinate of the chunk * @param biomes Proposed biome values for chunk - can be updated by * generator * @return short[][] containing the types for each block created by this * generator * @deprecated Magic value */ @Deprecated public byte[][] generateBlockSections(World world, Random random, int x, int z, BiomeGrid biomes) { return null; // Default - returns null, which drives call to generate() } /** * Shapes the chunk for the given coordinates. * * This method must return a ChunkData. *
* Notes: *
* This method should never attempt to get the Chunk at * the passed coordinates, as doing so may cause an infinite loop *
* This method should never modify a ChunkData after it has * been returned. *
* This method must return a ChunkData returned by {@link ChunkGenerator#createChunkData(org.bukkit.World)}
*
* @param world The world this chunk will be used for
* @param random The random generator to use
* @param x The X-coordinate of the chunk
* @param z The Z-coordinate of the chunk
* @param biome Proposed biome values for chunk - can be updated by
* generator
* @return ChunkData containing the types for each block created by this
* generator
*/
public ChunkData generateChunkData(World world, Random random, int x, int z, BiomeGrid biome) {
return null; // Default - returns null, which drives call to generateExtBlockSections()
}
/**
* Create a ChunkData for a world.
* @param world the world the ChunkData is for
* @return a new ChunkData for world
*/
protected final ChunkData createChunkData(World world) {
return Bukkit.getServer().createChunkData(world);
}
/**
* Tests if the specified location is valid for a natural spawn position
*
* @param world The world we're testing on
* @param x X-coordinate of the block to test
* @param z Z-coordinate of the block to test
* @return true if the location is valid, otherwise false
*/
public boolean canSpawn(World world, int x, int z) {
Block highest = world.getBlockAt(x, world.getHighestBlockYAt(x, z), z);
switch (world.getEnvironment()) {
case NETHER:
return true;
case THE_END:
return highest.getType() != Material.AIR && highest.getType() != Material.WATER && highest.getType() != Material.LAVA;
case NORMAL:
default:
return highest.getType() == Material.SAND || highest.getType() == Material.GRAVEL;
}
}
/**
* Gets a list of default {@link BlockPopulator}s to apply to a given
* world
*
* @param world World to apply to
* @return List containing any amount of BlockPopulators
*/
public List
* A null value is returned if a world should not use a fixed spawn point,
* and will instead attempt to find one randomly.
*
* @param world The world to locate a spawn point for
* @param random Random generator to use in the calculation
* @return Location containing a new spawn point, otherwise null
*/
public Location getFixedSpawnLocation(World world, Random random) {
return null;
}
/**
* Data for a Chunk.
*/
public static interface ChunkData {
/**
* Get the maximum height for the chunk.
*
* Setting blocks at or above this height will do nothing.
*
* @return the maximum height
*/
public int getMaxHeight();
/**
* Set the block at x,y,z in the chunk data to material.
*
* Note: setting blocks outside the chunk's bounds does nothing.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @param material the type to set the block to
*/
public void setBlock(int x, int y, int z, Material material);
/**
* Set the block at x,y,z in the chunk data to material.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @param material the type to set the block to
*/
public void setBlock(int x, int y, int z, 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.
*
* @param xMin minimum x location (inclusive) in the chunk to set
* @param yMin minimum y location (inclusive) in the chunk to set
* @param zMin minimum z location (inclusive) in the chunk to set
* @param xMax maximum x location (exclusive) in the chunk to set
* @param yMax maximum y location (exclusive) in the chunk to set
* @param zMax maximum z location (exclusive) in the chunk to set
* @param material the type to set the blocks to
*/
public 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.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param xMin minimum x location (inclusive) in the chunk to set
* @param yMin minimum y location (inclusive) in the chunk to set
* @param zMin minimum z location (inclusive) in the chunk to set
* @param xMax maximum x location (exclusive) in the chunk to set
* @param yMax maximum y location (exclusive) in the chunk to set
* @param zMax maximum z location (exclusive) in the chunk to set
* @param material the type to set the blocks to
*/
public void setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, MaterialData material);
/**
* Get the type of the block at x, y, z.
*
* Getting blocks outside the chunk's bounds returns air.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @return the type of the block or Material.AIR if x, y or z are outside the chunk's bounds
*/
public Material getType(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.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @return the type and data of the block or the MaterialData for air if x, y or z are outside the chunk's bounds
*/
public MaterialData getTypeAndData(int x, int y, int z);
/**
* Set a region of this chunk from xMin, yMin, zMin (inclusive)
* to xMax, yMax, zMax (exclusive) to block id.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param xMin minimum x location (inclusive) in the chunk to set
* @param yMin minimum y location (inclusive) in the chunk to set
* @param zMin minimum z location (inclusive) in the chunk to set
* @param xMax maximum x location (exclusive) in the chunk to set
* @param yMax maximum y location (exclusive) in the chunk to set
* @param zMax maximum z location (exclusive) in the chunk to set
* @param blockId the block id to set the blocks to
* @deprecated Uses magic values.
*/
@Deprecated
public void setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, int blockId);
/**
* Set a region of this chunk from xMin, yMin, zMin (inclusive)
* to xMax, yMax, zMax (exclusive) to block id and data.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param xMin minimum x location (inclusive) in the chunk to set
* @param yMin minimum y location (inclusive) in the chunk to set
* @param zMin minimum z location (inclusive) in the chunk to set
* @param xMax maximum x location (exclusive) in the chunk to set
* @param yMax maximum y location (exclusive) in the chunk to set
* @param zMax maximum z location (exclusive) in the chunk to set
* @param blockId the block id to set the blocks to
* @param data the block data to set the blocks to
* @deprecated Uses magic values.
*/
@Deprecated
public void setRegion(int xMin, int yMin, int zMin, int xMax, int yMax, int zMax, int blockId, int data);
/**
* Set the block at x,y,z in the chunk data to blockId.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @param blockId the blockId to set the block to
* @deprecated Uses magic values
*/
@Deprecated
public void setBlock(int x, int y, int z, int blockId);
/**
* Set the block at x,y,z in the chunk data to blockId.
*
* Setting blocks outside the chunk's bounds does nothing.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @param blockId the blockId to set the block to
* @param data the block data to set the block to
* @deprecated Uses magic values
*/
@Deprecated
public void setBlock(int x, int y, int z, int blockId, byte data);
/**
* Get the blockId at x,y,z in the chunk data.
*
* Getting blocks outside the chunk's bounds returns 0.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @return the block id or 0 if x, y or z are outside the chunk's bounds
* @deprecated Uses magic values
*/
@Deprecated
public int getTypeId(int x, int y, int z);
/**
* Get the block data at x,y,z in the chunk data.
*
* Getting blocks outside the chunk's bounds returns 0.
*
* @param x the x location in the chunk from 0-15 inclusive
* @param y the y location in the chunk from 0 (inclusive) - maxHeight (exclusive)
* @param z the z location in the chunk from 0-15 inclusive
* @return the block data value or air if x, y or z are outside the chunk's bounds
* @deprecated Uses magic values
*/
@Deprecated
public byte getData(int x, int y, int z);
}
}