You decide which services we may enable for analytics, personalization, and external content.
We use cookies and similar technologies on our website to personalize content, embed external media, and better understand how individual areas are used.
Necessary cookies
These entries support essential functions such as security, stability, and form processing.
Optional sections
AnalyticsMarketingPersonalizationExternal media
Your data may be processed with your consent or on the basis of legitimate interests. In the cookie settings, you can reject or explicitly allow each optional category.
Some services process personal data in third countries. By consenting, you also agree to this transfer. You can find more information in our Privacy Policy.
You can reopen and change your selection at any time. · 1.0.2
Minecraft: BungeeCord Server Configuration Settings
Learn how to optimally configure and manage your BungeeCord server network for better performance and player experience → Find out more now
10 November 20265 min read0 Views0 helpful
What is a BungeeCord configuration for?
BungeeCord manages a bundle of servers connected via the proxy server (BungeeCord server). To customize this server network, you need to edit the config.yml file. On this page, you will learn the exact meaning of each setting and get additional information about the effects on sub-servers like PaperSpigot and Bukkit servers.
FAQ
Frequently asked questions
It specifies how many players can connect to the server simultaneously. Unlike max_players in listeners, this is the internal absolute total player count.
When set to true, players with a Forge client (for modpacks) can join the server. If false, such connections are rejected.
It defines how long the server can go without sending signals to players before shutting down and disconnecting all connections. The default is 30000 (30 seconds).
No, these are exclusively BungeeCord permissions, not Spigot/Bukkit permissions.
Feedback
Was this article helpful?
Your feedback helps us prioritize and improve content.
0 of 0 Users found this article helpful.
Personal support
Need more help than the guide provides?
Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.
Navigation
Minecraft
Settings
forge_support
This value can be set to false or true. If set to true, players with a Forge client (intended for modpacks) can join the server. If set to false, these connections are rejected.
player_limit
This value indicates how many players can connect to the server simultaneously. Compared to the max_players value in the listeners, this is the internal, absolute total player count.
permissions
Here you can assign certain permissions to specific groups. These are only BungeeCord permissions and not, for example, Spigot/Bukkit permissions.
Syntax and indentation (2 spaces each) are important:
This number indicates how long the server can go without sending signals to players before shutting down and disconnecting all connections. By default, this value is set to 30000, which corresponds to a maximum response time of 30 seconds.
log_commands
This value can be set to false or true. If set to true, a message is written to the console whenever a player executes a BungeeCord command. If false, this message is not shown.
network_compression_threshold
This sets the size of packets sent to players. A smaller value than the default 256, e.g., 128, can improve connection quality for more distant users. However, this also leads to significantly higher CPU usage, so this setting should be changed with caution.
online_mode
This value can be set to false or true. If true, only players who have purchased Minecraft can join the server. If false, cracked players can also join since no communication with the Mojang server occurs.
Important: If cracked players are allowed on your server, you should use an authentication plugin; otherwise, others could impersonate you and gain admin rights.
disabled_commands
Here you can list commands that should be disabled and not executable across the entire network. This restriction applies to all players in the network.
servers
This list shows all sub-servers in your network. If a server is missing here, it will not be integrated into your server system.
Syntax and indentation (2 spaces each) are important:
The motd is the message shown in your server list when you ping a sub-server via the forced_hosts function:
Under address enter the corresponding IP of the sub-server. If restricted is set to true, the player must have the permission bungeecord.server.ServerName to enter the sub-server.
listeners
This variable contains many options important for connecting to the BungeeCord server. Multiple listeners can be created to allow connections to different IP addresses and ports. A listener consists of the following configuration values:
query_port - Defines the listener's port.
motd - Defines the message shown in the server list when the player has the BungeeCord server directly in their list.
tab_list - Choose between GLOBAL_PING, GLOBAL, and SERVER. GLOBAL_PING shows all players including their pings in the tab list. GLOBAL shows all players across all servers but without ping. SERVER shows only players on the same sub-server. Important: This feature does not work in versions 1.8 and older.
query_enabled - Can be false or true. If true, a UDP query is checked during the DNS process, allowing only such connections. If false, other connections via forwarding to the server are possible.
proxy_protocol - Can be false or true. If true, you can use the HAProxy protocol. If false, the protocol is rejected.
forced_hosts - Allows direct connections to sub-servers. Syntax: Your.OwnDomain.net: ServerName
ping_passthrough - Can be false or true. If true, when pinging the sub-server via forced_hosts, you see the real MOTD of the sub-server instead of the MOTD from the BungeeCord config. If false, the value from servers is returned.
priorities - List servers in descending order for which players should connect first. A server is skipped if offline or unavailable.
bind_local_address - Can be false or true. If true, the system always tries to forward players to servers listening on the same IP as the BungeeCord server. If false, sub-servers can have different IP addresses. Relevant only for networks running servers on different systems.
host - Sets the IP and port of the host. If 0.0.0.0 is set as IP, all IP addresses and domains forwarding to the host are accepted.
max_players - Numeric value determining the maximum player count for this listener.
tab_size - Sets the maximum number of players shown in the tab list.
force_default_server - Can be false or true. If true, players always connect to the default server (the first available server in priorities). If false, players connect to the sub-server they were last online on. Important: If enabled, connections via forced_hosts are also forwarded to the default server.
ip_forward
Can be false or true. If true, players can only access the network directly through the BungeeCord server. If false, players can also connect directly to a sub-server if they know IP and port.
Important: If online_mode is true, you should enable this feature to close a security vulnerability.
prevent_proxy_connections
Can be false or true. If true, the IP addresses of connected players are sent to the Mojang server. If false, the server prevents IP forwarding to Mojang.
This setting has no real impact on gameplay.
groups
Here you can assign one or more groups to individual players. They then receive the associated BungeeCord permissions as defined in permissions.
Syntax and indentation (2 spaces each) are important:
Code
groups:
PlayerName:
- GroupName
connection_throttle
Defines how long a player must wait before trying to connect to the server again. By default, this is set to 4000, which corresponds to a maximum wait time of 4 seconds.
stats
BungeeCord inserts a randomly generated code here. It is recommended not to change this code, as it helps optimize BungeeCord and fix bugs. Analytics data is sent anonymously and encrypted to the developers.
connection_throttle_limit
Determines how many connection attempts a player has before they must wait the connection_throttle time to try connecting again.
Server hosting from €2.49 / month, online instantly, DDoS protection included.
Preferred source on Google
