Частые вопросы (Velocity) ❓

🤔 Какая версия Java нужна?

Для Velocity версии 3.5.0 и выше требуется минимум Java 21.

🔌 Работают ли плагины от BungeeCord?

Нет. Архитектура Velocity несовместима с плагинами BungeeCord и Waterfall. Ищите версии плагинов под Velocity (например, на платформе Hangar). В крайнем случае можно использовать экспериментальный загрузчик Snap, но стабильность не гарантируется.

🛑 Популярные ошибки

Ошибка: "If you wish to use IP forwarding..."

Причина: Неверная связка серверов в старом формате. Решение: Проверьте настройки связки. На игровом сервере параметр bungeecord в spigot.yml должен быть включен (true).

Ошибка: "This server requires you to connect with Velocity"

Причина: Игровой сервер ожидает соединение в режиме modern, а прокси использует другой режим. Решение: Установите player-info-forwarding-mode = "modern" в velocity.toml и сверьте настройки с paper-global.yml.

Ошибка: "Invalid payload REGISTER!"

Причина: Заход с модами на ядро Spigot. Решение: Перейдите на ядро Paper (или его форки). Добавьте флаг -Dpaper.disableChannelLimit=true в строку запуска игрового сервера.

Ошибка: "A plugin tried to cancel a signed chat message"

Причина: С версии 1.19.1 введена криптографическая подпись чата. Плагины прокси больше не могут изменять сообщения напрямую. Решение: Установите плагин SignedVelocity на прокси-сервер.

Ошибка: "Read time out" на серверах с модами

Причина: Прокси разрывает соединение при слишком долгой загрузке модов. Решение: Увеличьте read-timeout в файле velocity.toml. В строку запуска Forge-сервера добавьте флаг -Dfml.readTimeout=X, где X - то же время в секундах.

🌐 Проблема с forced-hosts и SRV

При использовании SRV-записей для нестандартного порта прокси видит не введенный адрес, а конечный целевой домен. В блоке [forced-hosts] необходимо указывать домен, на который ссылается SRV-запись (цель CNAME).