Article — Nether Portal Calculator
The Minecraft Nether Portal Coordinate Calculator
Minecraft uses an 8:1 coordinate ratio between the Overworld and the Nether. Move 1 block in the Nether and you cover 8 blocks of Overworld surface. To build a portal in the Nether that links to a specific Overworld portal, divide the Overworld X and Z by 8 (the Y axis is preserved). To go the other way, multiply by 8. The calculator above does both directions automatically, with the same flooring math the game uses internally.
The Nether's compressed coordinate space is the whole reason long-range Minecraft transit works. A 1000-block walk through the Nether covers 8000 blocks of Overworld — fast enough to reach a base 10 minutes away on foot in under 90 seconds. This guide walks through the ratio, the linking math, the mistakes that cause portals not to link, and how to plan a transit network that scales.
The Nether portal 8:1 ratio
Every block of movement in the Nether covers 8 blocks of Overworld on the X and Z axes. The Y axis (vertical) does not scale — a portal at Y=64 in the Overworld targets Y=64 in the Nether. The formula is simple:
- Overworld to Nether: divide X and Z by 8 (and floor)
- Nether to Overworld: multiply X and Z by 8
- Y axis: unchanged in both directions
- Speed advantage: 8× faster transit between distant bases
An Overworld portal at (800, 64, -400) targets a Nether portal at (100, 64, -50). The Nether coordinates are 800/8 = 100, the same Y=64, and -400/8 = -50. Build a Nether portal at exactly that point and the two will link.
The Nether is much smaller than the Overworld. The Overworld world border is at ±30 million blocks. The Nether's equivalent reach is ±3.75 million Nether blocks — the same Overworld span, compressed by 8×. The world is the same; only the coordinate system shrinks.
How Nether portal linking actually works
When you step through a portal, the game runs an algorithm to find the destination:
- Compute the target coordinates in the other dimension using the 8:1 ratio (or 8:1 reverse).
- Search a 128-block cube in the Nether (or a 1024-block cube in the Overworld) around the target.
- If an existing portal is found within that search radius, link to the closest one.
- If no portal is found, the game creates a new one at the target coordinates (or the nearest safe spot).
That last step is why builders sometimes find that the game creates a new portal in an unexpected place. If the target coordinates fall inside lava, in a wall, or in some other unsafe spot, the game searches nearby for a buildable location. The result can be a portal on a cliff edge, halfway up a wall, or in the middle of a fortress room.
The search-radius rule also explains another classic mistake: building a second portal near the calculated target but not exactly on it. If a different portal is closer to the target than yours, the game will link to that other portal instead, and your new portal will create yet another portal on the far side.
Building Nether portals
The portal frame is made of obsidian. The minimum size is 4 blocks wide × 5 blocks tall (or 5 × 4). The maximum is 23 × 23. Most players build the minimum because larger frames work identically and cost more obsidian.
The frame itself can be built with or without corner blocks. In Java Edition, corners are optional — the game completes the rectangle when the portal is activated. The minimum obsidian count for a 4×5 portal without corners is 10 blocks (4 on the bottom + 4 on the top - wait, no: 3 on bottom + 3 on top + 4 on each side - corners = 10 blocks). With corners, the count is 14.
To activate, place flint and steel inside the frame. Fire charges work too, as does using a lava bucket on the bottom blocks. Any source of fire inside the frame ignites the portal.
Carry a diamond pickaxe to mine obsidian (10 seconds per block with diamond, much longer with iron). Each portal costs 14 obsidian for the full frame — 168 seconds of mining at diamond speed. Plan obsidian quantities before long expeditions.
Reading Minecraft coordinates
Open the F3 debug screen in Java Edition (or the coordinates option in Bedrock Edition settings) to see your current XYZ position. The values mean:
- X: east-west position. East is positive, west is negative
- Y: vertical position. Sea level is Y=63 (Java) or Y=62 (Bedrock); bedrock floor is Y=-64
- Z: north-south position. South is positive, north is negative
- Origin: world spawn is near (0, 64, 0)
The 8:1 ratio applies only to X and Z. Y stays the same between dimensions. A portal at (1000, 70, -500) in the Overworld targets (125, 70, -63) in the Nether — Y=70 in both, X scaled from 1000 to 125, Z scaled from -500 to -63 (floored).
Common Nether portal mistakes
The most frequent issue is two portals close together on one side, fighting for the same portal on the other side. If your Overworld portals are within 1024 blocks of each other on any axis, the game can link both to the same Nether portal. Plan transit networks with 1024+ block spacing.
Other frequent issues:
- Off-by-floor: divide-by-8 must be floored. Overworld X=799 maps to Nether X=99 (not 99.875)
- Forgetting Y: Y must match for portals to link. A portal at Y=64 will not link well to one at Y=120 even with correct X and Z
- Building near existing portals: a nearby portal in the search radius will steal the link from your new one
- Auto-created portals: travelling without building first lets the game create portals in surprise locations — sometimes inside structures or on cliffs
- Bedrock vs Java differences: some edge cases differ between editions; corner blocks are required in Bedrock
Building a Nether transit network
For a multi-portal Nether highway, follow three rules:
- Space Overworld portals at least 1024 blocks apart on the X or Z axis.
- Build each Nether portal at exactly the calculated target of its Overworld partner.
- Confirm the link before assuming. Walk through, check the destination, walk back, check the return.
For long-distance hubs, build a central Nether spawn with multiple portals leading to different Overworld bases. The 8× speed advantage means that even a 5000-block Overworld base is only 625 Nether blocks from spawn — under 60 seconds of running.
Nether portal edge cases
A few quirks worth knowing:
- Portals inside the Nether ceiling (Y > 128) can target Overworld coordinates that do not exist as sky — the game will spawn the return portal at the highest valid Y
- Ghasts can shoot fireballs at obsidian portals, but obsidian itself is indestructible
- Two portals built simultaneously by different players can race the linking algorithm — whichever player traveled first locks the link
- Nether portals do not propagate signals, redstone, or items unless using hopper/dropper trickery on the entry side
- Falling through a portal into the Nether preserves momentum but not exact Y — the game searches for the nearest safe Y
A short history of the Nether portal
The Nether portal was added to Minecraft in Alpha 1.2.0 (Halloween Update) in October 2010. The 8:1 ratio was set at the same time and has never changed. Notch (Markus Persson) designed the dimension partly as a hellscape (the Nether bears strong influence from Doom), partly as a fast-travel mechanic.
The Halloween Update also added pumpkins, jack-o-lanterns, and the original Nether mobs (ghasts, zombie pigmen). The Nether Update (June 2020) added the four biomes (crimson forest, warped forest, soul sand valley, basalt deltas) and the netherite tier, but kept the portal math identical. Fourteen years of Nether-based long-distance travel runs on the same 8:1 rule.