Velocity and BungeeCord Setup: Secure Network Wizard

Set up a Velocity or BungeeCord network step by step: velocity.toml, Paper forwarding, firewall and Geyser/Floodgate settings all at once.

Why should a proxy network be set up securely?

In a Velocity or BungeeCord network, players connect to the proxy first, and the proxy transfers them to the backend servers (lobby, survival…). Because backend servers run with online-mode=false, if the backend server's port is open to the outside, someone can bypass the proxy and connect directly to that port, and join with any player name, even a staff name. This is the cause of the most common "OP stolen" incidents on cracked servers.

  • Modern forwarding (Velocity) makes it harder to impersonate the proxy but doesn't replace a firewall; they should be used together.
  • If they're all on the same machine, the simplest solution is to open the backend servers only inside the machine with server-ip=127.0.0.1.
  • BungeeCord's legacy forwarding is "fundamentally insecure" according to PaperMC; if you use BungeeCord, BungeeGuard and a firewall are mandatory.
  • On a cracked network, install the login plugin (nLogin, LibreLogin, JPremium) on the proxy; don't give OP, manage permissions with LuckPerms.

After setup, verify with Port Check that the backend port is closed from the outside, and score all your security settings with Security Check.

Guides related to this tool

Frequently Asked Questions

Velocity or BungeeCord?

Velocity. It's developed by PaperMC, is faster and is more secure with modern forwarding. BungeeCord's old forwarding is fundamentally insecure compared to PaperMC's.

What should online-mode be on a server behind a proxy?

On backend servers online-mode is always false; the proxy handles player verification. On a premium network, online-mode must be true on the proxy.

Why should the backend server port be closed?

If the backend server is reachable from outside, someone can bypass the proxy and join with any name they want (including a staff member's name). Use server-ip=127.0.0.1 on the same machine, and a firewall on separate machines.

Other Minecraft Server Tools

Is your server ready? Add your server to the list, collect votes and automatically reward your players. All tools →