PROMO Get 10% off any server with code: START Limited-time offer
Ctrl K
DocumentationMinecraftServer network (Velocity)

Server network with Velocity

Link your lobby, survival and minigames into one network — players switch between servers without leaving the game.

⏱ 1 min read✏️ Report an issue with this page
On this page

How it works

You need one proxy server (Velocity) and at least one backend server (Paper/Purpur). Players only connect to the proxy — the backends aren't visible to them.

ServerSoftwareRAM
ProxyVelocity512 MB – 1 GB
LobbyPaper2 GB
Survival / modesPaper / Purpuras needed

Proxy configuration

velocity.toml
player-info-forwarding-mode = "modern"

[servers]
lobby = "LOBBY_IP:PORT"
survival = "SURVIVAL_IP:PORT"
try = ["lobby"]

Velocity generates a forwarding.secret file — copy its contents, you'll need them on the backends.

Backend configuration

config/paper-global.yml
proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'FORWARDING_SECRET_CONTENTS'

On every backend set online-mode=false in server.properties — the proxy takes over account verification.

🔒

Secure your backendsWithout a correct secret, someone could connect to a backend directly, bypassing the proxy, and impersonate any player. Don't publish your backend addresses.