How to Set Up a Velocity Proxy

Learn how to set up Velocity as a modern alternative to BungeeCord for server networks.

Velocity is a modern Minecraft proxy with better security and performance than BungeeCord. It's recommended for new networks.

Setting Up Velocity

Create a Velocity server

Set up a server with Velocity as the type in Startup on the XGamingServer panel.

Configure velocity.toml

Go to Files and edit velocity.toml:

bind = "0.0.0.0:25577"
motd = "&aMy Network"
show-max-players = 100
player-info-forwarding-mode = "modern"

[servers]
lobby = "lobby-ip:lobby-port"
survival = "survival-ip:survival-port"

try = ["lobby"]

Configure backend servers

On each Paper backend server, edit config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: ""  # Copy from velocity forwarding.secret

Copy the forwarding secret

Find forwarding.secret in your Velocity server files and copy its contents into each backend's Paper config.

Set online-mode on backends

Edit server.properties on each backend:

online-mode=false

Velocity vs BungeeCord

Feature	Velocity	BungeeCord
Security	Modern forwarding (secure by default)	Requires BungeeGuard
Performance	Better	Good
Plugin API	Modern	Legacy
Configuration	TOML (cleaner)	YAML

💡 Tip: Velocity's "modern" forwarding mode is inherently secure — no need for BungeeGuard.

See also: BungeeCord Guide | IP Forwarding

If you need help, join our Discord.