nocware

nocware › Blog › How Nether Portal Linking Works

How Nether Portal Linking Works

The three rules the game uses to match portals, and how to place yours so they always link where you want.

A lit Nether portal made of obsidian on a netherrack background, with flint and steel, a compass, an ender pearl and a lava bucket
Quick answer
  • Divide your Overworld X and Z by 8 to get the Nether spot. Multiply by 8 to go back.
  • Y doesn't change.
  • The game sends you to the closest portal it can find near that spot. That's why portals mislink.

Came out of the Nether 100 blocks from your base? Two portals spitting you out of the same place? It's not random. The game follows three simple rules.

Nether Portal CalculatorConvert Minecraft Overworld coordinates to Nether coordinates and back, so your portals link to the right place every time

Rule 1: divide by 8

1 block in the Nether = 8 blocks in the Overworld. This only applies sideways (X and Z).

OverworldNether
X 800, Z -1200X 100, Z -150
X 250, Z 333X 31, Z 41
X -1203, Z 40X -151, Z 5
Negative numbers round down-1203 ÷ 8 = -150.375, which rounds to -151, not -150. Easy to get wrong by one block.

Rule 2: height stays the same

A portal at Y 70 looks for a partner around Y 70 in the other dimension.

The game does search the whole height of the world. But it measures distance in 3D, so a portal at a closer height can win even if it looks further away on your map.

Rule 3: closest portal wins

When you step through, the game converts your coordinates, searches the area around that spot, and sends you to the nearest portal.

128blocks searched in the Overworld (Java and Bedrock)
16blocks searched in the Nether on Java
128blocks searched in the Nether on Bedrock

So if two Overworld portals are within 128 blocks of each other, a Nether portal might send you to the wrong one.

No portal in range? The game builds a new one for you, wherever it finds space. That's how you end up on a random ledge.

How to link portals properly

  1. Stand in your first portal and note your X, Y and Z (F3 on Java, or turn on "Show coordinates" on Bedrock).
  2. Convert X and Z: ÷ 8 going into the Nether, × 8 coming out. Keep Y.
  3. Go to those coordinates in the other dimension and build the second portal yourself. Don't trust the auto-made one.
  4. Break any spare portals the game made. Leftovers cause most mislinks.
  5. Test it both ways. Go through and back, and check you land where you expect.

Portal still linking wrong?

ProblemFix
Two Overworld portals use the same Nether portalBuild a separate Nether portal for each, more than 16 blocks apart on Java
Nether portal sends you to the wrong Overworld portalAnother portal is closer. Move it, or rebuild yours on the exact converted coordinates
A brand new portal keeps appearingYour portal is out of range. Recheck the maths, especially negatives
Two portals in range, wrong one winsRebuild at a matching Y level
Frame size doesn't matterThe smallest portal is 4 wide by 5 tall (10 obsidian if you skip the corners), and the biggest is 23 by 23. Size doesn't change where it links.
Playing Hardcore?An auto-made portal can drop you on a ledge over lava. Build your Nether-side portal on purpose, then light up and wall in the area around it before you leave.

Cheat sheet

  • ÷ 8 for X and Z, round down. Keep Y.
  • Build the second portal yourself.
  • Java: Nether portals over 16 blocks apart, Overworld portals over 128 blocks apart.
  • Bedrock: over 128 blocks apart in both dimensions.
  • Delete spare portals.
Nether Portal CalculatorConvert Minecraft Overworld coordinates to Nether coordinates and back, so your portals link to the right place every time

More guides

All guides →

Free Minecraft tools

See all 30 tools →

Made by nocware, a Hardcore Minecraft streamer. One life, live Mon, Wed and Fri at 6pm UK.