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

/**
 * ### 🎯 整数 坐标对象
 *
 * x y z坐标均为**整数**，多用来表示方块坐标等用整数表示的位置
 *
 * @see [🎯 坐标对象](https://docs.litebds.com/zh-Hans/#/LLSEPluginDevelopment/GameAPI/Basic?id=%f0%9f%8e%af-%e5%9d%90%e6%a0%87%e5%af%b9%e8%b1%a1)
 */
declare class IntPos {
  /**
   * @param x x坐标（整数）
   * @param y y坐标（整数）
   * @param z z坐标（整数）
   * @param dimId 维度ID
   */
  constructor(x: number, y: number, z: number, dimId: number);

  /** x坐标（整数） */
  x: number;

  /** y坐标（整数） */
  y: number;

  /** z坐标（整数） */
  z: number;

  /**
   * ### 维度文字名
   *
   * 主世界 - `Overworld`\
   * 下界 - `Nether`\
   * 末地 - `TheEnd`
   */
  readonly dim: "主世界"|"下界"|"末地";

  /**
   * ### 维度ID
   *
   * 主世界 - `0`\
   * 下界 - `1`\
   * 末地 - `2`
   *
   * 如果某种情况下维度无效，或者无法获取，你会发现`dimid`的值为`-1`
   */
  dimid: 0 | 1 | 2;

  toString(): string;
}