PortalLinked

Return through your Nether portal to the base you left.
PortalLinked is a server-side mod for Fabric, NeoForge and Forge that remembers each player's Nether portal pair. When nearby Overworld portals lead to the same Nether portal, each player can return to their own starting portal.
How it works
- Enter the Nether through your Overworld portal.
- PortalLinked remembers the source portal and the portal you arrive at.
- Return through that arrival portal to reach your original portal.
Personal links let players share a Nether portal without sharing the same return destination. A successful crossing establishes a fresh pair.
Nether travel still works normally. Build and enter a different portal to explore a new route. Normal Minecraft portal searching, portal generation and the 1:8 Overworld-to-Nether coordinate scale remain available. If a remembered exit is destroyed, extinguished, resized, blocked or excluded in the configuration, normal portal routing takes over.
Features
- Personal portal pairs for each player.
- Links saved with normal player data and retained across normal server restarts.
- No external database required.
- Configurable dimension exclusions and diagnostic logging.
- Administrator commands to reload settings and clear individual links.
- Normal End portal, mob and item behavior.
Installation and compatibility
Download the file matching your exact Minecraft version and loader, place it in the server's mods/ folder, then restart the server. Replace older PortalLinked copies when updating.
Mod builds cover 1.7.10, 1.8.9, 1.12.2, and releases from 1.16.5 through 26.3. Loader availability varies by version; check the file's version and loader tags or the exact support matrix.
PortalLinked is not required on clients. Fabric API is not required. Forge 1.7.10 requires a matching Forge/FML client for the server's login handshake, even though the PortalLinked mod itself is only needed on the server.
For Paper, Spigot, Purpur or Folia, use the separate PortalLinked plugin.
Configuration
The mod creates config/portallinked.json:
{
"enabled": true,
"excluded-worlds": [],
"debug": false
}
enabled: enable personal linking. Disabling it preserves saved pairs while normal portal travel continues.
excluded-worlds: dimension identifiers, such as minecraft:the_nether. If either endpoint is excluded, personal routing and recording are skipped.
debug: enable diagnostic logging.
Keep all three settings and the value types shown above. Invalid reloads retain the previous active configuration and saved links.
Administrator commands
/portallinked reload — reload the configuration.
/portallinked status — display active settings.
/portallinked forget [online-player] — clear the selected player's remembered pair; omit the name to clear your own.
Commands require operator level 2.
Forge 1.8.9 note
One manual return after a server restart reached a neighboring portal despite a saved pair, alongside a native movement rollback. Later manual and controlled network repeats returned correctly, but the original cause remains unestablished.
Source and license
Created by EyeCrasher. Open source under GPL-3.0-only.
Source code · Report an issue · Releases and corresponding source