/// <reference path="../../index.d.ts" />

declare namespace mc {
  /**
   * ### 通过方块坐标获取Block
   *
   * 通过此函数来手动生成对象
   *
   * **注意**：要获取的方块必须处于已被加载的范围中，否则会出现问题
   *
   * @param pos 方块所在坐标
   *
   * @returns 方块对象
   */
  function getBlock(pos: IntPos): Block | undefined

  /**
   * ### 通过方块坐标获取Block
   *
   * 通过此函数来手动生成对象
   *
   * **注意**：要获取的方块必须处于已被加载的范围中，否则会出现问题
   *
   * @param x 方块x坐标
   * @param y 方块y坐标
   * @param z 方块z坐标
   * @param dimId 方块维度
   *
   * @returns 方块对象
   */
  function getBlock(x: number, y: number, z: number, dimId: 0 | 1 | 2): Block | undefined

  /**
   * ### 设置指定位置的方块
   *
   * 通过此函数，将一个坐标对应的方块设置成另一个，类似于命令 `/setblock`
   *
   * @param pos 目标方块位置
   * @param blockObject 要设置成的方块对象或方块 NBT 数据
   *
   * @returns 是否成功设置
   */
  function setBlock(
    pos: IntPos | FloatPos,
    blockObject: Block | NbtCompound
  ): boolean

  /**
   * ### 设置指定位置的方块
   *
   * 通过此函数，将一个坐标对应的方块设置成另一个，类似于命令 `/setblock`
   *
   * @param pos 目标方块位置
   * @param blockString 方块标准类型名（如`minecraft:stone`）
   * @param tileData 方块状态值，同原版 `/setBlock` 指令的 `tileData`，默认为 `0`，仅通过方块类型名放置方块时有效
   *
   * @returns 是否成功设置
   */
  function setBlock(
    pos: IntPos | FloatPos,
    blockString: string,
    tileData: number
  ): boolean

  /**
   * ### 设置指定位置的方块
   *
   * 通过此函数，将一个坐标对应的方块设置成另一个，类似于命令 `/setblock`
   *
   * @param x 方块 x 坐标
   * @param y 方块 y 坐标
   * @param z 方块 z 坐标
   * @param dimId 方块维度
   * @param blockObject 要设置成的方块对象或方块 NBT 数据
   *
   * @returns 是否成功设置
   */
  function setBlock(
    x: number,
    y: number,
    z: number,
    dimId: 0 | 1 | 2,
    blockObject: Block | NbtCompound
  ): boolean

  /**
   * ### 设置指定位置的方块
   *
   * 通过此函数，将一个坐标对应的方块设置成另一个，类似于命令 `/setblock`
   *
   * @param x 方块 x 坐标
   * @param y 方块 y 坐标
   * @param z 方块 z 坐标
   * @param dimId 方块维度
   * @param blockString 方块标准类型名（如`minecraft:stone`）
   * @tileData 方块状态值，同原版 `/setBlock` 指令的 `tileData`，默认为 `0`，仅通过方块类型名放置方块时有效
   *
   * @returns 是否成功设置
   */
  function setBlock(
    x: number,
    y: number,
    z: number,
    dimId: 0 | 1 | 2,
    blockString: string,
    tileData: number
  ): boolean

  /**
   * ### 在指定位置生成粒子效果
   *
   * 粒子效果名称可以查阅[Minecraft Wiki](https://minecraft.fandom.com/zh/wiki/%E7%B2%92%E5%AD%90?variant=zh#.E7.B1.BB.E5.9E.8B)得知
   *
   * 在传入参数的时候不要忘记命名空间前缀。类似于 `minecraft:heart_particle`
   *
   * @param pos 目标生成位置
   * @param type 要生成的粒子效果名称（可查阅wiki得知）
   *
   * @returns 是否生成成功
   */
  function spawnParticle(pos: IntPos | FloatPos, type: string): boolean

  /**
   * ### 在指定位置生成粒子效果
   *
   * 粒子效果名称可以查阅[Minecraft Wiki](https://minecraft.fandom.com/zh/wiki/%E7%B2%92%E5%AD%90?variant=zh#.E7.B1.BB.E5.9E.8B)得知
   *
   * 在传入参数的时候不要忘记命名空间前缀。类似于 `minecraft:heart_particle`
   *
   * @param x x坐标
   * @param y y坐标
   * @param z z坐标
   * @param dimId 维度
   * @param type 要生成的粒子效果名称（可查阅wiki得知）
   *
   * @returns 是否生成成功
   */
  function spawnParticle(
    x: number,
    y: number,
    z: number,
    dimId: 0 | 1 | 2,
    type: string,
  ): boolean
}