BungeeCord is a unique server type used by thousands of Minecraft server owners. It allow users to easily connect other servers that are running on Spigot or Paper, creating a network for players to use.

When linked together, players can log into the BungeeCord network and jump between each Spigot/Paper server that's connected, all from in-game. This is perfect for large servers that offer several different modes, such as minigames and factions, or servers that just want to keep things separated.

You can learn more about BungeeCord and its many features here: https://www.spigotmc.org/wiki/bungeecord/

Requirements

In order to run BungeeCord, you must have at least three Minecraft servers available. One server is used as the "proxy" that runs BungeeCord, another server typically acts as a “Hub” or “Lobby” running Spigot or Paper, and any additional servers typically are used for the actual gameplay (e.g. different modes like “Factions”, “Creative”, “Survival”, etc.).

While we highly encourage you to look into bare metal options when considering running a network, you can still run BungeeCord on our shared servers - especially if your network will be relatively small (only 1-2 server modes and/or a small player base).

Note:  BungeeCord networks do not support Vanilla or modded (Forge) servers at this time. Those types do not support "proxy" connections, and could cause conflicts and crashes if used.

Configuring BungeeCord

For a more complete configuration guide, please visit the official BungeeCord page here: https://www.spigotmc.org/wiki/bungeecord-configuration-guide/. Our team is always happy to assist with answering your questions about this as well. 


Adding a server
BungeeCord itself is configured with only one file: "config.yml". This file can be found in the root folder in the File Manager, or via an FTP connection. To add a new Spigot/Paper server to your network, you'll first need to know its IP address. From there, locate the following section inside the BungeeCord config file:

...
servers:
  lobby:
    motd: '&1Just another BungeeCord - Forced Host'
    address: localhost:25565
    restricted: false
...

This section is added by BungeeCord by default, but you'll need to change it for your own server needs. If our example server has the IP address of phx.demo.mymc.io:25565 we can modify this configuration section as follows:

...
servers:
  phoenixServer:
    motd: 'A really awesome server!'
    address: phx.demo.mymc.io:25565
    restricted: false
...

Following this pattern, we can add more servers the same way:

...
servers:
  phoenixServer:
    motd: 'A really awesome server!'
    address: phx.demo.mymc.io:25565
    restricted: false
  ashburnServer:
    motd: 'Another really cool server!'
    address: ash.demo.mymc.io:25565
    restricted: false
...


Server Priorities
The last step is to find the section for server priorities. By default, it looks like this:

...
priorities:
- lobby
...

Next, add the names of each server you're connecting to this list, in the order of importance. Usually, the "hub" server goes first, but this is up to you! The final result should look something like this:

...
priorities:
- phoenixServer
- ashburnServer
...


Configuring Spigot and Paper
After saving your changes and restarting BungeeCord, players will be sent to one of these servers when they log in. You'll need to edit your existing Spigot/Paper servers to accept players coming from BungeeCord. The official guide has some information on the settings to change, which can be found here: https://www.spigotmc.org/wiki/bungeecord-installation/#post-installation

Plugins

One of the perks of running BungeeCord is the use of Bungee-exclusive plugins. These work a bit differently than traditional plugins, and can be installed on BungeeCord itself. You can find a list of such plugins over on this page: https://www.spigotmc.org/resources/categories/bungee-proxy.3/

Certain plugins may offer compatibility with both BungeeCord and Spigot/Paper. In these cases, please read the plugin's documentation for more information.

Specials

If you're interested in starting a network with us, feel free to contact our sales team for more information on your options.

Questions?

If you're feeling stuck, please feel free to reach out to our support team! We'll always be happy to point you in the right direction.

Did this answer your question?