Skip to content

Nether Portal Linking Explained

JavaBedrock

A Nether portal links to the nearest existing portal within a search area around its scaled position, which is simple until two portals share an area. The rule, the arithmetic and the fixes, with the portal calculator doing the sums.

Updated · 6 min read · Java & Bedrock up to 26.3

Ruined portal finder for seed -1234567890123 centred on the portal at 32, 96
Seed −1234567890123, Java 26.3: the ruined portal 93 blocks from spawn.

The 1:8 rule

One block of travel in the Nether equals eight blocks in the Overworld along X and Z; Y is not scaled. When you enter a portal at Overworld 1600, 70, -800, the game looks for a portal around Nether 200, 70, -100, and when you come back from Nether 200, 70, -100 it looks around Overworld 1600, 70, -800. The portal calculator does the division and multiplication for any coordinate and shows the search area described below.

The Nether portal calculator with 1600, 70, -800 entered, showing the Nether coordinates 200, 70, -100 and both search areas
The portal calculator with 1600, 70, −800 typed in. It gives the Nether coordinates, the 16-block search square there, the 128-block return square, and says whether the pair links both ways.

Because of the scale, the Nether is the fast way across the Overworld: a 2,000-block trip to a stronghold becomes 250 blocks, and an ice road or a flying machine in the Nether moves you across a whole continent in minutes. Most portal problems come from forgetting that the search area is also scaled: 128 blocks in the Overworld is only 16 in the Nether.

How the game picks a portal

When you step through a portal, the game scales your position to the other dimension and searches for an existing portal block within 128 blocks horizontally in the Overworld, or 16 blocks in the Nether, across the whole height of the dimension. If it finds one, you arrive there, at the closest portal if several qualify. If it finds none, it builds a new portal near the scaled position, preferring a spot with solid ground and space, and failing that, carving one out of the terrain.

The search uses straight-line distance including height, so a portal 100 blocks up on the Nether roof can lose to a portal at a lower Y that is slightly further away horizontally. Two Overworld portals less than about 128 blocks apart will usually share one Nether portal, because their scaled positions are within 16 Nether blocks of each other, inside the search area of whichever Nether portal was built first.

Pixlriffs links portals to two farms in his 1.20 Survival Guide and walks through how portals search for each other, including one that ends up linking to two places by accident. Pixlriffs on YouTube

Building a matched pair

  1. Build the Overworld portal and note its coordinates from F3 or the map. Say 1600, 70, -800.
  2. Divide X and Z by eight: 200, -100. Keep Y similar if you can, or choose a Y in the Nether that is convenient, between 30 and 120.
  3. Go through the portal once. The auto-generated Nether portal will be near 200, -100; if it is within a few blocks, keep it. If not, build a new portal at those coordinates and break the old one.
  4. Light the portal and go back. You should arrive at your original Overworld portal. If you arrive elsewhere, another Overworld portal within 128 blocks of 1600, -800 won the search.
  5. Drop markers on the seed map for both portals, in both dimensions. Future portals then go where the markers say they can.

The calculator shows both search areas as block ranges, and a planned portal that overlaps an existing one shows up before you spend the obsidian.

Ruined portals: free obsidian and a head start

Ruined portals have generated in the Overworld and the Nether since 1.16, on a 40×40-chunk grid in the Overworld and a 25-chunk grid in the Nether, so one is rarely more than 600 blocks away. Each has a partly built frame, often with a few obsidian blocks missing, and a chest with flint and steel, obsidian, gold items and sometimes an enchanted golden apple. Repairing one is the fastest way into the Nether on a fresh seed.

The ruined portal finder shows every ruined portal in both dimensions. Seed -1234567890123 has one 93 blocks from spawn at 32, 96; seed 0 has one at -352, 96. A ruined portal on the Nether side is also a landmark, since it is the only structure that generates at a known grid in the Nether besides fortresses and bastions.

Structure popup for the ruined portal at 32, 96 on seed -1234567890123, with a Nether coordinates button and the chest loot listed
The ruined portal popup on −1234567890123: 93 blocks from spawn, a button with the Nether coordinates 4, 12, and the chest contents the engine predicts, which matched the game chest for chest in our tests.
Seed -1234567890123 ruined portalJava 26.3 · a ruined portal 93 blocks from spawn, obsidian and a chest included

A Nether hub that stays organised

Once you have more than two portals, give the Nether side a hub: one central room near the spawn portal's Nether position with tunnels leading to each destination's scaled coordinates. Keep the tunnels at one Y, build portals at x ÷ 8 and z ÷ 8, and label them. Use the seed map's Nether view to check that no tunnel runs into a fortress or a bastion you would rather not meet: on seed 123456789 the fortress at -160, -304 and the bastion at 320, 16 are both within a few hundred blocks of spawn ÷ 8.

Nether view of seed 123456789 around the spawn portal position with the fortress at -160, -304 and the bastion at 320, 16
The Nether on 123456789 around the portal position: fortress at −160, −304, bastion at 320, 16 and a Nether ruined portal in between. Plan the hub tunnels around these.

Bedrock follows the same 1:8 scale and search rules, with portals of any size between 4×5 and 23×23. The calculator applies to both editions; only the structure positions around your hub differ, and the map shows Bedrock's own fortress and bastion positions when you choose the edition.

Questions

How do I calculate Nether coordinates?

Divide the Overworld X and Z by eight; Y stays the same. The portal calculator does it and shows the area the game will search for an existing portal.

How far apart can two Overworld portals be before they share a Nether portal?

Their scaled positions must be more than 16 Nether blocks apart to be safe, which is 128 Overworld blocks, and in practice build Nether portals by hand when Overworld portals are closer than about 300 blocks.

Why did the game build a new portal instead of linking?

No portal block was within 128 blocks (Overworld) or 16 blocks (Nether) of the scaled position, in three dimensions. Build the Nether portal within a few blocks of the calculated coordinates.

Does the Y coordinate matter for linking?

Yes. The search measures straight-line distance including height, so portals far apart vertically can fail to link even if their X and Z match. Keep paired portals at similar heights when you can.

Can I use a ruined portal as my main portal?

Yes. Repair the frame with obsidian from its chest or your own, light it, and treat it like any portal. Its position decides where the Nether side appears, so check the calculator first.

Written by the Minecraft Tools team from the same world-generation engine that runs the seed map. Coordinates quoted here were computed with it for the stated seed, edition and version, and the engine is tested against the real game.