Minecraft Portal Linking Calculator (Java)
Enter your Overworld and Nether portals to see which portal each one leads to, and fix portals that link to the wrong place. The game looks for an existing portal within ±16 blocks in the Nether and ±128 blocks in the Overworld.
Runs on your device · nothing uploaded
This tool is code that runs inside your browser. Your files, text and pictures are read here and never sent to a server, so it even works offline once loaded. Signed in? Only what you save to your account (My Kit, wardrobe) or publish is uploaded.
Where each portal takes you
- Base (Overworld) aims at Nether X 100, Z -200 → links to Base hub (0 blocks from the aim point).
- Village (Overworld) aims at Nether X 125, Z -188 → no portal within ±16 blocks, so the game builds a new one near X 125, Z -188.
- Base hub (Nether) aims at Overworld X 800, Z -1600 → links to Base (0 blocks from the aim point).
Green dots: Overworld portals shown at their Nether spot (÷ 8). Red squares: Nether portals. Dashed boxes: the ±16-block area the game searches in the Nether.
.
How far the game searches
| Going to | Search area | Matching spot |
|---|---|---|
| The Nether | ±16 blocks (X and Z) | Overworld X, Z ÷ 8 |
| The Overworld | ±128 blocks (X and Z) | Nether X, Z × 8 |
Java Edition 1.16+. Bedrock searches a different area, so links can differ there.
How to use it
- Add each Overworld portal with its X, Y and Z (stand in it and press F3).
- Add each Nether portal the same way.
- Read where each portal leads; a warning means the game would build a new portal.
- Move or rebuild a Nether portal to the aim point shown so the pair links both ways.
How it works
When you enter a portal, Java 1.16 and newer works out the matching spot on the other side (Overworld X and Z ÷ 8, or Nether × 8, rounded down) and looks for portals in a square 33 blocks wide around it in the Nether, or 257 blocks wide in the Overworld, at any height. It picks the closest one; if there is none, it builds a new portal nearby. Because the Overworld search is so wide, two Overworld portals close together often both lead to the same Nether portal.
Questions
Why does my portal take me to the wrong portal?
Another portal is closer to the matching spot than the one you wanted. Build the Nether portal exactly at Overworld X ÷ 8, Z ÷ 8, and keep other portals more than 16 blocks away in the Nether.
Why did the game make a new portal?
No existing portal was inside the search area. Build your own portal at the aim point the tool shows, then break the extra one.
Does the Y level matter?
Not for which portals are found: the search covers the whole height. Among portals in the area, the closest in 3D wins, so height can break ties.
How do I link two portals that are close together?
Space them at least 128 blocks apart in the Overworld, or give each its own Nether portal at its exact ÷ 8 spot so each finds its own partner first.
Is it the same on Bedrock?
The ÷ 8 rule is the same, but Bedrock searches a different area, so check links in game.
Related tools
By PickaxeKit Editorial Team. Updated 2026-11-09.