Set up FabricProxy Lite to receive player data from Velocity

Generate and configure the mod

Place the FabricProxy Lite mod .jar file in your Fabric server's mods folder alongside Fabric API, then start the server. This generates config/FabricProxy-Lite.toml.

Match secrets between proxy and server

Open FabricProxy-Lite.toml and locate the secret parameter. Copy this value exactly.

On your Velocity proxy, open velocity.toml and:

1. Set forwarding-mode to modern

2. Set forwarding-secret to the exact same secret from your Fabric server config

Both values must match perfectly, or the server will reject player connections from the proxy.

Verify the connection

Restart both the Velocity proxy and Fabric server. When players connect through Velocity, they should appear on the server with their correct usernames and UUIDs. Check your server logs for any authentication errors—if you see rejection messages, double-check that the secrets are identical.