Dimensions & structures · Java & Bedrock · Beginner

How to Plan Nether Hub Tunnels and Link Portals Using the World Map Viewer

Building a Nether hub is the fastest way to travel long distances in Minecraft, because every block traveled in the Nether equals eight blocks in the Overworld. However, linking portals across dimensions often goes wrong when lava lakes, huge caverns, or math errors push portals out of alignment. By using our browser-based World Map Viewer, you can preview both dimensions, calculate exact 8:1 coordinates, and plan safe tunnel routes directly from your save files without uploading your world anywhere.

Open the World Map ViewerSee your whole world from above like Google Maps - zoom, pan, cave view, PNG export.

What you need

  • A copy or backup of your Minecraft world save folder (Java Edition) or exported .mcworld/.zip file (Bedrock Edition).
  • Access to the World Map Viewer on our site in any modern browser.
  • Enough obsidian and a flint and steel in-game to build your portals at the exact planned coordinates.

Step by step

  1. 1Back Up and Load Your World into the World Map Viewer

    Before opening or working with any world files, always make a duplicate backup copy of your save folder just in case. Open the World Map Viewer on our site and click Open world folder or .zip to select your save directory (in Java Edition, look inside your saves folder; in Bedrock Edition, select your exported world archive or local db folder). Because the tool runs entirely inside your browser, your files are read locally and immediately render your explored chunks.

    Tip: If an area of the map looks blank, it simply means you have not visited and generated those chunks in-game yet.

  2. 2Pinpoint Your Overworld Portal Coordinates

    Make sure the dimension selector in the World Map Viewer is set to the Overworld. Pan and zoom across your map to find your main base and the distant biomes or outposts you want to connect. Hover your cursor over each planned portal spot and write down the exact X and Z coordinates shown in the viewer.

    Tip: Note your approximate Y-level (elevation) in-game as well, since vertical distance can break link priority if two portals are very close together.

  3. 3Switch to the Nether and Use the 8:1 Coordinate Overlay

    Use the dimension switcher in the World Map Viewer to change the view from the Overworld to the Nether (in Java Edition files, this reads region data from the DIM-1 folder). Enable the coordinate overlay or hover over the map to see corresponding 8:1 coordinates, which automatically divide your Overworld X and Z numbers by 8. Locate the exact Nether X and Z coordinates that match your Overworld targets.

    Tip: If you are calculating manually, simply divide the Overworld X and Z by 8 and round down to the nearest whole block (do not divide the Y height).

  4. 4Inspect Nether Terrain and Plan Safe Tunnel Elevations

    Look closely at the Nether map around your target coordinates to check for massive lava oceans or bastions that might block your paths. By toggling vertical Y-level slices or inspecting the terrain height in the World Map Viewer, decide on a uniform elevation for your entire hub network. Most players choose either just below the Nether roof (around Y=115 to Y=120) or right below the lava ocean floor (around Y=15) to avoid open hazards.

    Tip: Building every Nether portal and tunnel at the exact same Y-level makes digging straight highways much easier and prevents portals from stealing each other's links.

  5. 5Build and Light Your Portals at the Exact Coordinates

    First, build and light the portal in the Overworld at your chosen X and Z coordinates, or step through it once to generate the surrounding Nether chunks if you have not explored the Nether yet. Next, travel into the Nether, go to the exact divided X and Z coordinates and your chosen hub Y-level, and build your matching Nether portal there. If the game automatically generated a portal in an inconvenient cave or cliff nearby, break that old portal completely so your two custom-placed portals link cleanly to each other.

    Tip: Light the new portal before breaking the auto-generated one so you do not get stranded without a way home.

How it works

Minecraft maps the Nether and Overworld using a strict 8:1 horizontal ratio. Whenever a player steps into an Overworld portal, the game takes the player's current X and Z coordinates and divides them by 8 (using floor division) to determine the ideal target point in the Nether. Conversely, stepping into a Nether portal multiplies the Nether X and Z coordinates by 8 to find the target Overworld spot. The vertical Y coordinate is never multiplied or divided.

Once the game calculates the ideal target coordinates in the destination dimension, it searches in a vertical column and a horizontal square radius around that target point for an existing active portal block. In Java Edition, this search area is 128 blocks outward from the target point in the Overworld and 16 blocks outward in the Nether (Bedrock Edition uses similar proportional bounding boxes). If multiple active portals exist inside that search radius, the game calculates the straight-line 3D distance (including the Y height difference) and sends you to the single closest portal.

When you load your save into the World Map Viewer, the tool reads your generated chunk data directly from disk—specifically the region (.mca) files inside the root region folder for the Overworld and the DIM-1/region folder for the Nether in Java Edition, or the LevelDB database records in Bedrock Edition. Because both dimensions are stored independently, switching views with an 8:1 coordinate overlay lets you visually align both maps before placing a single block.

Common mistakes

  • Dividing the Y coordinate by 8: Only horizontal X and Z coordinates scale by 8. Keep your Nether portal's Y elevation reasonably close to your Overworld portal's Y elevation when placed near other portals so 3D distance calculations do not jump to a neighbor's portal.
  • Forgetting negative signs when reading coordinates: A single misplaced minus sign on the X or Z axis will send your tunnel in the exact opposite quadrant of the dimension.
  • Leaving auto-generated Nether portals standing: When you enter the Nether for the first time, the game often places the exit portal tens of blocks away from the true 8:1 coordinate to avoid lava or solid netherrack. If you do not destroy and relocate it to the exact divided coordinates, nearby portals built later will cross-link into it.
  • Looking at unexplored blank areas in the viewer: The World Map Viewer only displays chunks that have already been generated by players in-game. If your Nether map is completely empty, enter the Nether briefly in-game to generate the local chunks, save, and reload the world in the viewer.

FAQ

Why is the Nether view completely blank in the World Map Viewer?

Minecraft only creates chunk files for areas a player has actually visited. If you have never entered the Nether in that save file, the DIM-1 folder (or Nether database entries) will be empty until you step through a portal in-game.

How close together can two Overworld portals be without linking to the same Nether portal?

As long as you manually build both corresponding Nether portals at their exact X/8 and Z/8 coordinates and match their Y-levels, Overworld portals can be as close as 10 to 16 blocks apart without interfering with each other.

Does using the World Map Viewer modify my save file?

No. The World Map Viewer only reads your world folder or .zip file locally in your browser to render the map and coordinates; it never alters your save data or uploads your world to a server.

By loading your save into our browser-based World Map Viewer, you can switch between the Overworld and Nether, apply the 8:1 coordinate math accurately, and build perfectly linked Nether hub tunnels without trial and error.

More dimensions & structures guides

Dimensions & structuresHow to Find Exact Structure Bounding Boxes (Fortresses, Witch Huts, Monuments) in Chunk NBTBuilding high-efficiency mob farms for Wither Skeletons, Witches, or Guardians requires knowing the exact coordinates of a structure's bounding box. Even if the physical blocks of a structure are destroyed or altered by terrain generation, the game uses invisible bounding boxes saved in the chunk data to dictate where structure-specific mobs can spawn. This guide teaches you how to inspect raw chunk NBT data using our browser-based tools to find those exact boundaries without your files ever leaving your computer.JavaAdvanced5 steps
Dimensions & structuresHow to View, Trim, or Remove Custom Datapack Dimensions in Your World SaveCustom datapacks and mods often generate their own dimensions, which can bloat your world save size or cause loading errors if the datapack is later removed. This guide shows you how to locate custom dimension namespaces in your Java Edition world folder, inspect their terrain using our browser-based World Map Viewer, and safely trim or delete their region data. Because our tools run locally in your browser, your world files are never uploaded to any server.JavaAdvanced5 steps
Dimensions & structuresHow to Reset Outer End Cities for Fresh Elytras While Keeping Your Main End IslandOn long-running worlds or multiplayer servers, the End dimension quickly becomes picked clean of Elytras and Shulker shells as players raid every nearby End City. This guide shows you how to reset the outer End islands to regenerate brand-new cities while keeping your central dragon island, Endermen farms, and exit portal completely intact. You can do this safely in your browser using our Chunk Trimmer, which processes your files locally without ever uploading your world.Java & BedrockBeginner5 steps
Dimensions & structuresHow to Reset the Ender Dragon Fight and Regenerate End Exit Gateways in level.datSometimes the Ender Dragon fight in Minecraft Java Edition can glitch, leaving you without a dragon egg, a missing exit portal, or unable to generate the twenty outer End gateways. By editing the DragonFight compound inside your world's level.dat file, you can completely reset the battle state and replenish the gateway generation pool. This guide uses our browser-based level.dat Editor, which processes everything locally on your device so your files are never uploaded.JavaIntermediate5 steps
Dimensions & structuresHow to Reset Trial Chamber Vaults so Players Can Unlock Them AgainIn Minecraft Java Edition, Trial Chamber vaults are designed to only reward each player once by recording their unique ID inside the block itself. If you run a server or want to replay a Trial Chamber in single-player, you can reset these vaults without destroying or replacing the blocks. By using our browser-based NBT Editor, you can safely delete the player memory from specific vaults while keeping your world files completely private on your own computer.JavaAdvanced5 steps