FabricProxy-Lite
Running a Minecraft network with a Velocity proxy is a powerful way to manage multiple servers, but it often introduces friction when you're using Fabric mods. That's where FabricProxy-Lite steps in. This clever add-on acts as a bridge, allowing your Fabric server to communicate cleanly with Velocity without the heavy overhead or compatibility headaches found in older solutions. It's designed for players and server admins who want the flexibility of a proxy network without sacrificing the modded experience.
Why Choose FabricProxy-Lite Over Other Proxy Mods?
The original FabricProxy was a great idea, but it had limitations. FabricProxy-Lite for Minecraft improves on that foundation by focusing exclusively on Velocity support and leveraging the Fabric API to handle Velocity packets. This focused approach means the mod is leaner and, crucially, offers better compatibility with other mods you might have installed. If you've ever seen mods clash over network code, you'll appreciate the cleaner integration that this lite version provides.
Key Technical Advantages
- Velocity-Only Focus: By stripping out support for other proxies, the codebase is simpler and less prone to conflicts.
- Fabric API Integration: Uses the official API to manage the handshake, ensuring your mods see a standard, expected connection flow.
- Improved Mod Compatibility: Because it doesn't hack around the core networking as aggressively, other mods that listen to connection events are less likely to break.
If you're looking to streamline your server setup, you'll want to download FabricProxy-Lite from its official Modrinth page. The latest version is always available there, and you can check the changelog for specific Minecraft version support. It's a small file, but it makes a world of difference in how your network handles player connections.
Prerequisites and Compatibility
Before you begin, ensure you have the right environment. FabricProxy-Lite requires the Fabric Loader to run. It is designed to work with modern versions of Minecraft, typically aligning with the latest stable releases that Fabric supports. Always check the Modrinth page for the specific Minecraft version tags, as the mod is updated regularly to keep pace with game updates. You will also need a running Velocity proxy (version 3.3.0 or higher is generally recommended).
For those who prefer a more streamlined approach to mod management, the foxygame.net launcher offers a curated add-on catalog where you can find and install FabricProxy-Lite with a single click, eliminating the need to manually track down files and dependencies. This is particularly handy when you're setting up a new server instance and want to ensure you're using a version that's known to work well with your other mods.
How to Install FabricProxy-Lite
The installation process is straightforward, but it requires a few precise steps. Here’s a simple guide on how to install the mod correctly.
Step 1: Place the Mod File
Download the FabricProxy-Lite JAR file from Modrinth. Take this file and drop it into the mods folder of your Fabric server. If you don't have a mods folder, create one in the root directory of your server.
Step 2: Generate the Config
Start your server once. The mod will detect that it's running and generate a default configuration file named FabricProxy-Lite.toml in the config folder. You can then stop the server to edit this file.
Step 3: Configure Velocity
On your Velocity proxy side, you need to enable player info forwarding. Open the velocity.toml file and set player-info-forwarding-mode to modern. This setting ensures that Velocity sends the necessary data to the backend server securely.
Step 4: Set the Secret
In the velocity.toml, you will see a forwarding-secret field. Generate a strong, random string for this value. Now, open the config/FabricProxy-Lite.toml file on your Fabric server and paste the exact same secret into the corresponding secret field. This shared secret is what authenticates the connection between the proxy and the backend.
Step 5: Restart and Verify
Save both configuration files and restart your Velocity proxy and your Fabric server. Once they are both up, try connecting through the proxy. If everything is configured correctly, you should be able to join without any "Invalid session" or "Unable to authenticate" errors.
Important Configuration Note for LuckPerms
If you use the popular permissions mod LuckPerms, you need to pay attention to a specific setting. FabricProxy-Lite relies on the Fabric API to send packets, but the API cannot send a packet before the QUERY_START event. This means that player information (like their UUID) might not be ready when LuckPerms expects it. To fix this, you must enable the hackEarlySend option in your FabricProxy-Lite.toml config file. This setting uses a Mixin to send the packet earlier, ensuring that LuckPerms gets the player data it needs to load permissions correctly. Without this, you might see players missing their permissions or experiencing other data-related glitches.
For those managing multiple servers, keeping your proxy mods up to date is crucial. The foxygame.net launcher can automate this process, checking for updates to FabricProxy-Lite and applying them seamlessly so you always have the latest bug fixes and version compatibility without manual downloads.
Troubleshooting and Reporting Issues
Even with a smooth setup, you might encounter a rare issue, especially if you have a complex modpack. If you find something wrong—whether it's a mod compatibility conflict or a login problem—the developers encourage you to report it. First, search the project's GitHub Issues page to see if someone else has already reported the same problem. If not, create a new issue. Provide a clear summary in the title, describe the problem in detail, and include any relevant logs. This helps the developers pinpoint the cause quickly and release a fix. They also welcome reports in Chinese if that's easier for you.
Ultimately, FabricProxy-Lite is an essential tool for anyone running a Fabric server behind a Velocity proxy. It simplifies the networking layer, improves compatibility, and ensures your players have a seamless connection experience. By following the setup steps and paying attention to the LuckPerms configuration, you can enjoy a robust and reliable proxy setup that feels native to the Fabric ecosystem.