Setting Up a BungeeCord or Velocity Proxy

A proxy server lets you connect multiple Minecraft servers together under one network. Players connect to the proxy, which then routes them between your backend servers (such as a lobby, survival, or minigames server). BungeeCord and Velocity are the two most common proxy options.

What You Need

A separate server on your plan for the proxy itself
One or more additional servers for your backend servers (lobby, survival, etc.)
All servers must be stopped while you configure them

Choosing Between BungeeCord and Velocity

Velocity is the recommended option for new setups. It is more modern, has better performance, and supports stronger security features. It works with Paper, Purpur, and Fabric servers.

BungeeCord is the original proxy and has wider plugin support. It works with Spigot, Paper, and Purpur servers.

If you are unsure, go with Velocity.

Setting Up the Proxy Server

Step 1: Install the Proxy Software

Log in to the Game Panel
Select the server you want to use as your proxy
In the left menu, click Game then Versions
Select Velocity or BungeeCord and install it
Start the server once to generate the configuration files, then stop it

Step 2: Configure the Proxy

Open the proxy configuration file in the File Manager.

For Velocity - open velocity.toml:

Find the [servers] section and add your backend servers. Use the IP address and port of each backend server as shown on their console page in the Game Panel.

[servers]
lobby = "123.456.78.90:25566"
survival = "123.456.78.90:25566"

Set which server players should join first:

try = ["lobby"]

For BungeeCord - open config.yml:

Find the servers section and add your backend servers:

servers:
  lobby:
    motd: 'Lobby Server'
    address: 123.456.78.90:25566
    restricted: false
  survival:
    motd: 'Survival Server'
    address: 123.456.78.90:25566
    restricted: false

Set the default server under listeners:

priorities:
  - lobby

Replace the example addresses with the actual IP and port of each backend server. The port can be any port assigned to that server - it does not have to be the default port.

Save the file.

Configuring Your Backend Servers

Each backend server needs to be configured to work with the proxy.

For All Backend Servers

Open server.properties in the File Manager
Set online-mode to false - this lets the proxy handle authentication instead of each server doing it individually

online-mode=false

Save the file

Important: With online-mode set to false, backend servers will accept any connection. Make sure players can only connect through the proxy and not directly to the backend servers. See the Securing Your Network section below.

For Paper/Purpur Servers (with Velocity)

If you are using Velocity with Paper or Purpur backend servers:

Open config/paper-global.yml
Find the proxies.velocity section
Set enabled to true
Set secret to match the forwarding-secret value from your Velocity proxy's forwarding.secret file
Set online-mode to true in this section (this is separate from server.properties)

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: your-forwarding-secret-here

For Spigot/Paper Servers (with BungeeCord)

If you are using BungeeCord:

Open spigot.yml
Set bungeecord to true

settings:
  bungeecord: true

Securing Your Network

With online-mode=false on your backend servers, it is important to make sure players cannot bypass the proxy and connect directly.

For Velocity - Velocity's modern forwarding with a shared secret (configured above) ensures that only your Velocity proxy can send players to your backend servers. This is the most secure option.

For BungeeCord - Consider installing a firewall plugin such as BungeeGuard on both your BungeeCord proxy and backend servers. This adds a shared token that prevents direct connections to your backend servers.

Starting Your Network

Once everything is configured:

Start your backend servers first and wait for them to fully load
Start your proxy server last
Players connect using the proxy server's address - they do not connect to the backend servers directly

Troubleshooting

Cannot Connect to the Proxy

Make sure the proxy server is running
Check that you are connecting using the proxy server's address and port, not a backend server

Stuck on "Connecting to the server"

Make sure the backend servers are running and fully started before the proxy
Check that the addresses and ports in the proxy config match the actual backend server addresses shown in the Game Panel
Make sure the port you are using for each backend server is actually assigned to that server in the panel

Players See "If you wish to use IP forwarding"

For Velocity, make sure online-mode is set to true in the proxies.velocity section of paper-global.yml and that the secret matches
For BungeeCord, make sure bungeecord: true is set in spigot.yml

UUID or Skin Issues

Make sure IP forwarding is properly configured (Velocity modern forwarding or BungeeCord IP forwarding)
Check that online-mode=false is set in server.properties on all backend servers

Need Help?

If you encounter any issues or need further assistance, you can reach us through:

Support Ticket
Discord Server - use the /support command
Email: [email protected]