How the Nether coordinate ratio works
The Nether compresses horizontal distance at a 1:8 ratio: traveling one block in the Nether moves you eight blocks in the Overworld. To find where an Overworld portal should link, the game divides X and Z by 8 and keeps Y unchanged. Going the other way, it multiplies X and Z by 8. Division rounds down, so an Overworld portal at X=100 becomes X=12 in the Nether, while X=-100 becomes X=-13.
This calculator applies the same conversion the game uses, so the target it shows is the point where Minecraft starts looking for an existing portal — and where a new one appears if none is found.
How to use the Nether Portal Calculator
- Pick the direction.Choose Overworld → Nether to divide by 8, or Nether → Overworld to multiply by 8. Y passes through unchanged in both directions.
- Enter your portal coordinates.Use the F3 debug screen (Java) or the map coordinates (Bedrock) at your existing portal's base.
- Build at the target.Place the Nether-side portal at the converted coordinates before lighting the other side, and the pair links exactly where you planned.
- Copy the helpers.The tool gives the teleport command for reaching the spot and fill commands for the obsidian frame, ready for the chat or a function file.
Portal linking rules in Java and Bedrock
When you step through a portal, the game converts the coordinates and searches the destination for the nearest existing portal. The search window differs by edition and direction:
| Travel direction | Java Edition search | Bedrock Edition search |
|---|---|---|
| Overworld → Nether | 16-block radius (32×32 area) | 128-block radius (256×256 area) |
| Nether → Overworld | 128-block radius (256×256 area) | 128-block radius (256×256 area) |
The search covers the full height of the destination, and the chosen portal is the closest by straight-line 3D distance including Y. That is why two Overworld portals within 16 blocks of each other's Nether target can grab each other's links: whichever existing portal sits closest in 3D distance wins.
How to link a portal pair correctly
- Calculate the target.Convert your Overworld portal's coordinates; note the exact X and Z in the Nether.
- Build the Nether side first.Teleport to the target, clear a 4×5 area, and build the frame there — the copyable fill commands place the frame with its first block exactly on the target.
- Light it and step through.Traveling back to the Overworld, the search looks within 128 blocks of your original portal, so it returns you to the right place.
- Break strays.If the game auto-created an unexpected portal near the target, mine it and relight your intended one; otherwise it keeps capturing the link.
For command blocks and datapacks, the give command generator handles item commands with the same version awareness, and the text generator formats server messages for your portal hub announcements.
Frequently Asked Questions
How do I convert Overworld coordinates to Nether coordinates?
Divide X and Z by 8 and keep Y unchanged; division rounds down, so X=100 becomes X=12 and X=-100 becomes X=-13. The calculator applies the same conversion the game uses when linking portals.
Why did my portal link to the wrong place?
Another existing portal was closer to the converted target by 3D distance, including Y. Build your intended Nether-side portal first at the calculated coordinates, and break any stray portal the game auto-created nearby.
How far apart should Overworld portals be?
In Java Edition, two Overworld portals that convert to targets within 16 blocks of each other in the Nether can share a link, so keep them at least 128 Overworld blocks apart in both X and Z. Bedrock Edition searches 128 blocks around the target in both dimensions.
Does the Y coordinate change in the Nether?
No. Y passes through unchanged in both directions, but it still counts toward the 3D distance the game uses to pick the closest portal, so matching heights between paired portals makes links predictable.
KEEP BUILDING