DistributedDimensions

DistributedDimensions

A Minecraft plugin system that splits a world across one Paper server per dimension, coordinated by a Velocity proxy.

[Player] ──► [Velocity Proxy (dd-velocity)]
                  │
        ┌─────────┼─────────┐
        ▼         ▼         ▼
  [Overworld]  [Nether]   [End]
  (dd-paper)  (dd-paper) (dd-paper)

Crossing a portal feels identical to vanilla: inventory, XP, hunger, gamemode, and chat are preserved across all servers in real time.

How it works

1. Player enters a portal → the Paper plugin cancels the vanilla event
2. The full player state (inventory, XP, hunger, gamemode…) is serialized and sent to Velocity via a plugin message channel
3. Velocity routes the player to the target server and forwards the message
4. The target server deserializes the state, finds a safe spawn location (or builds a portal), and teleports the player

Nether coordinate scaling (1:8 ratio) and End platform spawning are handled automatically.

Requirements

• Java 21
• A Velocity 3.x proxy
• Three Paper 1.21.11 servers (one per dimension)

Configuration

Each Paper server declares its dimension in plugins/DistributedDimensions/config.yml:

world: OVERWORLD   # OVERWORLD | NETHER | END
debug: false

The Velocity plugin reads plugins/distributed-dimensions/config.toml:

debug = false