Nether portal calculator and link checker
Type where you stand and get the matching block in the other dimension, with negative numbers rounded the way the game does. Then check if two portals will link on Java or Bedrock.
Checked against Java 26.3 and Bedrock 26.60 on
Build the Nether portal at
Type X, Y and Z, or paste them all at once into any field.
Will these two portals link?
Stand in each portal and enter the coordinates the game shows. The check runs both trips, because a pair can work one way and not the other.
Fill in both portals to see the two trips.
Divide by 8, then round down
One block in the Nether is eight blocks in the Overworld, on X and Z. So the Nether match of an Overworld spot is X divided by 8 and Z divided by 8, rounded down. The way back is X times 8 and Z times 8. This 1:8 rule is the same on Java and Bedrock, and it is why the Nether is a shortcut: walk 100 blocks there and you cover 800 at home.
Rounded down means toward the lower number, and that matters on the negative side of the map. Overworld X -9 is Nether X -2, not -1, because -1.125 rounds down to -2. Rounding toward zero, the way a quick sum in your head does, puts most negative coordinates one Nether block off. The calculator rounds the way the game does.
Y does not scale. The Nether is only 128 blocks tall, with a bedrock floor from Y 0 to 4 and a bedrock roof from Y 123 to 127, so an Overworld portal on a mountain has no matching height there. The portal search covers the full height of the world, so a Nether portal at another Y still links. Height only decides which portal wins when two are in range.
Java and Bedrock search different distances
When you step through, the game converts your position and looks for an existing portal in a square around that spot. On Java, that square reaches 16 blocks in each direction when you arrive in the Nether, and 128 blocks when you arrive in the Overworld. The Nether radius was cut from 128 to 16 in Java 1.16.2 so that it matches the 1:8 scale. Since then both trips cover the same stretch of map, so a Java pair that sits well inside the range links both ways, as long as no other portal is closer.
Bedrock searches 128 blocks in both dimensions. That sounds generous, and it is the trap. Your Overworld portal will happily take you to a Nether portal up to 128 Nether blocks away, which is 1,024 Overworld blocks of slack. The way back only searches 128 Overworld blocks, the same as 16 Nether blocks. So a Nether portal 40 blocks off the right spot works on the way in, and on the way home the game builds you a brand-new Overworld portal. The link checker shows both trips for exactly this reason.
Why a portal picks the wrong partner
If more than one portal sits inside the search square, the game takes the closest by straight-line distance, with Y counted. A portal deep underground can lose to one that is farther away on the map but at the right height. The checker here knows only the two portals you enter, so if a third portal is closer to the matching spot, the game picks that one instead.
If no portal is in range, the game builds one within 16 blocks of the matching spot, at any height, wherever it finds room. That is how a new Nether portal ends up beside a lava lake or on a ledge, and how it ends up close enough to a second Overworld portal's spot to steal its link.
Build the Nether side yourself
Our advice for any portal you will use more than once: do not let the game place the Nether half. Build the Overworld portal, go through once, then walk to the coordinates this calculator gives you and build the Nether portal there yourself. Match X and Z exactly, and match Y as closely as the Nether lets you, because the game counts height when it picks between portals.
Stand inside each portal when you read your coordinates. On Java, the F3 screen shows them, and F3 + C copies them as a command that you can paste straight into this calculator. On Bedrock, turn on Show Coordinates in the world options.
Sources
Frequently asked.
6 questions
How do I convert Overworld coordinates to Nether coordinates?
Divide X and Z by 8 and round down. Keep Y. Overworld 800, 64, -340 is Nether 100, 64, -43, because -340 divided by 8 is -42.5, and rounding down gives -43. To go from the Nether to the Overworld, multiply X and Z by 8.
Why does my Nether portal take me to the wrong portal?
The game takes the closest portal inside its search square, measured in a straight line with height counted. Another portal can be closer to the matching spot than the one you meant, often one at a better height. Build the portal you want at the exact coordinates from the calculator, at a similar Y, and it is the closest one, so it wins.
Why did going back through my portal make a new portal?
The return trip found no portal near the matching spot. On Bedrock this happens when the Nether portal is more than 16 Nether blocks from the right spot, because the Overworld search covers only 128 Overworld blocks, even though the trip into the Nether searches 128 Nether blocks. On Java, both trips use matching distances, so a new portal on either side means the other portal is too far off, or a portal was broken.
Is the Nether calculation different on Java and Bedrock?
No. The 1:8 conversion is the same on both. The search distance is what differs. Java looks 16 blocks around the spot in the Nether and 128 in the Overworld. Bedrock looks 128 blocks in both, which is why a Bedrock pair can work one way only.
Does the Y coordinate change in the Nether?
No, Y stays the same. The Nether is only 128 blocks tall, with bedrock at Y 0 to 4 and Y 123 to 127, so pick an open height between them. The search for a portal covers every height, so the link still works. Y only matters when two portals compete.
Can I paste my coordinates instead of typing them?
Yes. Paste three numbers into any field, like 120 64 -340, and the calculator fills X, Y and Z. It also reads the Java F3 line and the command that F3 + C copies, and that command switches the direction for you, because it names the dimension you stand in.