LoginPhaseProxy

Плагин для Velocity, который обеспечивает корректную передачу пакетов LoginPluginMessage и LoginPluginResponse между игроком и бэкенд-сервером.

LoginPhaseProxy — это специализированный плагин для прокси-сервера Velocity, предназначенный для проксирования пакетов LoginPluginMessagePacket от бэкенд-сервера к игроку и LoginPluginResponsePacket от игрока к бэкенд-серверу. Это критически важное решение для работы модовых бэкенд-серверов, которые полагаются на специфическую коммуникацию через Login Plugin сообщения для корректной инициализации соединения.

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

В стандартной конфигурации Velocity при подключении игрока происходит фаза Login (P ↔ V), в ходе которой происходит обмен пакетами между игроком и прокси-сервером. Как только Velocity отправляет пакет Server Login Success, фаза Login считается завершенной, и прокси инициирует процесс подключения к бэкенд-серверу.

Бэкенд-сервер затем проходит свою собственную фазу Login (V ↔ B) и может отправлять Login Plugin Message Packets. Однако Velocity не может переслать их игроку, так как фаза Login (P ↔ V) уже официально закрыта. В этом случае прокси отвечает пустым пакетом Login Plugin Response, так как не знает, как обрабатывать такие сообщения. Это блокирует возможность передачи необходимых данных игроку во время авторизации, что делает невозможным вход на модовые бэкенд-серверы.

LoginPhaseProxy решает эту проблему, перехватывая и проксируя сообщения Login Plugin между игроком и бэкенд-сервером, обеспечивая беспрепятственную работу модовых серверов в сети Velocity.

❓ Какую проблему решает плагин (подробно)

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

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

Механизм работы плагина можно описать как сложную манипуляцию внутренними процессами прокси-сервера. Он использует Java Reflection для доступа к внутренним классам Velocity (ProxyServer -> ConnectionManager), что позволяет переопределить инициализаторы каналов сервера (serverChannelInitializer).

Это дает плагину возможность перехватывать коммуникацию как с игроком (Frontend), так и с бэкенд-сервером (Backend).

Техническая реализация включает следующие этапы:

• Плагин отслеживает фазу подключения игрока до получения пакетов SetCompressionPacket(5) (опционально) и ServerLoginSuccessPacket(6).
• Полученные пакеты добавляются в буфер вместо прямой отправки игроку.
• Синтетически в конвейер Velocity отправляется loginAcknowledgedPacket(7), что заставляет прокси поверить, будто фаза Login завершена, и начать процесс подключения к бэкенду.
• Для предотвращения вмешательства Velocity в процесс перехвата плагин скрытно удаляет обработчики из конвейера serverChannel pipeline, которые добавляются при переходе от фазы Login к Config.
• Плагин возвращает MinecraftVarintLengthEncoder и устанавливает состояние MinecraftDecoder в StateRegistry.LOGIN, чтобы пакеты кодировались и декодировались корректно.
• Если бэкенд-сервер отправляет LoginPluginMessagePacket(10) во время своей фазы Login, плагин перехватывает его и отправляет игроку.
• Если игрок отправляет LoginPluginResponsePacket(12), плагин перехватывает его и передает бэкенд-серверу.
• Когда бэкенд-сервер завершает фазу Login, отправляя ServerLoginSuccessPacket(15), плагин выгружает все накопленные в буфере пакеты игроку, завершая фазу Login.
• После завершения процесса плагин восстанавливает состояние MinecraftDecoder до предыдущего (Config Phase).

Для обеспечения стабильности плагин игнорирует пакет LoginAcknowledgedPacket (clientProtocolVersion >= ProtocolVersion.MINECRAFT_1_20_2), если он отправлен игроком после завершения фазы Login, так как в этот момент он не ожидается.

🔁 Сценарии использования

Плагин рекомендуется к использованию в следующих случаях:

• Создание сетей на базе Velocity, где бэкенд-серверы используют модовые сборки (например, AutoModpack).
• Ситуации, когда модовые сервера требуют специфических сообщений авторизации (Login Plugin Messages) для инициализации клиента.
• Организация работы бэкенд-серверов, которые иначе не могут передать необходимые данные игроку из-за ограничений прокси-сервера Velocity.