- Документация
- https://modrinth.com/plugin/velocity-limbo-handler
Velocity Limbo Handler — серверный плагин для прокси Velocity, который обрабатывает лимбо, очереди и повторное подключение игроков. Он рассчитан на ситуации, когда целевой backend-сервер недоступен или завершил работу: вместо немедленного разрыва соединения пользователь может остаться в сети и ожидать возврата нужного сервера.
Проект относится к управлению, технологиям и служебным инструментам. Компонент требуется только серверной стороне, а клиентская установка не поддерживается. Подтверждены версии плагина 1.8.3 и 1.8.2; лицензия — GPL-3.0-or-later.
В сети Velocity игрок подключается к прокси, после чего направляется на backend-сервер. При перезапуске или сбое backend без отдельной обработки соединение может завершиться. Velocity Limbo Handler добавляет промежуточное состояние ожидания и управляет дальнейшим подключением.
Плагин не заменяет Velocity или игровой сервер: его область — лимбо, очередь и обработка возврата к целевому backend.
Лимбо служит точкой, где пользователь остаётся подключённым к прокси, пока нужный backend недоступен. На подтверждённом уровне процесс можно представить так:
• соединение с целевым сервером прекращается;
• игрок переводится в предусмотренное состояние лимбо;
• для него учитывается очередь нужного backend;
• очередь периодически обрабатывается;
• после восстановления сервера выполняется дальнейшая обработка подключения.
Успешный возврат при любом типе аварии не гарантирован.
Ключевая функция — отдельная умная очередь для каждого backend. Игрок ждёт сервер, на котором находился, а не становится за пользователями, ожидающими другие режимы.
При проверке многосерверной сети следует убедиться, что:
• пользователи разных серверов не смешиваются;
• позиция относится к правильной цели;
• восстановление одного backend не влияет на чужую очередь;
• повторное отключение не создаёт дубликат.
Предоставленная основа не задаёт максимальную длину очереди или гарантированное время ожидания.
Плагин автоматически сообщает игрокам их позицию в очереди. Это помогает отличить рабочее ожидание от зависшего соединения. Частота уведомлений и формулировки относятся к настраиваемой части, но универсальные значения в фактической основе не установлены.
Сообщения следует проверить при короткой и длинной очереди: они не должны обещать время входа, которого плагин не прогнозирует.
Velocity Limbo Handler может блокировать нежелательные команды в лимбо, препятствуя обходу предусмотренного маршрута. Ограничение действует в промежуточном состоянии и не заменяет общую защиту прокси.
Перед вводом полезно определить, какие действия разрешены ожидающему игроку, а какие способны перевести его на другой сервер или нарушить очередь. В исходных данных не задан обязательный список команд, поэтому его нельзя считать одинаковым для всех сетей.
Практическая проверка включает попытки:
• перейти на другой режим;
• повторно вызвать переход к недоступному backend;
• использовать действия, выбранные для блокировки.
Плагин учитывает режим обслуживания, белый список и разрешения обхода. Это позволяет различать обычного игрока и пользователя, которому разрешён вход при ограниченном доступе.
Для теста нужны учётные записи без специальных прав и с разрешённым обходом. Названия разрешений в основе не приведены.
Поддержка обслуживания не означает, что плагин сам восстанавливает backend или определяет причины его недоступности. Он применяет предусмотренную логику допуска.
Velocity Limbo Handler заявлен как совместимый с LibreLogin. Цель интеграции — не нарушать цепочку авторизации при переводе игрока в лимбо и последующем перенаправлении.
В сети с аутентификацией следует проверить полный сценарий: первичный вход, подтверждение пользователя, попадание в очередь, ожидание и возврат к backend. LibreLogin не указан обязательной project dependency, поэтому его поддержка не создаёт требования устанавливать систему там, где она не используется.
Платформа — Velocity. Метаданные подтверждают версии Minecraft от 1.8 до 1.21.11 с перечисленными промежуточными выпусками, а также 26.1, 26.1.1, 26.1.2 и 26.2.
Диапазон не гарантирует совместимость с любой сборкой Velocity, лимбо-сервером и сторонним маршрутизатором.
Стороны указаны как server=required и client=unsupported. Игрокам не нужен отдельный мод.
Подтверждённая процедура установки:
• остановить Velocity;
• выбрать подходящий JAR;
• поместить его в папку plugins;
• запустить прокси;
• проверить журнал загрузки;
• проверить доступный и недоступный backend.
Обязательные project dependencies в выбранных метаданных не указаны. Сам Velocity и инфраструктура лимбо при этом остаются частью среды, для которой предназначен плагин.
velocity-limbo-handler-1.8.3+108.jar — версия 1.8.3, размер 611331 байт. SHA-512: c6c73a7ec926020000fa7730ecbbd641e1a9640a557ba9266bd7a3078a71727be17cef69db995582b029dbcc8cff99afc04dc8453d043017c15203aaf0e41410. SHA-1: 76ba67e7b9d2bda53652ca6224cdf0d9eba7b8af.
velocity-limbo-handler-1.8.2+97.jar — версия v1.8.2, размер 609977 байт. SHA-512: ffeb873b380963e4f4d8837994a021bb598f05e0510274e5d3d9de59c9e7711adf2df05522f2e9708d7bf1a4479411a28725cd9e0344942a50862fb30e3d6c89. SHA-1: 79340c1af04a94015e1a96965858366faf9ef58d.
До рабочего запуска стоит воспроизвести:
• обычный вход на доступный сервер;
• остановку backend при активных игроках;
• очереди двух разных серверов;
• режим обслуживания и право обхода;
• авторизацию через LibreLogin;
• заблокированное действие в лимбо.
Результаты нужно оценивать на версиях клиентов, реально используемых сетью. Источник не приводит нагрузочных испытаний, предельного числа игроков или гарантии сохранения позиции после любого сетевого сбоя.
Velocity Limbo Handler распространяется по GPL-3.0-or-later. Изменение и распространение должны учитывать условия этой лицензии.
JAR-файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому проверка не подтверждает поведение при реальных сбоях и не заменяет аудит кода.
В основе он указан как плагин Velocity с установкой в папку plugins совместимого прокси. Требование размещать тот же JAR на каждом backend не заявлено.
Нет. Заявлены отдельные очереди: игрок ожидает именно тот сервер, на котором находился.
Да. Плагин поддерживает блокировку нежелательных команд, однако конкретный перечень определяется локальной схемой.
Заявлен учёт белого списка и разрешений обхода. Конкретные права и связанный плагин обслуживания в фактической основе не названы.
Нет. Компонент работает на стороне Velocity; клиентская установка не поддерживается.
Проект относится к управлению, технологиям и служебным инструментам. Компонент требуется только серверной стороне, а клиентская установка не поддерживается. Подтверждены версии плагина 1.8.3 и 1.8.2; лицензия — GPL-3.0-or-later.
Назначение плагина
В сети Velocity игрок подключается к прокси, после чего направляется на backend-сервер. При перезапуске или сбое backend без отдельной обработки соединение может завершиться. Velocity Limbo Handler добавляет промежуточное состояние ожидания и управляет дальнейшим подключением.
Плагин не заменяет Velocity или игровой сервер: его область — лимбо, очередь и обработка возврата к целевому backend.
Скриншоты и внешний вид
Как работает лимбо
Лимбо служит точкой, где пользователь остаётся подключённым к прокси, пока нужный backend недоступен. На подтверждённом уровне процесс можно представить так:
• соединение с целевым сервером прекращается;
• игрок переводится в предусмотренное состояние лимбо;
• для него учитывается очередь нужного backend;
• очередь периодически обрабатывается;
• после восстановления сервера выполняется дальнейшая обработка подключения.
Успешный возврат при любом типе аварии не гарантирован.
Очередь для конкретного сервера
Ключевая функция — отдельная умная очередь для каждого backend. Игрок ждёт сервер, на котором находился, а не становится за пользователями, ожидающими другие режимы.
При проверке многосерверной сети следует убедиться, что:
• пользователи разных серверов не смешиваются;
• позиция относится к правильной цели;
• восстановление одного backend не влияет на чужую очередь;
• повторное отключение не создаёт дубликат.
Предоставленная основа не задаёт максимальную длину очереди или гарантированное время ожидания.
Уведомления о позиции
Плагин автоматически сообщает игрокам их позицию в очереди. Это помогает отличить рабочее ожидание от зависшего соединения. Частота уведомлений и формулировки относятся к настраиваемой части, но универсальные значения в фактической основе не установлены.
Сообщения следует проверить при короткой и длинной очереди: они не должны обещать время входа, которого плагин не прогнозирует.
Защита лимбо
Velocity Limbo Handler может блокировать нежелательные команды в лимбо, препятствуя обходу предусмотренного маршрута. Ограничение действует в промежуточном состоянии и не заменяет общую защиту прокси.
Перед вводом полезно определить, какие действия разрешены ожидающему игроку, а какие способны перевести его на другой сервер или нарушить очередь. В исходных данных не задан обязательный список команд, поэтому его нельзя считать одинаковым для всех сетей.
Практическая проверка включает попытки:
• перейти на другой режим;
• повторно вызвать переход к недоступному backend;
• использовать действия, выбранные для блокировки.
Обслуживание и права обхода
Плагин учитывает режим обслуживания, белый список и разрешения обхода. Это позволяет различать обычного игрока и пользователя, которому разрешён вход при ограниченном доступе.
Для теста нужны учётные записи без специальных прав и с разрешённым обходом. Названия разрешений в основе не приведены.
Поддержка обслуживания не означает, что плагин сам восстанавливает backend или определяет причины его недоступности. Он применяет предусмотренную логику допуска.
Интеграция с LibreLogin
Velocity Limbo Handler заявлен как совместимый с LibreLogin. Цель интеграции — не нарушать цепочку авторизации при переводе игрока в лимбо и последующем перенаправлении.
В сети с аутентификацией следует проверить полный сценарий: первичный вход, подтверждение пользователя, попадание в очередь, ожидание и возврат к backend. LibreLogin не указан обязательной project dependency, поэтому его поддержка не создаёт требования устанавливать систему там, где она не используется.
Совместимость
Платформа — Velocity. Метаданные подтверждают версии Minecraft от 1.8 до 1.21.11 с перечисленными промежуточными выпусками, а также 26.1, 26.1.1, 26.1.2 и 26.2.
Диапазон не гарантирует совместимость с любой сборкой Velocity, лимбо-сервером и сторонним маршрутизатором.
Стороны указаны как server=required и client=unsupported. Игрокам не нужен отдельный мод.
Установка
Подтверждённая процедура установки:
• остановить Velocity;
• выбрать подходящий JAR;
• поместить его в папку plugins;
• запустить прокси;
• проверить журнал загрузки;
• проверить доступный и недоступный backend.
Обязательные project dependencies в выбранных метаданных не указаны. Сам Velocity и инфраструктура лимбо при этом остаются частью среды, для которой предназначен плагин.
Файлы и контрольные суммы
velocity-limbo-handler-1.8.3+108.jar — версия 1.8.3, размер 611331 байт. SHA-512: c6c73a7ec926020000fa7730ecbbd641e1a9640a557ba9266bd7a3078a71727be17cef69db995582b029dbcc8cff99afc04dc8453d043017c15203aaf0e41410. SHA-1: 76ba67e7b9d2bda53652ca6224cdf0d9eba7b8af.
velocity-limbo-handler-1.8.2+97.jar — версия v1.8.2, размер 609977 байт. SHA-512: ffeb873b380963e4f4d8837994a021bb598f05e0510274e5d3d9de59c9e7711adf2df05522f2e9708d7bf1a4479411a28725cd9e0344942a50862fb30e3d6c89. SHA-1: 79340c1af04a94015e1a96965858366faf9ef58d.
Практическая проверка
До рабочего запуска стоит воспроизвести:
• обычный вход на доступный сервер;
• остановку backend при активных игроках;
• очереди двух разных серверов;
• режим обслуживания и право обхода;
• авторизацию через LibreLogin;
• заблокированное действие в лимбо.
Результаты нужно оценивать на версиях клиентов, реально используемых сетью. Источник не приводит нагрузочных испытаний, предельного числа игроков или гарантии сохранения позиции после любого сетевого сбоя.
Лицензия и безопасность
Velocity Limbo Handler распространяется по GPL-3.0-or-later. Изменение и распространение должны учитывать условия этой лицензии.
JAR-файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому проверка не подтверждает поведение при реальных сбоях и не заменяет аудит кода.
FAQ
Нужен ли плагин на backend-серверах?
В основе он указан как плагин Velocity с установкой в папку plugins совместимого прокси. Требование размещать тот же JAR на каждом backend не заявлено.
Все пользователи ждут в одной очереди?
Нет. Заявлены отдельные очереди: игрок ожидает именно тот сервер, на котором находился.
Можно ли ограничить команды в лимбо?
Да. Плагин поддерживает блокировку нежелательных команд, однако конкретный перечень определяется локальной схемой.
Работает ли режим обслуживания?
Заявлен учёт белого списка и разрешений обхода. Конкретные права и связанный плагин обслуживания в фактической основе не названы.
Требуется ли клиентский мод?
Нет. Компонент работает на стороне Velocity; клиентская установка не поддерживается.
