
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 地图界面的复制品。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。