Nether Portal Calculator

Link portals perfectly · Java + Bedrock

Type coordinates on either side and the other updates instantly. Copy ready-to-use teleport commands and see the portal search range on a real-scale map.

Overworld

scale 1×
Teleport command
/execute in minecraft:overworld run tp @s 344 64 -1290

The Nether

scale 8×
Teleport command
/execute in minecraft:the_nether run tp @s 43 64 -162
Java Edition: searches 128 blocks around the target in the Overworld and 16 in the Nether, so precise builds link reliably.

Portal Search Range Map

Both panes show the same patch of your world, top down (X runs right, Z runs down), drawn at the true 8:1 scale. The Overworld pane spans 2,560 blocks; the Nether pane spans 320. The circle is the area the game scans for an existing portal. Any portal inside it can capture your teleport, which is exactly how mislinks happen. Click either pane to mark an existing portal and the map will tell you whether it would capture you.

overworld · center 344 / -1290 · 2,560 blocks across
nether · center 43 / -162 · 320 blocks across
Your positionPortal search range (128 blocks Overworld, 16 Nether)Existing portal (click a map to place)

How Nether Portal Linking Works

The Nether runs on an 8:1 coordinate scale. When you step through a portal, the game converts your X and Z (divide by 8 going in, multiply by 8 coming out), keeps your Y, and then looks for an existing portal near that converted point. If it finds one, you arrive there, whether or not it is the portal you built. If it finds nothing, it creates a brand new portal at the closest valid spot.

The search range is the whole story. On Java Edition the game scans 128 blocks around the target in the Overworld and 16 blocks in the Nether. Those two numbers cover the same ground once you account for the 8:1 scale, so linking behaves symmetrically. On Bedrock Edition the scan is 128 blocks in both dimensions, and 128 Nether blocks equals 1,024 Overworld blocks. That huge capture area is why Bedrock portals grab the wrong partner so much more often.

This calculator applies the exact rule the game uses internally: Nether X and Z are the Overworld values divided by 8 and rounded down (Java's Math.floor, so -1290 becomes -162, not -161). Y passes through untouched.

Why your portal takes you to the wrong portal

A mislink almost always means another portal sits inside the search circle of your converted target. The usual causes: two Overworld portals are close enough that their Nether targets land within 16 blocks of the same Nether portal, an auto-generated portal spawned offset from the ideal spot and now outcompetes your manually built one, or an old portal from a previous base was never removed. The game does not remember pairs. It re-runs the nearest-portal search on every trip, so the closest portal in range always wins.

How to fix a mislinked portal

1.Stand at the Overworld portal and press F3 (Java) or enable Show Coordinates (Bedrock) to read your X, Y, Z.
2.Enter those values in the calculator above to get the exact Nether coordinates.
3.Travel to that Nether X and Z and build a portal there yourself, then light it.
4.Break the wrong portal the game generated (or leave it if it now sits outside the search range of every target you use).
5.Test the link in both directions. Manually placed portals at converted coordinates always beat the search radius lottery.

Building correctly paired portals from scratch

The reliable pattern is simple: never let the game place a portal for you. Build the Overworld portal, convert its coordinates, then build the Nether portal at that converted X and Z before you ever step through. Keep Y levels roughly similar where the terrain allows it. Do this for every portal pair you own and mislinks become impossible, no matter how close together your bases are.

Java vs Bedrock Differences

MechanicJava EditionBedrock Edition
Search range, Overworld side128 blocks128 blocks
Search range, Nether side16 blocks128 blocks (1,024 Overworld equivalent)
Nether build heightUp to Y=255 (roof at Y=127 is accessible)Hard cap at Y=127, roof unreachable
Portals above the roofCan be built manually, never auto-generateNot possible
Coordinate conversionIdentical: X and Z divided or multiplied by 8, Y unchanged

The math in this calculator is the same for both editions. What changes is how forgiving the linking is: Java's tight 16-block Nether scan rewards precise builds, while Bedrock's giant capture area means you should always build both sides of a pair manually.

Overworld to Nether coordinates chart

Nether X and Z are the Overworld X and Z divided by 8, rounded down. Rounding down matters for negative coordinates: -100 becomes -13, not -12. Going back, Nether coordinates times 8 give the Overworld spot exactly.

Overworld X or ZNether X or Z
10012
25031
50062
1,000125
2,500312
5,000625
10,0001,250
20,0002,500
-100-13
-1,290-162
-5,000-625
Nether X or ZOverworld X or Z
1080
50400
100800
5004,000
1,0008,000
2,50020,000
-50-400
-500-4,000

Quick Reference

Nether distanceOverworld distanceNotes
18The base ratio
16128Java portal search range
1281,024Bedrock Nether search range
1,0008,000One ice highway segment

Portal spacing: if you build both sides of every pair manually, portals can sit a few blocks apart and still link correctly. If the game generates one side for you, keep Overworld portals at least 256 blocks apart on Java and at least 2,048 blocks apart on Bedrock so their search areas cannot overlap.

Gold farm spacing:portal-array gold farms rely on the same linking rules. Place the array so that no portal you actually travel through has its converted target within the search range of the farm portals: 128 Overworld blocks on Java, 1,024 on Bedrock. Convert the array's center with the calculator and check the map above to confirm your travel portals sit outside the circle.

Roof of the Nether: the bedrock roof sits at Y=127. Portals never generate above it, so the roof (Java only) is the safest place for long-distance travel and farms. A Nether portal built at Y=127 or below behaves normally; the calculator warns you if your Nether Y is above the cap.

Frequently Asked Questions

How do you calculate nether portal coordinates?

Divide your Overworld X and Z by 8 and round down. Going the other way, multiply Nether X and Z by 8. Y is not scaled. An Overworld portal at X=344, Z=-1290 pairs with a Nether portal at X=43, Z=-162. The calculator at the top of this page does both directions as you type.

Why did my portal create a new portal?

No existing portal sat inside the search range of your converted coordinates, so the game built one at the closest valid spot it could find. That spot can be offset by dozens of blocks, on a cliff or above lava. Build the destination portal yourself at the exact converted X and Z before traveling and the game will always use it.

Do Y coordinates matter for nether portals?

Y is never multiplied or divided, and X and Z dominate the portal search. A Nether portal at Y=12 happily pairs with an Overworld portal at Y=64. Keep Y levels loosely similar when convenient, and keep the Nether side below the bedrock roof at Y=127, since portals cannot generate above it.

How far apart should portals be so they do not link?

With both sides built manually, a few blocks of separation is enough. With auto-generated portals, keep Overworld portals at least 256 blocks apart on Java, which puts their Nether targets more than 16 blocks apart, and at least 2,048 blocks apart on Bedrock, where the 128-block Nether scan covers 1,024 Overworld blocks.

Browse more Minecraft tools: