MC TOOLBOXServer & Files
Starter config.yml aligned with the SpigotMC BungeeCord Configuration Guide: listeners, servers, online_mode, ip_forward, permissions, and forced hosts. Review before production.
With ip_forward true, set each backend Spigot/Paper online-mode=false and enable BungeeCord mode in backend config. See Spigot wiki: BungeeCord Configuration Guide and IP Forwarding.
# BungeeCord config.yml starter - based on SpigotMC BungeeCord Configuration Guide
# Backend Spigot/Paper servers should use online-mode=false when ip_forward is true.
# Also set bungeecord: true (Paper: settings.bungeecord / spigot.yml paper settings).
server_connect_timeout: 5000
remote_ping_cache: -1
forge_support: false
player_limit: -1
permissions:
default:
- bungeecord.command.server
- bungeecord.command.list
admin:
- bungeecord.command.alert
- bungeecord.command.end
- bungeecord.command.ip
- bungeecord.command.reload
timeout: 30000
log_commands: false
network_compression_threshold: 256
online_mode: true
disabled_commands: []
servers:
lobby:
motd: '&1Just another BungeeCord - Forced Host'
address: 'localhost:25566'
restricted: false
listeners:
- query_port: 25577
motd: '&1A BungeeCord Server'
tab_list: GLOBAL_PING
query_enabled: false
proxy_protocol: false
forced_hosts:
pvp.example.com: pvp
ping_passthrough: false
priorities:
- lobby
bind_local_address: true
host: '0.0.0.0:25577'
max_players: 1
tab_size: 60
force_default_server: false
ip_forward: true
remote_ping_timeout: 5000
prevent_proxy_connections: false
groups: {}
connection_throttle: 4000
stats: 4a7666ca-8f8a-4e72-bcf6-adb249a4bc84
connection_throttle_limit: 3
log_pings: true
Server & Files
A BungeeCord proxy needs a config.yml with listeners, server list entries, priorities, and online-mode / IP-forward settings before it will boot in a useful way. This tool builds a starter file for lobby-plus-game layouts so you are not copying random pastebins. It is not a finished production lockdown and not a Velocity TOML generator.
You set listener host and MOTD, map backend server names to host:port, choose priority order, optional forced hosts, and the common online_mode and ip_forward flags. The output is a config.yml in the general shape Bungee expects. You still place it on the proxy machine and harden permissions, firewalls, and groups.
When ip_forward is true, backend Paper or Spigot servers usually run online-mode=false and are configured to trust the proxy. Get that wrong and you see broken UUIDs, cracked joins, or security holes. Only expose the proxy port publicly; keep game ports on private networks when you can.
Priorities decide which backend players land on by default. Forced hosts map a domain name to a specific server entry so play.example.com and skyblock.example.com can split traffic. DNS must point those names at the proxy, not at random backend IPs, or the forced-host map will never run.
Replace example hosts, default passwords-looking groups, and sample MOTDs. Review connection throttle, query settings, and permissions. Treat the download as a scaffold you review line by line, not as a file you open to the internet blindly.
Velocity uses a different config format and modern forwarding modes. If your network is Velocity-first, use Velocity docs for that path. This page targets classic BungeeCord-style config.yml for people still on that stack or learning proxy basics.
Quick questionsNot safely. Fix hosts, permissions, and firewall rules, then open ports carefully.
Different format. This generates Bungee config.yml, not Velocity TOML.
The proxy authenticates with Mojang and forwards identity. Backends trust that only when forwarding is set up correctly.
Check priorities, forced hosts, and DNS. The proxy only routes what the config and domain names describe.
Waterfall is Bungee-compatible enough for many configs, but always test on your real proxy jar.
If something feels wrong, a Minecraft version is missing, the wording is confusing, or you have a better workflow idea, send it over. Real player feedback is how these tools get sharper.