Skip to main content

How to Connect BungeeCord

General Information​

The BungeeCord proxy server is used to connect multiple Minecraft servers into a single network, allowing players to switch between them seamlessly (e.g., lobby → gamemodes → lobby). A minimum of three servers is required for proper operation:

  • one for BungeeCord (proxy),
  • at least two as backend servers (e.g., lobby, gamemode).

RAM Requirements:

RAM AmountNumber of PluginsNumber of Players
1.5 GB (DEV)0–8up to 150 players
3 GB (SAND)8–15up to 300 players
5 GB (DIRT)20+300+ players

Proxy servers are not resource-intensive, as they do not store worlds or similar data.

BungeeCord Proxy Server Configuration​

Download and Installation​

  1. In the panel, under Engine Versions, select the BungeeCord engine (or its fork: Waterfall, Travertine).
  2. Start the server to generate the default files.

Editing the config.yml File​

Go to the Files tab, then open the config.yml file in the proxy’s root directory; you will need to change a few things:

query_port: PORT 
host: 0.0.0.0:PORT

Replace PORT with the port assigned to your server on IceHost.
Where to check which PORT is assigned to the server? In the Console tab, on the left side you will see a lot of information about the server – there you will find your current PORT.

The correct PORT configuration should look like this:
Bungeecord

Next, adjust:

online_mode: false # leave true for premium authentication. False allows Non-Premium players to join but reduces security
ip_forward: true # required for the proxy to forward players’ original IP and UUID

Adding a New Server to the Proxy​

To add a server to the proxy network, perform the following steps:

  1. On the BungeeCord server, go to the Files tab, then again to the config.yml file
  2. Enter the IP-1 addresses of your servers in the servers: section. In the "address" field, provide both the hostname and port number, for example:
servers:
  lobby:
    motd: '&bServer hosted on IceHost!'
    address: 83.168.0.0:50080 # Change to the lobby IP-1.
  gamemode:
    motd: '&bServer hosted on IceHost!'
    address: 83.168.0.0:50023 # Change to the gamemode IP-1.
    restricted: false

Configuring Minecraft Servers​

For each server (lobby, gamemode, etc.):

Edit server.properties​

online-mode=false

Edit spigot.yml​

settings:
  bungeecord: false → true

Edit config/paper-global.yml​

In the proxies.bungee-cord section:

proxies:
  bungee-cord:
    online-mode: true → false

Save and restart each server.

Verification and Common Errors​

To check if the proxy is working correctly, after it starts, connect using the IP-1 address assigned to the BungeeCord server. In the Minecraft client, use the /server command to see the list of available backend servers.

Most Common Issues and Their Fixes​

  1. Could not connect to default or fallback server
    Means BungeeCord cannot connect to the default server. Verify the servers: section in config.yml – ensure the IP addresses and ports match the actual backend data and that those servers are running.

  2. If you wish to use IP forwarding, please enable it in your BungeeCord config as well!
    This message appears when original player data forwarding is not enabled. In config.yml, set ip_forward: true, and on each backend server, in spigot.yml, enable bungeecord: true.

  3. Server is online mode!
    BungeeCord requires backend servers to operate in offline mode. Open server.properties on each backend and change online-mode=true to online-mode=false.