How do I set up a BungeeCord/Velocity/Waterfall proxy network here?
A Minecraft "network" is a proxy sitting in front of several backend servers, letting players move between them without disconnecting. Here's how to build one on Humble.
What a network is made of
A network is a proxy plus one or more backend servers, each its own service. The proxy routes players; the backends run the actual worlds (lobby, survival, minigames, and so on).
Step-by-step
- Order a small server for the proxy and install BungeeCord/Waterfall (legacy) or Velocity (modern) from the Software page.
- On each backend (lobby, survival, etc.), set
online-mode=falseinserver.properties— the proxy handles authentication. - In the proxy config, list each backend's
IP:port. - Secure the backends so only the proxy can reach them (see the BungeeGuard guide).
Warning: Setting backends to offline-mode without securing them is a real risk. Always add BungeeGuard/IP protection so players can't connect to backends directly and bypass the proxy.
Frequently asked questions
How many services do I need? At least one for the proxy and one per backend. Open a ticket and we'll help with allocations and sizing.
Which proxy should I use? Velocity is the modern choice; BungeeCord/Waterfall are the legacy options. All install from the Software page.
Why offline-mode on backends? Because the proxy performs authentication. Just be sure to secure the backends with BungeeGuard so they can't be reached directly.
More in BungeeCord / Velocity / Proxy Networks
- What is BungeeCord / a "network" and how does it work?
- How many servers/plans do I need for a network?
- Proxy says "Could not connect to default/fallback server" — how do I fix it?
- "Proxy server is offline" kick when the proxy is down — how do I handle it?
- How do I secure offline-mode backends (BungeeGuard / firewall)?
- Can I open extra ports for proxy backends or plugins (BlueMap, voice chat)?