
Proxy-Portals
A minecraft proxy plugin that allows players to transport between servers with nether portals.
Installation
This plugin works on the backend. No need for a proxy plugin. Simply place the jar file in the plugins folder of any server you want to use portals in, and restart your server. (Note, this plugin does not need to be on the server the player is teleporting to! If you have one central lobby server that has all of the portals, that is the only server that needs the plugin.)
Usage
To register an ordinary into a server switching portal, use the command /register-server *server*, in which you replace *server* with the name of the server you want the portal to transport you to. The *server* parameter must be the exact same that it appears in your velocity.toml (you can find a list of available servers and their exact names with the /server command). You will be promped to walk into the portal you want to register. After you do so, the entire portal (size and shape doesn't matter) will be registered to redirect the player to that server.
Multiple portals can be registered to one server!
To remove a registration from a portal without deleting your entire configuration, use the command /deregister-server *server* in which you replace *server* with the name of ther server you want to deregister. After running this command, all portals registered under *server* will return to regular portals.
Disclaimer:
I use a recursive function to register the entirety of any portal the player steps into. With very large portals, the registration will not be immediate, and the server will throw a thread dump. This is normal, the plugin will still work perfectly fine.
NOTE:
I highly highly recommend going into the config.yml and changing lobby-mode to true on any server that you configure portals on. This will prevent players from being locked out of a server because they spawn in a portal. It is false by default because this option sends everyone who joins the server to the server spawn when they join, no matter where the are in the world.
There is also a no-player-die configuration option. When true, this will prevent the player from dying of damage, drowning, or starving. This should be used for lobby-type worlds.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as ProxyPortalsPaper.jar — drop this file into the mods folder
- Download size: 11 KB
- Download link checked 5 Sept 2026 — working
These come from our own check of the pack file, not from the source page.