Articles on: Minecraft

Getting started with your Velocity proxy

Lilypad provides top-of-the-line hardware, making us perfect for Minecraft networks who need the best performance. We've made it simple to set up a Velocity-based network on our servers — just follow the steps below:


What will you need?

  • 2 or more Paper-based Minecraft servers on the latest Minecraft version
  • A proxy server, which we can provide for free if you contact support


Once we've set up your proxy for you, we'll need to put your "backend" servers (the ones the proxy will forward connections to) behind a firewall. This will change their IPs so that they're only accessible internally, meaning players will now have to join through the proxy.


  1. Head to our game panel at panel.lilypad.gg and select your proxy server, then go to the Files tab and open the velocity.toml file


  1. Scroll down to the [servers] section and set up your backend servers' names and addresses as appropriate. The names are what players will connect with using the /server command, e.g. /server lobby, and the addresses will need to be the new IP and ports your backend servers have been given, beginning with 172.18.0.1



  1. Copy the text inside the forwarding.secret file on your proxy, as this will be needed to allow your proxy to communicate securely with your backend servers.



  1. Restart your proxy to load in the new configuration.


  1. Visit each of your backend servers in the panel, and follow the below process to configure them for use with the proxy:
  • Open server.properties and set online-mode to false, and network-compression-threshold to -1
  • Open config/paper-global.yml, scroll down to the velocity section and set enabled to true, online-mode to true and then paste in the forwarding secret you copied earlier



  • If you have Geyser installed on the server, remove it (but keep Floodgate) and install/configure Geyser-Velocity + Floodgate-Velocity on the proxy instead — you will need to copy the key.pem from the proxy to the backend servers
  • If you are running a Fabric backend server, install FabricProxy-Lite and follow its instructions for setup


  1. You should be good to go! Get in touch if you run into any issues while getting things set up.

Updated on: 10/07/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!