BungeeCord Installation

Discussion in 'Wiki Discussion' started by jtaylor69, Jul 4, 2014.

  1. jtaylor69

    jtaylor69 Retired Moderator

    BungeeCord Installation

    BungeeCord Installation

    Guides to installing BungeeCord on your OS

    Installing BungeeCord on Windows(top)

    1. As a prerequisite, install Java 7 or above if you don't have it already (from Java.com).
    2. Download the latest BungeeCord build from here.
    3. Place the file inside a new directory dedicated to BungeeCord.
    4. Create a new startup script to launch the the JAR:
    Code (Text):
    @echo off

    java -Xms512M -Xmx512M -jar BungeeCord.jar
    5. Double-click the batch file.​


    • You may need to add Java to your path. More details may be found here.

    Installing BungeeCord on Linux(top)

    1. As a prerequisite, install Java 7 or above if you don't have it already [Ubuntu, CentOS].
    2. Download the latest BungeeCord build from here.
    3. Place the file inside a new directory dedicated to BungeeCord.
    4. Create a new startup script to launch the the JAR:
    Code (Text):

    java -Xms512M -Xmx512M -jar BungeeCord.jar
    5. Run your start up script.​


    • For Linux, it is vital to use a utility, such as tmux or screen, to keep your remote SSH session alive even after you disconnect, so that the proxy is always running.

    Installing BungeeCord on Mac OS X(top)

    1. As a prerequisite, install Java 7 or above if you don't have it already [OS X].
    2. Download the latest BungeeCord build from here.
    3. Place the file inside a new directory dedicated to BungeeCord.
    4. Create a new startup script to launch the the JAR:
    Code (Text):

    java -Xms512M -Xmx512M -jar BungeeCord.jar
    6. Open Terminal.
    7. Type into Terminal: (Don't hit enter)
    Code (Text):
    chmod a+x
    8. Drag your startup script file into the Terminal window and push ENTER, ensuring that there is a space between chmod a+x and your startup script's location.
    9. Double click your startup script.​


    • You should be running BungeeCord on a server for production use, with Linux preferably


    Depending on your Minecraft host's configuration, you will have two ways to enable the use of BungeeCord through Multicraft.
    • If there's already an option for BungeeCord in the JAR file selection menu, you can simply select it and restart your server upon save. However, this may not be recommended if your host does not keep up to date with the latest bungee builds.
    • If you have access to upload custom server JARs (FTP), download the BungeeCord JAR and enter in the name of the file via the JAR file input box located on the index of the panel. Some hosts may require you to rename your JAR to a specific name (like custom.jar) and then select it from the dropdown menu.
    • If your personal server you have root to, place the bungecord.jar.conf in your daemon jar directory, then update the jar using the admin panel. The jar should now be the client's jar selection.


    • Multicraft on some versions will not show BungeeCord as online, even when it is. It will still work fine, however.
    • Some hosts don't allow BungeeCord, and you should check with your host before installing.

    General Installation Advice(top)

    • It is generally recommended to allocated 512MB RAM for every 500 players. Please keep in mind that additional plugins may impact the amount needed in your case. To allocate more RAM change the -Xms and -Xmx values in the start-up script. To allocate 1GB of RAM, simply enter both values as 1G.
    • The recommended platform to run BungeeCord on is Linux. While you are able to start and use BungeeCord on Windows and Mac OS X, this is not recommended and support may be limited in this case.
    • If you are using Multicraft, you can grab the official BungeeCord config file from their site:


    Once you have successfully installed BungeeCord, it is time to get it working properly. One of the most essential steps is to set your connected server instances (e.g. Spigot, Bukkit) to run in offline-mode, which can be achieved by modifying server.properties. In addition, you will need to set connection-throttle to -1 in bukkit.yml.

    To support online-mode UUIDs, name changes, and IP bans, enable ip_forward: true in BungeeCord's config.yml. If you don't, serious data inconsistencies will occur. Note: you still need to set online-mode to false in the server.properties files of your servers.
    • Set bungeecord: true in spigot.yml throughout all of your Spigot backends.
    • Use VanillaCord throughout all of your vanilla backends.
    • If any backends are using Spigot-CraftBukkit, switch to Spigot and follow the applicable instructions.


    As your servers will now be running without authentication, this poses a new security risk. Users may connect to your servers directly, under any username they wish to use. Unfortunately for them, this issue can be easily combated by restricting access to these servers.

    ↳ BungeeCord and servers on the same machine
    Just edit the server.properties of each server, so that the server-ip value is set to Keep in mind during testing that the player whitelist will be ignored for connections coming from the same host as your proxy!​
    ↳ BungeeCord on a GSP (Minecraft host)
    You will need to secure your setup by using an IP whitelisting plugin to accept connections only from certain IPs (BungeeCord and all regular servers). One such plugin is BungeeGuard, which is recommended over IPWhitelist since IPWhitelist is exploitable if the attacker purchases a BungeeCord server on the same GSP as you.​
    ↳ BungeeCord and servers on different machines
    In this case, a server firewall is needed to ensure no one can access your backend servers. Please see the firewall guide for more information.​

    Adding Servers: You must add new entries for each Minecraft server you wish to link under servers in BungeeCord's config.yml, consisting of the address (IP/host), MOTD, and whether or not it is restricted.
    Please note that any server that you add to your proxy can send Plugin Messages to the BungeeCord or any connected server (as long as they have players online) which might leak information or compromise plugin/server security so you should fully trust the people operating these servers if they aren't your own. (Or find methods to filter/block them)

    Server Icon: Place your 64x64 png file named server-icon.png into the same folder that BungeeCord is in and restart the server.
    #1 jtaylor69, Jul 4, 2014
    Last edited by a moderator: Feb 14, 2017
  2. jtaylor69

    jtaylor69 Retired Moderator

    Need a Mac OSX user to contribute to this article
    • Like Like x 1
  3. It's pretty much the same as Linux. Make the run.sh and put it in the folder with the BungeeCord.jar
  4. Who removed my -xms removal change? XMS Should never be used, Java knows best on how much memory to allocate on boot.
  5. It's important just incase you are running your website/voice server on the same dedicated server.
  6. So i have this BungeeCord network and currently i have ip_forward: false on my BungeeCord server config.
    And on the servers connected to the BungeeCord i have setting BungeeCord: false on spigot.yml

    This means that servers connected to the BungeeCord network will get a wrong UUID for the player who logs in.

    So when 1.8 comes out both of these settings needs to be turned to true but this will cause problems because then when a player will login, he will login with his own IP address, not the BungeeCords ip address.
    So then i can't use this "OnlyProxyJoin" plugin anymore and then people will be able to login with any username to my servers connected to the BungeeCord network.

    So what could i do to block people joining to my offline servers which are connected to the BungeeCord server?

  7. I would recommend making a new thread in the Bungeecord sub-form, you would get the better help. This discussion is used for the wiki.
    • Agree Agree x 1
  8. It's working.
  9. I know, I added it awhile back. If that was even the statement.
  10. This really helped me out thanks :D
  11. Thanks for this post! This helped me a lot
  12. Enjoy the report. ^.^
    • Agree Agree x 1
  13. Thanks it helped me a ton!
  14. Very thorough. Thanks for this well rounded guide.
  15. thank you i will use this
  16. I will definitely recommend this to my friends that are having a hard time with Installation!
  17. Aschorren


    Looks like a great tutorial.

    Thanks OP!
  18. This helped me a lot
  19. Thanks for help :)
  20. disculpen, pero las paginas de BungeedCord estan fallando todas, trato de hacer mi Network y no puedo por que falla al descargar los modulos de la Network, necesito los modulos ya pague todo