
Voxygen
使用每服务器种子和客户端命令,将缺失的原版区块生成到 Voxy 中。
查看大图语言
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
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。