My players can't connect through the proxy. What's wrong?

Check that your forwarding secret in Velocity's configuration matches exactly with the secret in your server's FabricProxy-Lite.toml file, and that modern forwarding mode is enabled in Velocity.

What's the difference between FabricProxy and FabricProxy Lite?

FabricProxy Lite only supports Velocity proxies (not BungeeCord) and has a smaller footprint, making it more compatible with other mods on your server.

Where do I find the configuration file?

After starting your server with the mod installed, the configuration file is generated at config/FabricProxy-Lite.toml.

What happens if I don't set a forwarding secret?

Without a matching forwarding secret between Velocity and your server, player information won't be properly forwarded and connections will fail or players will appear as different users.

FabricProxy Lite Mod FAQ — FabricProxy Lite Mod Wiki

DownloadFabricProxy Lite Mod

Get the files on 9Minecraft

Do I need to install this mod on my client?

No, FabricProxy Lite is server-side only. Install it only on your Fabric server in the mods folder, not on player clients.

How do I enable offline mode for players connecting through the proxy?

Open your FabricProxy-Lite.toml config file and adjust the hackOnlineMode setting to allow players to join without authentication when proxied.

Do I need Fabric API installed?

Yes, Fabric API must be in your mods folder alongside FabricProxy Lite for the mod to function.

Can I use this mod with BungeeCord?

No, FabricProxy Lite only works with Velocity. If you need BungeeCord support, use the full FabricProxy mod instead.

Why are players seeing different UUIDs when proxied?

Ensure your forwarding secret is correctly configured on both Velocity and the Fabric server, as a mismatch will cause the server to reject forwarded player data.

Does this mod affect server performance?

FabricProxy Lite is designed as a lightweight alternative, so it has minimal performance impact compared to the full FabricProxy mod.