跳转至

坐标

坐标(Coordinate)是Minecraft基岩版中用于表示世界内位置的数值系统。基岩版使用三维笛卡尔坐标系来定义世界中每一个位置,坐标在命令系统、附加包定义、脚本API等诸多方面都有应用。

坐标系

基岩版的世界坐标系由三个互相垂直的轴构成:

  • X轴:东西方向。正方向指向东方,负方向指向西方。
  • Y轴:垂直方向。正方向指向上方,负方向指向下方。
  • Z轴:南北方向。正方向指向南方,负方向指向北方。

该坐标系符合左手坐标系规则。世界中的每一个方块位置对应一组整数坐标,而精确位置则使用浮点数坐标表示。

坐标范围

在主世界维度中,Y轴的有效范围为-64至319(基游戏版本1.18.0及以上)。旧版世界的Y轴范围为0至255。下界和末地维度的Y轴范围为0至255。X轴和Z轴在理论上没有硬性限制,但在极远距离处可能出现浮点精度导致的异常行为。

坐标表示方式

在命令中,坐标可以通过三种方式表示:

绝对坐标

绝对坐标直接指定世界中的精确位置。例如,100 64 -200表示X为100、Y为64、Z为-200的位置。

相对坐标

相对坐标(Relative Coordinate)以波浪号~为前缀,表示基于命令执行位置的偏移。省略偏移量时默认为0。例如:

  • ~ ~ ~:命令执行位置本身。
  • ~10 ~-5 ~0:执行位置的X方向偏移10格、Y方向偏移-5格。

局部坐标

局部坐标(Local Coordinate)以脱字号^为前缀,表示基于命令执行者朝向的偏移。三个分量分别对应左方、上方和前方:

  • ^ ^ ^:命令执行位置本身。
  • ^5 ^0 ^10:执行者左方5格、前方10格的位置。

局部坐标的基准方向由执行者的视角旋转角度(偏航角和俯仰角)决定。不同于相对坐标始终以世界轴为基准,局部坐标会随着执行者的朝向变化而变化。

相对坐标和局部坐标不可在同一条命令中混用。

方块坐标与精确坐标

方块坐标是取整后的整数坐标,用于定位方块在世界中的位置。方块坐标通过对精确坐标向下取整(floor)得到。例如,精确坐标(1.7, 64.3, -0.2)对应方块坐标(1, 64, -1)

精确坐标为浮点数,用于定位实体等非方块对象的位置。玩家的坐标通常指其脚部所在位置,眼睛位置约在脚部位置上方1.62格处。

区块坐标

区块(Chunk)是世界的基本加载单位,每个区块覆盖16×16个方块的水平区域。区块的坐标通过方块坐标整除16(向下取整)得到。例如,方块坐标X为35的位置位于区块X为2的区块中。

子区块(Subchunk)是区块在垂直方向上的划分单位,每个子区块覆盖16格高度。子区块的Y坐标通过方块Y坐标整除16得到。

调试屏幕中的坐标

在游戏中的调试屏幕(Debug Screen)中可以查看当前玩家的精确坐标、方块坐标和区块坐标等详细信息。调试屏幕仅在开发构建中可用。

在正式版中,玩家可以通过世界设置中的“显示坐标”选项在屏幕上显示当前坐标。