Skip to main content
warningServer ErrorsAffects: All versions

How to Fix Velocity/BungeeCord Proxy Errors

Fix proxy errors by enabling matching IP forwarding settings on both the proxy and backend servers.

Quick Fix

Enable IP forwarding on both the proxy and all backend servers. For Velocity, use modern forwarding.

Error Message

If you wish to use IP forwarding, please enable it in your BungeeCord config

How to Fix

1

For BungeeCord: set ip_forward: true in BungeeCord config.yml AND bungeecord: true in spigot.yml

2

For Velocity: set player-info-forwarding-mode=modern in velocity.toml

3

Copy the forwarding secret to all backend servers

4

If not using a proxy, set bungeecord: false in spigot.yml

Common Causes

  • IP forwarding not enabled on both proxy and backend
  • bungeecord: true in spigot.yml but not using BungeeCord
  • Velocity modern forwarding not configured correctly

Diagnostic Steps

  1. Determine if you use BungeeCord or Velocity
  2. Configure forwarding on both proxy and backends
  3. Restart all servers

FAQ

Velocity or BungeeCord?

Velocity is recommended for new setups. It has better performance, security, and modern forwarding support.

Related Errors

Need More Help?