Back to mods
World Preview (Unofficial Port) project artwork

CurseForge · Minecraft mod

World Preview (Unofficial Port)

Allows you to preview a map / seed in the new world screen. Community fork ported to Minecraft 1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2 and 26.3 with new features and a redesigned UI.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which World Preview (Unofficial Port) release should I use?

Updated 15 days ago
Latest stable file world_preview-1.5.6-26.3-NeoForge.jar
Game version 26.3
Loader NeoForge

World Preview (Unofficial Port) world_preview-1.5.6-26.3-NeoForge.jar targets 26.3 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is World Preview (Unofficial Port) required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does World Preview (Unofficial Port) world_preview-1.5.6-26.3-NeoForge.jar need?

world_preview-1.5.6-26.3-NeoForge.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add World Preview (Unofficial Port) without breaking your instance.

Built for World Preview (Unofficial Port) world_preview-1.5.6-26.3-NeoForge.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use world_preview-1.5.6-26.3-NeoForge.jar. It targets 26.3 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside world_preview-1.5.6-26.3-NeoForge.jar. It opens that exact file at the source.

About this project

What does World Preview (Unofficial Port) add?

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.

Project description from CurseForge.

Pick your setup

World Preview (Unofficial Port) by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

12 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

World Preview (Unofficial Port) versions and loaders

50 of 50 releases match

Looking for an older file? The official CurseForge project page is in Resources.