How to Configure IP Forwarding for BungeeCord and Velocity

Enable on the proxy

Edit config.yml on your BungeeCord proxy via Files on the XGamingServer panel:

ip_forward: true

Enable on backend servers

Edit spigot.yml on each backend:

settings:
  bungeecord: true

Restart all servers

Restart the proxy and all backend servers.

Set forwarding mode on proxy

Edit velocity.toml:

player-info-forwarding-mode = "modern"

Configure backends

Edit config/paper-global.yml on each Paper backend:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "your-forwarding-secret"

Copy the secret from forwarding.secret in your Velocity server files.

Restart all servers

⚠️ Warning: If you see "If you wish to use IP forwarding, please enable it in your BungeeCord config" — this means ip_forward is not set to true on the proxy.

📝 Note: Velocity's "modern" forwarding is more secure than BungeeCord's. It uses a shared secret to verify the proxy's identity.

See also: BungeeCord Guide | Velocity Guide

If you need help, join our Discord.