Tool 02 · portal linking

Nether Portal Calculator

Convert overworld X and Z to nether coordinates by dividing by 8, or go back the other way by multiplying. Y is not scaled by the conversion, and negative coordinates keep their sign.

Tool 02 · Overworld ↔ Nether Link

Type coordinates from F3 (Java) or from the Bedrock coordinate screen. X and Z are scaled by 8; Y is not scaled by this tool.

Exact X
—
Exact Z
—
Y (not scaled)
—
Whole block, nearest
—

Exact values keep the precision you typed: X −1,010 ÷ 8 is −126.25 and is shown as −126.25, never rounded to one decimal place. The whole-block line is a separate suggestion — nearest whole block, halves rounded away from zero.

Zero is the world centre line in both dimensions, so a negative result stays negative: it is a position west or north of the centre, not a distance from it.

Y is not scaled by this tool, but where the portal actually comes out depends on nearby portals and the space available there — see the nether portal article on the Minecraft Wiki.

What a nether portal calculator does

The nether is a compressed copy of the overworld: one block travelled in the nether covers eight blocks of overworld distance. That ratio is the whole reason the nether works as a shortcut network, and it is also the whole job of this calculator. It takes the X and Z you read from the debug screen, divides them by eight, and gives you the spot where the matching portal belongs. Run it the other way and it multiplies by eight to tell you where a nether portal points above ground.

The two rules behind it are short:

  • Nether X = overworld X divided by 8. Same for Z.
  • Y is not scaled by the conversion. Height plays no part in the 8:1 ratio, so the Y you type is passed through untouched. That is a statement about the maths, not a promise about where the portal will appear — see below.

Why the 8:1 ratio matters

A tunnel 125 blocks long in the nether is a 1000-block walk in the overworld. That is why established worlds keep a hub with short nether corridors instead of long surface roads, and why the ice-boat highway is the fastest transport in the game. When you build a link between two bases, work out both ends with this calculator first, then dig: the portal on each side has to sit at the computed coordinates, not wherever the tunnel happens to end.

Negative coordinates

Negative values are not special, they just feel strange. Divide X = -1000 by 8 and you get -125. That is 125 blocks west of zero, not 125 blocks east and not closer to the middle of anything. Zero is the world centre line in both dimensions, and the sign carries straight through the division.

If the division does not land on a whole block, keep the exact number and round once. X = -1010 divided by 8 is exactly -126.25, and -126 is the nearest whole block. The calculator shows the exact value and a suggested whole block on separate lines, with the rounding rule printed on the page (nearest whole block, halves rounded away from zero), because rounding twice — first to a decimal place, then to a block — is how a link quietly ends up two blocks off. A block either way rarely matters in practice, since the game looks for an existing portal near the target point instead of insisting on an exact match.

Does the portal come out at the same Y?

Not necessarily. The 8:1 ratio applies to X and Z only; this calculator does not scale Y. Where the portal actually appears is decided by the game, not by arithmetic: it searches for an existing portal near the target point, and it needs a spot where a frame and a player will fit. So the exit height depends on the portals already around the destination and on the space available there — dig down, build a platform, or clear a cave if the search comes up empty. Light the portal, walk through, then read the Y on the far side. The Minecraft Wiki article on nether portals documents the linking and search rules in detail.

Building a working link, step by step

  1. Read the coordinates. In Java Edition press F3 and note the X, Y and Z on the line that starts with your block position. On Bedrock open the coordinate screen. Note the numbers before you start moving, or write them down; walking ten blocks changes the answer by more than a block.
  2. Run the numbers. Put X and Z into the calculator in the direction you are travelling. Note the Y as well, so you know what height you are aiming at.
  3. Build the portal on the target side. Ten obsidian blocks is the minimum frame, and the corners can be left out. A frame of 4 by 5 blocks on the outside gives a 2 by 3 opening, the standard size.
  4. Stand in the middle when you light it. The game takes the position of the player or entity that enters, not the centre of the frame, which is why two players can sometimes arrive at two different places.
  5. Walk through and check the other side. Read the coordinates on the far side and compare them with the number the calculator gave you. If the portal came out somewhere else, an older portal was already within range and got picked instead, or there was no room for a frame at the target point.

Common mistakes

  • Scaling Y. Only X and Z are divided or multiplied; height is not part of the ratio.
  • Dividing by eight when travelling out of the nether. Going up to the overworld, you multiply.
  • Aiming at the nether roof. The top of the nether is solid bedrock, and a portal frame cannot be placed inside it. If your target point sits up against the roof, dig down until there is room for the frame and the player. Build limits are not identical across editions, so check the ceiling in the edition you play instead of assuming one number fits both.
  • Reusing a portal that is already nearby. Two portals close together in the nether will fight over the same overworld exit. Space your links out, or rebuild the second one a few blocks away and test again.

Frequently asked questions

How far does a portal have to be from another portal?

There is no fixed distance you must keep in the frame itself, but links need room to breathe. If two nether portals are close together, the game can send both of them to the same overworld portal. Space them well apart and test each link after you build it.

Does this work for Bedrock Edition?

Yes. Both editions use the same 1:8 ratio between the dimensions. Open the coordinate screen in Bedrock, read X, Y and Z, and put those numbers in.

Why is my portal coming out in the wrong place?

Because another portal was already within the search range of the target point and the game linked to it, or because the target point had no room for a frame. Break or move the old portal, clear space at the destination, or move the new one a few blocks, then try again.

Do negative coordinates work the same way?

Yes. The formula does not change sign rules. X = -1000 becomes -125, which is 125 blocks west of zero in the nether.

Does Y stay the same when the portal links?

Not guaranteed. This calculator does not scale Y — only X and Z are affected by the 8:1 ratio, so the Y you type is the Y the conversion is based on. Where the portal lands is up to the game: it looks for an existing portal near the target point and needs room for a frame, so the exit height depends on the terrain and the portals already around the destination. Read the Y on the far side after you light it.

Is this an official Minecraft tool?

No. CraftCircle is an independent fan-made tool and is not approved by or associated with Mojang Studios or Microsoft.

Keep building