Как принимать другие версии Minecraft с помощью ViaVersion
Позвольте более новым и более старым клиентам Minecraft подключаться к вашему серверу Paper с помощью ViaVersion, ViaBackwards и ViaRewind: установка, ограничения и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
По умолчанию сервер Minecraft принимает только клиенты своей версии. ViaVersion и его дополнения транслируют обмен данными между клиентом и сервером, чтобы могли подключаться игроки, оставшиеся на другой версии.
Это руководство продолжает материал Установка и обновление плагинов на Paper и использует папку /opt/minecraft/server, сервис minecraft.service и команду mc-console.
В итоге вы узнаете:
- какие плагины устанавливать в зависимости от нужных версий
- как устанавливать и обновлять их с проверкой целостности
- как ограничить разрешённые версии и выполнить откат
Предварительные требования
- Сервер Paper с
mc-console, установленный по руководству по Paper, а такжеcurlиjq - SSH-доступ с пользователем, у которого есть
sudo - Клиент Minecraft другой версии для итоговой проверки
Выбор плагинов
Какой плагин устанавливать, зависит от того, как версия клиента соотносится с версией сервера:
| Какие игроки должны подключаться | Необходимые плагины |
|---|---|
| Клиент более новой версии, чем сервер | ViaVersion |
| Клиент более старой версии, вплоть до 1.9 | ViaVersion + ViaBackwards |
| Клиент версии 1.7 или 1.8 | ViaVersion + ViaBackwards + ViaRewind |
Ограничения
ViaVersion транслирует протокол, но сама игра по-прежнему определяется сервером. Прежде чем открывать доступ другим версиям, учтите следующее:
- Новый контент: старый клиент не знает новых блоков, предметов и существ. Они показываются ему в приближённом виде
- Высота мира: клиент версии ниже 1.17 не видит блоки ниже
y=0и вышеy=255и не может с ними взаимодействовать - Инвентари: в клиенте версии ниже 1.17 некоторые клики могут срабатывать со смещением
- Стол кузнеца: он недоступен клиентам версий ниже 1.19.4 на сервере 1.20 или новее, если не использовать дополнительный модуль
- Звуки: у некоторых новых звуков нет аналогов в старых клиентах
- Античит: различия в поведении между версиями могут вызывать ложные срабатывания. Проверьте свою конфигурацию
- Новые версии: ViaVersion обычно выходит через несколько дней после обновления Minecraft
- Bedrock: ViaVersion работает только с Java. Для консолей и мобильных устройств используйте Geyser и Floodgate
Резервное копирование плагинов
ViaVersion не изменяет мир, но резервная копия плагинов позволит быстро вернуться к текущему состоянию:
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server plugins
sudo ls -lh /opt/minecraft/backupsУстановка плагинов
Создайте скрипт, который загружает плагины с Hangar, проверяет, что они поддерживают вашу версию Paper, и сверяет их контрольные суммы:
sudo nano /opt/minecraft/via-get.sh#!/bin/bash
# Загружает плагины Via с Hangar и проверяет их контрольные суммы
set -euo pipefail
CIBLE="${1:?Укажите целевую папку}"
MC_VERSION="${2:?Укажите версию сервера, например 26.3}"
shift 2
if [ "$#" -eq 0 ]; then
echo "Укажите хотя бы один плагин, например ViaVersion." >&2
exit 1
fi
UA="mon-serveur-minecraft/1.0 (https://your-domain.com)"
mkdir -p "$CIBLE"
cd "$CIBLE"
for PLUGIN in "$@"; do
API="https://hangar.papermc.io/api/v1/projects/$PLUGIN/versions?limit=1&channel=Release&platform=PAPER"
VERSION=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -c '.result[0]')
if ! echo "$VERSION" | jq -e --arg mc "$MC_VERSION" '.platformDependencies.PAPER | index($mc)' > /dev/null; then
echo "$PLUGIN не заявляет поддержку Paper $MC_VERSION." >&2
exit 1
fi
NOM=$(echo "$VERSION" | jq -r '.downloads.PAPER.fileInfo.name')
URL=$(echo "$VERSION" | jq -r '.downloads.PAPER.downloadUrl')
SHA256=$(echo "$VERSION" | jq -r '.downloads.PAPER.fileInfo.sha256Hash')
curl -fL -H "User-Agent: $UA" -o "$NOM.new" "$URL"
echo "$SHA256 $NOM.new" | sha256sum -c -
mv "$NOM.new" "$NOM"
echo "$NOM установлен."
doneЗамените your-domain.com в строке UA, затем сделайте скрипт исполняемым:
sudo chmod 755 /opt/minecraft/via-get.shУстановите выбранные плагины. Вот самый распространённый вариант, позволяющий принимать более старые клиенты:
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins 26.3 ViaVersion ViaBackwardsДля клиентов 1.7 и 1.8 добавьте ViaRewind в конец команды. Укажите только ViaVersion, если хотите принимать лишь клиенты новее сервера.
Перезапустите сервер и дождитесь строки Done:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fПроверка результата
sudo mc-console plugins
sudo journalctl -u minecraft.service --since "10 minutes ago" --no-pager | grep 'ViaVersion detected server version'Плагины должны появиться в списке, а в журнале должна быть указана версия вашего сервера. Затем подключитесь клиентом другой версии и выведите используемые версии:
sudo mc-console viaversion listВаш ник должен быть указан напротив версии вашего клиента. Если никто не подключён, команда отвечает No players found!.
Наконец, попробуйте то, что делают ваши игроки: ставьте и ломайте блоки, откройте сундук, используйте ваши команды и основные плагины.
Ограничение принимаемых версий
Параметр block-versions отклоняет определённые версии. В этом примере блокируется всё, что старше 1.20.5:
sudo -u minecraft sed -i 's/^block-versions: .*/block-versions: ["<1.20.5"]/' /opt/minecraft/server/plugins/ViaVersion/config.yml
sudo grep '^block-versions:' /opt/minecraft/server/plugins/ViaVersion/config.yml
sudo systemctl restart minecraft.serviceПоддерживаются префиксы < и >, а также несколько значений подряд: ["<1.16", "1.16.4", ">1.17.1"]. Игрок, которому отказано в подключении, видит текст из параметра block-disconnect-msg.
С прокси Velocity
Если вы используете Velocity, устанавливайте ViaVersion либо на прокси, либо на серверы, но никогда не в обоих местах.
Предпочтительны серверы Paper: в документации ViaVersion указано, что античиты могут работать хуже, когда трансляция выполняется на прокси. В этом случае повторите установку для каждого сервера, меняя папку:
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/lobby/plugins 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft-lobby.serviceСовременная передача данных Velocity не принимает клиенты версий ниже 1.13, поэтому в такой конфигурации ViaRewind не откроет им доступ.
Обновление
Paper заменяет плагины при запуске, используя папку plugins/update. Сделайте резервную копию, поместите туда новые версии и перезапустите сервер:
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server plugins
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins/update 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft.serviceОбновляйте все плагины Via одновременно, поскольку их версии связаны между собой. После выхода новой версии Minecraft дождитесь, пока они начнут её поддерживать.
Откат
Удалите плагины. Мир это не затрагивает, а игрокам с другой версией снова будет отказано в подключении:
sudo systemctl stop minecraft.service
sudo rm -f /opt/minecraft/server/plugins/ViaVersion-*.jar /opt/minecraft/server/plugins/ViaBackwards-*.jar /opt/minecraft/server/plugins/ViaRewind-*.jar
sudo systemctl start minecraft.serviceПапки конфигурации остаются в plugins, и их можно удалить, если вы не планируете устанавливать эти плагины снова.
При возникновении проблем
sudo journalctl -u minecraft.service -n 200 --no-pager | grep -iE 'via|error|exception'«Incompatible client! Please use …»
Трансляция для этой версии не работает. Проверьте с помощью sudo mc-console plugins, что плагины загружены, и сравните версию клиента с таблицей в разделе Выбор плагинов. Старому клиенту нужен ViaBackwards.
«You are using an unsupported Minecraft version!»
Эта версия заблокирована параметром block-versions или block-protocols в plugins/ViaVersion/config.yml.
«This server is only compatible with Minecraft 1.13 and above.»
Это сообщение выдаёт Velocity при современной передаче данных. Такой клиент не может подключаться через этот прокси.
«ViaVersion does not have any compatible versions for this server version!»
ViaVersion слишком стар для вашего сервера. Обновите его. Если версия Minecraft только что вышла, дождитесь совместимой версии плагина.
Скрипт сообщает «не заявляет поддержку Paper»
В последней версии, опубликованной на Hangar, ваша версия Paper не указана. Проверьте номер, переданный скрипту, и страницу проекта. Если версия Minecraft совсем новая, подождите несколько дней.
Плагин Via не загружается
| Сообщение | Причина | Решение |
|---|---|---|
Unknown/missing dependency plugins |
Для ViaBackwards не хватает ViaVersion или для ViaRewind не хватает ViaBackwards | Установите указанный плагин |
Ambiguous plugin name |
Две версии одного плагина в plugins |
Оставьте только один файл |
UnsupportedClassVersionError |
Слишком старая версия Java | Установите Java 25 |
Блоки-призраки или смещённый инвентарь
Такие расхождения часто возникают при трансляции между далёкими друг от друга версиями. Обновите плагины Via и при необходимости ограничьте принимаемые версии, исключив самые старые.
Подробнее читайте в документации по установке, документации по настройке и в инструменте выбора плагинов проекта.