BungeeCord Installation

Feb 13, 2017 at 12:28 AM
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
    pause
    5. Double-click the batch file.​

    Advice(top)

    • 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):
    #!/bin/sh

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

    Advice(top)

    • 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):
    #!/bin/sh

    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.​

    Advice(top)

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

    Multicraft(top)

    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.

    Advice(top)

    • 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:
      http://www.multicraft.org/download/conf/?file=bungeecord.jar.conf

    Post-Installation(top)

    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_forwarding: 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 127.0.0.1. 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 IPWhitelist.​
    ↳ 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.

    Server Icon: Place your 64x64 png file named server-icon.png into the same folder that BungeeCord is in and restart the server.
    ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬


  • Loading...
  • Loading...