Як налаштувати проксі 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; бази даних входять до кожного тарифу.