ArqonaraArqonara
IDEN

Setup Velocity Proxy

Run multiple servers behind one Velocity proxy.

On this page

Velocity is a next-generation server proxy designed to replace BungeeCord. Velocity is far more efficient in CPU usage, has built-in protection against bot attacks, and supports modern encryption.

1. Initial Preparation#

To build a network, you'll need at least:

  • 1 dedicated server for Velocity (512MB - 1GB of RAM is enough).
  • 1 or more backend servers (Survival, Lobby, etc.) running Paper or Purpur.

2. Configuring Velocity#

After installing Velocity on your proxy server, open the velocity.toml file:

  1. Change the Port: Make sure bind = "0.0.0.0:25565".
  2. Enable Forwarding: Find player-info-forwarding-mode and change it to modern.
  3. Secret Key: Velocity will create a forwarding.secret file. Copy the code inside it.

3. Configuring Backend Servers (Paper/Purpur)#

On each destination server (Survival/Lobby), you must configure them to accept connections from Velocity:

  1. Open config/paper-global.yml (for the latest Paper) or paper.yml.
  2. Find the proxies.velocity-secret section and enter the code from forwarding.secret above.
  3. Change online-mode in server.properties to false (because authentication will be handled by Velocity).

4. Registering Servers to the Proxy#

Back in velocity.toml on the proxy server, find the [servers] section and add your servers:

json

[servers]lobby = "IP_SERVER_LOBBY:25566"survival = "IP_SERVER_SURVIVAL:25567"

5. Additional Security (Required)#

So players can't "bypass" the proxy and directly join the backend servers illegally:

  • Make sure all backend servers do NOT use port 25565.
  • Use a firewall or configure the backend IPs so they only accept connections from your Proxy IP.

Why Is Velocity Better?#

  • Anti-Bot: Handles connections more robustly than BungeeCord.
  • Native Support: Supports new Minecraft features without needing many additional plugins.
  • Lightweight: 1GB of RAM can handle hundreds of players without lag on the proxy layer.

Troubleshooting#

Error: Unable to authenticate?

Make sure player-info-forwarding-mode in Velocity and the Paper configuration both use modern mode with the correct secret key.

Players can't switch servers?

Check whether the IP and Port in the [servers] section match the actual IPs of your backend servers.

Setting Up a Network Feels Difficult?Building a network is indeed technical. Contact our support team if you need help syncing the Velocity Secret.
PreviousConfigure Java Mods & Server SettingsNextCan't Connect (Connection Refused)