База знаний / Как сделать связку Velocity?

⚙️ Работа с ядрами

Как сделать связку Velocity?

Velocity — современный прокси-сервер для объединения нескольких Minecraft-серверов в одну сеть. Ниже — установка и настройка связки с backend-серверами на Paper.

💾 Установка

  1. Скачайте Velocity с официального сайта PaperMC.
  2. Загрузите ядро на сервер через SFTP и переименуйте его в server.jar (или укажите имя JAR в настройках запуска).
  3. После первого запуска откройте файл velocity.toml.
  4. Установите значение параметра bind в формате:
    bind = "0.0.0.0:<порт>"
  5. Если у вас нет лицензии, измените параметр online-mode на:
    online-mode = false
    Подробнее — игра без лицензии.

🔩 Привязка (после 1.13)

Перейти к привязке для 1.12.2 и ниже

Найдите в velocity.toml параметр player-wiki-forwarding-mode и установите:

player-wiki-forwarding-mode = "modern"

Перейдите на backend-серверы, которые хотите привязать. Откройте файл paper.yml (в новых версиях Paper — config/paper-global.yml, секция proxies.velocity).

Найдите секцию velocity-support и установите:

velocity-support:
  enabled: true
  online-mode: true  # false, если пиратская версия

Вставьте значение из forwarding.secret (из velocity.toml) в поле secret без кавычек. Пример:

secret: rReanTmins3

🔩 Привязка (до 1.13)

Перейти к привязке для 1.13 и выше

Найдите в velocity.toml параметр player-wiki-forwarding-mode и установите:

player-wiki-forwarding-mode = "bungeeguard"

Перейдите в файл spigot.yml на backend-сервере и установите:

bungeecord: true

Скачайте плагин BungeeGuard и установите его — см. как добавить плагин.

Перейдите в папку plugins/BungeeGuard, откройте config.yml и вставьте секрет из forwarding.secret. Пример:

allowed-tokens:
  - "WjfdKF94OI"

Введите в консоль:

bungeeguard reload

🕹️ Добавление серверов

Откройте файл velocity.toml.

Найдите секцию [servers] и добавьте серверы по примеру:

lobby = "mars.minecraft.rent:25565"

В параметре try укажите сервер, к которому будут подключаться игроки по умолчанию:

try = ["lobby"]

Секции [forced-hosts] и [advanced] оставьте без лишних изменений, если не используете принудительную маршрутизацию по домену.

Перезагрузите все серверы — Velocity и каждый backend — через консоль.

Важно: игроки подключаются к IP и порту Velocity, а не к backend-серверам напрямую. Порты backend-серверов должны быть доступны только для Velocity.