Portal Cornerlink (Orientation Fix)

Extended Description (Modrinth)

Portal Cornerlink – Orientation Fix is a fix-only downstream fork of Corner Portal Linking, focused on restoring correct Nether portal exit behavior while preserving the original corner-based portal matching mechanics.

Why this fork exists

In vanilla Minecraft 1.21.5+, Nether portal traversal preserves an entity’s orientation and velocity when exiting a portal.
However, in Portal Cornerlink (and its upstream forks), custom portal handling unintentionally reintroduced older behavior where:

Players exit portals facing the portal frame instead of their original direction

Entity velocity is reset or rotated

Minecart-based portal systems derail or fail entirely

This fork restores vanilla-compatible teleport behavior while keeping Portal Cornerlink’s matching logic intact.

What this fork fixes

Correct portal exit orientation
Players now exit portals facing the same direction they entered, matching vanilla behavior.

Velocity preservation across portals
Entity velocity is no longer reset or reoriented during portal traversal.

Minecart and rail compatibility
Rail-to-portal and portal-to-rail systems work correctly again, including standard minecart-based Nether portal chunk loaders.

These fixes are purely behavioral correctness fixes — no new mechanics are introduced.

What this fork does NOT change

❌ No changes to corner-matching rules

❌ No new portal mechanics

❌ No chunk loading logic added

❌ No gameplay balance changes

If no glazed terracotta corner blocks are present, vanilla Nether portal behavior is preserved.

How Portal Cornerlink works (unchanged)

Place any colored glazed terracotta at the four corners of a Nether portal

On the destination side, portals with matching corner block patterns will link together

Corner orientation does not matter — mirrored portals still match

Portals without corner blocks follow vanilla linking rules

Compatibility notes

Nether portal chunk loaders

This fork restores vanilla entity orientation and velocity handling when traveling through Nether portals.
As a result, existing minecart-based Nether portal chunk loader designs function correctly again.

This mod does not add or modify chunk loading mechanics — it restores the behavior that those designs rely on.

Lineage and attribution

Original mod: Corner Portal Linking by starbidou

Upstream fork: Maintained by dake (Minecraft 1.21.x update and performance improvements)

This fork: Maintained by deka, focused on portal exit correctness (orientation and velocity)

This project is not affiliated with the original author or upstream maintainers.

License

Licensed under the GNU Lesser General Public License v2.1 (LGPL-2.1).

You are free to use, modify, and redistribute this mod under the same license, provided that the corresponding source code remains available.

Who should use this fork?

Players using rail-based Nether portal systems

Technical players relying on minecart portal chunk loaders

Servers that want Portal Cornerlink behavior without breaking vanilla portal traversal

Anyone experiencing incorrect facing direction after portal travel

If you do not rely on entity direction or velocity through portals, the difference may not be noticeable.