Back to mods
FabricProxy-Lite project artwork

Modrinth · Minecraft mod

FabricProxy-Lite

Fabric mod for support forward player data from velocity

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which FabricProxy-Lite release should I use?

Updated 4 months ago
Latest stable file v2.12.0
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

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.

Client Not supported
Dedicated server Required
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by FabricProxy-Lite v2.12.0
required
Matching file found Matched file: 0.157.0+26.2

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.

  1. 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.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 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

  1. Put the mod into the mods folder
  2. Start the server to generate the config
  3. Configure Velocity player-info-forwarding-mode to modern and setting forwarding-secret
  4. Configure secret in config/FabricProxy-Lite.toml to 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:

  1. Search for the issue, and find if there's already one. You can also add some additional info you got.
  2. If there's no such issue matches yours, create an issue ​by clicking the "New issue" button.
  3. 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.
  4. Check again the whole thing you have written, use the preview feature to check the composing.
  5. 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.
  6. 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.

38 available setups

Showing 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

23 of 23 releases match

Looking for an older file? The official Modrinth project page is in Resources.