FabricProxy-Lite
I don't know my version or loader
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!
也歡迎用中文回報問題喔 ;)
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 26.1, 26.1.1, 26.1.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as FabricProxy-Lite-2.12.0.jar — drop this file into the mods folder
- Download size: 72 KB
- Download link checked 27 Aug 2026 — working
These come from our own check of the pack file, not from the source page.