Voxygen

Voxygen

使用每服务器种子和客户端命令,将缺失的原版区块生成到 Voxy 中。

语言

EN/English | ZH-CN/简体中文

Voxygen

一个客户端 Fabric 模组,为每个多人服务器地址存储一个世界种子,并提供 /voxygen 命令。

命令

/voxygen on
/voxygen off
/voxygen status
/voxygen toggle
/voxygen radius
/voxygen radius <radius>
/voxygen threads
/voxygen threads <threads>
/voxygen progress
/voxygen progress on|off|toggle
/voxygen seed
/voxygen seed <seed>
  • on 和 off 全局启用或禁用 Voxygen。
  • status 显示当前状态以及为当前世界记录的种子。
  • toggle 切换当前状态。
  • radius 显示以区块为单位的配置半径。
  • radius <radius> 将半径设置为正整数。默认值为 64 个区块。
  • threads 显示配置的工作线程数。
  • threads <threads> 将工作线程数设置为 1 到 256。默认值为 32。
  • progress 显示是否启用了生成进度 Boss 栏。
  • progress on|off|toggle 控制黄色的 Voxygen 进度 Boss 栏。默认禁用,并在生成完成后两秒消失。
  • seed 显示为当前世界记录的种子。
  • seed <seed> 在没有可用的本地集成服务器种子时手动设置种子。当本地种子可直接读取时,该参数会被隐藏。

在单人游戏中,Voxygen 直接从 Minecraft 的集成服务器读取真实种子并使用它,而不会将其保存到配置中。否则,需通过 /voxygen seed <seed> 显式配置种子。Voxygen 从不自动运行原版 /seed,也不会捕获其输出。

配置保存到 config/voxygen.json。它包含全局 enable 设置、进度显示设置 showProgress、生成 radius、工作线程数 threads,以及以多人服务器地址或单人存档路径为键的 seeds 映射。升级后首次启动时会自动导入现有的 voxy-client-side.json 设置。

生成

启用后,Voxygen 基于切比雪夫距离,以连续的顺时针方形螺旋遍历玩家周围的方形区域。它在后台工作线程上生成缺失的区块,通过 ChunkStatus.TERRAIN 使用 Minecraft 本地原版 ChunkGenerator,然后复用 Voxy 的体素化、mip 生成和世界更新路径。

仅生成目标 1x1 区块;不会生成或读取相邻区块。这会生成生物群系和基础地形(包括含水层流体),但有意排除树木、结构、矿石、植被和放置的湖泊。体素化地形目前使用天空光照 15 和方块光照 0。

Voxygen 仅根据 Voxy 中实际存储的数据决定是否跳过某个区块;原版客户端渲染距离不影响该决定。它在生成前、体素化前以及插入前立即检查 Voxy,以确保生成的数据不会替换已从服务器接收的地形。

生成窗口跟随玩家。中心和半径的更新在专用后台线程上运行,合并快速变化,并按螺旋顺序重建剩余队列,同时保留仍与新窗口重叠的已完成、活动和重试工作。一次更新完成后,可在 1 秒冷却后运行另一次更新。初始生成在加入有效世界后两秒开始。

更改工作线程数不会重新启动生成。降低线程数时,多余的活动作业会正常完成;提高线程数则允许启动更多作业。失败的区块进入重试队列。当会话必须被替换时,它会停止分派新工作,并让活动作业先完成并保存。

生成仅适用于本地识别的原版主世界、下界和末地维度。当当前服务器没有记录的种子、维度不受支持、Voxy 不可用或缺少所需的本地世界生成注册表时,生成会暂停而不是猜测。仅凭种子无法推断自定义的服务器端世界生成设置。

支持的版本

  • Minecraft 26.3
  • Fabric Loader 0.19.5+
  • Fabric API 0.160.5+
  • Java 25
  • Voxy(必需)

许可证

MIT