LimboAPI - Виртуальные серверы для Velocity

LimboAPI - это специализированная библиотека (плагин) для прокси-сервера Velocity, которая позволяет разработчикам создавать так называемые "виртуальные серверы" или "лимбо". Если вы владелец крупного проекта или разработчик серверного ПО, то знаете, что Limbo - это состояние, когда игрок подключен к сети, но ещё не находится на каком-либо игровом сервере. Обычно это пустое пространство, где игрок зависает в ожидании.

Зачем это нужно? В первую очередь для оптимизации и безопасности. Вместо того чтобы держать игрока на полноценном сервере с миром, мобами и логикой (что жрет ресурсы), его можно поместить в легковесное виртуальное пространство. Там он может пройти капчу, ввести пароль или просто подождать загрузки, не нагружая основной сервер Minecraft.

Что умеет LimboAPI

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

• Перехват при входе - отправляйте игрока в Limbo сразу при подключении к прокси, ещё до выбора сервера.
• Перемещение в игре - кидайте игрока в виртуальный мир прямо во время игрового процесса (например, для проверки на читы).
• Виртуальный инвентарь - открывайте игроку меню, показывайте карты и предметы, которых физически нет на сервере.
• Интерфейс - полная поддержка Title, ActionBar и чата.
• Загрузка миров - можно подгрузить схематику (.schematic) и показать её игроку как фон или лобби.

По сути, это фундамент для создания сложных систем авторизации или защиты. Кстати, на базе LimboAPI построены такие монстры, как LimboAuth (система входа с 2FA) и LimboFilter (мощнейшая защита от ботов). Это доказывает, что инструмент рабочий и выдерживает реальные нагрузки.

Для разработчиков

Если вы пишете плагины для Velocity, подключить библиотеку проще простого. Она работает как compile-only зависимость.

Maven

Добавьте репозиторий и зависимость в ваш pom.xml:

<repositories>
    <repository>
        <id>elytrium-repo</id>
        <url>https://maven.elytrium.net/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>net.elytrium</groupId>
        <artifactId>limboapi-api</artifactId>
        <version>1.0.7</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Gradle

Для Gradle конфигурация выглядит так:

repositories {
    maven {
        setName("elytrium-repo")
        setUrl("https://maven.elytrium.net/repo/")
    }
}

dependencies {
    compileOnly("net.elytrium:limboapi-api:1.0.7")
}

Основная логика строится вокруг события LoginLimboRegisterEvent (для входа) и класса LimboFactory (для управления в процессе игры). API интуитивно понятный, особенно если вы уже работали с пакетами Minecraft.

Совместимость и нюансы

Важный момент: LimboAPI использует наработки проектов ProtocolSupport и ViaVersion для корректной обработки блоков и маппинга версий. Это значит, что виртуальные миры будут нормально отображаться у игроков с разными версиями клиента Minecraft.

Если вы планируете запустить сеть серверов с защитой от ботов или кастомной авторизацией, вам понадобится надёжный хостинг серверов Майнкрафт. На BungeeHost (https://bungee.host) вы можете развернуть свой Velocity прокси и установить LimboAPI в пару кликов. Это избавит от головной боли с настройкой сети и позволит сосредоточиться на разработке.

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