Set Up a BungeeCord Network

What BungeeCord Does

BungeeCord is a reverse proxy. Players connect to the proxy IP, the proxy hands them off to a backend server (lobby, survival, minigames, etc). /server <name> jumps between them with no disconnect.

BungeeCord only proxies Spigot/Paper/Purpur. It won't carry Forge/Fabric or Vanilla traffic.

Mandatory Configuration

You're exposing only the BungeeCord IP. Backend servers must be unreachable directly, otherwise anyone who finds their IP can log in as any username.

On every backend server

server.properties:

online-mode=false

spigot.yml:

settings:
  bungeecord: true

On the BungeeCord proxy

config.yml:

ip_forward: true
online_mode: true
servers:
  lobby:
    motd: "Lobby"
    address: 10.0.0.5:25566
    restricted: false
  survival:
    motd: "Survival"
    address: 10.0.0.5:25567
    restricted: false
priorities:
  - lobby

Server Config Fields

Lock Down The Backends

Backend servers should only accept traffic from the proxy's IP. On Endercloud, ask support to add an internal-only firewall rule for each backend port. If a player can connect directly to a backend, they can spoof staff usernames.

Once locked down, players use the public proxy IP and /server <name> to navigate.

Need More Help?

First-time network? Drop your topology in Discord, we'll review the configs.