ViaVersion: как пустить на сервер игроков с других версий

Какой плагин за что отвечает

Примеры:

• Сервер 1.16.5, игроки заходят с 1.21: нужен только ViaVersion.
• Сервер 1.21, игроки заходят с 1.16.5: ViaVersion и ViaBackwards.
• Сервер 1.21, нужны клиенты 1.8: ViaVersion, ViaBackwards и ViaRewind.

Если сомневаетесь, помощник viaversion.com/setup подскажет набор под вашу версию.

Установка и куда ставить в сети

1. Скачайте jar с Hangar: ViaVersion, ViaBackwards, ViaRewind. Сборки для разработки лежат на ci.viaversion.com.
2. Положите в plugins и перезапустите сервер. Менеджеры плагинов и /reload ломают ViaVersion, нужна полная перезагрузка.
3. Прочитайте лог запуска: ошибки ViaVersion видны сразу.

Нужна Java 17 или новее. Старые серверы вроде 1.8 обычно работают на Java 17, иногда с флагом -DPaper.IgnoreJavaVersion=true. Если не выходит, есть сборки под Java 8 без гарантии поддержки. Разработчики предупреждают, что позже потребуется Java 21.

В сети на Velocity плагины ставят либо на прокси, либо на серверы за ним, не туда и туда. Совместимость лучше на бэкендах. На прокси не видно блокирования мечом на серверах 1.8, античиты работают хуже, а первые минуты Velocity опрашивает версии подсерверов. Сам Velocity должен быть обновлён. Для BungeeCord с версии 5.0.0 нужен отдельный ViaBungee.

ViaVersion как мод: Fabric и Forge

Основной jar работает на Paper и Velocity. Для остальных платформ есть отдельные проекты, моды выложены на Modrinth:

• ViaFabricPlus: клиентский мод для Fabric и Quilt, позволяет с одного клиента заходить на серверы практически любых версий. Разработчики пишут, что ViaVersion лучше всего работает на Paper или через ViaFabricPlus.
• ViaForge: клиентская реализация Via для Forge и NeoForge.
• ViaFabric: Via для Fabric. ViaBackwards и ViaRewind к нему кладут в папку mods.
• ViaBungee для BungeeCord, ViaSponge для Sponge и отдельный прокси ViaProxy.

Полезные настройки config.yml

Файл лежит в plugins/ViaVersion/config.yml, отступы только пробелами.

block-versions: ["<1.17"]
block-disconnect-msg: "You are using an unsupported Minecraft version!"
max-pps: 800
tracking-period: 6

• block-versions не пускает указанные версии, поддерживаются операторы < и >. Номерами протоколов то же делает block-protocols.
• Встроенный ограничитель пакетов кикает за спам. Если игроков выкидывает с «You are sending too many packets!», выставьте max-pps: -1 и tracking-period: -1.
• Если ViaVersion выглядит в timings как причина лагов на 1.8, отключите nms-player-ticking, но античит может работать хуже.

Частые проблемы

• Нет цвета ников в табе. Мешает autoteam при плагинах тегов: выполните /viaver autoteam или выключите опцию в конфиге.
• Кик «Outdated Server». Обновите Velocity, проверьте лог запуска и что ViaVersion действительно загрузился на нужном сервере.
• Игроки с новой версии не видят новых блоков. Так задумано: ViaVersion даёт совместимость, а не контент новой версии.
• После /reload кикает игроков. Это защита при ProtocolLib. После обновления Via-плагинов нужен перезапуск.
• Не работает на Velocity. Подождите, пока пройдёт опрос подсерверов, обновите Velocity и проверьте без других плагинов на прокси.
• Для поддержки /viaversion dump даёт ссылку с данными, нужен доступ к dump.viaversion.com:443.