NeoVelocity

Мод NeoVelocity для Minecraft — совместимость прокси Velocity с NeoForge

NeoVelocity — это мод-обертка для серверов Minecraft на загрузчике NeoForge, позволяющая безопасно подключаться к ним через прокси-сервер Velocity с использованием протокола Modern Forwarding. Без этого мода серверы, скрытые за прокси, часто видят всех игроков как подключившихся с локального адреса 127.0.0.1, а также могут ошибаться при проверке UUID и скинов. Мод реализует нативный протокол передачи данных, гарантируя корректную отправку реальных IP-адресов, идентификаторов игроков и профилей на сервер.

Как работает передача данных

Основная задача мода — реализовать протокол Modern Forwarding, который является частью нативного стека Velocity. Он перехватывает процесс входа игрока и перенаправляет данные от прокси к серверу NeoForge. Это решает проблему, когда прокси не передает информацию о реальном IP-адресе клиента, из-за чего сервер видит соединение как локальное (127.0.0.1). Также мод гарантирует корректную валидацию UUID и скинов, предотвращая ошибки аутентификации, которые возникают при использовании устаревших методов передачи данных.

Управление конфигурацией

После первого запуска сервера мод генерирует файл конфигурации config/neovelocity-common.toml. Ключевым элементом настройки является секрет (secret), который должен быть скопирован из файла forwarding.secret в корневой директории прокси Velocity и вставлен в конфиг NeoVelocity. Поддерживается два способа настройки: прямая вставка строки секрета в файл конфигурации или указание на путь к файлу, где этот секрет хранится. Изменения в конфигурации, включая обновление секрета, применяются автоматически без необходимости перезапуска сервера (Auto-Reload).

Совместимость с Fabric Networking API

Мод автоматически обнаруживает наличие fabric_networking_api_v1. Если на сервере установлен мод Forgified Fabric API и возникают проблемы с отключением при входе, в конфигурации NeoVelocity следует установить параметр login-custom-packet-catchall = false. В этом режиме мод проверяет подпись пакета входа: если секрет совпадает, он обрабатывает вход; если нет — пакет игнорируется и передается другим модам. Важно: при неправильном секрете и включенном режиме false сервер может отключить игрока с ошибкой "Incompatible mod detected", так как будет воспринимать пакеты Velocity как незнакомые данные.

Безопасность и настройка сети

Критически важно не открывать порт сервера NeoForge напрямую в интернет. Необходимо настроить брандмауэр (например, iptables или UFW) так, чтобы он принимал соединения с сервера только с IP-адреса прокси Velocity. Если порт сервера открыт для публичного доступа, злоумышленник, зная секрет прокси, может обойти систему аутентификации и подключиться напрямую. Для крупных модпаков, превышающих лимит Velocity в 64 известных пакета, в аргументы запуска прокси нужно добавить флаг -Dvelocity.max-known-packs=64 (увеличив значение, например, до 128).

Устранение неполадок

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

• "NeoVelocity configuration error...": Мод установлен, но секрет не настроен. Решение — вставить forwarding.secret в конфиг.
• "Unable to verify proxy data integrity.": Секрет в прокси и на сервере не совпадают. Проверьте точность копирования без лишних пробелов.
• "This server requires you to connect via a Velocity Proxy...": Подключение идет напрямую к серверу, а не через прокси, либо в конфиге прокси velocity.toml параметр player-info-forwarding-mode стоит на "none" или "legacy". Его нужно изменить на "modern".
• "Incompatible mod detected...": Другой мод (часто Fabric Networking API) изменил структуру пакета входа. Решение — установить login-custom-packet-catchall = false в конфиге NeoVelocity.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Dynamic FPS — похожий мод
• Cherished Worlds — похожий мод

Автор: G_ab · Лицензия: GPL-3.0-only