LOD Server Support

LOD 服务器支持

让安装了 Voxy 的玩家在多人服务器上无需先探索世界，就能看到延伸至数百个区块外的完整渲染地形。还支持远距离玩家渲染，因此你也能看到远超原版渲染距离的其他玩家。甚至可以在运行 Distant Horizons 的服务器上显示远处地形（实验性功能）。

在线体验：安装 Voxy 和本模组后，加入 lod-server-support.modrinth.gg。支持 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 | Paper / Purpur | Folia | NeoForge | Sponge |
|—|—|—|—|—|—|
| 26.3 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 26.2 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 26.1 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 1.21.11 | ✅ | ✅ | ✅ | – | ✅ |
| 1.21.10 | ✅ | ✅ | – | – | ✅ |
| 1.21.1 | ✅ | ✅ | – | ✅ | ✅ |

Folia 和 Sponge 支持仍处于实验阶段。NeoForge 支持尽力提供，其中远距离玩家渲染仅适用于 1.21.1。

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

可以根据 LOD 数据填充 Xaero的世界地图/小地图和 旅行地图。新安装时默认启用；在客户端的 Sodium 设置中切换“Map Ingestion”，点击 Apply，然后重新连接。Xaero 的洞穴地图也会填充，包括任意高度的下界地图。服务器可以通过 privacy.request_no_map_ingestion 要求客户端不要将 LOD 地形添加到地图中（低于 0.19.0 的客户端将因此无法获取 LOD）。拥有 lss.map_ingestion 权限的玩家不受此限制。

从 v0.4.0 到当前版本，LOD Server Support 均支持向前和向后兼容。服务器管理员可自由更新以使用改进功能，而不会影响旧版本客户端（除非启用了 privacy.request_no_map_ingestion）；客户端也可以更新，同时保持与旧版服务器的兼容性。

NeoForge（26.2 和 26.1）的客户端测试方案是我们的 Foxy 分支（请从发布页面获取；它包含原版 Foxy 缺少的 Windows 原生库修复），该方案可在 NeoForge 上加载常规 Fabric 版 Voxy JAR。已在 26.2 上使用 Sodium 0.9.1 + Voxy 0.2.18-beta，以及在 26.1.2 上使用 Sodium 0.8.12 + Voxy 0.2.16-beta 进行测试，具体搭配请见 Foxy README。

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（或 DH Support 插件）的服务器后，即使服务器未安装 LOD Server Support，远处地形也会通过 Voxy 加载。为获得最佳效果，我们仍建议在服务器上安装 LOD Server Support；如果已安装，它始终会优先使用。适用于所有版本的 Fabric 客户端，以及 26.2、26.1 和 1.21.1 版本的 NeoForge 客户端。请勿同时安装 Distant Horizons 客户端模组。可在客户端 Sodium 设置中的“Allow DH Server Terrain”选项将其关闭（NeoForge：需要重启游戏）。此功能未经 Distant Horizons 团队认可。

Voxy Server Side 是同一个模组。Voxy Server Side 客户端兼容安装了 LOD Server Support 的服务器，反之亦然。

安装

请在服务器（LOD Server Support Fabric 模组、Paper 插件、NeoForge 模组或 Sponge 插件）以及每一位需要这些功能的客户端上都安装 LOD Server Support。连接的客户端和服务器两端都未安装 LOD Server Support 时，此功能将无法运行（Distant Horizons 服务器除外，见上文）。未安装 LOD Server Support 的客户端仍可正常加入。

配置

首次运行时会生成配置文件：Fabric、NeoForge 和 Sponge 的路径为 config/lss-server-config.yaml，Paper 的路径为 plugins/LodServerSupport/lss-server-config.yaml。客户端设置位于 config/lss-client-config.yaml。设置按功能分组，并在文件中附有说明，包括单位以及重启/重新连接要求。

编辑 YAML 文件，然后在服务器上运行 /lsslod reload，或在客户端上运行 /lss reload。

命令

服务器（Fabric、NeoForge、Paper 和 Sponge）

• /lsslod stats – 显示每位玩家的传输统计信息
• /lsslod diag – 显示详细诊断信息（配置、带宽、队列深度）
• /lsslod reload – 从 YAML 重新加载服务器设置；需要重启才能生效的设置会显示出来
• /lsslod store status – 显示 LOD 存储状态（状态、命中/未命中计数、大小）
• /lsslod store backfill start|stop|status – 控制后台预热遍历任务（Paper 不支持）
• /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 和 Sponge 上，启用 LOD 存储后会运行回填任务来填充存储。只有存储填充完成后，才能实现最大的 CPU 节省。使用 /lsslod store backfill status 查看任务进度。如果世界远大于玩家通常探索的区域，可在 storage.lod_store.backfill 下将 enabled: false 设为禁用，以节省磁盘空间。Paper 会在提供地形时填充存储。

使用带宽和生成限制器来限制 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 加载感觉缓慢，就提高它。

在 Paper 上禁用 LOD 存储重新扫描。 在 storage.lod_store 下设置 resweep_interval_seconds: 0。这会减少定期检查，但在 Paper 上可能会错过区块更新，因此可能会提供旧的 LOD。

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

再分发

此模组采用 MIT 许可证，欢迎在注明出处的情况下再分发，整合包可以直接引用官方 Modrinth 项目。根据 Modrinth 的重新上传政策：XANTHA 通过 Voxy Server Side 获得版权持有者的明确许可，可以在 Modrinth 上分发此模组及其衍生作品。