Prime Mover Game Tools

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

Overworld → Nether: X ÷ 8 and Z ÷ 8, rounded down. Nether → Overworld: X × 8 and Z × 8. Y stays the same.

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 inJava: blocks each wayBedrock: blocks each way
Overworld128128
Nether16128

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

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.