package org.bukkit.craftbukkit; import org.bukkit.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) */ public class CraftChunkSnapshot implements ChunkSnapshot { private final int x, z; private final String worldname; private final byte[] buf; // Flat buffer in uncompressed chunk file format private final byte[] hmap; // Height map private final long capture_fulltime; private static final int BLOCKDATA_OFF = 32768; private static final int BLOCKLIGHT_OFF = BLOCKDATA_OFF + 16384; private static final int SKYLIGHT_OFF = BLOCKLIGHT_OFF + 16384; /** * Constructor */ CraftChunkSnapshot(int x, int z, String wname, long wtime, byte[] buf, byte[] hmap) { this.x = x; this.z = z; this.worldname = wname; this.capture_fulltime = wtime; this.buf = buf; this.hmap = hmap; } /** * Gets the X-coordinate of this chunk * * @return X-coordinate */ public int getX() { return x; } /** * Gets the Z-coordinate of this chunk * * @return Z-coordinate */ public int getZ() { return z; } /** * Gets name of the world containing this chunk * * @return Parent World Name */ public String getWorldName() { return worldname; } /** * Get block type for block at corresponding coordinate in the chunk * * @param x 0-15 * @param y 0-127 * @param z 0-15 * @return 0-255 */ public int getBlockTypeId(int x, int y, int z) { return buf[x << 11 | z << 7 | y] & 255; } /** * Get block data for block at corresponding coordinate in the chunk * * @param x 0-15 * @param y 0-127 * @param z 0-15 * @return 0-15 */ public int getBlockData(int x, int y, int z) { int off = ((x << 10) | (z << 6) | (y >> 1)) + BLOCKDATA_OFF; return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF); } /** * Get sky light level for block at corresponding coordinate in the chunk * * @param x 0-15 * @param y 0-127 * @param z 0-15 * @return 0-15 */ public int getBlockSkyLight(int x, int y, int z) { int off = ((x << 10) | (z << 6) | (y >> 1)) + SKYLIGHT_OFF; return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF); } /** * Get light level emitted by block at corresponding coordinate in the chunk * * @param x 0-15 * @param y 0-127 * @param z 0-15 * @return 0-15 */ public int getBlockEmittedLight(int x, int y, int z) { int off = ((x << 10) | (z << 6) | (y >> 1)) + BLOCKLIGHT_OFF; return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF); } /** * Gets the highest non-air coordinate at the given coordinates * * @param x X-coordinate of the blocks * @param z Z-coordinate of the blocks * @return Y-coordinate of the highest non-air block */ public int getHighestBlockYAt(int x, int z) { return hmap[z << 4 | x] & 255; } /** * Get world full time when chunk snapshot was captured * @return time in ticks */ public long getCaptureFullTime() { return capture_fulltime; } }