FabricProxy-Lite
This mod is a lightweight version of FabricProxy that specializes exclusively in working with Velocity. Unlike the original, it uses Fabric-API to handle Velocity packets, providing enhanced compatibility with other modifications.
Setup
Mod installation is simple and intuitive:
- Place the mod file in the mods folder
- Start the server to automatically generate the configuration file
- In Velocity settings, set the
player-info-forwarding-modeparameter tomodernand configureforwarding-secret - In the
config/FabricProxy-Lite.tomlfile, specify the same secret key in thesecretparameter as in the Velocity configuration
Configuration
The following parameters are available in the FabricProxy-Lite.toml configuration file, which can also be set via environment variables:
| Parameter | Environment Variable | Description | Default | Required |
|---|---|---|---|---|
hackOnlineMode |
FABRIC_PROXY_HACK_ONLINE_MODE |
Allows connection through proxy without disabling online mode | true |
|
hackEarlySend |
FABRIC_PROXY_HACK_EARLY_SEND |
Uses mixin for early packet sending to Velocity (required for some mods like LuckPerms) | false |
|
hackMessageChain |
FABRIC_PROXY_HACK_MESSAGE_CHAIN |
Fixes player disconnection errors when switching between servers | false |
|
disconnectMessage |
FABRIC_PROXY_DISCONNECT_MESSAGE |
Message for players connecting without using Velocity | "This server requires connection through Velocity." |
|
secret |
FABRIC_PROXY_SECRET |
Secret key for Velocity forwarding (can also use FABRIC_PROXY_SECRET_FILE variable to read from file) |
✓ |
Reporting Issues
If you discover errors, compatibility issues, or connection difficulties, follow these steps:
- Check existing issues for similar cases
- Create a new issue if no similar one is found
- Clearly describe the problem in the title and provide detailed information in the description
- Be sure to attach logs for analysis
- Review formatting before submission
- Specify appropriate labels if necessary
Your feedback helps improve the mod!
