Configuring player information forwarding
Velocity supports forwarding information about your players to your servers, such as IP addresses, UUIDs and skins. Velocity supports two different methods for forwarding player information to your servers, which are described in the appropriate sections.
Configuring modern forwarding
modern forwarding is a Velocity-native format. It forwards all player information in an efficient binary format and
employs a MAC code to make it much more difficult to trick the server into impersonating your Velocity proxy.
However, it is only available for Minecraft 1.13 or higher.
To use modern forwarding with any supported server implementation, set the
player-info-forwarding setting in
modern. You then need to ensure your server is properly configured to use velocity forwarding by
following the steps in the appropriate section below:
You will need build 377 and above for Paper 1.13+ to use modern forwarding.
To allow Paper to understand the forwarding player data, in your
to true and
settings.velocity-support.secret to match the secret in your
velocity.toml. You must also set
settings.velocity-support.online-mode to the
online-mode setting in your
velocity.toml. Once you're done
paper.yml, reboot your server.
A mod called FabricProxy allows you to use Velocity modern forwarding with a modded server using Fabric.
Configuring legacy BungeeCord-compatible forwarding
legacy forwarding is the player information forwarding protocol that is used by BungeeCord when enabling IP
forwarding from BungeeCord. Due to this, it is ubiquitous and well-supported by most server implementations. It has
excellent compatibility (supporting version sas old as 1.7.2, released in 2013) and will work with Forge if you
also install SpongeForge on your modded server and configure it correctly. However, it is not as secure as the
If you need to use BungeeCord-compatible forwarding, simply set your
player-infor-forwarding setting in
legacy. You will also need to make sure your server is properly configured to understand the data sent by
Configuring Spigot / Paper
To make Spigot or Paper understand the data forwarded from Velocity, set
true in your
spigot.yml and then reboot your server.
To configure Sponge to understand the data forwarded from Velocity, set
bungeecord.ip-forwarding to true in your
config/sponge/global.conf file, and then restart your Sponge server.