DimensionTransfer: Automatic Dimension Routing for Minecraft Proxies

DimensionTransfer routes players to the right backend server automatically when they change dimensions in Minecraft. No commands, no visible addresses, just seamless travel.

Download dimension transfer for Minecraft 1.21.1

Original name: dimension transfer

Minecraft: 1.21.1

Loaders: Forge

FileVersionLoaderSize
dimension-transfer-1.0.0.jar1.21.1Forge17 КБDownload

DimensionTransfer

Running a split-server network where the Overworld lives on one backend and every other dimension lives somewhere else sounds elegant on paper. In practice, it usually means players typing clumsy commands or getting dumped onto the wrong server every time they step through a Nether portal. DimensionTransfer solves that problem at the proxy level, quietly reading each dimension change and forwarding the player to the correct backend before they even notice anything happened.

This Velocity proxy plugin is built for network owners who want clean, command-free dimension routing. If you have been searching for a reliable way to download DimensionTransfer and finally separate your Overworld from your resource-heavy custom dimensions, this guide covers what the plugin does, how it works under the hood, and how to set it up without breaking your existing setup.

What DimensionTransfer Actually Does

At its core, DimensionTransfer listens for the RESPAWN packet that a backend server sends to the client whenever a player switches dimensions. Since Minecraft 1.20.2, that packet fires on every dimension change, which makes it the perfect trigger. The proxy intercepts it, reads the target dimension, and automatically forwards the player to the matching backend server.

The default logic is simple and sensible: the Overworld stays on your main server, and every other dimension goes to your secondary server. Players never type a command, and they never see a backend address. From their perspective, walking into a Nether portal just works.

Dimension Identification and Matching

DimensionTransfer compares both the world ID and the dimension type ID when deciding where to send a player. Either one written in the config will match, which gives you flexibility for modded dimensions that share a type with vanilla ones. This dual-check approach is far more forgiving than strict ID matching alone.

Loop Prevention Built In

One of the smartest design choices here is that the plugin only handles RESPAWN packets, never LOGIN. Combined with a per-player cooldown, this prevents the dreaded forwarding loop where a player bounces endlessly between servers. You can tune the cooldown in the config to suit your network's latency and player volume.

Configuration Options

The config file is refreshingly straightforward. You can adjust:

  • The Overworld server name (your main backend)
  • The server that handles all other dimensions
  • The dimension list used for matching
  • Per-player cooldown duration
  • Debug logging for troubleshooting

Debug logging is worth enabling during your first test run. It shows exactly which dimension IDs are being detected and where players are being forwarded, which saves hours of guesswork when a modded dimension refuses to route correctly.

Requirements and Supported Versions

DimensionTransfer requires the PacketEvents library, so make sure that dependency is installed on your proxy before you start. The plugin targets Velocity and is designed around Minecraft 1.20.2 and newer, since the RESPAWN-on-dimension-change behavior only exists from that version onward. If your network runs Paper or Purpur backends behind Velocity on 1.20.2 through the latest releases, you are in the right territory.

There is one critical prerequisite that trips up a lot of admins: both backends must have the same set of mods installed and must both register the split dimensions. If the secondary server does not know about a dimension, the split-server setup simply will not take effect, no matter how perfect your config looks.

How to Install DimensionTransfer

Installation follows the standard Velocity plugin workflow. Drop the plugin jar into your proxy's plugins folder, install PacketEvents alongside it, restart the proxy, and edit the generated config to match your server names and dimension list. After a restart, test by stepping into a Nether portal and watching the debug log to confirm the forward fires correctly.

If you would rather skip the manual file juggling, the foxygame.net launcher bundles DimensionTransfer in its add-on catalog, so you can add it to a compatible Velocity setup with a single click and let the launcher handle version matching for you.

For players and admins who prefer a guided experience, grabbing DimensionTransfer for Minecraft through a managed launcher removes the guesswork around dependency versions. Just confirm your proxy and backends are all on 1.20.2 or later before you begin.

Final Thoughts

DimensionTransfer is one of those plugins that does a small job extremely well. It removes commands from the player experience, hides backend addresses, and keeps dimension routing consistent across your entire network. The PacketEvents dependency and the matching-mods prerequisite are the only real hurdles, and both are easy to satisfy with a little planning. If your network splits the Overworld from everything else, this plugin belongs in your proxy's plugin folder.