Setting Up a BungeeCord/Waterfall Network

When your Minecraft community grows too large for a single server to handle, or you want to offer different game modes (Survival, Factions, Minigames) seamlessly, you need a proxy network.

What is BungeeCord / Waterfall?

A proxy server acts as a gateway. Players connect to the proxy, which then seamlessly routes their connection to the various "backend" backend servers (like your Hub, Survival, and Creative servers) without requiring them to disconnect.

1. Provisioning the Servers

You will need at least two servers, but typically three: A Proxy, a Hub, and a Game server. The proxy uses very little RAM (512MB - 1GB is usually enough), while backend servers need standard resources.

2. Configuring Backend Servers

On your backend servers (Paper/Purpur), you must enable BungeeCord mode to forward IP addresses correctly, otherwise all players will appear to connect from the proxy's IP.

• Open spigot.yml and set bungeecord: true.
• Open server.properties and set online-mode=false. (CRITICAL: Ensure your servers are firewalled so players cannot bypass the proxy to join backend servers directly!)

3. Configuring the Proxy

On your BungeeCord/Waterfall server, edit the config.yml:

• Set ip_forward: true.
• Under the servers: section, add your backend servers with their respective IP addresses and ports.
• Under listeners:, configure the priorities: to point to your Hub server first.

Restart all servers, and your network is ready!