How to Set Up a BungeeCord Network

Learn how to set up a BungeeCord proxy to connect multiple Minecraft servers into a network.

BungeeCord is a proxy that connects multiple Minecraft servers into a single network. Players can switch between servers (lobby, survival, minigames) without disconnecting.

How BungeeCord Works

Players → BungeeCord Proxy → Backend Server 1 (Lobby)
                            → Backend Server 2 (Survival)
                            → Backend Server 3 (Minigames)

Players connect to the proxy, which routes them to backend servers.

Setting Up the Proxy

Create a BungeeCord server

Set up a server with BungeeCord as the type in Startup on the XGamingServer panel.

Configure the proxy

Go to Files and edit config.yml:

listeners:
  - host: 0.0.0.0:25565
    motd: "&aMy Network"
    max_players: 100
    priorities:
      - lobby

servers:
  lobby:
    address: lobby-ip:lobby-port
    motd: "Lobby Server"
    restricted: false
  survival:
    address: survival-ip:survival-port
    motd: "Survival Server"
    restricted: false

ip_forward: true

Configuring Backend Servers

Enable BungeeCord mode on backends

On each backend server, edit spigot.yml via Files:

settings:
  bungeecord: true

Set online-mode to false on backends

Edit server.properties on each backend:

online-mode=false

The proxy handles authentication, so backends must have this disabled.

Install BungeeGuard

For security, install BungeeGuard on both the proxy and all backend servers to prevent unauthorized direct connections.

⚠️ Warning: Without BungeeGuard, anyone who knows a backend server's IP can connect directly and impersonate any player. This is a critical security vulnerability.

💡 Tip: Consider Velocity as a modern alternative to BungeeCord with better security and performance.

If you need help, join our Discord.

How to Set Up a BungeeCord Network

On this page