Fork of Poseidon providing Bukkit #1060 to older Beta versions (b1.0-b1.7.3)
1package org.bukkit.generator;
2
3import org.bukkit.Chunk;
4import org.bukkit.World;
5
6import java.util.Random;
7
8/**
9 * A block populator is responsible for generating a small area of blocks.
10 * For example, generating glowstone inside the nether or generating dungeons full of treasure
11 */
12public abstract class BlockPopulator {
13 /**
14 * Populates an area of blocks at or around the given chunk.
15 * <p>
16 * The chunks on each side of the specified chunk must already exist; that is,
17 * there must be one north, east, south and west of the specified chunk.
18 * The "corner" chunks may not exist, in which scenario the populator should
19 * record any changes required for those chunks and perform the changes when
20 * they are ready.
21 *
22 * @param world The world to generate in
23 * @param random The random generator to use
24 * @param chunk The chunk to generate for
25 */
26 public abstract void populate(World world, Random random, Chunk source);
27}