FTB预生成地图桥接

FTB预生成地图桥接

逐步从已保存的本地地形或LSS交付的区块填充FTB Chunks地图,可配置工作限制。

FTB Pregen Map Bridge

使用已存在的区块,为你的 FTB Chunks 地图填补缺失的地形,无需亲自重访每个区域。

这是一个独立的客户端附加模组,为 Minecraft 1.21.11 / Fabric 上的 Voxy Enhanced 开发。它使用 FTB Chunks 原生的地图绘制功能和 LOD Server Support API。它不是 FTB 或 LSS 的官方项目,也不包含它们的原始类或资源。

功能说明

  • 在单人游戏或由客户端托管本地世界时,读取当前维度中已保存的 .mca 地形,并填补缺失的 FTB 地图图块,扫描时优先处理附近的区域。
  • 可以使用由 Chunky 等预生成器创建的已保存地形,或普通游玩期间先前生成的地形。Chunky 并非本附加模组的直接依赖项。
  • 在远程多人游戏客户端上,接受由 LOD Server Support 0.20.0 提供的地形列。本附加模组不会读取他人计算机上的文件,也不会独立请求其整个世界的文件。
  • 保留已经完整的 FTB 图块。已探索地形的变化仍由 FTB 的正常邻近更新来处理。
  • 通过 FTB 保存地图数据,并记录已完成的本地区域指纹,以便在后续处理时跳过未更改的区域。

它不会生成 Minecraft 地形、加载实体、增加模拟/渲染距离或编辑世界区域文件。它确实会在客户端写入地图/缓存和进度数据,因此随着更多地形的绘制,FTB 地图的磁盘占用会增加。它不会添加领地声明,也不会更改其权限。

受控的后台工作

  • 一个低优先级的读取/解码线程,队列有界。
  • 最多 12 个已准备好的区块快照和 32 个已排队的网络列。
  • 默认上限为每秒 64 个区块,以 64 像素的切片绘制,每次客户端更新目标为 2 毫秒。
  • 在较长的游戏刻之后让出一次更新,并提供暂停/恢复命令。

这些是工作限制,并非保证的吞吐量或所有操作的硬性上限。巨大的预生成区域可能需要数小时。不声称能提升 FPS 或保证零卡顿。 原生 FTB 地图仍会执行其自身的加载、保存和内存管理。

前置要求

  • Minecraft 1.21.11、Fabric Loader 0.20.1+、Java 21+。
  • 适用于 Minecraft 1.21.11 的 Fabric API;源码环境使用 0.141.6+1.21.11。
  • FTB Chunks (Fabric) 2111.1.1,以及其正常依赖项,包括 FTB Library、FTB Teams 和 Architectury。
  • LOD Server Support / Voxy Server Side 0.20.0,适用于 Minecraft 1.21.11 的 Fabric 构建。

在此测试版中,FTB Chunks 和 LSS 都是硬性依赖项,包括单人游戏。此构建固定到上述 API 版本,不适用于其他 Minecraft 版本或不同的 FTB/LSS 发行版。

在每个需要填充自身地图的客户端中安装主 JAR。不要将其作为独立的专用服务器地图绘制器安装:本附加模组仅限客户端。远程绘制需要服务器和客户端都安装 LSS,以便地形能够实际传输,具体受该连接可用数据和配置范围限制。请遵循原始依赖项目的设置说明。

命令与配置

  • /ftbmapfill — 状态以及已绘制/已跳过区块、排队工作和错误的计数。
  • /ftbmapfill pause — 暂停本次会话的地图绘制工作。
  • /ftbmapfill resume — 恢复工作。

此首个测试版中的状态消息使用葡萄牙语。启用后,进入世界时会自动开始绘制。

配置文件为 config/ftb_pregen_map_bridge.json;编辑后需重启:

{"enabled": true, "maxChunksPerSecond": 64, "frameBudgetMillis": 2.0}

可接受的限制为每秒 4–256 个区块和 0.5–4 毫秒的绘制目标。较低的上限,例如每秒 16 个区块和 1 毫秒,以较小的预算换取更小的开销。

当前测试版的限制

  • 仅读取已存在且完全生成的本地区块。支持的 Anvil 压缩格式为 gzip、zlib 和未压缩记录,包括外部 .mcc 区块。不支持的压缩格式或不可读的记录将被跳过/报告;世界不会被转换。
  • 远程 LSS 路径会绘制新传输的数据。LSS 认为已传输的地形可能不会自动重发;此缓存/重连场景尚未完全验证。本附加模组不会静默擦除或重置 LSS/Voxy 缓存。
  • 如果你有意清除 FTB 地图缓存,请同时清除 local/ftb-pregen-map-bridge/ 下对应的桥接进度记录;否则已完成的本地区域可能仍被标记为已处理。
  • 这不会替代邻近地图更新,也不会强制刷新每个已完成的远处图块。

验证与致谢

针对 Anvil 读取、负坐标、调色板、高度、生物群系、LSS 列快照、真实 FTB 绘制、地图保存/重载、队列限制、暂停和断开的隔离原生检查均已通过。合成测试数据未打开个人世界。视觉游戏表现、完整多人连接和真实 FPS 仍有待确认。

原始附加模组:K9 / Chris Heverton,为 Voxy Enhanced 开发。

  • FTB Chunks (Fabric) — FTB。
  • LOD Server Support — bitvox / VoX 及贡献者;测试版本也称为 Voxy Server Side 0.20.0。
  • Fabric 和 Minecraft 保留其各自的作者身份和许可证。

原始集成代码使用包含在 LICENSE.txt 中的 Custom License / All Rights Reserved。依赖项的许可证不因此被替换。本附加模组不重新分发任何上游类、地图纹理或其他资源。

与 FTB、LSS 开发者、Mojang 或 Microsoft 无关联,也未获其认可。

美术作品披露: 项目头像是原创的 AI 生成品牌插图。它不是游戏截图,也不是 FTB 地图界面的复制品。