Velocity Proxy Guide

1. Why Velocity?

Velocity is the modern, high-performance proxy that replaces BungeeCord. It supports modern IP forwarding, Geyser translation and per-backend permissions. We recommend it for any network with two or more backend servers.

2. Deploy the proxy

Order a small VPS (1–2 GB) from /hosting/vps-budget, then install Velocity with the Paper / Spigot / Fabric backends you want behind it. Each backend runs as its own Lunify service.

3. velocity.toml

Add your backend servers in the [servers] block:

[servers]
lobby = { address = "127.0.0.1:25565", motd = "Lobby" }
survival = { address = "127.0.0.1:25566", motd = "Survival" }

try = ["lobby"]

4. IP forwarding

Set player-info-forwarding = "modern" on Velocity, and in spigot.yml / paper-global.yml of every backend set:

proxies: velocity: enabled: true secret: "<shared secret>"

Keep the secret identical on all backends.

5. Plugins that need proxy awareness

Install VelocityTab, LuckPerms (with a shared MySQL database) and Geyser on the proxy only. Backends should not run BungeeCord-style plugins.