← Back to Knowledgebase

Proxy Setup Guide (Velocity)

How to link multiple servers together using Velocity (the modern alternative to BungeeCord).

What is a Proxy?

A proxy is a server that doesn't host any worlds itself. Instead, it accepts player connections and forwards them to other "backend" servers (like Hub, Survival, Creative). This allows players to switch servers without disconnecting.

Step 1: The Proxy Server

  1. Order a separate server for your Proxy (the Dirt Plan is usually sufficient).
  2. In the Panel, select Velocity as the server JAR/Type.
  3. Start the server once to generate files, then stop it.
  4. Open velocity.toml in the File Manager.
  5. Find player-info-forwarding-mode and set it to "modern".
  6. Locate the [servers] section. Add your backend servers here: 
    [servers]
hub = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
try = ["hub"]
  7. Save and restart the Proxy.

Step 2: The Backend Servers

For each server you want to link (Hub, Survival, etc.):

  1. Open server.properties.
  2. Set online-mode=false (The proxy handles authentication).
  3. Save and close.
  4. If using Paper (recommended), open config/paper-global.yml.
  5. Find proxies.velocity.
  6. Set enabled: true and online-mode: true.
  7. Set secret: to the secret key found in your Proxy's forwarding.secret file.
  8. Restart the backend server.

Security Warning

CRITICAL: Since backend servers are in offline mode, you MUST setup a firewall (IP Whitelist) so players cannot bypass the proxy and join them directly. In RYN Host panel, use the firewall manager to only allow connections from your Proxy's IP.