FabricProxy-Lite

FabricProxy-Lite - это мод для Майнкрафт на Fabric, который решает одну важную задачу: передаёт данные игроков (UUID, скины, никнеймы) через прокси-сервер Velocity. Если вы используете Velocity на сервере с модами, без такого мода плагины вроде LuckPerms не увидят реальные UUID игроков - всё будет ломаться.

По сути, это облегчённая версия FabricProxy, которая работает только с Velocity и использует Fabric API для обработки пакетов Velocity. За счёт этого совместимость с другими модами выше - меньше конфликтов.

Установка

1. Положите мод в папку mods.
2. Запустите сервер - появится конфиг.
3. В Velocity настройте player-info-forwarding-mode на modern и задайте forwarding-secret.
4. В конфиге config/FabricProxy-Lite.toml пропишите тот же secret, что и в Velocity.

Настройка

Вот параметры из FabricProxy-Lite.toml (их же можно задать через переменные окружения). Если параметр не указан в конфиге, подставляется значение по умолчанию. Обязательным является только secret.

Параметр	Переменная окружения	Описание	По умолчанию	Обязательно
hackOnlineMode	FABRIC_PROXY_HACK_ONLINE_MODE	Разрешает подключение через прокси без отключения online-mode.	true
hackEarlySend	FABRIC_PROXY_HACK_EARLY_SEND	Fabric API не может отправлять пакеты до события QUERY_START, поэтому UUID игрока не будет готов к этому моменту. Включение hackEarlySend использует миксин для ранней отправки пакета в Velocity. Нужно для некоторых модов (например, LuckPerms).	false
hackMessageChain	FABRIC_PROXY_HACK_MESSAGE_CHAIN	Исправляет кик игроков с ошибками вроде Received chat packet with missing or invalid signature при переключении между серверами. Подробнее в issue #30 и #121.	false
disconnectMessage	FABRIC_PROXY_DISCONNECT_MESSAGE	Сообщение при кике игроков, которые подключаются не через Velocity.	"This server requires you to connect with Velocity."
secret	FABRIC_PROXY_SECRET	Секретный ключ для форвардинга Velocity. Должен совпадать с содержимым файла forwarding.secret на стороне Velocity. Можно также задать через переменную FABRIC_PROXY_SECRET_FILE.		✓

Что важно знать

• Если у вас сервер на Fabric и вы используете Velocity - этот мод практически обязателен. Без него многие плагины не увидят реальные данные игроков.
• hackEarlySend включайте только если какой-то мод требует данные на раннем этапе (как LuckPerms). Иначе можно оставить выключенным - меньше шансов на конфликты.
• hackMessageChain пригодится, если игроки вылетают с ошибкой подписи чата при переходе между серверами.
• Мод совместим с Minecraft 1.17-1.21 (точные версии смотрите на странице загрузки). Работает только на Fabric.

Скачайте FabricProxy-Lite и забудьте про проблемы с прокси-пересылкой данных на вашем сервере Майнкрафт.