LimboAuth - авторизация для Minecraft Velocity

Что такое LimboAuth

LimboAuth - серверный плагин авторизации для Minecraft-прокси на базе Velocity. До регистрации или входа игрок помещается во временный виртуальный сервер Limbo, поэтому не получает доступ к основному серверу и его игровому миру раньше времени.

Это полезная схема для сетей Minecraft, где авторизацию нужно контролировать на уровне прокси. Игрок сначала проходит проверку, а уже потом отправляется на лобби или игровой сервер. В результате меньше риск обхода авторизации, кражи аккаунтов и доступа к серверной инфраструктуре через незащищённое подключение.

Проект построен на LimboAPI - библиотеке Elytrium для отправки игроков в виртуальные серверы Limbo. Такой сервер не требует отдельного полноценного инстанса Minecraft: он работает как изолированное промежуточное окружение внутри прокси.

Возможности плагина

LimboAuth подходит для серверов с разной схемой подключения и поддерживает несколько распространённых вариантов хранения аккаунтов.

• H2 для небольших проектов и локального хранения данных
• MySQL для серверных сетей с общей базой пользователей
• MariaDB как совместимый вариант для инфраструктуры на MySQL
• PostgreSQL для проектов, где используется эта система управления базами данных
• Режимы Online, Offline и Floodgate
• Поддержка Geyser и Floodgate для игроков Bedrock Edition
• Гибридная авторизация для смешанных серверов
• Хеширование паролей с помощью BCrypt, а в актуальной ветке также поддерживаются схемы на базе Argon2
• Перенос аккаунтов из AuthMe-подобных плагинов
• Блокировка слишком простых и легко угадываемых паролей
• Двухфакторная аутентификация по TOTP
• Возможность задавать UUID игрока на основе данных из базы
• Полностью настраиваемые сообщения плагина
• Возможность отключать отдельные сообщения
• Загрузка миров в формате MCEdit schematic
• Премиум-авторизация и дополнительные настройки для серверной сети

Список возможностей делает LimboAuth не просто формой входа, а полноценным шлюзом между подключением игрока и остальной инфраструктурой прокси.

Как работает авторизация через Limbo

После подключения игрок не сразу попадает на обычный сервер. LimboAuth отправляет его во временное виртуальное окружение, где можно показать форму регистрации или входа и выполнить необходимые проверки.

Пока пользователь не подтвердил аккаунт, доступ к лобби, выживанию, мини-играм и другим серверам сети закрыт. После успешной авторизации плагин передаёт игрока дальше по заданной логике. Для владельца сети это особенно удобно: проверка выполняется централизованно, а не отдельно на каждом backend-сервере.

Такой подход помогает избежать типичной проблемы прокси-сетей, когда игрок проходит через один сервер, но ещё не успел корректно авторизоваться на другом. Временный Limbo выступает безопасной точкой ожидания и не даёт неавторизованному пользователю свободно перемещаться по сети.

Поддержка Geyser и смешанных режимов

LimboAuth рассчитан не только на Java Edition. При использовании Geyser и Floodgate к прокси могут подключаться игроки с Bedrock Edition, а плагин учитывает их способ входа.

Поддерживается гибридный режим, в котором одновременно могут работать обычные Java-игроки, пользователи Online Mode, Offline Mode и Floodgate. Это важно для серверов, объединяющих разные редакции Minecraft или использующих собственную систему распределения премиум- и непремиум-аккаунтов.

В актуальных версиях исправлялись редкие проблемы гонки между Online Mode и Floodgate при переходе игрока из одного Limbo в другой. Поэтому при настройке смешанной авторизации стоит проверять не только базовый вход, но и переходы между прокси, лобби и игровыми серверами.

Защита паролей и двухфакторная аутентификация

Пароли не должны храниться в базе в открытом виде. LimboAuth использует BCrypt для их хеширования, а в текущей ветке проекта заявлена также поддержка Argon2. Это делает базу менее опасной целью при утечке данных: вместо исходного пароля в ней находится результат криптографического хеширования.

Отдельно можно включить блокировку слабых паролей. Настройка пригодится публичным проектам, где игроки часто используют короткие комбинации, имя персонажа или стандартные последовательности вроде 123456. Чем больше сервер, тем полезнее ограничивать такие варианты ещё во время регистрации.

Для дополнительной защиты предусмотрена TOTP-двухфакторная аутентификация. После включения игрок подтверждает вход одноразовым кодом из приложения-аутентификатора. Это снижает риск доступа к аккаунту даже в случае компрометации основного пароля.

Миграция с AuthMe и похожих систем

Если сервер раньше работал с AuthMe или другим совместимым плагином, LimboAuth может использоваться для переноса существующих аккаунтов. Это позволяет сохранить базу пользователей и не заставлять игроков проходить регистрацию заново.

Перед миграцией стоит сделать резервную копию базы и проверить формат хешей. На тестовом прокси желательно отдельно проверить вход обычного аккаунта, премиум-аккаунта, пользователя Floodgate и аккаунта с включённой двухфакторной защитой.

Настройка сообщений и Limbo-окружения

Сообщения авторизации можно подробно настроить. Владелец проекта может заменить стандартные фразы на текст своего сервера, изменить подсказки для регистрации и входа или отключить отдельные уведомления.

Плагин также умеет загружать миры в формате MCEdit schematic. Это позволяет оформить виртуальное окружение Limbo под стиль конкретной серверной сети: например, использовать небольшую комнату ожидания или отдельную площадку вместо полностью пустого пространства. Сам формат и содержимое схемы зависят от конфигурации сервера, поэтому перед применением лучше проверить её на тестовом экземпляре.

Совместимость и требования

LimboAuth работает на прокси Velocity и требует установленный LimboAPI. Текущая стабильная версия проекта - 1.1.14, а актуальная ветка собирается с использованием Java 17, LimboAPI 1.1.26 и Velocity 3.4.0-SNAPSHOT.

В старых каталогах могут встречаться устаревшие сведения о поддерживаемых версиях Minecraft, поэтому их не стоит воспринимать как точную гарантию совместимости с современной сборкой. Перед развёртыванием проверьте версии самого Velocity, LimboAPI, Java и дополнительных компонентов Geyser или Floodgate.

LimboAuth относится к прокси-плагинам, а не к обычным серверным модам для Fabric, Forge или NeoForge. Игрокам, как правило, не требуется устанавливать клиентский мод только ради базовой авторизации. При этом конкретная схема входа зависит от режима сети, настроек прокси и подключённых дополнений.

Связанные проекты

В экосистеме Elytrium LimboAuth используется рядом с другими инструментами для Velocity:

• LimboAPI - библиотека для работы с виртуальными серверами Limbo и отправки игроков во временные окружения
• LimboFilter - решение для фильтрации ботов на Minecraft-прокси
• LimboAuth Client Mod - клиентское дополнение для автоматического входа
• LimboAuth Social Addon - дополнение для привязки социальных сетей

Эти проекты не обязательны для базовой работы LimboAuth, если конкретная функция не нужна серверу. Например, для стандартной регистрации и входа достаточно самого плагина авторизации, Velocity и корректно настроенного LimboAPI.

Практические нюансы для владельца сервера

Перед переносом LimboAuth на рабочую сеть проверьте маршрутизацию после успешного входа. Пользователь должен попадать именно на нужный сервер, а не застревать во временном Limbo из-за ошибки в настройках Velocity.

Для крупных сетей лучше использовать внешнюю базу данных, а не локальный H2. MySQL, MariaDB или PostgreSQL удобнее при нескольких прокси и резервном копировании аккаунтов. H2 остаётся практичным вариантом для небольшого проекта, тестовой сети или одного прокси.

Отдельно протестируйте Offline Mode, Online Mode и Floodgate. Эти режимы по-разному определяют личность игрока, UUID и источник авторизации. Ошибка в настройках может привести к появлению дубликатов аккаунтов или к тому, что пользователь не сможет войти под уже зарегистрированным именем.

LimboAuth не добавляет новые блоки, предметы или механики выживания. Это инфраструктурный инструмент для серверов Minecraft, который меняет именно процесс подключения и доступа к сети. Игрок обычно замечает его только по экрану входа, но для администратора разница существенная: авторизация происходит до передачи пользователя на основные серверы.

Проект распространяется с открытым исходным кодом по лицензии AGPL-3.0. Он предназначен для владельцев Velocity-сетей, которым нужна гибкая авторизация с поддержкой баз данных, Geyser, Floodgate, миграции аккаунтов и многоуровневой защиты входа.