Advertisement
Advertisement
EVERYDAY

Nether Portal Calculator — link Overworld and Nether coordinates correctly

Convert coordinates between the Overworld and the Nether at the 8:1 ratio, and check whether a new portal will link to one you already built.

Press F3 in Java Edition, or turn on Show Coordinates in Bedrock settings, to read your current position.
Y is never scaled. It carries across unchanged, though the Nether has a solid ceiling so very high values are not reachable there.
Only applies when converting Overworld to Nether. Going the other way multiplies by 8 and is always exact.
The game looks for an existing portal near the arrival point before creating a new one. 128 blocks is the figure normally quoted for recent versions — confirm it for the version you play.
Matching coordinates
 
Target X
Target Z
Target Y
Distance to existing portal
Tip: build the second portal manually at the calculated position and light it before you walk through the first one. If you let the game place it for you, it picks a spot it likes and the pair may never line up the way you intended.
Advertisement

This nether portal calculator does the coordinate arithmetic that makes portal pairs behave. Every block you walk in the Nether covers eight blocks of the Overworld horizontally, so the two dimensions are linked by a simple ratio — and almost every complaint about portals sending you to the wrong place comes down to that ratio being applied to the wrong axis, in the wrong direction, or not at all.

Arb Digital publishes this in a free tools library that is mostly business arithmetic, with a handful of pages like this one for the calculations people actually search for. It is deliberately narrow: it converts positions and checks link distance. It does not plan a route, generate a build, or know anything about your world file.

What This Nether Portal Calculator Does

Give it a position in either dimension and it returns the matching position in the other. Overworld to Nether divides X and Z by eight. Nether to Overworld multiplies X and Z by eight. Y is carried across untouched in both directions, because the vertical axis is not scaled at all.

It also answers the question that actually causes the trouble: will this new portal hijack an existing one? Enter the coordinates of a portal you already have on the target side, and the tool reports the horizontal distance from the calculated arrival point to that portal. If the distance is inside the link search radius, the game is likely to send you to the old portal instead of creating a new one — which is the entire mechanism behind two Overworld portals mysteriously sharing a single Nether portal.

The nearest tool on the site is the Minecraft circle generator, which lays out block positions for a circle or dome and has nothing to do with dimensions. For pure geometry with no game rules attached, the 3D distance calculator handles the straight-line distance between two points in space, and the coordinates converter deals with real-world coordinate systems rather than game ones.

How to Use It

  1. Read your coordinates in game. Java Edition shows them on the F3 debug screen; Bedrock has a Show Coordinates toggle in world settings.
  2. Choose the direction. Overworld to Nether when you have a base and want the matching Nether spot; Nether to Overworld when you are exploring the Nether and want to know what is above.
  3. Enter X, Z and Y. Signs matter — a negative Z stays negative through the conversion.
  4. Add an existing portal if you have one nearby. Leave the fields far away or at an obviously distant value if you do not.
  5. Build at the calculated spot and light it manually. Then travel, rather than travelling first and letting the game choose.

The Formula: How the 8:1 Ratio Works

The Nether is compressed horizontally by a factor of eight relative to the Overworld. One block of horizontal movement in the Nether corresponds to eight blocks in the Overworld, which is why travelling through the Nether is the standard way to cross long distances quickly.

Going down, from Overworld to Nether: nether X = overworld X ÷ 8 and nether Z = overworld Z ÷ 8, with the result taken to a whole block. Going up: overworld X = nether X × 8 and overworld Z = nether Z × 8. Y is unchanged either way.

Worked example, which is the default on this page. An Overworld base at X 1000, Y 64, Z −520 divides to X 125 and Z −65, giving a Nether target of 125, 64, −65. Reverse it and 125 × 8 = 1000 while −65 × 8 = −520, returning the original position exactly. That clean round trip only happens because both Overworld numbers were already multiples of eight; start from X 1003 and you get 125 again, so the reverse trip lands three blocks away.

That asymmetry is worth understanding rather than fighting. Eight Overworld positions map to one Nether position, so the Nether-to-Overworld direction always produces a coordinate that is a multiple of eight, and any Overworld portal not on a multiple of eight will sit slightly off its own reverse mapping. A few blocks of drift is harmless for a base; it matters when you are building a linked network and want portals to line up predictably.

Advertisement

Why Portals Link to the Wrong Place

When you step into a portal, the game does not simply build a new portal at the divided coordinates. It first looks for an existing portal within a search radius of that arrival point, and if it finds one, it sends you there. Only if the search comes up empty does it create a new portal — and then it places it at a spot it considers valid, which may be some distance from where you expected.

This is the single mechanism behind nearly every portal complaint. Two Overworld portals a few hundred blocks apart divide down to two Nether points only tens of blocks apart, well inside the search radius, so both link to the same Nether portal. Walk into the second one and you come out at the first one's destination. The fix is not a bug report; it is spacing. Overworld portals need to be far enough apart that their Nether targets are separated by more than the search radius.

Work that threshold out from the radius you entered above. If the search radius is 128 blocks in the Nether, two Nether portals must be more than 128 blocks apart, which means their Overworld counterparts must be more than 8 × 128 = 1,024 blocks apart. Build closer than that and the pair will fight over one destination. The distance box on this page gives you the number to check against directly.

Building Both Sides by Hand

The reliable method is to build and light both portals yourself before you use either one. Construct the Overworld portal, calculate the Nether coordinates here, travel there by whatever means you like, build a portal at that exact position, and light it. Because a portal already exists within the search radius, each side will find the other rather than generating something new.

A portal frame is a rectangle of obsidian with an interior between two blocks wide by three tall and twenty-three by twenty-three. The minimum ten-obsidian frame is the standard build. What matters for linking is the position of the portal block you actually enter, so if you are trying to be exact, place the frame so its interior sits on the calculated coordinate rather than the corner.

If you are building at speed, remember that the Nether is hostile and the ceiling is solid bedrock. A portal calculated at a high Y value may land inside the ceiling layer, and one at a very low Y may land in lava. Read the calculated Y as a target rather than a promise, and be prepared to move a few blocks vertically — vertical position does not affect linking anywhere near as much as horizontal position does.

Planning a Nether Highway

The reason people care about this arithmetic is the Nether highway: a tunnel network built in the Nether that connects distant Overworld locations at one-eighth the travel distance. To plan one, convert every Overworld destination to its Nether coordinate first, then look at the resulting set of points. What was a sprawling map becomes a compact cluster, and the tunnel layout is obvious once you can see it that way.

Two practical points fall out of the conversion. First, distances shrink but heights do not, so a highway at a single Y level connects everything regardless of how mountainous the Overworld is above it. Second, because eight Overworld blocks collapse to one, small errors in the Nether become large errors in the Overworld — being three blocks off in a tunnel puts your exit portal twenty-four blocks from where you wanted it. Measure carefully on the Nether side.

If you want the raw travel maths rather than the coordinate maths, the speed distance time calculator converts a distance and a movement speed into a travel time, which is a reasonable way to compare a Nether route against an Overworld one. For the general geometry of a diagonal path, the 3D distance calculator gives the straight-line length between any two points.

Version Differences and What This Page Assumes

The 8:1 horizontal ratio has been the constant across editions for a very long time, and it is what this calculator implements. What has changed over the years is world height, the structure of the Nether itself, and some of the details of how the game picks a spot when it has to create a portal for you. The official Nether Update announcement from Minecraft.net covers the biomes and mobs that arrived with that overhaul, and the Minecraft updates timeline is the place to check which version introduced what.

Because those details do move, the link search radius on this page is an input rather than a hardcoded constant. If your version, server plugin or datapack uses a different radius — some server software makes it configurable — enter that number and the distance check adjusts. The coordinate conversion itself is unaffected either way.

Running a gaming community, server or channel?

Arb Digital's free tools library covers the audience, content and measurement maths behind growing an online following, and our team is happy to talk through anything the tools cannot answer.

Browse Free Tools Talk to Arb Digital

Common Mistakes to Avoid

  • Dividing the Y coordinate — only X and Z are scaled. Height carries across unchanged in both directions.
  • Dropping a minus sign — a negative coordinate stays negative through the conversion, and losing the sign puts the portal on the opposite side of the map.
  • Building Overworld portals closer than about 1,024 blocks apart — their Nether targets land inside the same search radius and end up sharing one destination.
  • Letting the game place the second portal — build and light both sides yourself if you want the pair to sit where you calculated.
  • Multiplying when you meant to divide — going into the Nether divides by eight, coming out multiplies by eight, and getting it backwards is off by a factor of sixty-four.

Related Free Tools From Arb Digital

Use the Minecraft circle generator to lay out circular builds block by block, the 3D distance calculator for straight-line distance between two points, the speed distance time calculator to compare travel routes, the dice roller for tabletop randomness, and the KD ratio calculator for competitive game statistics. Everything else is in the free online tools hub.

Frequently Asked Questions

What is the Overworld to Nether coordinate ratio?

Eight to one horizontally. Divide the Overworld X and Z by eight to get the Nether position, and multiply the Nether X and Z by eight to go the other way. The Y coordinate is not scaled.

Do I divide the Y coordinate as well?

No. Height carries across unchanged. The compression applies only to the horizontal axes, which is what makes Nether travel fast without changing how deep or high anything sits.

Why do two of my portals come out in the same place?

Because their calculated Nether positions are close enough together that the game finds the existing portal inside its search radius and sends you there. Spacing the Overworld portals further apart is the fix.

How far apart should Overworld portals be?

Far enough that their Nether targets exceed the search radius. With a 128-block radius that means more than 8 × 128 = 1,024 blocks between the Overworld portals, which the distance box on this page lets you check directly.

Should I build the second portal myself?

Yes, if you want the pair to line up. Build and light both sides manually at the calculated positions, then travel. Letting the game generate the far side means it chooses a location that suits its own placement rules.

Does rounding down or to nearest matter?

Only by a block or two in the Nether, but a block in the Nether is eight in the Overworld. Rounding down matches how the game divides, so it is the default here.

Is the ratio the same in Bedrock and Java Edition?

The 8:1 horizontal ratio applies in both. Details such as world height and the exact rules for generating a new portal have changed across versions, which is why the search radius is an input you can adjust.

Does this tool read my world file?

No. It makes no external requests and has no access to any game data. It converts the numbers you type and reports the distance between two points you supply.

This tool performs coordinate arithmetic only. Minecraft is a product of Mojang Studios and this page is not affiliated with, endorsed by, or produced by Mojang Studios or Microsoft. Game behaviour varies by version, platform and server configuration, so confirm anything that matters against your own world.

Advertisement
Advertisement

Take it further