ViaVersion — плагин для поддержки клиентов разных версий на сервере в Minecraft

ViaVersion — плагин для поддержки клиентов разных версий на сервере в Minecraft

ViaVersion позволяет игрокам с более новой версией клиента подключаться к серверу на более старой версии. Если сервер работает на 26.1.2, а игрок открыл предыдущую версию игры, он зайдёт без каких-либо действий со своей стороны. Плагин бесплатный и имеет открытый исходный код. 

Принцип работы 

Плагин перехватывает сетевые пакеты между клиентом и сервером и конвертирует их между протоколами на лету. 

Самая полная поддержка — на Paper. На BungeeCord и Velocity ViaVersion устанавливается на сам прокси, а не на backend-серверы. 

Команды 

Все команды вводятся в чате или консоли сервера. Для выполнения в игре нужны права оператора. 

Таблица команд

alt: вывод команды /viaver list

Конфигурация 

Файл: plugins/ViaVersion/config.yml. Генерируется автоматически при первом запуске.

block-versions — блокирует подключение определённых версий. Поддерживает операторы < и >, например: block-versions: ["<1.17"].

block-disconnect-msg — сообщение при отключении из-за заблокированной версии. Поддерживает Minecraft color codes. 

logging.log-blocked-joins — логирует попытки подключения от заблокированных версий в консоль. По умолчанию false. 

send-supported-versions — при true сервер сообщает клиенту список поддерживаемых версий в пинг-ответе. 

Лимит пакетов 

По умолчанию игрока кикают при превышении 800 пакетов/с. Дополнительно отслеживается поведение за временным окном — например, при sustained-max-per-second: 200, sustained-period-seconds: 7 и sustained-threshold: 4 игрока кикнут, если он превышал 200 пакетов/с в течение 4 секунд из 7. Чтобы отключить лимит — enabled: false. 

Дополнительные параметры 

hologram-patch — исправляет высоту голограмм для клиентов 1.9+ на более старых серверах. По умолчанию false. Если голограммы от плагинов типа HolographicDisplays отображаются не на той высоте — включи этот параметр. 

serverside-blockconnections — включает серверную обработку соединений блоков для клиентов 1.13+. По умолчанию true. Влияет на корректное отображение заборов, стеклянных панелей, дверей. Параметр blockconnection-method определяет способ обработки: packet — на уровне пакетов, world — на уровне мира (экспериментально). 

use-1_15-instant-respawn — при true клиенты 1.15+ респавнятся мгновенно без экрана смерти. По умолчанию false. 

armor-toggle-fix — исправляет баг с заменой брони в занятом слоте для клиентов 1.19.4+. По умолчанию true. 

enforce-secure-chat — определяет значение secure chat, которое отправляется клиентам 1.19+ при входе. Не рекомендуется менять, если сервер работает на 1.19 или новее. 

Вывод 

ViaVersion закрывает одну простую, но важную задачу: несоответствие версии клиента и сервера. Если администратор не может обновить сервер из-за зависимостей от старых плагинов, а игроки уже на более новых версиях — плагин решает проблему без изменений на стороне клиента. Для базового использования конфиг не нужен.