LOD服务器支持

LOD服务器支持

Voxy多人游戏支持与Distant Horizons兼容性(非官方)。在多人游戏中,可以看到数千方块之外的完整渲染区块和玩家。

LOD Server Support

使安装了 Voxy 的玩家能够在多人服务器上看到数百个区块范围内完整渲染的地形,无需事先探索世界。还包含远处玩家渲染,因此你也能看到远超原版渲染距离的其他玩家。它甚至能在运行 Distant Horizons 的服务器上显示远处地形。

实时体验:安装 Voxy 和本模组后加入 lod-server-support.bitvox.me。支持 Minecraft 26.3、26.2、26.1、1.21.11、1.21.10 和 1.21.1。

演示视频

兼容性

客户端在所有版本上使用 Fabric 模组;在 26.3、26.2、26.1 和 1.21.1 上,NeoForge 客户端也可用。支持的服务器:

Minecraft Fabric NeoForge
26.3 ✅ ✅
26.2 ✅ ✅
26.1 ✅ ✅
1.21.11 ✅ -
1.21.10 ✅ -
1.21.1 ✅ ✅

NeoForge 支持为尽力而为,远处玩家渲染仅在 1.21.1 上可用。

兼容 AntiXray、Moonrise、C2ME、ViaVersion/ViaBackwards,以及包括 Create 在内的大多数其他模组。可与 Distant Horizons 在同一服务器上同时运行,以同时支持 DH 客户端和 Voxy 客户端。

可基于 LOD 数据填充 Xaero's World/Mini Map 和 JourneyMap。新安装默认开启;在客户端 Sodium 设置中切换“Map Ingestion”,点击应用,然后重新连接。Xaero 的洞穴地图也会填充,包括任意高度的下界。服务器可通过 privacy.request_no_map_ingestion 要求客户端不要将 LOD 地形添加到其地图中(0.19.0 之前的客户端将不会获得 LOD)。拥有 lss.map_ingestion 权限的玩家不受此限制。

LOD Server Support 从 v0.4.0 到当前版本均向后和向前兼容。服务器管理员可自由更新以利用改进,而不会破坏旧版本客户端(除非开启 privacy.request_no_map_ingestion),客户端也可更新而不破坏与旧服务器的兼容性。

在 NeoForge(1.21.1)上使用 Roxy 加载 Fabric 版 Voxy jar。已测试可与 Roxy 0.2.0、Voxy 0.2.16-beta(1.21.11 构建)、Sodium 0.8.12 和 Forgified Fabric API 0.116.15 配合工作。如果远处的 Voxy 区块不显示,请在视频设置中关闭环境雾。

Distant Horizons 服务器(实验性,默认开启)。 加入运行 Distant Horizons 3.3.x 的服务器,远处地形会通过 Voxy 加载,即使服务器未安装 LOD Server Support。为获得最佳效果,我们仍建议在服务器上也安装 LOD Server Support,存在时它始终优先。适用于所有版本的 Fabric 客户端,以及 26.2、26.1 和 1.21.1 上的 NeoForge 客户端。不要同时安装 Distant Horizons 客户端模组。可在客户端 Sodium 设置中通过“Allow DH Server Terrain”关闭(NeoForge:重启游戏)。未获 Distant Horizons 团队认可。

安装

在服务器(LOD Server Support Fabric 模组或 NeoForge 模组)和每个需要这些功能的客户端上都安装 LOD Server Support。如果连接客户端和服务器不同时安装 LOD Server Support,它将无法工作(Distant Horizons 服务器除外,见上文)。未安装 LOD Server Support 的客户端仍可正常加入。

配置

配置文件在首次运行时生成于 Fabric 和 NeoForge 上的 config/lss-server-config.yaml。客户端设置在 config/lss-client-config.yaml 中。设置按功能分组并有内联文档,包括单位和重启/重连要求。

编辑 YAML 并在服务器上运行 /lsslod reload,或在客户端运行 /lss reload。

命令

服务器(Fabric 和 NeoForge)

  • /lsslod stats - 显示每位玩家的传输统计
  • /lsslod diag - 显示详细诊断(配置、带宽、队列深度)
  • /lsslod reload - 从 YAML 重新加载服务器设置;仍需要重启的设置会被报告
  • /lsslod store status - 显示 LOD 存储状态(状态、命中/未命中计数器、大小)
  • /lsslod store backfill start|stop|status - 控制后台预热遍历
  • /lsslod help - 列出所有命令

客户端(Fabric 和 NeoForge)

  • /lss reload - 从 YAML 重新加载客户端设置;仍需要重连的设置会被报告
  • /lss clearcache - 清除本地列缓存,强制所有区块从服务器重新请求
  • /lss reset - 清除此世界的 LOD(本地缓存和 Voxy 存储的数据)并重新流式传输
  • /lss diag - 显示客户端诊断(连接、吞吐量、扫描进度、请求预算)

服务器性能调优

开启 LOD 存储。 在 storage.lod_store 下设置 enabled: true(需要重启)。它会将预处理后的 LOD 数据缓存到磁盘以节省 CPU,缺点是额外的磁盘占用,可能与你的世界文件大小相当。

在 Fabric 和 NeoForge 上,启用 LOD 存储后会有一个回填任务填充它。只有在存储填充完成后才能实现最大 CPU 节省。使用 /lsslod store backfill status 检查任务进度。如果你的世界远大于玩家常访问的区域,可通过在 storage.lod_store.backfill 下设置 enabled: false 来节省磁盘空间。

使用带宽和生成限制器来限制 CPU。 LOD Server Support 的 CPU 成本基本上就是它每秒服务的列数加上它生成的区块数,而这些配置正好限制这些:

  • network.bandwidth.per_player_mib_per_second / network.bandwidth.global_mib_per_second 限制区块服务速率。它们有意计算未压缩字节,以免压缩悄悄提高实际上限。实际网络利用率取决于压缩和地形。
  • generation.concurrency.global / generation.concurrency.per_player 限制新区块生成,这是 LOD Server Support 能触发的最昂贵操作。在探索新地形的服务器上这占主导地位,降低它是最有效的节省。在 generation 下设置 enabled: false 会停止新生成;现有任务会完成。
  • storage.disk.max_concurrent_reads 限制同时运行的 LOD 磁盘读取数量,使 LOD 流量不会垄断原版区块加载所需的磁盘 I/O。0 自动默认值适合大多数服务器;如果在 LOD 流式传输时游戏区块加载卡顿,将其降低到 1 或 2;如果在快速 NVMe 存储上 LOD 加载感觉缓慢,则提高它。

预生成世界。 显然,对玩家体验最好的做法是使用 Chunky 等工具预生成地图,以避免区块生成。

再分发

本模组采用 MIT 许可证,欢迎附带署名的再分发,允许整合包使用。