When setting up a BungeeCord network for Minecraft servers, a common issue faced by server administrators is the "Server is in setup mode" error. This problem often arises when attempting to run the BungeeCord setup, which involves enabling "BungeeCord" mode in the spigot.yml file and installing the "IPWhitelist" plugin. If these steps are executed without a BungeeCord network actually running, players will be unable to connect to the server and will encounter this error message. This guide will walk you through resolving this issue.

Understanding the Cause

The "Server is in setup mode" error typically occurs when the server is configured for BungeeCord, but the BungeeCord proxy is not properly set up or running. This misconfiguration leads to a failure in connecting the server with the BungeeCord network, resulting in the error message when players attempt to join.

Steps to Resolve the Issue

To fix the "Server is in setup mode" error, follow these steps:

  1. Check BungeeCord Network: Ensure that your BungeeCord network is correctly set up and running. This involves configuring your BungeeCord proxy and ensuring that all linked servers are properly connected to this network.
  2. Review spigot.yml Settings: In the spigot.yml file, verify that the BungeeCord mode is correctly enabled. This setting is crucial for the server to recognize and connect to the BungeeCord proxy.
  3. IPWhitelist Plugin: Confirm that the IPWhitelist plugin is installed and configured correctly. This plugin is used to manage connections to your server within the BungeeCord network.
  4. Restart the Server: After making the necessary adjustments, restart your Minecraft server to apply the changes.

Alternative Solutions

If the above steps do not resolve the issue, consider the following alternatives:

  • Disable BungeeCord Mode Temporarily: Temporarily disable BungeeCord mode in the spigot.yml file to allow direct connections. This can be a temporary fix to allow players to join while you troubleshoot the BungeeCord network.
  • Consult BungeeCord Documentation: Review the official BungeeCord documentation for additional insights and common troubleshooting steps.


Resolving the "Server is in setup mode" error requires ensuring that your BungeeCord network is correctly set up and that your server settings are properly configured for this environment. By following the steps outlined above, you can effectively troubleshoot and fix this issue, allowing players to connect to your server seamlessly.

Was this answer helpful? 0 Users Found This Useful (0 Votes)