Biome Snapshot

---

本模组提供了一些命令，用于将指定坐标范围内的生物群系或地形状态导出为平面地图（需要权限等级 4）。

导出的图像保存在 config/biome-snapshot/<levelName>/ 中。

支持 en_us、zh_cn、zh_hk 和 zh_tw 语言。

重要提示：

• 导出图像时，游戏服务器将暂停，直到生成完成。
• 导出图像时，Biome Snapshot 会每 5 秒报告一次进度（%）；请耐心等待。
• 大陆海洋生物群系颜色解析器和大陆河流海洋生物群系颜色解析器仅支持 Minecraft 的主世界维度。
• 真实海岸线颜色解析器在遇到已完全生成的区块时，将以最新的表面方块为准。

/biome-snapshot

将指定坐标范围内的生物群系或地形状态导出为平面地图（需要权限等级 4）。

语法

/biome-snapshot <colorResolver> <from> <to>

参数

• <colorResolver>：颜色解析器

  指定要使用的颜色解析器。必须为 biome、mainland_ocean_biome、mainland_river_ocean_biome 或 real_coastline。如果不是，则此命令不会被解析。

  示例

  • biome
  • mainland_ocean_biome
  • mainland_river_ocean_biome
  • real_coastline

• <from>：column_pos 和 <to>：column_pos

  必须是仅含 和 的柱状坐标。每个值必须为整数或波浪号表示法。

  示例

  • 0 0
  • ~ ~
  • ~1 ~-2

/biome-snapshot-config

配置每个颜色解析器（需要权限等级 4）。游戏重启后，所有配置将重置为默认值。

语法

/biome-snapshot-config 有三个子命令（biome、mainland_ocean_biome 和 mainland_river_ocean_biome）。

• /biome-snapshot-config ...

  • ... biome ...

    配置生物群系颜色解析器。可为其他模组或数据包配置自定义生物群系颜色。

    • ... set <namespace> <path> <color>

      设置（生物群系的）颜色。

    • ... remove <namespace> <path>

      移除（生物群系的）颜色。

    • ... get <namespace> <path>

      获取（生物群系的）颜色。

  • ... mainland_ocean_biome ...

    配置大陆海洋生物群系颜色解析器。

    • ... set mainland <color>

      设置大陆的颜色。

    • ... set ocean <color>

      设置海洋的颜色。

    • ... get mainland

      获取大陆的颜色。

    • ... get ocean

      获取海洋的颜色。

  • ... mainland_river_ocean_biome ...

    配置大陆河流海洋生物群系颜色解析器。

    • ... set mainland <color>

      设置大陆的颜色。

    • ... set river <color>

      设置河流的颜色。

    • ... set ocean <color>

      设置海洋的颜色。

    • ... get mainland

      获取大陆的颜色。

    • ... get river

      获取河流的颜色。

    • ... get ocean

      获取海洋的颜色。

参数

• <namespace>：string 和 <path>：string

  指定生物群系的命名空间和路径。这两个值必须是单个单词（不含空格）。

  对于已配置颜色的生物群系，<namespace> 参数和 <path> 参数将自动提示其命名空间和路径。

  示例

  • minecraft plains
  • biomesoplenty auroral_garden
  • betterend amber_land

• <color>：integer

  指定颜色值。必须为 0 到 16,777,215 之间的整数。

  <color> 参数将自动提示 Biome Snapshot 提供的默认颜色值（如果有）。

  示例

  • 0
  • 255
  • 16777215

颜色解析器

生物群系颜色解析器

ID：biome。

基于生物群系，每个生物群系都有其独特的颜色。

示例：/biome-snapshot biome -5000 -5000 0 0

大陆海洋生物群系颜色解析器

ID：mainland_ocean_biome。

基于生物群系，将所有生物群系分为两类：大陆和海洋。默认情况下，大陆使用平原的颜色（绿色）表示，海洋使用海洋的颜色（深蓝色）表示。

示例：/biome-snapshot mainland_ocean_biome -5000 -5000 0 0

大陆河流海洋生物群系颜色解析器

ID：mainland_river_ocean_biome。

基于生物群系，将所有生物群系分为三类：大陆、河流和海洋。默认情况下，大陆使用平原的颜色（绿色）表示，河流使用河流的颜色（蓝色）表示，海洋使用海洋的颜色（深蓝色）表示。

示例：/biome-snapshot mainland_river_ocean_biome -5000 -5000 0 0

真实海岸线颜色解析器

ID：real_coastline。

"在默认情况下，1.18 及更高版本的海岸线与实际地形并不完全吻合。这不是一个 bug，而是因为地图显示的是底层生物群系，而不是精确的地形。在海岸附近，海洋和河流生物群系下面常常是陆地，而陆地生物群系也可能位于水下。"
来自 CHUNKBASE

上述现象存在于所有基于生物群系的颜色解析器中。如果你只需要精确的生物群系地图，此现象不会对你产生影响。如果你需要更真实地反映海岸线，请选择：真实海岸线颜色解析器。

真实海岸线颜色解析器基于 NOISE 生成阶段的区块数据，该阶段已生成并应用了真实的高度图。由于此阶段的表面方块仅为石头和水，因此可以使用这两种方块对应的颜色，在导出的图像中反映海岸线的情况。

需要注意的是，NOISE 阶段只是区块生成的早期阶段。如果区块已完全生成，甚至被玩家修改过，则将使用最新的表面方块作为标准，导出的图像也将使用最新表面方块的颜色。换句话说，Biome Snapshot 不会将区块回滚到 NOISE 阶段。

此外，后续阶段（例如地形雕刻（CARVERS））可能仍会轻微改变海岸线，但这些变化并不显著。而且，将区块生成到这些后期阶段所需的时间和空间远大于生成到 NOISE 阶段（早期阶段）所需的时间和空间。未来，这可能会被拆分为两个独立的颜色解析器以供选择。

示例：/biome-snapshot real_coastline -5000 -5000 0 0

面向模组和数据包开发者

Biome Snapshot 使模组和数据包的开发者或爱好者能够为其自定义生物群系配置默认颜色。

请前往 Issue 页面提交请求。

请提供模组或数据包的主页链接、你的身份（开发者、管理员、贡献者等），以及包含生物群系信息（命名空间、路径和默认颜色）的列表。

我将在 issue 中回复你的请求。

许可证

依据 Apache License 2.0 许可。