
Modrinth · Minecraft mod
FabricProxy-Lite
Fabric mod for support forward player data from velocity
Quick answer
Which FabricProxy-Lite release should I use?
FabricProxy-Lite v2.12.0 targets 26.1, 26.1.1, 26.1.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.
Where it goes
Is FabricProxy-Lite required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does FabricProxy-Lite v2.12.0 need?
v2.12.0. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add FabricProxy-Lite without breaking your instance.
Built for FabricProxy-Lite v2.12.0. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use v2.12.0. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside v2.12.0. It opens that exact file at the source.
About this project
What does FabricProxy-Lite add?
Same as FabricProxy but only supports Velocity and uses Fabric-API to handle Velocity packets.
This one will have better compatibility with other mods.
Setup
- Put the mod into the mods folder
- Start the server to generate the config
- Configure Velocity
player-info-forwarding-modetomodernand settingforwarding-secret - Configure
secretinconfig/FabricProxy-Lite.tomlto match Velocity config
Config
Here are all the parameters that you can set in the FabricProxy-Lite.toml config file or environment variables. Note that all properties require a value, but if the property isn't specified in the config file it'll just get populated by the default value. So the parameters that are marked as required needs a manually added value i.e. the Velocity forwarding secret.
| Name | Environment Variable | Description | Default | Required |
|---|---|---|---|---|
hackOnlineMode |
FABRIC_PROXY_HACK_ONLINE_MODE |
Allows connection through a proxy without disabling online-mode. | true |
|
hackEarlySend |
FABRIC_PROXY_HACK_EARLY_SEND |
Fabric-API can't send packet before QUERY_START event, so player info(UUID) will not ready at QUERY_START event. Setting hackEarlySend to true will use mixin for early send packet to velocity. This is required for some mods, such as LuckPerms. |
false |
|
hackMessageChain |
FABRIC_PROXY_HACK_MESSAGE_CHAIN |
This option fixes players being kicked for Received chat packet with missing or invalid signature. or Chat message validation failure, which only happens when the player switches to another server. See #30 and #121 for more info. |
false |
|
disconnectMessage |
FABRIC_PROXY_DISCONNECT_MESSAGE |
The custom disconnect/kick message for users that aren't connecting through Velocity. | "This server requires you to connect with Velocity." |
|
secret |
FABRIC_PROXY_SECRET |
The Velocity forwarding secret. This should be the same random string as in Velocity's forwarding.secret file. Alternatively you could set the FABRIC_PROXY_SECRET_FILE environment variable to read the secret from a file instead of config. |
✓ |
Report Issue
If you have found something wrong, like mod compatibility or login problem, follow the steps below to let us know:
- Search for the issue, and find if there's already one. You can also add some additional info you got.
- If there's no such issue matches yours, create an issue by clicking the "New issue" button.
- Summary the problem and write it into the title, then describe the issue as detailed as you can, and make sure to provide any of the logs so we can know what's really happened.
- Check again the whole thing you have written, use the preview feature to check the composing.
- Select one or multiple labels if you know what it means. The label isn't required to complete the issue and can leave it empty.
- Submit the issue and make sure you can get the notification from it.
We thank all the contributions you made, thank you!
也歡迎用中文回報問題喔 ;)
Project description from Modrinth.
Pick your setup
FabricProxy-Lite by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build21w07a
1 loader build21w06a
1 loader build21w05b
1 loader build21w05a
1 loader build21w03a
1 loader build1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader buildShowing the newest 12 of 35 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
FabricProxy-Lite versions and loaders
v2.12.0
FabricProxy-Lite-2.12.0.jar
28 Mar 2026
v2.11.0
FabricProxy-Lite-2.11.0.jar
3 Oct 2025
v2.10.1
FabricProxy-Lite-2.10.1.jar
12 Sept 2025
v2.10.0
FabricProxy-Lite-2.10.0.jar
27 Aug 2025
v2.9.0
FabricProxy-Lite-2.9.0.jar
14 Jun 2024
v2.8.0
FabricProxy-Lite-2.8.0.jar
24 Apr 2024
v2.7.0
FabricProxy-Lite-2.7.0.jar
28 Oct 2023
v2.6.0
FabricProxy-Lite-2.6.0.jar
21 Jun 2023
v2.5.0
FabricProxy-Lite-2.5.0.jar
16 Mar 2023
v2.4.0
FabricProxy-Lite-2.4.0.jar
10 Dec 2022
v2.3.0
FabricProxy-Lite-2.3.0.jar
1 Aug 2022
v2.2.0
FabricProxy-Lite-2.2.0.jar
28 Jul 2022
Looking for an older file? The official Modrinth project page is in Resources.