# Elytrium

Entertainment Studio

This page will help you understand our plugins and mods. Good luck!

[elytrium.net/](https://elytrium.net/)


# Donation

Your donations are really appreciated. Donations wallets/links/cards:

* MasterCard Debit Card (Tinkoff Bank): `5536 9140 0599 1975`
* Qiwi Wallet: `PFORG` or [this link](https://my.qiwi.com/form/Petr-YSpyiLt9c6)
* YooMoney Wallet: `4100 1721 8467 044` or [this link](https://yoomoney.ru/quickpay/shop-widget?writer=seller\&targets=Donation\&targets-hint=\&default-sum=\&button-text=11\&payment-type-choice=on\&mobile-payment-type-choice=on\&hint=\&successURL=\&quickpay=shop\&account=410017218467044)
* Monero (XMR): 86VQyCz68ApebfFgrzRFAuYLdvd3qG8iT9RHcru9moQkJR9W2Q89Gt3ecFQcFu6wncGwGJsMS9E8Bfr9brztBNbX7Q2rfYS


# Info

{% embed url="<https://github.com/Elytrium/LimboAPI>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord) [![Proxy Stats](https://camo.githubusercontent.com/170b7b7ac089ce27e5a4df66e9c2ac1707549f3e3809390e625f29ad7d02ff7a/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f736572766572732f31323533303f6c6f676f3d6d696e656372616674266c6162656c3d53657276657273)](https://bstats.org/plugin/velocity/LimboAPI/12530) [![Proxy Stats](https://camo.githubusercontent.com/8110161e87c80e4317f8549b42182fc558a398924ad9ecdff26b609f26e814ce/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f706c61796572732f31323533303f6c6f676f3d6d696e656372616674266c6162656c3d506c6179657273)](https://bstats.org/plugin/velocity/LimboAPI/12530)

Library for sending players to virtual servers (called limbo)\
[MC-Market](https://www.mc-market.org/resources/21097/)\
[SpigotMC.org](https://www.spigotmc.org/resources/limboapi-limboauth-limbofilter.95748/)\
[Описание и обсуждение на русском языке (spigotmc.ru)](https://spigotmc.ru/resources/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.715/)\
[Описание и обсуждение на русском языке (rubukkit.org)](http://rubukkit.org/threads/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.177904/)

Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### See also

* [LimboAuth](https://github.com/Elytrium/LimboAuth) - Auth System built in virtual server (Limbo). Uses BCrypt, has TOTP 2FA feature. Supports literally any database due to OrmLite.
* [LimboFilter](https://github.com/Elytrium/LimboFilter) - Most powerful bot filtering solution for Minecraft proxies. Built with LimboAPI.

### Features of LimboAPI

* Send to the Limbo server during login process
* Send to the Limbo server during play process
* Send maps, items to player's virtual inventory
* Display player's XP
* Send Title, Chat, ActionBar
* Load world from world files like .schematic
* and more...

### How to

* Include `limboapi-api` to your Maven/Gradle project as compile-only
* Subscribe to `LoginLimboRegisterEvent` to send players to the Limbo server during login process
* Use `LimboFactory` to send players to the Limbo server during play process

### How to include it

**Setup your project via adding our maven repository to your pom.xml or build.gradle file.**

* Maven:

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

    <dependencies>
        <dependency>
            <groupId>net.elytrium.limboapi</groupId>
            <artifactId>api</artifactId>
            <version>1.1.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
```

* Gradle:

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

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

### Used Open Source projects

* [ProtocolSupport](https://github.com/ProtocolSupport/ProtocolSupport) - for modern->legacy block mappings
* [ViaVersion](https://github.com/ViaVersion/ViaVersion) - for modern string->integer block mappings

### Demo

* [LimboAuth](https://github.com/Elytrium/LimboAuth) - The auth plugin, that uses LimboAPI as a dependency at the basic level.
* [LimboFilter](https://github.com/Elytrium/LimboFilter) - The antibot solution, that uses LimboAPI as a dependency, using almost all available API methods, like Low-level Minecraft packet control.


# Info

{% embed url="<https://github.com/Elytrium/LimboAuth>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord)   [![Proxy Stats](https://camo.githubusercontent.com/b3ed8488d63a1891b9e13d5167336a8bc30e51e12c04b3d3376530a90ee12610/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f736572766572732f31333730303f6c6f676f3d6d696e656372616674266c6162656c3d53657276657273)](https://bstats.org/plugin/velocity/LimboAuth/13700) [![Proxy Stats](https://camo.githubusercontent.com/e53a1764d832055865d6e50878fcb62747c79547066634beb0efde2b8aa7f225/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f706c61796572732f31333730303f6c6f676f3d6d696e656372616674266c6162656c3d506c6179657273)](https://bstats.org/plugin/velocity/LimboAuth/13700)

Auth System built in virtual server (Limbo).\
[Описание и обсуждение на русском языке (spigotmc.ru)](https://spigotmc.ru/resources/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.715/)\
[Описание и обсуждение на русском языке (rubukkit.org)](http://rubukkit.org/threads/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.177904/)

Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### See also

* [LimboFilter](https://github.com/Elytrium/LimboFilter) - Most powerful bot filtering solution for Minecraft proxies. Built with [LimboAPI](https://github.com/Elytrium/LimboAPI).
* [LimboAPI](https://github.com/Elytrium/LimboAPI) - Library for sending players to virtual servers (called limbo)

### Features of LimboAuth

* Supports [H2](https://www.h2database.com/html/main.html), [MySQL](https://www.mysql.com/about/), [PostgreSQL](https://www.postgresql.org/about/) [databases](https://en.wikipedia.org/wiki/Database);
* [Geyser](https://wiki.geysermc.org/) [Floodgate](https://wiki.geysermc.org/floodgate/) support;
* Hybrid ([Floodgate](https://wiki.geysermc.org/floodgate/)/Online/Offline) mode support;
* Uses [BCrypt](https://en.wikipedia.org/wiki/Bcrypt) - the best [hashing algorithm](https://en.wikipedia.org/wiki/Cryptographic_hash_function) for password;
* Ability to migrate from [AuthMe](https://www.spigotmc.org/resources/authmereloaded.6269/)-alike plugins;
* Ability to block weak passwords;
* [TOTP](https://en.wikipedia.org/wiki/Time-based_one-time_password) [2FA](https://en.wikipedia.org/wiki/Help:Two-factor_authentication) support;
* Ability to set [UUID](https://minecraft.fandom.com/wiki/Universally_unique_identifier) from [database](https://en.wikipedia.org/wiki/Database);
* Highly customisable config - you can change all the messages the plugin sends, or just disable them;
* [MCEdit](https://www.mcedit.net/about.html) schematic world loading;
* And more...


# Config parameters

| Parameter                            | Default                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                   | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| serializer                           | LEGACY\_AMPERSAND                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Сериализаторы, которые будут использоваться для текста                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| prefix                               | LimboAuth &6>>\&f                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Префикс, который будет заменяться в {PRFX}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| auth-time                            | 60000                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               | Максимальное время аутентификации игрока в миллисекундах. После истечения заданного времени игрок будет кикнут.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| enable-bossbar                       | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Боссбар                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| bossbar-color                        | RED                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                               | Цвет боссбара. Возможные цвета: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| bossbar-overlay                      | NOTCHED\_20                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                               | Изменяет стиль боссбара. Возможные стили: PROGRESS, NOTCHED\_6, NOTCHED\_10, NOTCHED\_12, NOTCHED\_20                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| min-password-length                  | 4                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Минимальная длинна пароля                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| max-password-length                  | 71                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                               | Максимальная длинна пароля                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| check-password-strength              | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Проверять пароль на "небезопасность"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| unsafe-passwords-file                | unsafe\_passwords.txt                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               | Файл, в котором хранятся "небезопасные" пароли                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| online-mode-need-auth                | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Игроки с лицензией должны авторизоваться                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| floodgate-need-auth                  | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Игроки с беброка должны авторизоваться                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| force-offline-mode                   | false                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               | Принудительный оффлайн режим                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| force-offline-uuid                   | false                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               | Использование оффлайн uuid                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| premium-and-floodgate-messages-delay | 1250                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| save-uuid                            | true                                                                                   | Forcibly set player's UUID to the value from the database. If the player had the cracked account, and switched to the premium account, the cracked UUID will be used                                                                                                                                                                                                                                          | Принудительно установите UUID игрока на значение из базы данных # Если у игрока была пиратка и он переключился на лицуху, будет использоваться пиратский UUID                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| enable-totp                          | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | TOTP                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| totp-need-password                   | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | TOTP требует пароль для его включения                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| register-need-repeat-password        | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Подтверждение пароля при регистрации                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| change-password-need-old-password    | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Смена пароля требует введение старого пароля                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| confirm-keyword                      | confirm                                                                                | Used in unregister and premium commands                                                                                                                                                                                                                                                                                                                                                                       | Слово, которое нужно ввести для подтверждения смены пароля или /premium                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| offline-mode-prefix                  | -                                                                                      | This prefix will be added to offline mode players nickname                                                                                                                                                                                                                                                                                                                                                    | Префикс у пиратских игроков                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| online-mode-prefix                   | -                                                                                      | This prefix will be added to online mode players nickname                                                                                                                                                                                                                                                                                                                                                     | Префикс у лицензионных игроков                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| migration-hash                       | -                                                                                      | Hash for migration                                                                                                                                                                                                                                                                                                                                                                                            | Хеш для миграции                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| dimension                            | THE\_END                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                               | Измерение в котором находится игрок. Возможные миры: OVERWORLD, NETHER, THE\_END                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| purge-cache-millis                   | 3600000                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                               | Время очистки кэша / Длительность сессии                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| purge-premium-cache-millis           | 28800000                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                               | Время очистки кэша у премиум игроков                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| qr-generator-url                     | <https://api.qrserver.com/v1/create-qr-code/?data={data}&size=200x200&ecc=M&margin=30> | QR Generator URL, set {data} placeholder                                                                                                                                                                                                                                                                                                                                                                      | Генератор QR кодов                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| totp-issuer                          | LimboAuth by Elytrium                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| bcrypt-cost                          | 10                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                               | Параметр bcrypt                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| login-attempts                       | 3                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Попытки при вводе пароля                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ip-limit-registrations               | 3                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Лимит регистраций на один ip                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| totp-recovery-codes-amount           | 16                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ip-limit-valid-time                  | 21600000                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                               | Время в миллисекундах, когда работает ограничение ip, установите значение 0 для отключения.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| allowed-nickname-regex               | ^\[A-Za-z0-9\_]{3,16}$                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                               | <p> ^ означает начало строки, $ означает конец строки </p><p> \[A-Za-z0-9\_] представляет собой набор символов из A-Z, a-z, 0-9 и \_  {3,16} означает, что допустимая длина составляет от 3 до 16 символов</p>                                                                                                                                                                                                                                                                                                                                                                                     |
| load-world                           | false                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| world-file-type                      | structure                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                               | Типы файла мира: "schematic" (1.12.2 и ниже, не рекомендуется). "structure" .nbt (сохранённый в 1.17 - 1.19)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| world-file-path                      | world.nbt                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| world-ticks                          | 1000                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               | Время в мире в тиках (24000 тиков == 1 игровому дню.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| game-mode                            | ADVENTURE                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                               | Доступно: ADVENTURE, CREATIVE, SURVIVAL, SPECTATOR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ispremium-auth-url                   | <https://api.mojang.com/users/profiles/minecraft/%s>                                   | <p>Custom isPremium URL </p><p></p><p>You can use Mojang one's API (set by default) </p><p>Or CloudFlare one's: <https://api.ashcon.app/mojang/v1/user/%s> </p><p></p><p> Or use this code to make your own API: <https://blog.cloudflare.com/minecraft-api-with-workers-coffeescript/> </p><p></p><p> Or implement your own API, it should just respond with HTTP code 200 only if the player is premium</p> | <p>Пользовательская isPremium ссылка.<br><br>Вы можете использовать API Mojang (установлен по умолчанию).</p><p>Или CloudFlare: <a href="https://api.ashcon.app/mojang/v1/user/%s"><https://api.ashcon.app/mojang/v1/user/%s></a> <br>Или используйте этот код для создания своего собственного API: <a href="https://blog.cloudflare.com/minecraft-api-with-workers-coffeescript/"><https://blog.cloudflare.com/minecraft-api-with-workers-coffeescript/></a><br>Или реализуйте свой собственный API, он должен просто отвечать HTTP-кодом 200 только в том случае, если у игрока лицензия :)</p> |
| on-rate-limit-premium                | true                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| world-coords                         | x: 0 y: 0 z: 0                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| cracked-title-settings               | fade-in: 10 stay: 70 fade-out: 20 clear-after-login: false                             |                                                                                                                                                                                                                                                                                                                                                                                                               | Управляет надписями на экране для игрока без лицензии                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| premium-title-settings               | fade-in: 10 stay: 70 fade-out: 20                                                      |                                                                                                                                                                                                                                                                                                                                                                                                               | Управляет надписями на экране с лицензией                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| auth-coords                          | x: 0.0 y: 0.0 z: 0.0 yaw: 0.0 pitch: 0.0                                               |                                                                                                                                                                                                                                                                                                                                                                                                               | Координаты в мире, где будет спавниться игрок при авторизации.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|                                      |                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |


# Permissions and Commands

### Player

<table><thead><tr><th width="327.832727780382">Permission</th><th>Command</th><th>Description</th></tr></thead><tbody><tr><td>limboauth.commands.destroysession </td><td>/destroysession</td><td>The player can disconnect</td></tr><tr><td>limboauth.commands.premium </td><td>/license or /premium</td><td>The player can connect a premium account</td></tr><tr><td>limboauth.commands.unregister </td><td>/unregister</td><td>The player can unregister</td></tr><tr><td>limboauth.commands.changepassword</td><td>/changepassword</td><td>The player can change the password</td></tr><tr><td>limboauth.commands.totp</td><td>/totp</td><td>The player can connect totp</td></tr><tr><td>limboauth.commands.*</td><td></td><td>The player can use all the listed commands</td></tr></tbody></table>

### Admin

<table><thead><tr><th width="338.84648076524775">Permission</th><th></th><th>Description</th></tr></thead><tbody><tr><td>limboauth.admin.forceunregister </td><td>/forceunregister </td><td>The admin can unregister to any player</td></tr><tr><td>limboauth.admin.forcechangepassword </td><td>/forcechangepassword </td><td>The admin can change the password to any player</td></tr><tr><td>limboauth.admin.reload</td><td>/lauth reload</td><td>The admin can reload the plugin</td></tr><tr><td>limboauth.admin.*</td><td></td><td>The admin can use all the listed commands</td></tr></tbody></table>


# Info

{% embed url="<https://github.com/Elytrium/LimboFilter>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord) [![Proxy Stats](https://camo.githubusercontent.com/95e2840c7fb3ba799bbbc859cda266c73c1cfd315ada0fc2cd1fd82107223731/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f736572766572732f31333639393f6c6f676f3d6d696e656372616674266c6162656c3d53657276657273)](https://bstats.org/plugin/velocity/LimboFilter/13699) [![Proxy Stats](https://camo.githubusercontent.com/4d697605d3b4fc624e8e1d993a4c0447c9eaab1400f6e7a0b474349555fe3895/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f706c61796572732f31333639393f6c6f676f3d6d696e656372616674266c6162656c3d506c6179657273)](https://bstats.org/plugin/velocity/LimboFilter/13699)

Most powerful bot filtering solution for Minecraft proxies. Built with LimboAPI.\
[MC-Market](https://www.mc-market.org/resources/21097/)\
[SpigotMC.org](https://www.spigotmc.org/resources/limboapi-limboauth-limbofilter.95748/)\
[Описание и обсуждение на русском языке (spigotmc.ru)](https://spigotmc.ru/resources/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.715/)\
[Описание и обсуждение на русском языке (rubukkit.org)](http://rubukkit.org/threads/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.177904/)

Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### See also

* [LimboAuth](https://github.com/Elytrium/LimboAuth) - Auth System built in virtual server (Limbo). Uses BCrypt, has TOTP 2FA feature. Supports literally any database due to OrmLite.
* [LimboAPI](https://github.com/Elytrium/LimboAPI) - Library for sending players to virtual servers (called limbo)

### Features of LimboFilter

* Improved Falling Check - Check X, Z coordinates;
* Highly customizable CAPTCHA's - change fonts, backplates, colors, alphabet-pattern, length;
* Client settings and brand checking;
* Highly customisable config - you can change all the messages the plugin sends;
* Ability to partially disable protection on low-loads of proxy;
* Ability to prepare raw packets to reduce CPU usage;
* Fast MCEdit schematic world loading for CAPTCHA checking;
* And more...

#### LimboFilter /vs/ popular antibot solutions:

Test server: i7-3770 (4c/8t 3.4GHz) Dedicated server, Ubuntu Server 20.04, OpenJDK 11, 16GB DDR3 1600MHz RAM, 4GB RAM is allocated to proxy.\
Attack: Motd + Join bot attack (100k joins per seconds, 1.17 Protocol)

| Proxy server                            | Info                                        | Boot time | % CPU on attack |
| --------------------------------------- | ------------------------------------------- | --------- | --------------- |
| Velocity                                | LimboFilter + LimboAuth Online/Offline Mode | 2 sec     | 20%             |
| Velocity                                | LimboFilter + Offline Mode                  | 2 sec     | 20%             |
| Leymooo's BungeeCord BotFilter          | JPremium Online/Offline Mode                | 8 sec     | 95%             |
| Leymooo's BungeeCord BotFilter          | Offline Mode                                | 8 sec     | 40%             |
| yooniks' BungeeCord Aegis Escanor 1.3.1 | Offline Mode                                | 10 sec    | 20%             |
| yooniks' BungeeCord Aegis 9.2.1         | Offline Mode                                | 10 sec    | 100% (xd)       |
| Velocity                                | JPremium Online/Offline Mode                | 2 sec     | 95%             |
| Velocity                                | BotSentry 9.2 + Online Mode                 | 2 sec     | 70%             |
| Velocity                                | Online Mode                                 | 2 sec     | 70%             |
| Velocity                                | Offline Mode                                | 2 sec     | 55%             |


# Permissions and Commands

### Admin

<table><thead><tr><th width="229.33333333333331">Permission</th><th>Command</th><th>Description</th></tr></thead><tbody><tr><td><em><strong>limbofilter.commands.sendfilter</strong></em></td><td>/sendfilter</td><td>The admin can send the player to filter</td></tr><tr><td>limbofilter.admin.stats </td><td>/lfilter stats</td><td>The admin can view the status of the filter</td></tr><tr><td>limbofilter.admin.reload </td><td>/lfilter reload</td><td>The admin can reload the plugin</td></tr><tr><td>limbofilter.admin.*</td><td></td><td>The admin can use all the listed commands</td></tr></tbody></table>


# Info

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord)\
[MC-Market](https://www.mc-market.org/resources/21097/)\
[SpigotMC.org](https://www.spigotmc.org/resources/limboapi-limboauth-limbofilter.95748/)\
[Описание и обсуждение на русском языке (spigotmc.ru)](https://spigotmc.ru/resources/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.715/)\
[Описание и обсуждение на русском языке (rubukkit.org)](http://rubukkit.org/threads/limboapi-limboauth-limbofilter-virtualnye-servera-dlja-velocity.177904/)

Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### See also

* [LimboAuth](https://github.com/Elytrium/LimboAuth) - Auth System built in virtual server (Limbo). Uses BCrypt, has TOTP 2FA feature. Supports literally any database due to OrmLite.
* [LimboFilter](https://github.com/Elytrium/LimboFilter) - Most powerful bot filtering solution for Minecraft proxies. Built with LimboAPI.
* [LimboAPI](https://github.com/Elytrium/LimboAPI) - Library for sending players to virtual servers (called limbo)


# Info

{% embed url="<https://github.com/Elytrium/LimboAuth-ClientMod>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord)

A client mod for [LimboAuth](https://github.com/Elytrium/LimboAuth)\
Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### Mod dependencies

* Architectury API

### Features of LimboAuth Client Mod

* Saves session tokens to the config file (`.minecraft/config/limboauth.yml`)
* You can set your own session token via the custom launcher

#### How does session token work

1. The server makes a token - a struct that contains an issue timestamp
2. The server signs this token with a private verify key (which you can see in the LimboAuth config)
3. The server sends the token to the client, the client saves it to the config file
4. When player joins the server, servers asks client if he has a session token
5. If the player has a session token, it sends it to the server
6. The server verifies the token via the private verify key

#### How to generate a session token

Pseudocode

```
# This key must be the same in the plugin config and in the server hash issuer
= = "testkey123"
= = unix_timestamp_millis ()
player_username = "TestPlayer123"

username_bytes = utf8.string_to_bytes(lower (player_username))
timestamp_bytes = big_endian.long_to_bytes(issue_timestamp)

# siphash 2-4 (default siphash) is used here
tokenhash = siphash.hash(verify_key, byte_concat(username_bytes, timestamp_bytes))
hash_bytes = big_endian.long_to_bytes(tokenhash)

token = base64.encode_to_string(byte_concat(timestamp_bytes, hash_bytes))
```

#### When does the token expire?

* The token expires if the player changes his password
* See ISSUEDTIME database field


# Info

Info

{% embed url="<https://github.com/Elytrium/FastMOTD>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord) [![Proxy Stats](https://camo.githubusercontent.com/b350a46c6733011d6174c18ca6b38d25cf40e45a776d4c129458928d5c03270d/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f736572766572732f31353634303f6c6f676f3d6d696e656372616674266c6162656c3d53657276657273)](https://bstats.org/plugin/velocity/FastMOTD/15640) [![Proxy Stats](https://camo.githubusercontent.com/4ebe54370c63163cd86332b2964837cd8b15c7ad22489e2fc30c6188c3423ad5/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f706c61796572732f31353634303f6c6f676f3d6d696e656372616674266c6162656c3d506c6179657273)](https://bstats.org/plugin/velocity/FastMOTD/15640)

A MOTD plugin for Velocity that caches network packets. This helps it be the fastest one of the MOTD plugins.\
Test server: [`ely.su`](https://hotmc.ru/minecraft-server-203216)

### Features

* Fake online (percent + static sum)
* Multiple descriptions/favicons support
* Set information (custom text in the player list)
* Caching of network packets
* Max count "just add up" support
* PNG built-in compression

### Comparison with other MOTD plugins

Intel Core i9-9700K, DDR4 (a server that is not running any programs):

| Plugin               | Pings per second count                 |
| -------------------- | -------------------------------------- |
| FastMOTD             | 1 700 000 - 2 000 000 pings per second |
| Without MOTD plugins | 900 000 - 1 100 000 pings per second   |
| MiniMOTD             | 480 000 - 580 000 pings per second     |

Intel Xeon E3-1270, DDR3 (a PC with several applications running):

| Plugin               | Pings per second count               |
| -------------------- | ------------------------------------ |
| FastMOTD             | 840 000 - 1 000 000 pings per second |
| Without MOTD plugins | 330 000 - 430 000 pings per second   |
| MiniMOTD             | 150 000 - 200 000 pings per second   |


# Info

{% embed url="<https://github.com/Elytrium/VelocityTools>" %}

[![Join our Discord](https://camo.githubusercontent.com/1185af6012f25cc9e1ec012ea5d7f0ed129d525a35def95f54c322f3d7526fff/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3737353737383832323333343730393738302e7376673f6c6f676f3d646973636f7264266c6162656c3d446973636f7264)](https://ely.su/discord)   [![Proxy Stats](https://camo.githubusercontent.com/ca8f46fa6277ba806fcd79bae08a9003dcae793099c2b1a254bf3bc6e7a49ed7/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f736572766572732f31323730383f6c6f676f3d6d696e656372616674266c6162656c3d53657276657273)](https://bstats.org/plugin/velocity/VelocityTools/12708) [![Proxy Stats](https://camo.githubusercontent.com/2af9d9bd845d090b15b8012adaddc09c88c2241e18ebc825a1dceb9af22facce/68747470733a2f2f696d672e736869656c64732e696f2f6273746174732f706c61796572732f31323730383f6c6f676f3d6d696e656372616674266c6162656c3d506c6179657273)](https://bstats.org/plugin/velocity/VelocityTools/12708)

Some useful tools for Velocity.\
[Modrinth](https://modrinth.com/plugin/velocitytools)

### Features of VelocityTools

* [Protocol](https://wiki.vg/Protocol_History) Blocker (prohibits connection from certain versions)
* [Hostnames](https://en.wikipedia.org/wiki/Domain_name) Manager (denies connection from a specific hostname, see details below)
* Brand Changer aka Brand Rewriter (changes brand in game and in ping requests)

### Commands and permissions


# Permissions and Commands

| Permission                             | Command                   | Description                        |
| -------------------------------------- | ------------------------- | ---------------------------------- |
| ***velocitytools.admin.reload***       | **/velocitytools reload** | Reload Plugin Command              |
| ***velocitytools.command.alert***      | **/alert**                | Send Proxy-Wide Alert Command      |
| ***velocitytools.command.find***       | **/find**                 | Find Player Server Command         |
| ***velocitytools.command.send***       | **/send**                 | Send Player to Server Command      |
| ***velocitytools.command.hub***        | **/hub**                  | Hub Command                        |
| ***velocitytools.command.hub.bypass*** | -                         | Disabled-Servers Bypass Permission |


