AutoModpack Velocity

AutoModpack Velocity обеспечивает поддержку системы автоматической загрузки модов в сетях на базе Velocity. Он служит мостом между клиентом и бекенд-серверами, скрывая сложность прямого подключения к хосту файлов.

⚠️ Перед установкой этого плагина вам необходимо обладать базовыми знаниями самого проекта AutoModpack.

AutoModpack Velocity — это плагин для прокси-сервера Velocity, предназначенный для работы в связке с основным проектом AutoModpack. Он позволяет использовать функционал автоматической доставки модов внутри сети серверов, где клиенты подключаются к прокси, а сами игровые серверы с модами находятся за ним.

Обычно AutoModpack требует, чтобы клиент мог напрямую связаться с сервером и хостом файлов модов. В сети Velocity клиент сначала подключается к прокси, что создает барьер для стандартной передачи данных. Данный плагин устраняет эту проблему двумя способами:

• Обмен данными на фазе входа: Плагин зависит от LoginPhaseProxy для передачи сообщений плагина входа между игроком и выбранным бекенд-сервером, так как Velocity по умолчанию не пересылает такие сообщения после завершения авторизации на прокси.
• Проксирование трафика AutoModpack: Когда бекенд-сервер отправляет сообщение automodpack:data, плагин считывает порт хоста файлов, сохраняет его и перезаписывает сообщение для клиента. Вместо прямого подключения к бекенду, клиент получает инструкцию подключиться к эндпоинту AutoModpack на самом прокси-сервере.

После того как клиент подключается к прокси по указанному адресу, плагин обрабатывает «магическое рукопожатие» (magic hostname handshake), определяет используемый виртуальный хост Velocity и устанавливает TCP-соединение с соответствующим бекенд-сервером. Все байты данных затем пересылаются в обе стороны, позволяя клиенту скачивать моды так же, как если бы он был подключен напрямую к бекенду.

Плагин поддерживает два режима работы в зависимости от конфигурации порта:

• Общий порт (по умолчанию): Если port установлен в -1, трафик AutoModpack использует тот же публичный порт, что и Velocity. Плагин внедряет обработчик в сетевой конвейер Velocity, отделяя обычные игровые соединения от трафика AutoModpack по уникальному рукопожатию.
• Выделенный порт: Если указан конкретный номер порта, плагин запускает собственный Netty-слушатель для обработки входящего трафика AutoModpack.

Настройки плагина находятся в файле /plugins/automodpack/automodpack-proxy.json.

Существует несколько важных нюансов при использовании плагина в сети:

• Обновления модов при переключении серверов: Поскольку при переключении между бекенд-серверами внутри сети Velocity клиент не устанавливает новое соединение, проверка обновлений AutoModpack не срабатывает. Решение 1 (рекомендуемое): Установите AutoModpack на лобби-сервер с отключенным modpackHost, указав addressToSend и portToSend на бекенд-сервер. Решение 2: Используйте отдельный лобби-сервер с установленным AutoModpack как точку входа. Игроки получат обновления при первом подключении к лобби, прежде чем будут перенаправлены на другие серверы.
• Совместимость с NeoVelocity: Мод NeoVelocity не работает с данным плагином. Рекомендуется использовать Proxy Compatible Forge (совместим с NeoForge).

⚠️ Так как плагин выполняет функции прокси, крайне рекомендуется следовать руководству Velocity по безопасности. Необходимо надежно блокировать прямые соединения к бекенд-серверам, включая порты, используемые для подключения к хосту модов.

1. Настройте прокси-сервер Velocity и бекенд-серверы с установленным AutoModpack.
2. Скачайте плагин AutoModpack Velocity.
3. Скачайте обязательную зависимость LoginPhaseProxy.
4. Поместите оба файла в папку /plugins/ вашего прокси-сервера.
5. Перезапустите прокси.