Voxy Server Side Horizon

Voxy 服务端地平线

这个模组将服务端同步的 LOD 数据与客户端基于种子的预测相结合，让远处的景观更早呈现在视野中。加入服务器后，玩家不必再独自慢慢探索世界，Voxy 才能显示远处的山脉、建筑、地形轮廓和广阔景观。

本模组适用于 Forge 1.20.1、NeoForge 1.21.1 和 fabric1.20.1/1.21.1/1.21.11/26.x 的整合包服务器、生存服务器、建筑服务器和探索服务器。如果你的服务器已经在使用 Voxy，或者你想为玩家带来更震撼的超远距离视野体验，这个版本就是为你打造的。

这是 Voxy Server Side 的社区分支，适用于 Forge / NeoForge；现已加入基于种子的地形预测、独立的预测 LOD 渲染器和本地地形缓存。它还支持服务器为玩家准备真实的 LOD 数据，帮助 Voxy 在多人服务器中更快、更可靠地显示超远距离地形。

客户端和服务器都必须安装 VSS Horizon。Voxy 本身只需安装在客户端。

功能介绍

基于种子的预测 LOD（beta）

VSS Horizon 可以让你在真实区块加载前看到地形。客户端利用服务器分享的世界种子和生成信息，构建远处山脉、山谷、海岸线及其他景观的近似预览，再通过自身的 LOD 系统进行渲染。细节会根据距离和屏幕尺寸进行调整：远处地形保留大致轮廓，近处区域则逐步细化。预测地形可以缓存在本地，减少你重返同一世界时的重复计算。随着真实地形数据逐渐可用，它会接管对应区域，包括玩家建造的建筑以及种子预测无法获知的地形改动。预测只是对受支持的世界生成配置进行近似呈现；服务器上的真实地形始终是最终依据。

预测功能默认启用，默认范围为 4,096 格。你可以在客户端配置或 VSS 设置页面调整范围和细节设置。服务器所有者可以控制是否分享世界种子和生成信息以供预测使用。

加入服务器后更快看到 LOD 地形

服务器 LOD 同步可让玩家获取自己尚未探索区域的真实地形数据。服务器可以向玩家发送已有的 LOD 数据，让远处地形从玩家所在位置开始逐步呈现；数据到达后，也会替换预测区域。

为多人服务器带来更好的 Voxy 体验

Voxy 非常适合超远距离视野，但在多人服务器中，如果每位玩家都在本地生成 LOD，体验可能会不一致。这个社区版本支持由服务器处理 LOD 同步：某个区域被一位玩家探索或生成后，其他玩家之后就能更快看到该区域。

这对大型生存服务器、城市建造服务器和探索服务器尤其有用。

更适合公共服务器

默认配置经过调整，优先节省带宽，而不是一开始就占用大量网络流量。服务器所有者可以根据服务器状况调整发送速度、LOD 范围和生成强度。

如果你的服务器带宽有限，可以先使用默认设置，再逐步测试调整。

Xaero 世界地图加载

客户端安装 Xaero的世界地图 后，VSS 会将服务器发送的远景柱写入世界地图，使地图覆盖范围不再受原版渲染距离限制。桥接完全在客户端完成，不修改协议，也不需要安装 Voxy；原版已加载的附近区块仍由 Xaero 自身绘制。

此功能默认启用，可在 VSS 的 Embeddium/Sodium 设置页面中控制。要临时禁用地图写入，请运行 /vssclient xaero disable；要重新启用，请运行 /vssclient xaero enable。运行 /vssclient xaero reload 将清除当前服务器上所有维度的客户端柱存在记录，并自动重新请求现有的 LOD 缓存。

Xaero 桥接需要 1.40.0 或更高版本。已针对相应平台上的 1.40.16、1.45.0 和 1.46.0 检查了公开接口和保存行为；其他版本和整合包组合仍需验证。如果反射接口不兼容，Xaero 桥接将自动禁用自身，不会影响 VSS/Voxy 的 LOD 功能。

LOD 随世界更新

当玩家在远处建造房屋、炸毁地形或重塑世界时，服务器可以通知客户端刷新相关 LOD。这有助于防止远处 LOD 停留在过时状态。

不只是地形：远处玩家显示

此功能为实验性功能。如果因渲染错误导致客户端崩溃，请禁用它。启用远处玩家同步后，超长视距不仅能显示地形，还能显示远处的玩家。

对于大型建筑服务器、活动服务器和多人生存探索服务器，这会让世界感觉更有生气。

适用于单人游戏和局域网

它不限于专用服务器。单人世界和局域网会话也可以使用相同的逻辑。

内置区块预生成

服主可以使用 /vss chunky 提前准备一个区域。它会生成真实的 Minecraft 区块，并为 Voxy 准备真实的 LOD 数据，在可用时复用有效的缓存柱。在专用服务器和局域网世界中，结果保存在服务器的持久 LOD 缓存中。在支持的单人会话中，它们可以直接导入本地 Voxy 实例。无需单独的 Chunky 模组。

这些命令需要管理员权限等级 2。开始前请启用 VSS 和区块生成；专用服务器还需要持久 LOD 缓存。

所有坐标和半径均以方块为单位。中心和半径选择一个包含边界的方形区域，向外取整到完整区块。半径可以为 0 到 8192；矩形选择最多可包含 4,194,304 个区块柱。完整区域必须位于世界边界内。每个服务器只能有一个预生成任务处于活动状态。

例如，以下命令会准备一个以方块坐标 (0, 0) 为中心、半径为 512 个方块的正方形区域：

/vss chunky 0 0 512

若要准备当前位置周围的地形，或选择一个矩形区域：

/vss chunky here 512
/vss chunky rect -256 -256 255 255

任务会在命令执行所在的维度中运行。若要选择其他维度，请使用 /execute：

/execute in minecraft:the_nether run vss chunky 0 0 128

系统每 60 秒报告一次进度。移动、切换维度或登出都不会取消任务。服务器关闭时任务会停止；之后重新运行相同的区域选择时，可以复用有效的已保存 LOD 区块列。在预生成仍在进行时，处于正常 LOD 同步范围内的客户端也可以接收已就绪的数据。

显式预生成采用优先速度的处理路径，不受 VSS 常规的生成、打包和磁盘队列限速机制约束，因此大型任务可能会给服务器带来较大负载。管理员可以使用 pause 和 resume 命令控制任务运行时机。

磁盘缓存容量

专用服务器在开始预生成前会检查已配置的 LOD 缓存容量。如果所选区域超过估算容量，请缩小区域或提高缓存上限。

使用 /vss disk_cache 查看已配置的容量、条目上限和保留期限。使用 /vss disk_cache <GiB> 可将容量设为 1 到 64 GiB 之间的整数。对应的中文命令为 /vss 磁盘缓存 [GiB]。

/vss disk_cache
/vss disk_cache 10
/vss 磁盘缓存
/vss 磁盘缓存 10

服务器 LOD 缓存的默认容量为 10 GiB。已保存的 LOD 区块列仍受已配置的容量和保留策略限制。

服务器所有者可调整的设置

此版本提供 /vss 命令和配置文件。服务器所有者可以根据服务器需求调整以下设置：

• 每位玩家可接收的 LOD 数据量
• 服务器同步 LOD 的距离
• 是否允许服务器自动补齐缺失的 LOD
• 是否向客户端发送用于地形预测的种子和生成信息
• LOD 刷新速度
• 远距离玩家显示
• 缓存大小和读取速度
• 使用内置的 /vss chunky 命令预生成哪些区域

常用命令示例：

/vss help
/vss stats
/vss bandwidth get
/vss bandwidth set_kbps <value>
/vss distance get
/vss distance set <chunks>
/vss generation enable
/vss generation disable
/vss chunky here 512
/vss chunky status
/vss help chunky
/vss disk_cache
/vss farplayers enable
/vss farplayers disable

中文命令示例：

/vss 帮助
/vss 状态
/vss 带宽 查看
/vss 带宽 设置 <Kbps value>
/vss 距离 查看
/vss 距离 设置 <chunk count>
/vss 生成 查看
/vss 生成 开启
/vss 生成 关闭
/vss 生成 状态
/vss 预生成 当前位置 512
/vss 预生成 状态
/vss 帮助 预生成
/vss 磁盘缓存
/vss 远处玩家 查看
/vss 远处玩家 开启
/vss 远处玩家 关闭

与原项目的区别

这是 Voxy Server Side 的非官方社区分支。

主要区别：

• 新增基于种子的地形预测，并配备独立的 LOD 渲染器
• 新增本地预测缓存和压缩的 CPU 网格存储
• 新增内置区域预生成，支持 /vss chunky 和中文命令别名
• 新增服务端持久化 LOD 缓存
• 新增压缩 LOD 数据传输
• 新增可选的远距离玩家显示/同步功能
• 改进变更区域的 LOD 缓存失效处理
• 改进 Forge / NeoForge 服务器的请求调度
• 优化默认配置，降低带宽和内存使用量
• 新增 Forge / NeoForge 整合包兼容性调整
• 新增 Forge / NeoForge 单人游戏的 LOD 生成与同步支持

免责声明

本项目是 Voxy Server Side 的非官方社区分支，并依据 MIT 许可证维护。