Proxy Network and IP Forwarding (Velocity / BungeeCord) - Avenvault Docs

Servers are almost always part of a larger proxy network. To ensure our plugins correctly identify players and do not trigger false positives due to proxy routing, you must configure your backend servers to correctly accept forwarded data.

Configuring Spigot / Paper Backend Servers

If Using BungeeCord or Waterfall

Open spigot.yml in your backend game server.
Locate the bungeecord setting and set it to true:

settings:
  bungeecord: true

Open server.properties and ensure online-mode is set to false.

Ensure your proxy firewall prevents players from connecting directly to the backend port.

If Using Velocity (Modern Forwarding)

Modern Paper servers natively support Velocity’s secure forwarding.

Open config/paper-global.yml on your backend server.
Locate the Velocity configuration block:

proxies:
  velocity-support:
    enabled: true
    online-mode: true
    secret: "YOUR_VELOCITY_SECRET_HERE"

Paste the secret generated by your Velocity proxy into the secret field.
Ensure online-mode is set to false in your server.properties.