Nether portal calculator and link checker
Game data: Minecraft Java Edition 26.3 and Bedrock Edition
Find where to build the matching portal, then check your whole portal network for portals that will link to the wrong one.
1. Convert coordinates
2. Check which portals link
One portal per line: an optional name, then X Y Z. Use the coordinates of a portal block (stand in the portal and read F3). Commas are fine.
How the conversion works
One block walked in the Nether covers eight blocks of the Overworld, but only sideways: height is not scaled. "Rounded down" means towards negative infinity, so −37.5 becomes −38, not −37. That detail is why some calculators put portals with negative coordinates one block off.
How the game picks a portal
When you step into a portal, the game converts your position to the other dimension and looks for existing portal blocks around that point. It searches a square, not a circle, through the full height of the world:
| Arriving in | Java: blocks each way | Bedrock: blocks each way |
|---|---|---|
| Overworld | 128 | 128 |
| Nether | 16 | 128 |
If it finds portal blocks, it takes the closest one by straight-line distance, including height. If it finds none, it builds a new portal near the converted point (within 16 blocks sideways). This is why two Overworld portals a hundred blocks apart can both lead to the same Nether portal: 100 Overworld blocks is only 12.5 Nether blocks, well inside the 16-block search.
Worked example: a farm portal that goes to the wrong place
Your home portal is at 1000, 70, −500 in the Overworld. Its Nether point is 1000 ÷ 8 = 125 and −500 ÷ 8 = −62.5, rounded down to −63, so you build its partner at 125, 70, −63.
Later you build a farm portal at 1100, 64, −500, but don't build anything in the Nether. Its Nether point is 1100 ÷ 8 = 137.5 → 137, and −63 again: 137, 64, −63. The home Nether portal is 12 blocks away along X, inside Java's 16-block search, and about 13.4 blocks away in a straight line, so the farm portal takes you to your home Nether portal. Coming back, you arrive at home, not the farm.
The fix is to build the farm's own Nether portal at 137, 64, −63 before you use it. Now each portal is the closest one to its partner's converted point, and both pairs link both ways. The checker above starts with this example; add Farm: 137 64 -63 to the Nether list to see it fixed.
Tips for a portal network that behaves
- Build the Nether side yourself at the exact converted coordinates before the game builds one for you.
- Portals at least 136 blocks apart can't interfere (in Java). 136 Overworld blocks is 17 Nether blocks, just outside the 16-block search, and 17 Nether blocks back is 136 Overworld blocks, outside the 128-block search. Closer is fine, but then each Nether portal must be at its exact converted point.
- Watch the height. The game counts Y in its distance, so a Nether portal that is close sideways but 60 blocks higher can lose to one further away at the right height.
- Big portals have many blocks. The game measures to the nearest portal block, not the portal's centre. For large portals, check with the block nearest the other portal.
- Bedrock searches much further in the Nether (128 blocks, not 16). An Overworld portal without its own Nether partner can grab any Nether portal up to 128 blocks from its converted point, which is 1,024 Overworld blocks. On Bedrock, always build each Nether portal yourself, exactly at its converted point, so it is the closest one.
What this checker leaves out
It treats each portal as one block, assumes nothing blocks the search (it doesn't know about chunks or the world border), and doesn't model where a brand-new portal would actually be placed, which depends on the terrain. For checking your own network, that's usually enough; if a result surprises you, enter the portal block closest to the other portal.
Sources: game behaviour as documented in the Minecraft Wiki "Nether Portal" article (portal search and coordinate conversion), checked 21 November 2026 for Java Edition 26.3 and current Bedrock Edition.