VoxyServer

VoxyServer

VoxyServer 是一款 Fabric 服务端模组，可使用 Voxy 将区块体素化为 LOD，并传输给已连接的客户端。安装了 Voxy 和 VoxyServer 的玩家会自动接收服务器发送的 LOD 数据，无需在客户端扫描世界或加载区块。未安装 Voxy 的玩家不受影响。

最新版本：Minecraft 26.1.x | Fabric

工作原理

服务器加载区块时，会将其体素化为 Voxy 的 LOD 格式，并存储在服务器上按世界划分的数据库中。安装了 Voxy 和 VoxyServer 的玩家连接后，服务器会从玩家所在位置开始，按螺旋路线向外传输 LOD 区段。玩家移动时，新的区段也会自动发送。

建造、爆炸等方块变化会被检测到，受影响的 LOD 区段会重新体素化，并自动推送给客户端。

也可以使用管理员命令，根据区域文件为已有世界补充数据，这样已探索过的地形无需玩家逐个区块重新前往，也能完成体素化。

安装

将 VoxyServer、Voxy 和 Sodium 的 jar 文件放入服务器的 mods 文件夹。服务端无需其他依赖项。

客户端也需要安装 VoxyServer、Voxy 和 Sodium。

配置

首次运行时会在 config/voxyserver.json 生成配置文件。

• lodStreamRadius：向每位玩家传输 LOD 的区块半径。
• maxSectionsPerTickPerPlayer：每个 tick 周期向每位玩家发送的 LOD 区段上限。
• sectionsPerPacket：单个网络数据包中打包的 LOD 区段上限。
• tickInterval：每轮传输周期之间的服务器 tick 数。
• workerThreads：Voxy 使用的工作线程数量。
• generateOnChunkLoad：区块在服务器上加载时将其体素化。
• dirtyTrackingEnabled：方块变化时重新体素化并推送 LOD。
• dirtyTrackingInterval：处理脏区块之间的 tick 数。
• debugTrackingEnabled：定期在控制台输出服务器内部统计数据。
• debugTrackingInterval：输出跟踪统计数据之间的 tick 数。

客户端配置

如果客户端安装了 模组菜单 和 Cloth Config，玩家可以从模组列表打开 VoxyServer 配置界面，调整个人传输偏好：

这些数值不会超过服务器设置的上限，保存后会自动发送至服务器。

命令

服务器管理员可以将已有的已生成区块导入 Voxy 存储。导入会按顺序进行，并直接读取已有区域文件，速度比等待区块正常加载快得多。导入完成后，已连接的 Voxy 客户端会自动刷新对应维度。

• /voxyserver import existing all
  导入所有已加载且包含 region 文件夹的维度。
• /voxyserver import existing current
  导入执行命令的玩家当前所在维度。
• /voxyserver import existing dimension <dimension>
  导入指定的已加载维度，例如 minecraft:overworld。
• /voxyserver import existing status
  显示当前导入状态。
• /voxyserver import existing cancel
  取消正在进行的导入任务。

存储

LOD 数据按世界存储在 <world>/voxyserver/。可以安全删除此文件夹，以重新生成所有 LOD 数据。

许可证：

GNU GPLv3