Terrarium

Terrarium

为 Minecraft 生成像素级精准的地球地形

从真实高程数据生成像素级精准的世界，支持动态瓦片加载和可自定义的地形塑造。

• 对于服务器和单人游戏，世界类型为 terrarium:terrarium；创建世界时选择地球，并选择自定义来按世界调整设置。

---

🌐 地形数据管线

• 数据来源: AWS S3 (elevation-tiles-prod/terrarium/{zoom}/{x}/{y}.png)
• 温度与降水数据 个人数据源托管于 GitHub，使用 QGIS 编译生成。 (clim-monthly/{month}/{zoom}/{x}/{y}) 此为临时托管方案
• 像素到方块: 1 像素 = 1 个 Minecraft 方块。
• 瓦片系统：
  • 每块瓦片 = 256×256 像素（游戏内 256×256 方块）。
  • zoom 级别决定每个轴的瓦片数量（2^zoom 块瓦片）。
    • 示例：zoom: 8 = 2⁸ = 256 块瓦片 → 256×256 = 65,536 方块宽。

---

🗃️ 下载

• 可在此处下载开发中测试版本 here
• 不保证对上述版本提供支持，仅支持 alpha、beta 和正式版本
• 需要 FabricAPI

---

🏔️ 技术说明

• 缩放示例：
  • zoom: 10 = 1,024 块瓦片 → 262,144×262,144 方块。
  • zoom: 13 = 8,192 块瓦片 → 2,097,152×2,097,152 方块。

🌩️ 性能：

• 更高的缩放级别 = 更大的世界，但生成速度更慢。
• 建议将缩放级别降低至 8–10，以获得适合生存游戏的世界尺寸。

世界尺寸对比

• zoom: 10（小型 - 约 1:48）与 zoom: 13（行星级 - 约 1:6）对比。

🖼️ 截图：

• 使用 v0.0.2-beta.2 + Bliss/Photon + WWOO 拍摄

Zoom: 13 | 高度 768

---

---

🛠️ 运作原理

• 瓦片获取：根据缩放级别从 AWS 下载 256×256 PNG 瓦片并进行缓存。
• 高度映射：将 RGB 像素转换为方块高度，并根据 additionalAlt 进行缩放。
• 生物群系放置：利用高程数据（startingY + altitudeDropoff）映射原版生物群系。

🔧 配置

/config/BlossomMods/Terrarium.json:

{
  "ELEVATION_URL": "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/", //高程数据源
  "TEMPERATURE_URL": "https://raw.githubusercontent.com/ly-nxs/terrarium-data/refs/heads/main/tiles/climate-monthly/", //气候数据源
  "CACHE_DIR": "./tiles", //瓦片缓存目录
}