Как настроить прокси Velocity для сети серверов Minecraft

Зачем нужна сеть серверов Minecraft и как работает Velocity

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

Игроки подключаются только к прокси. Прокси авторизует их через Mojang, а затем передаёт на один из бэкенд-серверов — обычных серверов Paper, на которых хранятся миры. Когда игрок вводит /server survival, Velocity переносит его на другой бэкенд без отключения.

• Прокси лёгкий: он не хранит мир, поэтому ему нужно гораздо меньше памяти, чем игровому серверу.
• Бэкенды работают в офлайн-режиме и доверяют прокси сообщать им, кто есть кто. Именно это доверие и нужно защитить.
• Velocity 4, текущая версия, требует Java 25 и поддерживает Minecraft от 1.7.2 до последнего релиза.

Установите Velocity

1. Скачайте Velocity с papermc.io в пустую папку.
2. Запустите его один раз на Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

При первом запуске создаются velocity.toml и файл forwarding.secret со случайным секретом. Остановите прокси командой end и откройте конфиг.

Настройте velocity.toml

Настройки, важные для первой сети:

bind = "0.0.0.0:25565"
motd = "<#09add3>My Network"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.11:25567"
try = ["lobby"]

• bind — адрес и порт, к которым подключаются игроки.
• player-info-forwarding-mode — установите modern. По умолчанию стоит none, при котором каждый игрок получает офлайн-UUID; legacy — старый формат BungeeCord, он имеет смысл только для серверов 1.12 и старше.
• [servers] — имя и адрес каждого бэкенда. Имя игроки используют с командой /server.
• try — куда игроки попадают при входе и куда их отправляют, если бэкенд их кикнул.

Forced hosts в разделе [forced-hosts] могут направлять игроков на бэкенд по введённому адресу — например, survival.yourserver.com сразу на выживание.

Настройте бэкенды Paper для modern forwarding

На каждом бэкенде Paper внесите три изменения и перезапустите сервер:

1. server.properties: online-mode=false — теперь авторизацию через Mojang выполняет прокси.
2. spigot.yml: settings.bungeecord: false.
3. config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'paste the contents of forwarding.secret here'

online-mode здесь должен совпадать с velocity.toml, а secret — точно совпадать с текстом в forwarding.secret прокси. Modern forwarding работает на Minecraft 1.13 и новее; серверы Spigot его не поддерживают, поэтому используйте Paper или форк Paper.

Другие бэкенды: серверы Fabric используют мод FabricProxy-Lite с тем же секретом, а серверам Forge выше 1.20.2 нужен ProxyCompatibleForge. Плагины BungeeCord на Velocity не работают.

Защитите бэкенды

Сервер в офлайн-режиме примет любой ник. Это безопасно, только если игроки не могут попасть на бэкенды в обход прокси.

• Modern forwarding — ваша главная защита. Бэкенд Paper с включённым forwarding Velocity отклоняет всех, кто подключается напрямую: без подписанных данных от прокси вход отклоняется с сообщением This server requires you to connect with Velocity.
• Храните секрет в тайне. Любой, у кого есть forwarding.secret, может выдать себя за ваш прокси. Никогда не публикуйте его и смените везде, если он утёк.
• По возможности закройте бэкенды файрволом. Документация Velocity прямо говорит, что modern forwarding не заменяет файрвол. Если прокси и бэкенды находятся на одной машине, привяжите каждый бэкенд к 127.0.0.1 и укажите их как 127.0.0.1:port.
• Никогда не запускайте бэкенд в офлайн-режиме с выключенным forwarding. Так любой сможет зайти под любым ником, в том числе как оператор.

Сеть на Velocity на HytHost

Каждая часть сети — отдельный сервер: один для прокси и по одному на каждый бэкенд. Прокси нужно мало памяти, поэтому ему хватит самого маленького тарифа; бэкенды подбирайте по мирам и числу игроков на странице хостинга Minecraft.

1. Сделайте один сервер прокси. Во вкладке Version выберите Velocity. Панель установит его и задаст bind на собственный порт сервера. Проверьте, что во вкладке Startup выбрана Java 25.
2. Включите modern forwarding сами. Панель создаёт базовый velocity.toml с пустым списком серверов. В файловом менеджере установите player-info-forwarding-mode = "modern" и добавьте бэкенды в [servers] с адресом и портом, которые каждый из них показывает в своей панели.
3. Настройте каждый бэкенд, как в разделе про Paper выше, с forwarding.secret прокси.
4. Направьте домен на прокси и давайте игрокам только этот адрес.

У каждого бэкенда свой публичный адрес, поэтому именно modern forwarding не пускает прямые подключения — не оставляйте бэкенд в офлайн-режиме с выключенным forwarding. Для прав во всей сети запустите LuckPerms на каждом сервере с одной общей базой MySQL; базы данных входят в каждый тариф.