PortalLinker
Vanilla nether portals are notoriously unreliable. You step through expecting to arrive at your base, only to be dumped on a random cliffside or inside a wall. Minecraft's built-in portal search often creates new, unwanted portals instead of connecting to the one you built. PortalLinker solves this completely by letting you hard-link portal pairs to precise coordinates, bypassing the game's fuzzy logic entirely. Every trip lands exactly where you told it to, for both players and entities.
Why PortalLinker for Minecraft Is a Game-Changer
Standard portal mechanics work on a "closest portal" search within a radius, which breaks spectacularly in complex networks. If you run a portal hub, a chunk loader array, or an orbital TNT cannon, you know the pain of portals drifting or auto-creating. PortalLinker replaces that chaos with deterministic, two-way links that persist through restarts. It's built for technical servers where precision is everything.
Exact Coordinate Linking
Forget about searching for the nearest portal. PortalLinker teleports you to the exact coordinates you set. No stray portals, no mismatched destinations. You define Portal 1 in one dimension and Portal 2 in another, then save the link. From that moment, entering either side sends you straight to the other, with zero deviation.
Two-Way and Entity-Safe
Links work in both directions automatically. Even better, PortalLinker redirects items, mobs, and TNT—not just players. This is a massive advantage for entity-based chunk loaders or automated cannon setups where every tick counts. The add-on ensures your payloads arrive on target every time.
How to Install PortalLinker on Your Server
Getting started is straightforward. First, ensure your server runs Paper or Purpur 1.21 through 1.21.11 with Java 21 or newer. PortalLinker uses the Paper API, so plain Spigot or Bukkit won't work. Once you've confirmed compatibility, download PortalLinker from a trusted source and place the JAR file into your server's plugins folder. Restart the server, and the plugin will generate its default configuration. If you're using a launcher like foxygame.net, you can find PortalLinker in the add-on catalog and install it with a single click, automatically matching your server version for a hassle-free setup.
Using PortalLinker: Commands and Menu
Setting up a link takes just three commands. Stand inside your first portal and type //setportal1. Travel to the other dimension, stand in the second portal, and type //setportal2. Finally, run //save (or //save myname to give the link a custom name). The temporary points reset, and the pair is now permanently linked. Single-slash aliases like /setportal1, /setportal2, and /saveportal also work for convenience.
To manage all your links, use //portals to open an in-game menu. Left-click a link to teleport to Portal 1, right-click to teleport to Portal 2, and shift-click to delete the link. The interface is clean and intuitive, making it easy to browse dozens of connections without memorizing coordinates.
Configuration and Permissions
The main configurable option is link-radius, which defaults to 3.0 blocks. This determines how close you must be to a portal's center to trigger the link. Adjust it if your portals are unusually large or small. The only permission node is portallinker.use, granted to operators by default. You can assign it to specific groups if you want non-OP players to create and manage links.
Real-World Applications for PortalLinker
PortalLinker shines in scenarios where vanilla portals constantly break. Portal-based chunk loaders rely on entities traveling back and forth; with PortalLinker, the entity always returns to the exact loader portal, preventing load-line drift. Orbital TNT cannons that fire through nether portals need pinpoint accuracy—PortalLinker guarantees the TNT exits at the same coordinate every shot. Multi-portal hubs with dozens of destinations stay organized, and you never accidentally create a new portal in someone's storage room.
Even for casual players, the add-on removes frustration. Build a beautiful portal room in your base and link it directly to your nether fortress portal. No more running through the nether to find where you popped out. The lightweight, event-driven design means no tick overhead, so it won't lag your server even with hundreds of links.
If you're managing a modded or semi-vanilla server, the foxygame.net launcher can keep PortalLinker updated automatically, ensuring you always have the latest bug fixes without manual downloads. This is especially handy when juggling multiple plugins across different Minecraft versions.
Conclusion
PortalLinker is the definitive solution for anyone tired of vanilla portal randomness. It delivers exact, two-way linking for players and entities, a simple command workflow, and a persistent system that survives restarts. Whether you're engineering complex redstone contraptions or just want your nether trips to be predictable, PortalLinker for Minecraft is an essential addition. Download PortalLinker today and take full control of your dimensional travel.