Quick Links Downloads - Latest build is generally stable and recommended! Source Code - Use this to browse the code, make pull requests or start hacking on a Bungee plugin. Bug Reports - Issues posted on these forums will be ignored, use this tracker instead. IRC - Come here if you have any questions or difficulties. See the support section below for more information. Introduction For a long time, Minecraft server owners have had a dream; a dream of a free, easy and reliable way to connect multiple servers together. BungeeCord is the answer to this dream. Whether you are a small server wishing to string multiple game modes together, an established 250 player server wishing to expand your capacity, or the megalithic monolith of the ShotBow Network, BungeeCord is ideal for you. The author has been writing similar systems for over a year now, and BungeeCord is the pinnacle of this. Written from the ground up, using all new development practices and principles, BungeeCord aims to be the most efficient, reliable and feature packed system around, already dominating similar systems costing hundreds of dollars each month. With the ability to load BungeeCord plugins, written against BungeeCord's expansive API, and many plugin message based hooks available for use by Bukkit plugins and back-end servers, the BungeeCord system can not only seamlessly integrate with existing setups, but can be limitlessly expanded to create anything from custom global ban integration to your very own MMO multiverse. Getting Started BungeeCord works best on a VPS / dedicated server, however it can also work on various control panels such as Multicraft. If you choose to install BungeeCord, it is expected that you are familiar with Minecraft server administration, and if you own a VPS / dedicated server, it is expected you have a basic knowledge of SSH and Linux servers. Installation Make sure that your server is equipped with Java 7 Make a new folder to run your BungeeCord in with the command Code (bash): mkdir bungee && cd bungee Download your preferred BungeeCord version and upload it to this folder. You can do this straight from the server by issuing the Code (bash): wget 'http://ci.md-5.net/job/BungeeCord/lastSuccessfulBuild/artifact/bootstrap/target/BungeeCord.jar' command. Start BungeeCord with the command Code (bash): java -jar BungeeCord.jar . This will generate the necessary configuration files. Then type /end into the console to stop BungeeCord Multicraft If you are using Multicraft, you can get their official config file from here: http://www.multicraft.org/download/conf/?file=bungeecord.jar.conf The official guide is currently under construction, but for now please see http://www.spigotmc.org/threads/700/for information on how to install and configure BungeeCord. Videos For reasons unknown to me, some people need a video to watch before they attempt to setup BungeeCord. Over the months we have amassed a few videos from users in order to help you get started with BungeeCord, you may view them below. Installation Videos (Move your mouse to reveal the content) Installation Videos (open) Installation Videos (close) Post Installation As your servers will now be running in offline mode, they are open to users connecting as whoever they want to, and wreaking havoc. Unfortunately for them, this is something that we don't want to happen. Whilst you may be tempted to install an IP whitelist plugin, there are much better ways of preventing users from even getting to the login stage, and thus safeguarding yourself from whatever they may throw at you. BungeeCord on same machine as all servers Simply open up the server.properties file on each of your servers, and set the server-ip option to 127.0.0.1, and then restart the server. BungeeCord on different machine to some servers First you need to set connection-throttle to -1 in bukkit.yml. This is a VERY important step, and if you don't do it, BungeeCord will NOT work properly. The only way to secure this setup entirely is to use a firewall to prevent access to them at all from the outside world. Luckily most Linux distributions include an easy to use firewall named iptables. Once you have everything set up you can activate this firewall with the command below, but first replace $BUNGEE_IP with the server running BungeeCord, and $SERVER_PORT with the port of your Minecraft server. Please note that all commands in this section must be run as root. Code (bash): iptables -I INPUT ! -s $BUNGEE_IP -p tcp --dport $SERVER_PORT -j DROP Next you must make these rules automatically apply each reboot. The commands used to do this vary depending on which Linux distribution you use: CentOS Code (bash): /etc/init.d/iptables save Debian / Ubuntu Code (bash): apt-get install iptables-persistent /etc/init.d/iptables-persistent save If at any time you find yourself unable to connect to your servers after messing with the firewall, simply enter this command to completely reset it: Code (bash): iptables --flush Inbuilt Commands <required argument> [optional argument] Plugins BungeeCord currently has an expansive plugin API to allow developers to create rich Java plugins. Currently there isn't much documentation, however you may review and download all Bungee plugins from the resources tab above. Support If you have a question or problem and don't mind waiting a little for a reply, you may post it in this thread. For development related questions, please post them in development subforum, and for issues, bugs and feature requests, please post them on the issue tracker at the top of this post. The preferred way to get to support is via realtime IRC chat. You can join us at #md_5 on irc.esper.net, or for your convenience a webchat link is provided below. If you do ask for help on IRC, be sure to stay for as long as you can, or until you get an answer. Also please be sure to pastebin any relevant errors and logs longer than 3 lines. http://webchat.esper.net/?nick=&channels=md_5 Sponsors Various individuals, companies and servers have made BungeeCord what it is today; for a full list of code contributions you may check the commit logs on GitHub. Staminus Communications however plays a bigger role than most, providing fantastic hosting and sponsorship for these forums and my other projects. If you find yourself in a spot of trouble with DDOS attacks, BungeeCord hosted on a Staminus server is a great, cost effective way to mitigate their impact. For more information click the logo below.