Velocity Limbo Handler

Velocity Limbo Handler - небольшой, но полезный плагин для прокси-серверов на Velocity. Если у вас когда-нибудь падал сервер с мини-играми или выживанием, игроки просто вылетали и теряли соединение. Этот плагин решает проблему: он удерживает игроков в специальном мире ожидания (лимбо), пока нужный сервер снова не станет доступен.

Зачем это нужно

В обычном Майнкрафте, если сервер крашится, клиент разрывает соединение и игрок видит главное меню. На больших проектах это раздражает и снижает онлайны. Velocity Limbo Handler перехватывает ситуацию: вместо дисконнекта игрок попадает на лимбо-сервер, видит сообщение о переподключении и ждёт возвращения на свой сервер. И всё это - в автоматическом режиме, без участия админа.

Особенности

• Умная очередь - игроки ждут только тот сервер, на котором были. Если у вас 10 серверов, очередь не смешивается.
• Оповещения о позиции - плагин сам сообщает игроку его номер в очереди. Не надо гадать, когда запустят.
• Защита от обхода - можно заблокировать команды /server, /hub и другие, чтобы игроки не сбегали с лимбо.
• Поддержка техработ - если сервер в мейнтенансе, плагин уважает вайтлист и пермишены.
• Дружит с LibreLogin - аутентификация не ломается, процесс входа остаётся нормальным.
• Совместимость - работает с Velocity (все свежие версии) и Майнкрафтом от 1.8 до 1.21+.

Как это работает (на пальцах)

Вы ставите на прокси обычный Velocity Limbo Handler, добавляете в конфиг имя лимбо-сервера (например, limbo) и сервер по умолчанию (lobby). Если какой-то бэкенд упал, плагин направляет игроков на лимбо. Как только сервер снова поднялся, игроки автоматически переподключаются. Никаких лишних телодвижений.

Быстрая установка

1. Скачайте .jar из релизов.
2. Кидайте в папку plugins вашего Velocity.
3. Перезапустите прокси - конфиги создадутся автоматически.
4. Отредактируйте config.yml и messages.yml под себя.
5. Ещё раз перезапустите - и всё готово.

Пример конфига:

# config.yml
limbo-name: "limbo"
direct-connect-server: "lobby"
task-interval: 3000
queue-notify-interval: 30
disabled-commands: ["server","hub"]

Сообщения для игроков настраиваются в messages.yml - можете написать что угодно, хоть "Подождите, сервер скоро появится".

Прокси-настройка

В velocity.toml надо прописать сервера примерно так:

[servers]
default = "lobby"
limbo = "limbo"

[forced-hosts]
"pvp.example.com" = ["pvp", "limbo"]
"build.example.com" = ["build", "limbo"]

Тогда даже если игрок заходит через конкретный домен, он всё равно попадёт в очередь при проблемах.

Права и нюансы

• Обычные игроки ставятся в очередь автоматически - ничего включать не надо.
• Команды, которые можно выполнять в лимбо, ограничиваются конфигом.
• Если используете плагины на техработы (типа Maintenance), Velocity Limbo Handler корректно их обрабатывает.
• LibreLogin поддерживается "из коробки" - аутентификация не сломается.

Скачайте Velocity Limbo Handler, если у вас большой проект на Velocity и вы устали от вылетов игроков при падении серверов. Вещь простая, но очень практичная.