Network of servers via proxy

Server setup

Connect a lobby and servers under one addressLearn more

Lobby, survival, and mini-games under one address. Enter server names to get a Velocity or BungeeCord configuration and the strings to change on each server in the network.

My Game select version

Save your preferences in this browser and apply them to supported tools. Settings in a shared link take priority. Wiki version labels are not affected.

Proxy

Servers — the first one becomes the lobby

Lobby
Survival server
Minigames server
New server

Result

Example · Servers: 3

Replace these lines and sections:

velocity.toml

bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "127.0.0.1:30001"
survival = "127.0.0.1:30002"
minigames = "127.0.0.1:30003"
try = [
    "lobby"
]

[forced-hosts]

Next to velocity.toml - one line:

forwarding.secret

5j0H9-wUywhB9HkE3UzxiKAq

On each server in the network - proxies section:

config/paper-global.yml

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: '5j0H9-wUywhB9HkE3UzxiKAq'

On each server in the network:

server.properties

online-mode=false

A secret new each time the page opens — copy all files from one screen.

How to use the result

  1. Launch the proxy

    First launch creates a config—then stop the proxy and replace the lines with the compiled ones.

  2. Configure network servers

    Each has their own port online-mode=false and the lines from blocks below the proxy. The proxy will check usernames.

  3. Close the ports

    Network servers should not be visible from outside — only through a proxy. Otherwise, players will bypass account verification.

What to know

  • Velocity is newer and faster. Relay 'modern' sends username and IP with signature; requires Paper 1.13+.
  • BungeeCord Older and simpler, works with Spigot; Waterfall uses the same config.yml.
  • Lobby first. Players land here upon joining or when another server fails.

To create a server-selection menu, use DeluxeMenus generator, check that the network is visible from outside — Server check.

Frequently asked questions

Velocity or BungeeCord — which to choose?

Velocity is a modern proxy option for Paper networks. Choose BungeeCord when your existing server software or plugins require it, and configure the matching forwarding mode.

Why are players joining the network server bypassing the proxy?

Its port is open externally, but online-mode is disabled. Close server network ports — only the proxy should be visible from outside.

What is forwarding.secret?

General Velocity and server network secret: the server trusts that the username and IP came from your proxy, not from spoofing.