CrossStitch - мод для совместимости с Velocity

CrossStitch - это узкоспециализированный, но крайне важный серверный мод для Minecraft, который решает одну из самых головных болей администраторов модифицированных серверов - совместимость с прокси вроде Velocity. Если вы когда-либо пытались запустить Fabric-сервер с кучей модов за Velocity и сталкивались с тем, что команды не работают, а игроков выкидывает с ошибками декодирования пакетов, то этот мод именно для вас.

Проект разработан при поддержке команды Velocity, что само по себе говорит о качестве и правильности реализации. Хотя сейчас он ориентирован на связку Velocity + Fabric, сам подход универсален и в будущем может быть адаптирован под другие прокси и загрузчики (как только в Velocity появится нормальная поддержка современного Forge, например).

Зачем это нужно?

С каждым обновлением Mojang дает мододелам всё больше возможностей для добавления контента. Но есть нюанс: многие из этих нововведений ломают логику работы классических прокси. Самая частая проблема - кастомные аргументы команд (Brigadier). Когда мод добавляет свои типы аргументов, Velocity просто не знает, как их обработать, и в лучшем случае команда не сработает, а в худшем - сервер крашится с ошибкой AvailableCommandsPacket.

CrossStitch решает это элегантно: вместо того чтобы писать отдельный сериализатор под каждый мод (что нереально), он внедряет универсальный механизм передачи данных. Это позволяет любым модам с любыми кастомными аргументами команд нормально работать через прокси. Без танцев с бубном и ручного маппинга.

Установка и настройка

Важный момент: CrossStitch ставится только на сервер, на клиенте он не нужен и не работает. Это чисто серверная утилита. При этом Fabric API не требуется - мод полностью автономен.

1. Убедитесь, что у вас Velocity версии 1.1.2 или новее - там уже есть встроенная поддержка CrossStitch.
2. Закиньте мод в папку mods вашего Fabric-сервера.
3. Перезапустите сервер.

После установки подключайтесь к серверу только через Velocity. Если зайти напрямую, минуя прокси, ничего страшного не случится, но и толку от мода не будет - он рассчитан именно на работу в связке с прокси.

Совместимость и версии

Актуальная версия мода - 0.1.7, которая добавила поддержку Minecraft 1.21.8. При этом проект поддерживает широкий диапазон версий: от 1.16.x до 1.21.x, включая ветки 1.17, 1.18, 1.19, 1.20 и 1.21. Это значит, что вы можете использовать его как на старых, так и на самых свежих версиях игры.

Мод распространяется под лицензией MIT, что приятно - можно свободно использовать в любых проектах, включая коммерческие сервера.

Что это дает на практике?

Если вы держите сервер с модами, которые добавляют сложные команды (например, системы экономики, кастомные телепорты, магические моды с аргументами-заклинаниями), и при этом хотите использовать Velocity для балансировки нагрузки или объединения нескольких серверов в сеть - без CrossStitch вы будете постоянно ловить ошибки. С ним всё просто работает.

Для обычных игроков ничего визуально не изменится, но для админов это must-have инструмент, если в инфраструктуре есть прокси. Мод легкий, не грузит сервер и не требует настройки - поставил и забыл.

Скачать CrossStitch стоит всем, кто строит серьезную серверную инфраструктуру на Fabric с использованием Velocity. Это один из тех модов, которые редко упоминают в обзорах, но без которых большие проекты просто не могут нормально функционировать.