Genesis – World Previewer & Pregenerator

每个加载器各有一个文件：Fabric 支持 Minecraft 1.20.1 至 1.21.1，Forge 支持 1.20.1 至 1.21，NeoForge 支持 1.20.4 至 1.21.1。

⭐ 功能介绍

• 预览即将创建的世界生物群系地图 – 在“创建新世界”界面点击 GENESIS 按钮即可打开；地图使用你的种子和已安装的所有模组，从真实的世界生成器中采样生成。
• 几秒内即可读图 – 先快速绘制粗略布局，再通过两轮更精细的绘制补全细节。默认使用 1 到 2 个后台线程，也可在设置中调至最多 16 个。
• 固定在 Y = 320 – 避免洞穴生物群系渗入地表地图。
• 色彩清晰，一目了然 – 16 个生物群系类别共用填充色，每种生物群系则在图例中使用独立的边框颜色。
• 模组生物群系也有专属颜色 – 优先按注册名称匹配，其次使用草地颜色，最后根据名称生成哈希颜色，因此不会出现无法辨认的灰色区域。
• 平移、缩放和测量 – 拖动平移，滚动缩放；点击 NEAR、MID、FAR 和 WIDE 可切换固定缩放级别。地图还提供比例尺、实时图例，以及光标下方的坐标和生物群系信息。
• 导出地图 – 点击“导出地图”，即可将当前视图保存为 PNG 图片到截图文件夹。图片每隔 512 格标注 x 和 z 坐标，并包含种子、世界原点，以及列出地图中所有颜色的图例。
• 出发前寻找结构 – 村庄、要塞、神殿和模组添加的结构会标记在种子对应的位置，悬停时显示名称；点击“结构”可隐藏这些标记。地形可能会阻挡结构生成，因此标记位置仅供参考。
• 选择出生点 – 右键点击地图，将新世界的出生点设在该处；点击“创建世界”或“预生成”时会使用该位置。点击“重置”可恢复为世界默认出生点。
• 查看当前游玩的世界地图 – 在游戏中按 G（可在“控制”中重新绑定按键），查看当前维度的生物群系地图。地图以你为中心并标出世界出生点；在单人游戏或运行 Genesis 的服务器中均可使用。
• 随手使用种子工具 – 输入数字或任意文本；点击 RANDOM 生成新种子，点击 COPY 复制到剪贴板，按 R 重新生成。离开界面时，种子会自动写回“创建新世界”界面。
• 游玩前预生成区块 – 设置预生成半径和线程数，并通过进度条查看进度、区块计数、动态预计剩余时间和当前维度。
• 按你的节奏控制 – 暂停或继续任务而不丢失进度，取消任务，或点击“进入世界”让任务在后台继续运行。
• 运行期间显示 HUD – 屏幕顶部显示维度、区块数、完成百分比和预计剩余时间；暂停时显示为金色，任务结束后自动消失。
• 也可使用命令控制 – 按维度或使用 all 执行 /genesis pregen，还可指定中心坐标；支持 cancel、pause、resume 和 status，并可使用 /genesis info 查看种子和生成器信息。
• 无法读取的信息会如实标明 – 无法读取生物群系的位置会显示为灰色，并在图例中标注；如果部分地图使用了较简单的替代方案，图例上方会显示琥珀色提示并说明原因。

📋 运行要求

• Fabric 上支持 Minecraft 1.20.1 至 1.21.1。
• Forge 上支持 Minecraft 1.20.1、1.20.2、1.20.3、1.20.4、1.20.6 或 1.21，包括 NeoForge 1.20.1 分支。
• NeoForge 上支持 Minecraft 1.20.4、1.20.5、1.20.6、1.21 或 1.21.1。
• Fabric 上需要 Fabric API 和 Cloth Config；Minecraft 1.20.1 需使用 Fabric Loader 0.14.23 或更高版本，1.20.2 和 1.20.3 需使用 0.19.5 或更高版本，1.20.4 至 1.20.6 需使用 0.15.11 或更高版本，1.21 和 1.21.1 需使用 0.19.2 或更高版本。
• Minecraft 1.20.1 需使用 Forge 47.1 或更高版本，1.20.2 需使用 48 或更高版本，1.20.3 和 1.20.4 需使用 49 或更高版本，1.20.6 需使用 50 或更高版本，1.21 需使用 51 或更高版本。
• Minecraft 1.20.4 需使用 NeoForge 20.4 或更高版本，1.20.5 需使用 20.5 或更高版本，1.20.6 需使用 20.6 或更高版本，1.21 和 1.21.1 需使用 21.0 或更高版本。
• Minecraft 1.20.1 至 1.20.4 需使用 Java 17 或更高版本；从 1.20.5 起需使用 Java 21 或更高版本。

📥 安装

1. 安装你的加载器；如果使用 Fabric，还需安装 Fabric API 和 Cloth Config。
2. 使用 Modrinth App 安装，或下载适用于你的加载器的 jar 文件并放入 mods 文件夹。每种加载器的 jar 文件都适用于上方列出的该加载器支持的所有 Minecraft 版本。
3. 打开“创建新世界”界面，屏幕上会显示一个 GENESIS 按钮。

⚙️ 配置

在 Forge 或 NeoForge 上，编辑 config/genesis-client.toml；两个 server_ 设置和 check_for_updates 则位于 config/genesis-common.toml。在 Fabric 上，编辑 config/genesis.json。

| 设置 | 默认值 | 功能说明 |
|—|—|—|
| preview_enabled | true | 完全开启或关闭生物群系预览。 |
| preview_threads | 0 | 生物群系采样线程数，范围为 0 到 16。设为 0 时由模组自动选择。 |
| preview_initial_radius | 64 | 初始三轮螺旋采样覆盖的区块数，范围为 16 到 512。 |
| preview_expand_radius | 16 | 完成螺旋采样后，每次扩展增加的区块数，范围为 4 到 128。 |
| spawn_from_map | true | 允许右键点击预览地图，为新世界选择出生点。 |
| show_structures | true | 在两张地图上标出结构可能生成的位置。 |
| server_world_map | true | 在服务器上，向玩家的世界地图提供该世界的生物群系信息。关闭后可向玩家隐藏世界布局。 |
| server_world_map_structures | true | 在服务器上，将结构位置一并提供给玩家的世界地图。 |
| check_for_updates | true | 每次启动游戏时检查一次 https://alkeari.com/updates/genesis.json；仅当你的 Minecraft 版本和加载器有更新版本的 Genesis 时，才会在聊天中提示并附上链接。不会发送其他信息；关闭此项即可跳过检查。 |
| pregen_default_radius | 128 | 预生成界面中预填的半径，范围为 1 到 2048。 |
| pregen_default_threads | 4 | 预生成界面中预填的线程数，也是命令默认使用的线程数，范围为 1 到 16。 |

在 Forge 和 NeoForge 上，修改会在预览下次重新启动时生效，包括更改种子或重新打开界面时；数值范围会受到限制。在 Fabric 上，修改会在重启游戏后生效；超出范围的数值会自动调整到最近的边界值。

🖥️ 兼容性

• 现有世界。预览仅会在“创建新世界”界面运行，因此不会对你已有的世界造成任何影响。你可以通过命令对已有世界进行预生成。
• 客户端或服务器。生物群系预览在客户端运行，只在客户端安装也安全。预生成、选择出生点和世界地图功能还需要在服务器上安装 Genesis；单人游戏已包含这些功能。
• 不会影响世界生成。预览只读取生成器信息，不会更改任何区块、结构或战利品表。
• 会自动检测 GeoGradient：地图会根据你的 GeoGradient 设置显示基于纬度划分的气候带。默认的地球尺寸下，一个气候带会延伸数千个方块，因此请缩小地图至 FAR 或 WIDE 以查看。
• 超平坦预览完全准确。其他自定义生成器则会使用原版气候绘制，并在地图上标记为近似结果。
• 服务器上的命令需要 2 级操作员权限；单人游戏中不受限制。所有人都可以使用 status 和 info。

🐛 支持

• 请在此模组的 Nexus Mods 页面报告问题或提问，所有报告都会得到跟踪处理。
• 请提供你的 Minecraft 版本、加载器及其版本、模组版本，以及你安装的其他模组。
• 此模组的文本还提供德语、西班牙语、法语、意大利语、日语、韩语、波兰语、巴西葡萄牙语、俄语和简体中文版本。
• 这些翻译由机器生成；如果有哪句话读起来不对，请指出具体内容并说明应如何翻译。

📄 许可

许可条款请参阅 Alkeari 许可协议。

每个版本的发布信息、更新内容和反馈方式都可以在项目页面查看：alkeari.com/projects/genesis。

如果你想了解它的工作原理，可以阅读源代码：github.com/Alkeari/Genesis-PUBLIC。