由 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 |
✅ |
✅ |
仅在 1.20.1 版本中提供 Forge;其他版本使用 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 不需要额外依赖。
此模组为 客户端且仅限单人。请安装在客户端;服务器无需安装,且在服务器世界中不可用预览功能。
与原版有何不同
以下列表记录了本移植版与原版的差异之处。未在此列出的功能均保持原样运作。
| |
Original (≤ MC 1.21) |
This port |
| Scroll wheel |
moves along the Y axis |
zooms the map; Ctrl+scroll always zooms and Alt+scroll always moves along Y, and the bare wheel can be set back to moving along Y in Settings → General → Scroll wheel zooms map |
| Zoom |
set from the config menu |
a 5-step ladder (16, 8, 4, 2 or 1 pixels per chunk; 4 by default), reachable from the mouse wheel, the settings screen and a scale-bar slider at the bottom-left of the map. The two most zoomed-out steps (2 and 1 pixels per chunk) resample the map, so they take a moment |
| Minecraft version |
1.20.x, 1.21 |
1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2, 26.3 |
| Mod loader |
Fabric, Forge, Quilt |
Fabric, NeoForge; Forge on 1.20.1 |
| Settings screen |
a single screen |
sidebar with separate pages, plus a Reset to defaults button |
| Starting Y layer |
the build limit |
about one third of the world height (≈ Y 64 in the Overworld) |
游戏内预览、持久化种子存储、生物群系高亮、预览缓存(含可选压缩)、线程数设置以及用于注册生物群系、结构和颜色映射的数据包机制,均与原版保持一致。
本移植版新增内容
以下大多数功能均为可选启用:每项功能都有独立的按钮或设置,且在你开启它们之前不会改变预览效果;例外情况是默认开启的拖拽预加载,以及配置文件的自动备份和迁移——这些仅影响采样工作和文件,从不影响预览显示的内容。
种子搜索 会根据一组条件扫描随机种子:最多四个生物群系(任意一个符合即可)、一种结构、最小生物群系面积占比、到最近匹配生物群系的最大距离,以及结构的独立距离限制。结果会进行排名,且搜索在后台运行,因此即使你切换到其他屏幕,搜索也会继续。仅支持可随机分布的结构;尚不支持同心环状结构(如要塞)。
种子历史、收藏和对比 —— 匹配的搜索结果会被存储,单击某行会将该种子应用为当前种子,Shift+右键点击将其加入收藏,右键点击则将其删除。对比屏幕将当前种子与最多七个其他种子并列展示,并报告生物群系多样性、水域占比、主导生物群系以及出生点评分。
世界分析 — 选择一个区域,获取生物群系分布、高度范围、平均高度、坡度统计和平坦区域比例,以及地形剖面图、高度图表、生物群系占比分解和带有理由的出生点质量评分。表格可导出为 CSV 和 JSON 格式。
地形地图导出 — 将当前种子(seed)的地形以高分辨率 PNG 格式写入文件,支持配置半径和每像素方块数,包含九种地形类别及可选的等高线叠加层。它还可以一次性遍历种子中的所有维度。
航点(Waypoints) — 按种子和维度存储的命名彩色标记。开启 Waypoints 后,左键点击地图即可放置一个;再次左键点击某个标记可重命名、重新着色或删除它。
测量工具 — 两次点击报告距离和轴向差值;右键点击清除。
出生点覆盖 — 在世界创建期间放置一个出生点标记,这些坐标将成为世界的出生点,无需作弊模式。
山体阴影和等高线 — 在高度图视图上模拟太阳光照(方位角、高度角、环境光、 exaggeration),以及在可配置间隔下的海拔等高线。
噪声参数视图 — 温度、湿度、大陆性、侵蚀、深度、怪异度以及峰谷,每个都有各自的颜色渐变。
其他小功能 — 小地图、实时统计数据、坐标、各生物群系的方块计数、视口周围区域的预加载、配置文件和其他维度视图的自动备份与迁移,包括具有非标准高度限制的维度。
使用方法
World Preview 在多人游戏菜单中添加了一个“预览”标签页。打开它会采样一个随机种子并绘制生物群系地图。默认情况下预览的是主世界(Overworld),结构和高度图处于关闭状态,且不存储任何噪声样本——所有这些都在“设置”中配置(地图右上角的扳手按钮)。
在地图上移动 — 拖动沿 X 和 Z 轴移动。拖动的队列按以下顺序工作:当前 Y 层未采样的生物群系 → 结构(如果启用)→ 高度图(如果启用)→ 交叉点(如果启用)→ 相邻 Y 层(如果启用)。滚轮缩放。沿 Y 轴移动可以看到洞穴生物群系;非洞穴生物群系贯穿整个世界高度,因此在每一层看起来都一样。方向键平移,Home 键重新居中于 (0, 0)。左下角的比例尺显示当前缩放比例,并可用作缩放滑块。
渲染模式,可从工具栏切换:
| 模式 |
显示内容 |
| 生物群系 |
生物群系颜色(默认) |
| 高度图 |
彩色化的高程,可选择颜色映射 |
| Y-交叉点 |
当前 Y 层上的方块,下方一层以较浅色调绘制 |
| 噪声参数 |
温度、湿度、大陆性、侵蚀、深度、怪异度和峰谷 |
结构没有独立的视图:一旦开启结构采样,单个结构类型可以从结构列表中切换。
种子(Seeds) 打开种子中心;分析(Analysis) 打开区域分析屏幕。对于单人游戏世界,暂停菜单中也添加了一个按钮,因此你可以在不离开世界的情况下打开预览。
常见问题
问:滚动不会缩放预览!
答: 在此移植版中,滚动默认用于缩放,如果你的不能缩放,请检查 设置 → 常规 → 滚轮缩放地图;当该选项关闭时,滚轮会沿 Y 轴移动,你需要 Ctrl+滚动来缩放。Alt+滚动始终沿 Y 轴移动。Y-交叉点视图全白是另一个问题;见下文。
问:Y-交叉点视图完全白色/黑色。
答: 预览大约从世界高度的三分之一处开始(主世界中约为 Y 64)。如果你仍然看不到任何东西,请滚动到较低的 Y 层——或者在地形位于其中部之上的维度中滚动到较高的 Y 层。
问:我的 CPU 占用率达到 100%!
答: 在 设置 → 常规 中降低线程数(该设置标记为“生物群系采样线程数”),并在那里关闭“启用拖动预加载”。World Preview 尽可能快地计算生物群系预览、结构和高度图,这本身就是 CPU 密集型的。在“分辨率”页面上降低“每个区块的采样量”可以进一步减少工作量,但代价是预览更粗糙。
问:配置文件在哪里,模组还向磁盘写入了什么?
答: 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。
链接
鸣谢
截图正在根据当前用户界面重新绘制。
An unofficial community port of World Preview by Caeruleus Draconis & Taiterio, carried forward to Minecraft 1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2 and 26.3 on Fabric and NeoForge, with Forge support for 1.20.1.
It draws a map of a world seed before the world is generated — biomes, structures, heightmap and Y-layer intersections — so you can look at a world before you commit to it.
All credit for the mod itself belongs to its original authors. Licensed under Apache-2.0.
Supported versions
| Minecraft |
Fabric |
NeoForge / Forge |
1.20.1 |
✅ |
✅ (Forge) |
1.21.1 |
✅ |
✅ |
1.21.11 |
✅ |
✅ |
26.1.2 |
✅ |
✅ |
26.2 |
✅ |
✅ |
26.3 |
✅ |
✅ |
Forge is available for 1.20.1 only; the other versions use NeoForge.
Which file do I need?
Pick the file that matches both your Minecraft version and your mod loader. File names look like world_preview-<mod version>-<minecraft version>-<loader>.jar, with the loader segment lowercase (fabric, neoforge) except on 1.20.1, where it is Fabric or Forge (world_preview-<mod version>-1.20.1-Fabric.jar, world_preview-<mod version>-1.20.1-Forge.jar).
The .dev and .sources variants are for developers and are not meant to be played.
On Fabric you also need Fabric API. NeoForge and Forge need nothing extra.
This mod is client-side and singleplayer-only. Install it on the client; a server does not need it, and the preview is not available on a server world.
What differs from the original
The list below records where this port departs from the original. Anything not listed here works the way it always did.
| |
Original (≤ MC 1.21) |
This port |
| Scroll wheel |
moves along the Y axis |
zooms the map; Ctrl+scroll always zooms and Alt+scroll always moves along Y, and the bare wheel can be set back to moving along Y in Settings → General → Scroll wheel zooms map |
| Zoom |
set from the config menu |
a 5-step ladder (16, 8, 4, 2 or 1 pixels per chunk; 4 by default), reachable from the mouse wheel, the settings screen and a scale-bar slider at the bottom-left of the map. The two most zoomed-out steps (2 and 1 pixels per chunk) resample the map, so they take a moment |
| Minecraft version |
1.20.x, 1.21 |
1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2, 26.3 |
| Mod loader |
Fabric, Forge, Quilt |
Fabric, NeoForge; Forge on 1.20.1 |
| Settings screen |
a single screen |
sidebar with separate pages, plus a Reset to defaults button |
| Starting Y layer |
the build limit |
about one third of the world height (≈ Y 64 in the Overworld) |
The in-game preview, persistent seed storage, biome highlighting, the preview cache (with optional compression), the thread-count setting and the datapack mechanism for registering biomes, structures and colour maps are all unchanged from the original.
Added in this port
Most of the following are opt-in: each has its own button or setting, and none of them change the preview until you turn them on; the exceptions — drag preloading, which is on by default, and the automatic backup and migration of the config files — only affect sampling work and files, never what the preview shows.
Seed search scans random seeds against a set of criteria: up to four biomes (any of them counts), a structure, a minimum biome area share, a maximum distance to the nearest matching biome and a separate distance limit for the structure. Results are ranked, and a search runs in the background, so it keeps going while you are on another screen. Only random-spread structures can be searched for; concentric-ring ones such as strongholds are not supported yet.
Seed history, favourites and comparison — matching searches are stored, and a row applies its seed on click, adds it to favourites on Shift+right-click and deletes it on right-click. A comparison screen puts the current seed next to up to seven others and reports biome diversity, water share, the dominant biome and a spawn score.
World analysis — pick a region and get biome distribution, height range, mean height, slope statistics and flat-area ratio, plus a terrain profile, a height chart, a biome-share breakdown and a spawn quality score with reasons. The tables export as CSV and JSON.
Terrain map export — write the current seed's terrain as a high-resolution PNG, with a configurable radius and blocks-per-pixel, nine terrain classes and an optional contour overlay. It can also walk every dimension of the seed in one batch.
Waypoints — named, coloured pins stored per seed and dimension. Switch on Waypoints and left-click the map to place one; left-click a pin again to rename, recolour or delete it.
Measure tool — two clicks report the distance and the axis deltas; right-click clears it.
Spawn point override — place a spawn pin during world creation and those coordinates become the world's spawn point, without cheats.
Hillshade and contour lines — simulated sun illumination on the heightmap view (azimuth, altitude, ambient, exaggeration) and elevation contour lines at a configurable interval.
Noise parameter views — temperature, humidity, continentalness, erosion, depth, weirdness and peaks & valleys, each with its own colour gradient.
Smaller things — a minimap, live statistics, coordinates, per-biome block counts, preloading of the area around the viewport, automatic backup and migration of the config files and views for other dimensions, including ones with non-standard height limits.
How to use it
World Preview adds a Preview tab to the Singleplayer menu. Opening it samples a random seed and draws a biome map. By default the Overworld is previewed, structures and the heightmap are off, and no noise samples are stored — all of that is configured in Settings (the wrench button, top-right over the map).
Moving on the map — drag to travel along X and Z. Dragging queues work in this order: biomes not yet sampled on the current Y layer → structures (if enabled) → heightmap (if enabled) → intersections (if enabled) → adjacent Y layers (if enabled). Scroll to zoom. Moving along Y lets you see cave biomes; non-cave biomes span the whole world height, so they look the same on every layer. Arrow keys pan, Home recentres on (0, 0). The scale bar at the bottom-left shows the current scale and doubles as a zoom slider.
Render modes, switchable from the toolbar:
| Mode |
Shows |
| Biomes |
biome colours (default) |
| Heightmap |
colourised elevation, with selectable colour maps |
| Y-intersections |
blocks on the current Y layer, with the layer below drawn in a lighter shade |
| Noise parameters |
temperature, humidity, continentalness, erosion, depth, weirdness and peaks & valleys |
Structures are not a view of their own: once structure sampling is on, individual structure types are toggled from the structures list.
Seeds opens the seed hub; Analysis opens the region analysis screen. For singleplayer worlds a button is also added to the pause menu, so you can open the preview without leaving the world.
FAQ
Q: Scrolling does not zoom the preview!
A: Scrolling zooms by default in this port, so if yours does not, check Settings → General → Scroll wheel zooms map; when that box is off, the wheel moves along the Y axis instead and you need Ctrl+scroll to zoom. Alt+scroll always moves along Y. A blank Y-intersections view is a different problem; see below.
Q: The Y-intersections view is completely white / black.
A: The preview starts at roughly one third of the world height (≈ Y 64 in the Overworld). If you still see nothing, scroll to a lower Y layer — or to a higher one, in a dimension whose terrain sits above its middle.
Q: My CPU is at 100%!
A: Lower the thread count in Settings → General (the setting is labelled Number of biome sampling threads), and turn off Enable drag preloading there as well. World Preview computes the biome preview, structures and heightmap as fast as it can, which is CPU-hungry by design. Lowering The amount of samples per chunk on the Resolution page reduces the work further, at the cost of a coarser preview.
Q: Where is the config file, and what else does the mod write to disk?
A: config/world_preview/config.json. Backups and migrations of older files happen automatically. Terrain exports land in config/world_preview/terrain_exports/ and analysis reports in config/world_preview/reports/.
Q: How do I add support for new biomes, structures or colour maps?
A: The same way as in the original mod: through the Minecraft datapack mechanism. The data format is unchanged by this port.
Q: Will other Minecraft versions be supported?
A: This port targets exactly the versions in the table above — there are no builds for anything in between (1.21.2–1.21.10) or older. For 1.20.x and 1.21 you can use the original mod, which covers those versions on Fabric, Forge and Quilt.
Q: Will multiplayer be supported?
A: No.
Mod compatibility
Modded chunk generators are detected at runtime and adapted.
| Mod |
What this port does |
| Terralith |
uses a chunk generator adapter |
| Biomes O' Plenty |
points its biomes at the datapack colour mapping |
| Oh The Biomes You'll Go |
points its biomes at the datapack colour mapping |
| Nature's Spirit |
points its biomes at the datapack colour mapping |
| Astral Sorcery |
notes that its custom dimensions may need datapack configuration |
| Awaken |
notes that its custom dimensions may need datapack configuration |
| TofuCraft |
notes that its custom dimensions may need datapack configuration |
| Oh The Trees |
notes that tree generation may vary |
| Wither Storm Mod |
records the mod as present |
| TerraFirmaCraft |
switches intersection sampling off — this entry is disabled by default |
Mods that are not on this list are left alone: biomes, structures and colour maps they add are picked up through the datapack mechanism.
TerraFirmaCraft (TFC) — World Preview is compatible with TFC, with one known limitation: the Y-intersections view stays white on every Y layer, because the column data this view samples is not exposed by TFCChunkGenerator's getBaseColumn. That comes from the data TFC exposes, not from a bug in TFC.
Links
Credits
- The original mod, its design and the large majority of its code are by Caeruleus Draconis & Taiterio. This port only exists because of their work.
- Anything the port adds, and anything it breaks, is this port's own responsibility.
- Licensed under Apache-2.0.
Screenshots are being redrawn for the current UI.
评论 0
登录后参与评分
还没有评论,来抢沙发吧