Articles on: Minecraft: Java Edition

How do I setup Bungeecord?

Want to see how easy it is to get going with Bungeecord? Watch how quickly you can get it set!

Bungeecord requires a standalone server to run on. If you do not have one, then you will need to purchase one.

Getting Started

The first thing you will want to do if you have any sort of file on the server is to reset it. If you do not know how to, please refer to this article. How do I reset my server?

Once you reset the server, getting started with BungeeCord is relatively easy.

Setting The Server To Bungeecord

Firstly, you will want to set your server type to Bungeecord. This can be done from the main page of the control panel. You will want to select the version you want.
We suggest using the auto-updating version. As you would not have to worry about needing to update it when an update releases.

Once you have your server type set to BungeeCord. You will want to stop your server.

Need help setting the server to Bungeecord still? How do I change my server type/version?

Configuring The Bungeecord Server

You will want to head to the FTP File Access. To get there, click on the Files button on the left sidebar. From there, click the FTP File Access.
Once in your files, you will want to locate the config.yml file. Click the edit button to the right of the name.

BungeeCord config.yml

This is where you will add your servers, change player limits, and even change the MOTDs.

To get started, you will want to set ip_forward to true.

If you do not have the dedicated IP yet, we suggest purchasing this for the BungeeCord server. How do I buy a dedicated IP?

You will also want to set the host to your server IP and port. From where it says host, you will want to paste in the IP and port of your Bungeecord server.

Below, you will see in the picture with all these options set.

Now that you have set this, you will want to add your servers.

There is a format for the servers you need to follow. Below, you will see that specific format, which is also provided in the config.yml file.

    motd: '&1Just another BungeeCord - Forced Host'
    address: 123.456.78.901:25565
    restricted: false

You will want to edit the server name, address, and the motd to what you want.
As for the restricted, that would be if you only wanted certain people that you give permission to join the server.
You need to follow the same process for all servers that you add.

Setting Up A Default Server

Setting up a default server is very simple.

You will need to:
Add the default server to the priority list.
Add the default server to the forced host.
Enable force_default_server.

Though for the forced host option, you will want to create a subdomain for the default server.

Need a subdomain? You can get that from here:

  - lobby

forced_hosts: lobby

force_default_server: true

Your setup will want to look like a variant of the setup example provided below.

Example Config

Now that you have configured the Bungeecord, you can start or restart the server.

Please note that when stopping or restarting the bungeecord server. Type end into the console.

End Console Command

Setting Up Your Game Server For Bungeecord

You will want to head to your server settings and disable online mode. This can easily be done by going to the files drop down box, then selecting config files.
Once there, you will want to click into server settings. Then locate the online mode option, select the drop down box and click on disabled.

After you select disabled, scroll to the bottom of the page and select the big blue save button.

Then reboot your server if you do not have to do the Spigot configuration.

If running Spigot:

You will want to head to your FTP File Access. (Files>FTP File Acess)
From there, locate the spigot.yml file and then select the edit button.

Once in on the file editor for the spigot.yml file, you will want to locate the bungeecord option. This is usually near the top on the settings option.
You will want to set it to true.

  save-user-cache-on-stop-only: false
  bungeecord: true
  sample-count: 12

Once you set it, you will want to click the save button to the top. Then reboot your server.

Setting Permissions

Now that you have configured your Bungeecord server and your game servers, you can start all of them up.

Though you you want to give yourself admin on the Bungeecord server, you would set this from the config.yml file of the server.

Under where it says groups:
  - admin

Change md_5 to your username
  - admin

If you restricted a server, you need to give them the bungeecord.server.servername permission node.
To setup basic Bungeecord permissions, please refer to this:

  - bungeecord.command.alert
  - bungeecord.command.end
  - bungeecord.command.ip
  - bungeecord.command.reload
  - bungeecord.command.server
  - bungeecord.command.list
  - bungeecord.command.send
  - bungeecord.server.servername
  - bungeecord.command.server
  - bungeecord.server.servername
  - bungeecord.command.server
  - bungeecord.command.list
  - admin
  - staff
  - staff
  - staff

If you decide to set that, be sure to restart your bungeecord server after any changes are made.
If you need any further help with this, please do let us know

Updated on: 07/22/2020

Was this article helpful?

Share your feedback


Thank you!