BungeeCord и Velocity в Майнкрафте — настройка сети

BungeeCord — программа-прокси, которая объединяет несколько серверов Майнкрафта под одним адресом: игрок подключается к сети и переключается между лобби, выживанием и мини-играми без выхода в главное меню. Velocity решает ту же задачу; для новой сети на Paper удобно использовать его режим modern, который защищает передачу данных игроков секретным ключом.

Что выбрать: BungeeCord или Velocity

Прокси не запускает игровые миры и не объединяет мощность нескольких компьютеров для обработки одного мира. Лобби, выживание и арена остаются отдельными серверами со своими процессами, папками и настройками. Инвентари и экономика между ними автоматически не синхронизируются.

Где скачать BungeeCord и Velocity

BungeeCord скачивайте через раздел загрузок BungeeCord на SpigotMC: он ведёт на официальный сервер сборок проекта. Выберите последнюю успешную сборку и файл BungeeCord.jar. Velocity скачивайте в разделе Downloads проекта PaperMC, выбрав сборку с поддержкой Java Edition 26.3.

Прокси запускают отдельно от игрового сервера. Файл BungeeCord или Velocity не нужно класть в папку plugins/ сервера Paper. Создайте для него собственную папку и проверьте требования выбранной сборки к Java: Velocity ветки 4.0.x требует Java 25 или новее.

Для каждого прокси нужны совместимые плагины. Перед переносом сети проверьте наличие версий ваших плагинов для новой платформы.

Какой хостинг нужен для сети

Для схемы «прокси, лобби и выживание» нужны три отдельных процесса. На хостинге серверов заранее проверьте возможность запуска прокси, доступные порты, ограничения памяти и способ закрыть прямой доступ к игровым серверам. При смене хостинга следуйте инструкции по переносу сервера на новый хост.

Пример рассчитан на одну машину без разделения процессов по контейнерам. Если серверы находятся на разных машинах или в разных контейнерах, используйте адреса, доступные именно из процесса прокси.

Бесплатный тариф с 1 ГБ памяти оценивайте отдельно для прокси и игровых серверов. Такой лимит сам по себе не гарантирует работу всей сети: игровые миры требуют собственных ресурсов, а Java расходует память сверх значения -Xmx. В контейнере нельзя отдавать всю доступную память под -Xmx; для бесплатного тарифа также проверьте возможность загрузки своего JAR и ограничения времени работы.

Как закрыть вход в обход прокси

Сначала ограничьте доступ к игровым серверам, затем отключайте на них проверку аккаунтов. В приведённых настройках аккаунт проверяет прокси, а внутренние серверы доверяют переданным им данным. Если оставить их доступными напрямую, можно открыть путь для входа под чужим ником.

• Одна машина без контейнеров: в server.properties каждого игрового сервера установите server-ip=127.0.0.1. В прокси укажите тот же адрес и соответствующий порт.
• Разные машины: настройте межсетевой экран, чтобы игровые порты принимали соединения только от прокси. При наличии закрытой сети используйте её адреса.
• Хостинг с контейнерами: используйте внутренние адреса и ограничения доступа из панели. Адрес 127.0.0.1 внутри контейнера указывает на него самого и обычно не ведёт к соседнему серверу.

Если на общем хостинге нельзя надёжно ограничить подключения по сети, для BungeeCord используйте BungeeGuard на прокси и игровых серверах с согласованным токеном. В Velocity режим modern уже проверяет общий секрет, но межсетевой экран остаётся дополнительным уровнем защиты. Секреты и токены не публикуйте.

Как настроить BungeeCord

Ниже — сеть с проверкой аккаунтов: BungeeCord принимает игроков, а два сервера Paper обслуживают лобби и выживание. Перед изменением существующей сети сохраните копии миров, данных игроков и конфигураций. Первичный запуск игрового сервера описан в инструкции, как создать сервер Майнкрафт.

1. Подготовьте отдельные папки для прокси и каждого Paper-сервера. Выберите сборки с поддержкой нужной версии игры.
2. В папке прокси запустите java -jar BungeeCord.jar. После создания config.yml остановите прокси командой end в его консоли.
3. Настройте config.yml по первой таблице. Меняйте существующие параметры, сохраняя вложенность YAML и отступы пробелами.
4. Запустите Paper-серверы для создания конфигураций, прочитайте условия EULA и примите их, если согласны. Остановите серверы и задайте параметры из второй таблицы. Ограничения доступа должны быть настроены до запуска серверов с online-mode=false.
5. Запустите игровые серверы, затем BungeeCord. Подключитесь к публичному адресу прокси и проверьте переходы между серверами.

В таблицах точки обозначают вложенность разделов, а не буквальное имя ключа. Например, servers.lobby.address означает ключ address внутри lobby, который находится в разделе servers.

Если используете только лобби и выживание, удалите ненужные примеры из servers и связанные с ними записи forced_hosts. Имена серверов должны совпадать во всех списках.

На обычном Spigot файла config/paper-global.yml нет: применяйте только настройки его собственных файлов. Не выключайте проверку аккаунтов на прокси ради исправления ошибки подключения. Значение online-mode=false у внутренних серверов в этой схеме нужно потому, что аккаунты уже проверяет BungeeCord.

Как настроить Velocity с Paper

Для Velocity используйте те же адреса игровых серверов, но другую схему передачи данных. Одновременно включать BungeeCord-forwarding и Velocity modern на одном Paper-сервере не нужно.

1. Положите файл Velocity в отдельную папку, переименуйте в velocity.jar и выполните java -jar velocity.jar. После создания конфигурации остановите прокси командой shutdown в его консоли.
2. Измените существующие параметры в velocity.toml по таблице. Основные параметры должны находиться до первой секции в квадратных скобках.
3. Настройте каждый Paper-сервер по следующей таблице. В поле секрета вставьте содержимое forwarding.secret из папки Velocity, а не имя этого файла.
4. Проверьте ограничения доступа, запустите Paper-серверы и прокси. Подключитесь к публичному адресу Velocity.

try задаёт порядок серверов, к которым Velocity пытается подключить игрока при входе или исключении с игрового сервера. Удалите ненужные примеры серверов и связанные с ними записи [forced-hosts].

Как переходить между серверами

Названия берутся из конфигурации прокси. Для команды нужно право bungeecord.command.server в BungeeCord или velocity.command.server в Velocity. Права выдавайте на прокси: статус оператора на Paper их не заменяет. Синтаксис других команд смотрите в разделе команд Майнкрафта.

Как исправить did you forget to enable BungeeCord

Сообщение did you forget to enable BungeeCord / IP forwarding on your server? означает, что во время входа на игровой сервер соединение неожиданно оборвалось. Частая причина — игровые серверы не настроены на приём данных от BungeeCord, но точную причину нужно искать в их журнале.

1. Проверьте ip_forward: true в config.yml BungeeCord.
2. На сервере, куда выполняется переход, проверьте settings.bungeecord: true в spigot.yml и online-mode=false в server.properties. В Paper отключите proxies.velocity.enabled.
3. Полностью перезапустите изменённые процессы и повторите вход через адрес прокси. Если ошибка осталась, найдите сообщение об исключении в консоли игрового сервера в момент подключения.

Проверяйте журналы обоих процессов: прокси и игрового сервера. Дополнительные причины отключений разобраны в разделе ошибок подключения.

Старые версии, моды и Bedrock

Режим передачи данных Velocity выбирается для всего прокси: нельзя задать modern для одного сервера и legacy для другого в одной обычной конфигурации. Это нужно учитывать при добавлении 1.12.2 в современную сеть.

Поддержка версий самим прокси не переводит протокол между клиентом и игровым сервером. Для входа новых клиентов на старые серверы используют ViaVersion, а для поддерживаемых старых клиентов на новых серверах — ViaVersion вместе с ViaBackwards. Подбирайте сборки под нужные версии; полноценные механики нового выпуска у старого клиента от этого не появятся.

Для Fabric передача данных через Velocity modern требует совместимого FabricProxy-Lite. Для Forge и других серверов с модами проверяйте поддержку конкретного загрузчика и выпуска: параметры Paper к ним напрямую не применяются.

Bedrock не подключается к Java-прокси напрямую. Для такого входа нужен Geyser, а для игры с аккаунтом Bedrock без отдельного аккаунта Java — Floodgate. В сети можно установить их версии для прокси; для Bedrock также потребуется доступный порт UDP.