World Preview (Unofficial Port)

Caeruleus Draconis 和 Taiterio 的 World Preview 非官方社区移植版，已延续支持 Minecraft 1.20.1、1.21.1、1.21.11、26.1.2、26.2 和 26.3，适用于 Fabric 和 NeoForge，并支持 1.20.1 的 Forge。

它会在生成世界前，根据世界种子绘制地图，显示生物群系、结构、高度图和 Y 层交叉情况，让你在决定进入某个世界前先预览它。

模组本身的所有功劳都归原作者所有。采用 Apache-2.0 许可证。

支持的版本

| Minecraft |Fabric |NeoForge / Forge |
| ——— |—— |—————- |
| 1.20.1 |✅ |✅（Forge） |
| 1.21.1 |✅ |✅ |
| 1.21.11 |✅ |✅ |
| 26.1.2 |✅ |✅ |
| 26.2 |✅ |✅ |
| 26.3 |✅ |✅ |

Forge 仅支持 1.20.1；其他版本使用 NeoForge。

我需要哪个文件？

请选择与你的 Minecraft 版本 和 模组加载器 都匹配的文件。文件名格式类似 world_preview-<mod version>-<minecraft version>-<loader>.jar，加载器名称部分为小写（fabric、neoforge）；但 1.20.1 除外，文件名中会使用 Fabric 或 Forge（world_preview-<mod version>-1.20.1-Fabric.jar、world_preview-<mod version>-1.20.1-Forge.jar）。

.dev 和 .sources 版本是供开发者使用的，不适合游玩。

使用 Fabric 时还需要安装 Fabric API。NeoForge 和 Forge 无需额外安装其他内容。

此模组仅支持客户端和单人游戏。请将其安装在客户端；服务器无需安装，而且无法在服务器世界中使用预览功能。

与原版的差异

以下列出了此移植版与原版不同之处。未列出的内容均与原版相同。

|   |原版（≤ MC 1.21） |本移植版 |
| —————– |———————— |—————————————————————————————————————————————————————————————————————————————————————————– |
| 滚轮 |沿 Y 轴移动 |缩放地图；Ctrl+滚轮始终用于缩放，Alt+滚轮始终沿 Y 轴移动；也可以在Settings → General → Scroll wheel zooms map中将单独使用滚轮的功能改回沿 Y 轴移动 |
| 缩放 |在配置菜单中设置 |分为 5 个档位（每区块 16、8、4、2 或 1 像素；默认 4 像素），可通过鼠标滚轮、设置界面以及地图左下角的比例尺滑块进行调整。缩放最远的两个档位（每区块 2 和 1 像素）会对地图重新采样，因此需要等待片刻 |
| Minecraft 版本 |1.20.x、1.21 |1.20.1、1.21.1、1.21.11、26.1.2、26.2、26.3 |
| 模组加载器 |Fabric、Forge、Quilt |Fabric、NeoForge；1.20.1 版本支持 Forge |
| 设置界面 |单一页面 |带有独立页面的侧边栏，另有恢复默认设置按钮 |
| 起始 Y 层 |建筑高度上限 |约为世界高度的三分之一（主世界约为 Y 64） |

游戏内预览、持久化种子存储、生物群系高亮、预览缓存（可选压缩）、线程数设置，以及用于注册生物群系、结构和颜色映射的数据包机制，均与原版保持一致。

此移植版新增内容

以下大多数功能均为可选：每项都有独立的按钮或设置，只有启用后才会影响预览。例外是默认开启的拖动预加载，以及配置文件的自动备份和迁移——它们只影响采样过程和文件，不会改变预览内容。

种子搜索会根据一组条件筛选随机种子：最多指定四种生物群系（任意一种符合即可）、一种结构、生物群系的最低面积占比、到最近匹配生物群系的最大距离，以及结构的独立距离上限。结果会按排名显示；搜索在后台运行，因此切换到其他界面后也会继续。搜索目前只支持随机分布型结构；要塞等同心环分布型结构暂不支持。

种子历史记录、收藏与对比 — 会保存符合条件的搜索结果；点击某一行即可应用对应种子，Shift+右键可将其加入收藏，右键可将其删除。对比界面会将当前种子与最多另外七个种子并列展示，并提供生物群系多样性、水域占比、主要生物群系和出生点评分。

世界分析 — 选择一个区域，即可查看生物群系分布、高度范围、平均高度、坡度统计和平坦区域占比，以及地形剖面、高度图、生物群系占比明细和附带原因说明的出生点质量评分。表格可导出为 CSV 和 JSON。

地形地图导出 — 将当前种子的地形导出为高分辨率 PNG，可配置半径和每像素对应的方块数，包含九种地形类别，并可选择叠加等高线。还可以一次性遍历该种子的所有维度。

路径点 — 按种子和维度保存带名称、颜色的标记。开启 Waypoints 后，在地图上单击左键即可放置标记；再次左键单击标记，可重命名、更改颜色或删除。

测量工具 — 单击两次即可显示距离和各轴的坐标差；右键可清除测量结果。

出生点覆盖 — 创建世界时放置出生点标记，这些坐标就会成为世界的出生点，无需作弊。

山体阴影与等高线 — 在高度图视图中模拟阳光照射效果（方位角、高度角、环境光、夸张度），并可按指定间隔显示等高线。

噪声参数视图 — 可分别查看温度、湿度、大陆性、侵蚀、深度、怪异度以及山峰与山谷，每项参数都有自己的颜色渐变。

其他功能 — 小地图、实时统计、坐标、生物群系方块计数、视口周围区域预加载、配置文件自动备份与迁移，以及其他维度的视图，包括高度限制不标准的维度。

使用方法

_World Preview_ 会在单人游戏菜单中添加一个 Preview 标签页。打开后会抽取一个随机种子并绘制生物群系地图。默认预览主世界，关闭结构和高度图，也不会保存噪声采样数据——这些都可以在 Settings 中配置（地图右上方的扳手按钮）。

在地图上移动 — 拖动即可沿 X 轴和 Z 轴移动。拖动后会按以下顺序安排任务：当前 Y 层尚未采样的生物群系 → 结构（若已启用）→ 高度图（若已启用）→ 交汇处（若已启用）→ 相邻 Y 层（若已启用）。滚动可缩放。沿 Y 轴移动可以查看洞穴生物群系；非洞穴生物群系会延伸至整个世界高度，因此在每一层看起来都相同。方向键可平移，Home可将视图重新居中到 (0, 0)。左下角的比例尺会显示当前比例，也可用作缩放滑块。

渲染模式，可通过工具栏切换：

| 模式 |显示内容 |
| —————- |————————————————————————————- |
| 生物群系 |生物群系颜色（默认） |
| 高度图 |着色后的海拔，可选择颜色映射 |
| Y 轴交汇处 |当前 Y 层的方块，下方一层以较浅颜色显示 |
| 噪声参数 |温度、湿度、大陆性、侵蚀、深度、怪异度以及山峰与山谷 |

结构不会单独作为一种视图显示：开启结构采样后，可在结构列表中切换各个结构类型。

种子打开种子中心；分析打开区域分析界面。对于单人世界，暂停菜单中还会添加一个按钮，让你无需离开世界即可打开预览。

常见问题

问：滚动滚轮无法缩放预览！

答：在此移植版中，滚动默认会缩放，所以如果你的不行，请检查Settings → General → Scroll wheel zooms map；当该复选框关闭时，滚轮会改为沿 Y 轴移动，你需要Ctrl+滚动来缩放。Alt+滚动始终沿 Y 轴移动。Y 轴截面视图一片空白是另一个问题；见下文。

问：Y 轴截面视图完全白/黑。

答：预览大约从世界高度的三分之一处开始（主世界中约为 Y 64）。如果你仍然什么都看不到，请滚动到更低的 Y 层——或者，在地形位于其中间高度之上的维度中，滚动到更高的层。

问：我的 CPU 占用达到 100%！

答：在Settings → General中降低线程数（该设置标为 _生物群系采样线程数_），并同时关闭那里的 _启用拖动预加载_。_世界预览_ 会尽可能快地计算生物群系预览、结构和高度图，按设计就是 CPU 密集型。在Resolution页面降低 _每区块采样量_ 可进一步减少工作量，代价是预览更粗糙。

问：配置文件在哪里，这个模组还会向磁盘写入什么？

答： config/world_preview/config.json。旧文件的备份和迁移会自动进行。地形导出位于config/world_preview/terrain_exports/，分析报告位于config/world_preview/reports/。

问：如何添加对新生物群系、结构或颜色映射的支持？

答：与原模组相同：通过 Minecraft 数据包机制。此移植版未更改数据格式。

问：会支持其他 Minecraft 版本吗？

答：此移植版仅针对上表中的版本——没有针对中间版本（1.21.2–1.21.10）或更旧版本的构建。对于 1.20.x 和 1.21，你可以使用原模组，它在 Fabric、Forge 和 Quilt 上覆盖了这些版本。

问：会支持多人游戏吗？

答：不会。

模组兼容性

模组区块生成器会在运行时被检测并适配。

| 模组 |此移植版的处理方式 |
| ———————– |———————————————————————- |
| Terralith |使用区块生成器适配器 |
| Biomes O’ Plenty |将其生物群系指向数据包颜色映射 |
| Oh The Biomes You’ll Go |将其生物群系指向数据包颜色映射 |
| Nature’s Spirit |将其生物群系指向数据包颜色映射 |
| Astral Sorcery |注明其自定义维度可能需要数据包配置 |
| Awaken |注明其自定义维度可能需要数据包配置 |
| TofuCraft |注明其自定义维度可能需要数据包配置 |
| Oh The Trees |注明树木生成可能有所不同 |
| Wither Storm Mod |将该模组记录为已存在 |
| TerraFirmaCraft |关闭截面采样——此条目默认禁用 |

不在此列表中的模组不受影响：它们添加的生物群系、结构和颜色映射会通过数据包机制被识别。

TerraFirmaCraft (TFC) — World Preview 兼容 TFC，但有一项已知限制：Y 轴交点视图在所有 Y 层都显示为白色，因为此视图采样所需的列数据未通过 TFCChunkGenerator 的 getBaseColumn 暴露。这是由 TFC 暴露的数据所致，并非 TFC 的 Bug。

链接

• 源代码和问题追踪器
• 所有构建版本（GitHub Releases）
• 完整更新日志
• 许可证（Apache-2.0）
• 原始项目位于 Modrinth 和 CurseForge — 这些页面不包含此移植版的构建版本。

致谢

• 原模组的设计及绝大部分代码由 Caeruleus Draconis 和 Taiterio 完成。没有他们的工作，就不会有此移植版。
• 此移植版新增的内容，以及它造成的任何问题，均由此移植版自行负责。
• 采用 Apache-2.0 许可证。

_正在为当前界面重新绘制截图。_