Introduction to BungeeCord: How BungeeCord Works

We have a video explanation of BungeeCord here:


This article is the only guide you will need to understand BungeeCord. This article will take you from a beginner to a complete understanding of BungeeCord in under 2 minutes.

What is BungeeCord?

BungeeCord is a server type for Minecraft that allows you to connect several servers together, so players can transfer between them without having to disconnect from the server.

BungeeCord is not a plugin

Users that are new to BungeeCord commonly assume that BungeeCord is a plugin for Spigot or Craftbukkit. This is not the case. Instead, BungeeCord is a server type, in the same way Spigot and Craftbukkit are.

BungeeCord cannot run Spigot or Craftbukkit plugins

Although it is developed and maintained by the Spigot team, BungeeCord is not Minecraft software and does not share any of the Spigot or Craftbukkit code. This means Spigot plugins are not compatible with BungeeCord. BungeeCord does support plugins, however only plugins that have been specifically developed for BungeeCord are compatible with BungeeCord.

BungeeCord cannot run worlds, players, etc

Since BungeeCord is not Minecraft software and does not run any of the Minecraft code, worlds and players cannot actually exist on a BungeeCord instance. BungeeCord is not a Minecraft server — rather, it is a proxy that simply bridges the connection between the player and server. It pretends to be a Minecraft server, but it isn’t. It’s only purpose is to forward you to one of the Minecraft servers under the network — if no servers are connected to the BungeeCord instance, the player will simply be disconnected upon joining as there is no Minecraft server under the network for them to actually play on.

BungeeCord requires a minimum of 3 servers

Your BungeeCord network will need a server for each of the servers you wish to run, plus an additional server to run BungeeCord.

The minimum requirements for a BungeeCord setup is as follows:

  • Two Minecraft servers that you wish to connect together (typically running Spigot).

  • An additional Minecraft server to run the BungeeCord Software.

BungeeCord cannot be used as a Hub or Lobby server — you would need an additional server, running Minecraft software (Spigot) to do this.

BungeeCord Network Diagram

A diagram showing the server structure of a BungeeCord network.

A diagram showing the server structure of a BungeeCord network.

How can I create a BungeeCord network?

Most Minecraft server hosts support BungeeCord networks. At Shockbyte, it’s very easy and can be done in just a couple clicks.

If you’re running your own VPS or Dedicated server the setup process is much more difficult — the BungeeCord documentation will be able to help you configure this: https://www.spigotmc.org/wiki/bungeecord/

If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php

Mitchell Smith

Managing Director @ Shockbyte

  • bungeecord, Spigot, proxy, explanation
  • 73 Users Found This Useful
Was this answer helpful?

Related Articles

BungeeCord Won't Start

There are several reasons why a BungeeCord server may not start up. Remember that the first thing...

IP Forwarding in BungeeCord

By default, servers connected under BungeeCord will not display the IP of the player, but rather...

Automatically Setup a BungeeCord Network with Shockbyte

We have a video tutorial on installing an entire BungeeCord network in under 60 seconds:   A...