> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plugins.avenvault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy Network and IP Forwarding (Velocity / BungeeCord)

> Configure BungeeCord and Velocity IP forwarding on Paper and Spigot backend servers to ensure correct player identification in proxy networks.

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

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

```yaml theme={null}
settings:
  bungeecord: true
```

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

<Warning>
  Ensure your proxy firewall prevents players from connecting directly to the backend port.
</Warning>

### If Using Velocity (Modern Forwarding)

Modern Paper servers natively support Velocity's secure forwarding.

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

```yaml theme={null}
proxies:
  velocity-support:
    enabled: true
    online-mode: true
    secret: "YOUR_VELOCITY_SECRET_HERE"
```

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