База знаний SolidHost

Все для создания идеального Minecraft-сервера

Добро пожаловать в центр знаний SolidHost. Здесь собраны гайды для администраторов: от выбора ядра и настройки Velocity до подключения TCPShield, Spark и красивого домена. Выбирай нужную категорию и прокачивай свой проект без лишней боли.

Настройка Velocity для Minecraft-сети

Установка Velocity, настройка прокси, modern forwarding, подключение лобби и backend-серверов.

03
VelocityПроксиMinecraftPaperForwarding

Установка Velocity

Загрузи на панель хостинга файл velocity-3.x.x.jar и запусти сервер один раз, чтобы Velocity создал конфиги.

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

Для Velocity нужен Java 17 или новее. Если прокси не стартует, сначала проверь версию Java в разделе запуска.

Шаг 1. Порт и адрес прослушивания

Открой velocity.toml в текстовом редакторе и найди параметр bind.

Если хочешь принимать игроков на основном порту, укажи, например, 25565.

Обычно меняют только порт, а IP оставляют 0.0.0.0, чтобы прокси принимал подключения на всех интерфейсах машины.

Если в панели у ноды указан цифровой IP, например 185.9.145.80, используй его только для проверки сети и DNS, а не как обязательную замену значения bind.

velocity.toml
bind = "0.0.0.0:25565"

Шаг 2. Онлайн-режим и секретный ключ

Дальше определи, будет ли сеть работать только с лицензионными аккаунтами.

Для лицензии оставь online-mode = true. Для пиратских серверов поставь false.

В файле forwarding.secret находится уникальный секретный ключ. Его нужно скопировать и использовать на backend-серверах. Никому не передавай этот ключ.

Критично

Секрет из forwarding.secret должен совпадать на прокси и на каждом backend-сервере. Если ошибиться хотя бы в одном символе, игроки не смогут нормально заходить.

velocity.toml
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

Шаг 3. Подключение серверов

Допустим, у тебя есть Лобби и Выживание. В секции [servers] пропиши названия и адреса серверов.

Для первого входа игрока обычно достаточно указать try = ["lobby"]. Этого хватает, чтобы по умолчанию кидать всех в лобби.

velocity.toml
[servers]
lobby = "127.0.0.1:30066"
survival = "127.0.0.1:30067"
try = ["lobby"]

Шаг 4. Настройка backend-серверов Paper / Spigot

На каждом backend-сервере, который стоит за Velocity, обязательно отключи собственную авторизацию Mojang в server.properties.

В spigot.yml оставь settings.bungeecord: false, если используешь modern forwarding от Velocity.

На новых версиях Paper открой config/paper-global.yml и включи поддержку Velocity, затем вставь тот же secret из forwarding.secret.

На старых версиях Paper эти же параметры находятся в paper.yml внутри блока settings.velocity-support.

Проверь еще раз

Для modern forwarding у backend-сервера должны совпадать три вещи: online-mode в Velocity, proxies.velocity.online-mode в Paper и сам secret. Плюс settings.bungeecord в spigot.yml должен оставаться false.

server.properties
online-mode=false
spigot.yml
settings:
  bungeecord: false
config/paper-global.yml
proxies:
  velocity:
    enabled: true
    secret: "тут_секрет_из_forwarding.secret"
    online-mode: true
paper.yml для старых версий
settings:
  velocity-support:
    enabled: true
    secret: "тут_секрет_из_forwarding.secret"
    online-mode: true

Шаг 5. Защита и правильный форвардинг

Для современной и безопасной схемы используй именно modern forwarding. Он защищает от подмены IP и служебных данных игрока заметно лучше, чем legacy-режим.

Главное: online-mode у прокси и online-mode в Paper-конфиге Velocity должны совпадать между собой.

Если ты поддерживаешь очень старые версии клиентов ниже 1.13, modern forwarding не подойдет. Тогда придется переходить на legacy или BungeeGuard, но это уже отдельный сценарий.

velocity.toml
player-info-forwarding-mode = "modern"

Проверка работы

Запусти Velocity через панель и подключись к прокси по IP:порту, например game1.solidhost.pro:25565.

Если попал на лобби, а с него уже можно перейти на другие backend-серверы, значит базовая настройка выполнена правильно.

Готово! Теперь твоя сеть работает через мощный прокси, а если что-то упрется в настройки, help-каналы SolidHost подскажут дальше.

Эта база знаний все еще активно дополняется

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