25% off on first order withAPEX25

This article is not yet available in your selected language and is being displayed in English.

Minecraft
Posted on Nov 5, 2026

Velocity vs BungeeCord: How to Set Up a Minecraft Proxy Network

Setting up your own network in Minecraft is a great way to build a community, especially for those running minigames. One single server isn’t enough to run everything, so that’s why proxies are required (like Velocity or BungeeCord). They c...
Velocity vs BungeeCord: How to Set Up a Minecraft Proxy Network

Table of Contents

Share on
Read Progress

Setting up your own network in Minecraft is a great way to build a community, especially for those running minigames. One single server isn’t enough to run everything, so that’s why proxies are required (like Velocity or BungeeCord). They connect multiple servers together, while players only connect to one address. You can have minigames on one server, survival on another, and creative on the third server.
 
In this Apex Hosting guide, we will compare Velocity and BungeeCord to get you started. We’ll also be showing you how to set them up. Let’s begin 👏
 
Skip the hard work. Get the Plugin Installation Addon to allow us to set up your proxy.
 

What is a Proxy Server?

A proxy network acts as an intelligent traffic director between your players and your individual Minecraft instances. Instead of players directly connecting to an individual survival or creative world, they connect to the proxy server. This authenticates the player’s account with Mojang and seamlessly forwards their connection to a backend game server (typically a central Lobby or Hub).
 

Velocity vs BungeeCord

Feature Velocity BungeeCord
Developer / Ecosystem PaperMC (Modern API, Hangar) SpigotMC (Classic Bungee API)
Performance High throughput, optimized packet handling Standard; can struggle under heavy connection spikes
Player Forwarding Modern Forwarding (HMAC secret key authentication) Legacy IP Forwarding (Requires manual IP whitelisting/firewalls)
Plugin Compatibility Velocity-specific plugins only BungeeCord-specific plugins only
Recommended Use Case Modern networks (1.13+), Paper backends, high security Legacy setups, pre-1.13 servers, legacy-only plugins

 

Why Velocity?

Velocity is built from the ground up by PaperMC for modern versions of Minecraft. It replaces traditional IP forwarding with Modern Forwarding, where each packet between the proxy and backend is authenticated with a cryptographic secret. This prevents offline-mode UUID spoofing out of the box without needing complex network firewalls.
 

Why BungeeCord?

BungeeCord is the original, time-tested proxy created by SpigotMC. While older, it boasts a massive legacy plugin catalog. However, because backend servers must run in online-mode=false using standard IP forwarding, backends must be strictly protected with a firewall or plugins like BungeeGuard to prevent unauthorized direct logins.
 

How to Setup Velocity

  1. Head towards your Apex server panel and stop the server.
  2. Click the Game File option and search for Velocity.
  3. Select it and follow the prompts accordingly – restart the server.
    Velocity Apex Hosting
  4. Navigate to File Management > FTP File Access on the left.
    Apex Hosting FTP
  5. Open the velocity.toml file by double clicking it.
    Velocity toml File
  6. Adjust the following settings:
    • bind: Set the port to match your proxy server’s assigned port
    • player-info-forwarding-mode: Change this from “NONE” to “modern”.
    • [servers]: Set your backend servers with their IP addresses.
    Velocity Setup Config Guide
  • Save these changes. Open the forwarding.secret file and copy the string of values.
    Velocity Secret Key

    This is required for later!

  •  

    Backend Server Setup

    1. Head towards your other backend server (such as the Lobby).
    2. Stop the server. Click Server Configuration > Config Files on the left.
      Velocity Apex Hosting Config FIles
    3. Select Server Settings, then disable the Online Mode option.
      Velocity Server Online Apex Hosting
    4. Go back to the FTP File Access area, then enter the config directory.
      Velocity Apex Hosting Paper
    5. Open the paper-global.yml file. In the proxies section (Velocity) edit this:
      • secret: ‘Paste Your Key Here’
      Velocity Apex Hosting Setup Guide
    6. Save the changes. Repeat this process for all your other backend servers.
    7. When you’re finished, restart all servers.
    8. Try connecting to the proxy server to test if this worked.

     

    BungeeCord Setup

    👉 For more information, review this guide.

    1. Go to your Apex server panel. Stop the proxy server.
    2. Click the Game File> option. Search for BungeeCord.
    3. Select it and confirm the prompts. Restart the server once to generate new files.
    4. Go to File Management > FTP File Access on the left menu.
    5. Open config.yml by double-clicking it.
    6. Adjust these settings:
      1. host: Set the port to match your proxy’s assigned port.
      2. ip_forward: Change this setting from false to true.
      3. priorities: Put your default lobby server first in the list.
      4. servers: Enter your backend server names, IP addresses, and ports.
    7. Save the file.

     

    Backend Server Setup

    1. Open your backend server on the Apex panel (such as the Lobby).
    2. Stop the server. Click Server Configuration > Config Files on the left.
    3. Open Server Settings. Set Online Mode to disabled (false). Save the file.
    4. Go to FTP File Access. Open the spigot.yml file.
    5. Find the settings section. Change bungeecord from false to true.
    6. Save your changes. Repeat these steps on all other backend servers.
    7. Start all backend servers first. Then, start your BungeeCord proxy server.
    8. Connect to your proxy IP in Minecraft to confirm it works.

     

    Conclusion

    Both Velocity and BungeeCord make scaling a Minecraft server network straightforward. For modern versions running on Paper (1.13+), Velocity provides better performance, superior thread handling, and native forwarding security. If you manage legacy versions or rely on classic BungeeCord plugins, BungeeCord remains a reliable choice when paired with appropriate backend firewall protections.