BungeeCord / Velocity Proxy

To connect multiple servers (Hub, Survival, Minigames) together so players can use /server to switch between them, you need a Proxy.

1. Why Velocity?

While BungeeCord and Waterfall are popular, Velocity is the modern standard. It handles modern Minecraft packet structures significantly better, is immune to many attacks, and is actively developed by the Paper team.

2. Step-by-Step Velocity Setup

Purchase a small 1GB-2GB server and set its software to Velocity. This is your proxy network entry point.
On your backend servers (Hub, Survival), open server.properties and set online-mode=false.
On your backend Paper/Purpur servers, open config/paper-global.yml. Find velocity-support: and set enabled: true and configure a secure secret: "your_random_password_here".
Start and stop your Velocity proxy to generate the files. Open velocity.toml.
Add your backend servers under the [servers] block using their IP and Port. (e.g., hub = "192.168.1.1:25566")
Copy the secret from your backend servers into the forwarding-secret setting in velocity.toml.
Restart all servers. Players must now connect through the Proxy's IP address.

Security Warning

Because backend servers are in offline mode, players could theoretically bypass the proxy and log in as anyone if they knew the backend IP/Port. To prevent this, Velocity forwarding secrets handle authentication. However, it's highly recommended to use a firewall plugin (like ServerRestorer or VanillaCord) to lock your backend ports so they only accept connections from your Proxy IP.