Skip to content

Velocity Proxy Setup

Velocity is a lightweight and modern Minecraft proxy used to connect multiple servers into a single network.
You need at least two instances: one backend server and one instance for the proxy itself.

In this example, the network contains an SMP server, a Lobby/Hub, and an Event server.
Together with the proxy, this requires four instances: smp, lobby, event, and proxy.

For the proxy instance, we provide a dedicated Mini Plan starting at 2.80 USD/month.
More details: https://allay-hosting.com/game

This is just an example configuration.
You will need to change the address and the servers section.

bind = "0.0.0.0:19132" # Your proxy instance port
online-mode = true
force-key-authentication = true
player-info-forwarding-mode = "modern"
forced-hosts = {}
compression-threshold = 128
compression-level = 5
[servers]
lobby = "5.175.186.1:30001"
smp = "5.175.186.1:30002"
event = "5.175.186.1:30003"
try = ["lobby"] # Server to connect on join
[forced-hosts]
# can be empty

After saving, copy the contents of the forwarding.secret file.
You will need this value for each backend server.

All backend servers that should connect through Velocity must be configured accordingly.

online-mode=false
proxies:
proxy-protocol: false
velocity:
enabled: true
online-mode: true
secret: YOUR_FORWARDING_SECRET

Replace YOUR_FORWARDING_SECRET with the value from the forwarding.secret file on the proxy instance.

Once the proxy and all backend servers have been configured, restart each instance.
Your network is now ready to use.