程序包 org.bukkit

# 接口 ChunkSnapshot

public interface ChunkSnapshot
表示一个静态的，线程安全的方块的区块的快照.

目的是允许清洁高效地复制一个区块的数据，然后在另一个线程（例如，地图渲染）中处理.

- ## 方法概要

  修饰符和类型
  方法
  说明
  `boolean`
  `contains(@NotNull Biome biome)`
  Tests if this chunk contains the specified biome.
  `boolean`
  `contains(@NotNull BlockData block)`
  Tests if this snapshot contains the specified block.
  `@NotNull Biome`
  `getBiome(int x, int z)`
  已过时。
  biomes are now 3-dimensional
  `@NotNull Biome`
  `getBiome(int x, int y, int z)`
  Get biome at given coordinates
  `@NotNull BlockData`
  `getBlockData(int x, int y, int z)`
  Get block data for block at corresponding coordinate in the chunk
  `int`
  `getBlockEmittedLight(int x, int y, int z)`
  获取区块中对应坐标方块的发光亮度等级.
  `int`
  `getBlockSkyLight(int x, int y, int z)`
  获取区块中对应坐标方块的天空亮度等级.
  `@NotNull Material`
  `getBlockType(int x, int y, int z)`
  获取区块中对应坐标方块的方块类型.
  `long`
  `getCaptureFullTime()`
  抓取区块快照时获取世界的完整时间.
  `int`
  `getData(int x, int y, int z)`
  已过时。
  不安全的参数
  `int`
  `getHighestBlockYAt(int x, int z)`
  获取指定坐标最高非空气方块的Y坐标.
  `double`
  `getRawBiomeTemperature(int x, int z)`
  已过时。
  biomes are now 3-dimensional
  `double`
  `getRawBiomeTemperature(int x, int y, int z)`
  Get raw biome temperature at given coordinates
  `@NotNull String`
  `getWorldName()`
  获取指定区块所在世界的名称.
  `int`
  `getX()`
  获取指定区块的X坐标.
  `int`
  `getZ()`
  获取指定区块的Z坐标.
  `boolean`
  `isSectionEmpty(int sy)`
  测试区块是否为空.

- ## 方法详细资料

  - ### getX

    int getX()
    获取指定区块的X坐标. 原文： Gets the X-coordinate of this chunk
    返回:
      X坐标

  - ### getZ

    int getZ()
    获取指定区块的Z坐标. 原文： Gets the Z-coordinate of this chunk
    返回:
      Z坐标

  - ### getWorldName

    @NotNull @NotNull String getWorldName()
    获取指定区块所在世界的名称. 原文： Gets name of the world containing this chunk
    返回:
      所在世界的名称

  - ### getBlockType

    @NotNull @NotNull Material getBlockType(int x, int y, int z)
    获取区块中对应坐标方块的方块类型.

    原文:Get block type for block at corresponding coordinate in the chunk

    参数:
      `x` - 0-15
      `y` - [世界最低高度, 世界最高高度)
      `z` - 0-15
    返回:
      方块物品类型

  - ### getBlockData

    @NotNull @NotNull BlockData getBlockData(int x, int y, int z)
    Get block data for block at corresponding coordinate in the chunk
    参数:
      `x` - 0-15
      `y` - [世界最低高度, 世界最高高度)
      `z` - 0-15
    返回:
      block material type

  - ### getData

    @Deprecated int getData(int x, int y, int z)
    已过时。
    不安全的参数
    获取区块中对应坐标方块的方块数据. 原文： Get block data for block at corresponding coordinate in the chunk
    参数:
      `x` - 0-15
      `y` - [世界最低高度, 世界最高高度)
      `z` - 0-15
    返回:
      0-15

  - ### getBlockSkyLight

    int getBlockSkyLight(int x, int y, int z)
    获取区块中对应坐标方块的天空亮度等级. 原文： Get sky light level for block at corresponding coordinate in the chunk
    参数:
      `x` - 0-15
      `y` - [世界最低高度, 世界最高高度)
      `z` - 0-15
    返回:
      0-15

  - ### getBlockEmittedLight

    int getBlockEmittedLight(int x, int y, int z)
    获取区块中对应坐标方块的发光亮度等级. 原文： Get light level emitted by block at corresponding coordinate in the chunk
    参数:
      `x` - 0-15
      `y` - [世界最低高度, 世界最高高度)
      `z` - 0-15
    返回:
      0-15

  - ### getHighestBlockYAt

    int getHighestBlockYAt(int x, int z)
    获取指定坐标最高非空气方块的Y坐标. 原文： Gets the highest non-air coordinate at the given coordinates
    参数:
      `x` - 方块X坐标 (0-15)
      `z` - 方块Z坐标 (0-15)
    返回:
      最高非空气方块的Y坐标

  - ### getBiome

    @NotNull @Deprecated @NotNull Biome getBiome(int x, int z)
    已过时。
    biomes are now 3-dimensional
    获取指定坐标的生物群系. 原文： Get biome at given coordinates
    参数:
      `x` - X坐标 (0-15)
      `z` - Z坐标 (0-15)
    返回:
      指定坐标的生物群系

  - ### getBiome

    @NotNull @NotNull Biome getBiome(int x, int y, int z)
    Get biome at given coordinates
    参数:
      `x` - X-coordinate (0-15)
      `y` - Y-coordinate [世界最低高度, 世界最高高度)
      `z` - Z-coordinate (0-15)
    返回:
      Biome at given coordinate

  - ### getRawBiomeTemperature

    @Deprecated double getRawBiomeTemperature(int x, int z)
    已过时。
    biomes are now 3-dimensional
    获取指定坐标原始生物群系的温度（范围为0.0到1.0）. 原文： Get raw biome temperature (0.0-1.0) at given coordinate
    参数:
      `x` - X坐标 (0-15)
      `z` - Z坐标 (0-15)
    返回:
      指定坐标的温度

  - ### getRawBiomeTemperature

    double getRawBiomeTemperature(int x, int y, int z)
    Get raw biome temperature at given coordinates
    参数:
      `x` - X-coordinate (0-15)
      `y` - Y-coordinate (0-15)
      `z` - Z-coordinate (0-15)
    返回:
      temperature at given coordinate

  - ### getCaptureFullTime

    long getCaptureFullTime()
    抓取区块快照时获取世界的完整时间. 原文： Get world full time when chunk snapshot was captured
    返回:
      时间，用tick表示

  - ### isSectionEmpty

    boolean isSectionEmpty(int sy)
    测试区块是否为空. 原文： Test if section is empty
    参数:
      `sy` - -区块的Y坐标, 为方块Y坐标整除16, 区间:[世界最低高度, 世界最高高度)
    返回:
      如果为空则返回true，否则返回false

  - ### contains

    boolean contains(@NotNull @NotNull BlockData block)
    Tests if this snapshot contains the specified block.
    参数:
      `block` - block to test
    返回:
      if the block is contained within

  - ### contains

    boolean contains(@NotNull @NotNull Biome biome)
    Tests if this chunk contains the specified biome.
    参数:
      `biome` - biome to test
    返回:
      if the biome is contained within