Back to mods
PortalLinked project artwork

CurseForge · Minecraft mod

PortalLinked

PortalLinked remembers each player’s Nether portal pair, ensuring return trips through the same portal lead back to where they started. (fix)

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which PortalLinked release should I use?

Updated 2 days ago
Latest stable file portallinked-neoforge-1.2.0+26.2
Game version 26.2
Loader NeoForge

portallinked-neoforge-1.2.0+26.2 targets 26.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is PortalLinked required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does portallinked-neoforge-1.2.0+26.2 need?

portallinked-neoforge-1.2.0+26.2. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add PortalLinked without breaking your instance.

Built for portallinked-neoforge-1.2.0+26.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use portallinked-neoforge-1.2.0+26.2. It targets 26.2 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside portallinked-neoforge-1.2.0+26.2. It opens that exact file at the source.

About this project

What does PortalLinked add?

PortalLinked

GitHub release Modrinth CurseForge Mods License: GPL-3.0-only

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

  1. Enter the Nether through your Overworld portal.
  2. PortalLinked remembers the source portal and the portal you arrive at.
  3. 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

Project description from CurseForge.

Pick your setup

PortalLinked by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

50 available setups

Showing the newest 12 of 19 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

PortalLinked versions and loaders

50 of 50 releases match

Looking for an older file? The official CurseForge project page is in Resources.