Skip to content
Minecraft Gateway · Networks

Velocity and BungeeCord network hosting on your own VM

A Minecraft network is a proxy with several servers behind it. Minecraft Gateway gives you a virtual machine dedicated to you, where you run the proxy and every backend from one panel.

How a Minecraft network is built

Players never connect to your game servers directly. They connect to a proxy, which passes them on to a backend server: usually a lobby first, then survival, creative or minigames. Moving between them with /server or a lobby menu does not disconnect the player.

The proxy is light. It handles logins and routing, not the game world. The backends are normal Paper or Purpur servers that do the real work. Because everything shares one address, players only ever see a single server.

Velocity, BungeeCord or Waterfall

VelocityBungeeCordWaterfall
Maintained byPaperMCSpigotMCPaperMC (development has ended)
Player info forwardingModern forwarding with a shared secretLegacy IP forwardingLegacy IP forwarding
PluginsVelocity pluginsBungeeCord pluginsBungeeCord plugins
Best forNew networksNetworks that depend on BungeeCord pluginsExisting setups only

For a new network, choose Velocity. Its modern forwarding needs Minecraft 1.13 or newer on the backends; older backends can use legacy forwarding.

Plan the RAM on one machine

On Gateway, the proxy and all backends share the VM's memory, so add them up before you choose. Leave about 1 GB for the system itself.

  • Proxy: 512 MB–1 GB is enough for most networks.
  • Lobby: 1–2 GB, kept small with a short view distance.
  • Survival: 3–6 GB depending on players and plugins.
  • Each minigame server: 1–2 GB.
  • Example on Gateway M (8 GB): proxy 1 GB, lobby 1.5 GB, survival 4 GB, the rest for the system.

Plans

PlanWhat you getPrice
Gateway S2 vCPU · 4 GB RAM · 40 GB NVMe€11.99/mo
Gateway L6 vCPU · 16 GB RAM · 160 GB NVMe€36.99/mo
Gateway NetworkVelocity + …On request

Prices per month. Billed monthly, no long contract.

See all plans

Set up your network on Gateway

  1. Request a Gateway machineChoose S, M or L, or ask for a Network setup. The VM is ready a few minutes after it is created.
  2. Install the proxyInstall Velocity, Waterfall or BungeeCord from the panel, at the latest available version.
  3. Create the backendsAdd a lobby, survival, minigames, each with its own loader and version, each managed from the panel.
  4. Turn on forwardingOn Velocity, set player-info-forwarding-mode = "modern" in velocity.toml, then on each Paper backend enable proxies.velocity in config/paper-global.yml with the same secret and set online-mode=false in server.properties.
  5. Point your addressUse a custom subdomain or your own domain for the proxy. Set try = ["lobby"] so new players land in the lobby.

Security basics for any network

  • Backends run with online-mode=false, so they must only accept connections from the proxy. Make them listen on 127.0.0.1 or block their ports from outside.
  • Keep the forwarding secret private. Anyone who has it can fake a player's identity on your backends.
  • On BungeeCord or Waterfall, set ip_forward: true in config.yml and bungeecord: true in each backend's spigot.yml.
  • Use a permissions plugin with a shared database, so ranks stay the same on every backend.

Frequently asked questions

Can I run the proxy and all backends on one Gateway machine?
Yes. That is what Gateway is for: a virtual machine dedicated to you, with a Velocity, Waterfall or BungeeCord proxy and several backend servers, each managed from the panel.
Which Gateway size do I need for a network?
Add up the RAM of the proxy and every backend, plus about 1 GB for the system. A small lobby plus survival fits Gateway S (4 GB) tightly, M (8 GB) gives room for a few servers, and L (16 GB) suits several busy backends. Bigger networks are available on request.
Is Waterfall still a good choice?
Waterfall is no longer developed by PaperMC, which recommends Velocity instead. Keep it only if you have an existing setup that depends on it.
Players are kicked with a forwarding error when they join a backend. What is wrong?
If the message is 'Failed to verify username', the backend still has online-mode=true; set it to false. If it says the server requires you to connect with Velocity, forwarding is off on the backend or the secret does not match. Check that the forwarding mode and the secret are the same on the proxy and every backend.
Can I put Fabric or Forge servers behind Velocity?
Fabric backends can work with an extra forwarding mod such as FabricProxy-Lite. Forge behind a proxy is harder and depends on the version. Paper and Purpur backends are the simplest.
Can I use my own domain for the network?
Yes. Gateway includes a custom subdomain or your own domain, so players join the proxy at your address.