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 按钮打开，使用你的种子和你安装的每一个模组，从真实的生成器中采样。
• 几秒内即可读懂——粗采样先填满视图，细采样随后补全，采样精度只与当前缩放级别相当，最多使用 4 个后台线程，且绝不超过处理器性能的 30%。
• 在地形之上采样——在世界顶部采样（原版为 Y 320，若使用 Ultra TerraForged 等生成器抬高世界则更高），因此洞穴生物群系绝不会渗入地表地图。
• 配色让你真正看得懂——16 个生物群系大类共用一种填充色，而每个具体生物群系在图例中都有各自的边框色。
• 模组生物群系也有真实颜色——依次按注册名、草色、名称哈希匹配，因此不会有任何东西显示为匿名灰色。
• 平移、缩放与测量——拖动平移，滚轮或按 – 和 + 缩放，从 25 区块的近景到数千区块的远景，配有比例尺、实时生物群系图例，以及光标下方的坐标和生物群系读数。
• 快速回到关键位置——“居中到出生点”和“居中到世界出生点”可将地图移到你选择的出生点和世界自身的出生点。
• 导出地图——EXPORT MAP 将当前视图中的地图以 PNG 保存到截图文件夹，每 512 格标注 x 和 z 坐标，并附上种子、世界原点和标明每种颜色的图例。
• 出发前先找到结构——村庄、要塞、神庙和模组结构会标记在种子生成它们的位置，悬停时显示名称。地形可能使其无法生成，因此标记只是可能的位置。
• 不遮挡地图的标记——七个分组可逐一显示或隐藏，缩小时附近结构合并为一个带编号的标记，废弃矿井仅在放大后显示。
• 选择地图绘制的内容——LAYERS 面板中有生物群系颜色、边框、图例、标记、叠加层以及每个结构分组的开关，你的选择会在会话之间保留。
• 预设与折叠——Clean、Explorer 和 All 预设一键设置地图，配合标记上限的 Sparse、Normal 或 Dense 折叠可保持清晰。
• 任意尺寸下都可读——无论 GUI 缩放和窗口大小如何，每个界面都保持相同比例，放不下时可滚动；ui_size 设置可将其放大。
• 选择你的出生点——右键点击地图可将新世界的出生点设在那里，在使用 CREATE WORLD 或 PRE-GENERATE 启动世界时生效；RESET 可恢复为世界自身的出生点。
• 你正在游玩的世界的地图——在游戏中按 G（可在“控制”中重新绑定），即可查看当前维度的生物群系地图，以你为中心并标出世界出生点，适用于单人游戏或运行 Genesis 的服务器。
• 种子工具就在手边——输入数字或任意文本，RANDOM 生成新种子，COPY 复制到剪贴板，R 重新随机。离开界面时会将种子写回“创建新世界”。
• 游玩前预生成——设置界面接收半径和线程数，随后进度界面显示带区块计数、预计剩余时间和当前维度的进度条。
• 由你掌控——PAUSE 和 RESUME 暂停/继续且不丢失进度，CANCEL 停止，或 ENTER WORLD 让其在后台继续运行。
• 运行时的 HUD——屏幕顶部显示维度、区块数、百分比和预计剩余时间，暂停时显示为金色，任务完成后消失。
• 也可通过命令驱动 – 按维度使用 /genesis pregen 或 all，可选以显式坐标为中心，支持 cancel、pause、resume 和 status，另有 /genesis info 用于查看种子和生成器。
• 绝不会被模组淹没 – 若某模组的结构集过于密集、没有实际世界就无法放置，则会从地图上略去，并在“准确度”部分列出名称。
• 坦诚说明无法读取的内容 – 无法读取生物群系的点位会以灰色绘制，并在图例中注明。
• “准确度”部分 – 当地图的一部分来自较简单的替代方案时，将生物群系或结构标记为琥珀色的“近似”，并说明原因。

📋 要求

• Minecraft 1.20.1 至 1.21.1，Fabric。
• Minecraft 1.20.1、1.20.2、1.20.3、1.20.4、1.20.6 或 1.21，Forge，包括 NeoForge 1.20.1 分支。
• Minecraft 1.20.4、1.20.5、1.20.6、1.21 或 1.21.1，NeoForge。
• Fabric 上需要 Fabric API 和 Cloth Config，且 Fabric Loader 在 1.20.1 上为 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 或更高。
• Forge 在 1.20.1 上为 47.1 或更高，在 1.20.2 上为 48 或更高，在 1.20.3 和 1.20.4 上为 49 或更高，在 1.20.6 上为 50 或更高，在 1.21 上为 51 或更高。
• NeoForge 在 1.20.4 上为 20.4 或更高，在 1.20.5 上为 20.5 或更高，在 1.20.6 上为 20.6 或更高，在 1.21 和 1.21.1 上为 21.0 或更高。
• Java 17 或更高，适用于 Minecraft 1.20.1 至 1.20.4；从 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，以及 config/genesis-common.toml 中的两个 server_ 设置和 check_for_updates。在 Fabric 上，编辑 config/genesis.json。

| 设置 | 默认值 | 作用 |
|—|—|—|
| ui_size | 0 | 每个 Genesis 界面的大小：0 自动（与窗口成比例），1 至 3 为更大。 |
| preview_enabled | true | 完全开启或关闭生物群系预览。 |
| preview_threads | 0 | 生物群系采样线程数，0 至 16。0 表示由模组自行选择。无论此值如何，运行的线程数绝不会超过处理器线程数的 30%。 |
| 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 设置显示其基于纬度的气候带。在其默认的地球尺寸下，一个气候带跨越数千个方块，因此请缩小视图以查看它们。
• 超平坦预览完全准确。其他自定义生成器会使用原版气候绘制，并在地图上标记为近似。
• 命令在服务器上为管理员等级 2，在单人游戏中不受限制；status 和 info 对所有人开放。

🐛 支持

• 请在此模组的 Nexus Mods 页面报告漏洞和提问，那里的每份报告都会被跟踪。
• 请附上你的 Minecraft 版本、你的加载器及其版本、模组版本以及你的其他模组。
• 该模组的文本还提供德语、西班牙语、法语、意大利语、日语、韩语、波兰语、巴西葡萄牙语、俄语和简体中文。
• 这些翻译由机器撰写；如果某行读起来不对，请说明是哪一行以及应该怎么读。

📄 许可证

许可条款见 Alkeari License Agreement。

每个版本、其更改以及如何发送反馈都在项目页面 alkeari.com/projects/genesis 上。