Nether Portal
Calculator

1. Find your current position. In Java Edition, press F3 and read the XYZ line. In Bedrock Edition, enable Show Coordinates in world settings.
2. Choose the source dimension at the top of the calculator, then select Java or Bedrock. The edition changes linking guidance only, never the X and Z math.
3. Type or paste X, Y, and Z. Decimals are floored to the block you are standing in. Y is optional and is never divided or multiplied by 8.
4. Read the ideal target X and Z for the other dimension, then copy the block coordinates or a share link.
5. Check the real link in game. Walk to the target, build or light the portal, and confirm which portal the game actually connects before building around it.

Block coordinates and exact portal placement are different things. The calculator plots the ideal horizontal position; the game still searches nearby chunks for an existing portal and may place a new portal at a suitable site instead.

Divide the Overworld X and Z by 8, then floor the result to a block coordinate. Y stays the same as a reference height.

X_Nether = floor(X_Overworld / 8)  ·  Z_Nether = floor(Z_Overworld / 8)

Worked examples

• (800, 64, -400) becomes (100, 64, -50).
• (-9, 70, 9) becomes (-2, 70, 1).

The second example is the one players get wrong. -9 divided by 8 is -1.125, and Minecraft floors toward negative infinity, so the block is -2, not -1. The same applies to Z.

Multiply the Nether X and Z by 8 to get the Overworld position. Y is again unchanged.

X_Overworld = 8 × X_Nether  ·  Z_Overworld = 8 × Z_Nether

Worked examples

• (100, 64, -50) becomes (800, 64, -400).
• (-2, 70, 1) becomes (-16, 70, 8).

Round trips are not perfectly reversible. Overworld X 7 floors to Nether X 0, and 0 multiplies back to Overworld 0, not 7. That is expected floor behavior, not a bug. Plan from block positions and expect a small margin when exact matching matters.

The calculated target is an ideal position. The game does not teleport you to the nearest block of it. When you enter a portal, Minecraft converts your entry block position, then searches for existing portal points of interest near that converted spot. If it finds one, it picks the closest by 3D Euclidean distance, including Y. If it finds none, it generates a new portal at a suitable nearby location.

Documented candidate search areas

These are square, axis-aligned candidate areas, not a circular "link radius". They describe where the game looks; they do not prove that a link will happen. Boundary details can also differ by version, so verify behavior for the version you play.

Want to build a purposeful pair? Learn how to link two Nether portals with a step-by-step workflow, negative-coordinate examples, and a two-way verification checklist.

Already know several active portals? Check which existing portal your trip is likely to use in the link checker. It compares entered portals by edition-specific search area and 3D distance, including the return trip.

A connection that already goes wrong needs a different task.Fix a Nether portal that goes to the wrong place with the symptom checks, height comparison and round-trip diagnosis.

One Nether block of horizontal movement covers eight Overworld blocks. Walk 100 blocks along an axis in the Nether and you have effectively crossed 800 blocks of Overworld distance.

That ratio is the whole trick. It does not promise a fixed travel time, because terrain, tunnels, mobs, and your route all change the trip. It also does not apply vertically, so a Nether shortcut is a horizontal shortcut only.

Ready to connect two locations? Plan a Nether highway between two locations with Nether endpoints, X/Z tunnel directions, corridor materials, and illustrative travel times.

• Dividing Y by 8. Y is a reference height. Only X and Z use the 8:1 ratio.
• Truncating negatives toward zero. Use floor: -9 / 8 becomes -2, not -1. The calculator already does this.
• Assuming matching coordinates guarantee a two-way link. The game searches for existing portals and picks by 3D distance. Existing portals can override the ideal target.
• Ignoring the entry portal block. A two-block-wide portal has more than one possible entry position. Which block you touch can change the converted target.
• Expecting the displayed Y to be the generated portal's Y. A new portal may be placed at a different height and location that is suitable for the terrain.
• Treating the Nether roof as mandatory. Roof placement is a common highway technique, not a requirement for a normal working portal.

If a portal exits somewhere unexpected, compare the actual destination with the ideal target, then look for another active portal inside the candidate search area. That overlap is the most common cause of a surprising link.

The converter floors input positions to block coordinates, divides or multiplies X and Z by 8, and floors again when moving into the Nether. Y is copied as a reference and never scaled. Empty X or Z values are errors. Empty Y is treated as unknown, not zero.

Input is limited to the documented world border range. Decimal positions are floored with Minecraft-style floor behavior, and invalid or unsafe values are rejected instead of being displayed as NaN or Infinity.

Read the full methodology for equations, worked cases, validation rules, and the actual test procedure.

Game mechanics sources

• Minecraft Wiki: Nether Portal— Frame dimensions, obsidian counts, and the 8:1 dimensional ratio.
• Minecraft Wiki: Nether portals tutorial— Portal linking behavior, candidate search areas, and edition differences.
• Minecraft Wiki: Nether survival tutorial— Portal construction examples, minimum frame, and ruined-portal repair.
• Minecraft Wiki: Crying obsidian— Crying obsidian cannot replace the functional frame edges.
• Minecraft Wiki: Ruined portal— Ruined structures may contain crying obsidian and need repair before use.
• Minecraft Wiki: Point of Interest— Portal blocks as points of interest used by the game search.
• Minecraft Wiki: Nether hub tutorial— Converting endpoints and building routes between Nether portals.
• Minecraft Wiki: Player movement— Nominal walking and sprinting movement speeds.
• Minecraft Wiki: Blue Ice— Blue-ice boat transport reference and top-speed context.
• Minecraft Wiki: Transportation methods— Packed-ice and blue-ice boat transport comparisons.

Minecraft Wiki is a community-maintained reference, not official Mojang documentation.