# SimpleLimbo<\/p>\n
A lightweight virtual limbo server plugin for Velocity proxy using LimboAPI.<\/p>\n
## Features<\/p>\n
– **Multiple Limbo Servers** – Create unlimited virtual limbo instances with different configurations
\n– **Auth Plugin Support** – Compatible with JPremium and other authentication plugins
\n– **Fallback System** – Automatically catch players when backend servers go down
\n– **AFK Detection** – Move idle players to a dedicated limbo server
\n– **Custom Worlds** – Load schematic files for limbo environments
\n– **Rich Display** – Titles, action bars, boss bars, and chat messages
\n– **Auto Reconnect** – Automatically attempt to reconnect players to backend servers
\n– **Velocity Bridge** – Register virtual servers that redirect to limbos<\/p>\n
## Requirements<\/p>\n
– Velocity 3.3.0+
\n– LimboAPI 1.1.27+
\n– Java 17+<\/p>\n
## Installation<\/p>\n
1. Download LimboAPI and place it in your Velocity plugins folder
\n2. Download SimpleLimbo and place it in your Velocity plugins folder
\n3. Restart Velocity
\n4. Configure `plugins\/simplelimbo\/config.yml`<\/p>\n
## Configuration<\/p>\n
### Basic Limbo Setup<\/p>\n
“`yaml
\nlimbos:
\n auth:
\n enabled: true
\n dimension: “OVERWORLD”
\n gamemode: “ADVENTURE”
\n world-time: 6000<\/p>\n
spawn:
\n x: 0.0
\n y: 100.0
\n z: 0.0
\n yaw: 0.0
\n pitch: 0.0<\/p>\n
settings:
\n read-timeout: 30000
\n should-rejoin: true
\n should-respawn: false
\n disable-falling: true
\n disable-falling-delay-ms: 5000<\/p>\n
commands:
\n – “login”
\n – “register”<\/p>\n
display:
\n on-join:
\n chat: “&eUse \/login or \/register”
\n title:
\n enabled: true
\n title: “&eAuthentication”
\n subtitle: “&7Please authenticate”
\n“`<\/p>\n
### Velocity Bridge (Auth Plugin Compatibility)<\/p>\n
For plugins like JPremium that expect players to be on a named server:<\/p>\n
“`yaml
\nvelocity-bridge:
\n enabled: true
\n register-aliases: true
\n aliases:
\n auth: “auth” # Maps server name “auth” to limbo “auth”
\n“`<\/p>\n
Then in your auth plugin config, set the limbo server to `auth`.<\/p>\n
### Anti-Fall Tuning<\/p>\n
– `disable-falling` keeps players from dropping after join (Y lock mode).
\n– `disable-falling-delay-ms` controls when anti-fall starts.
\n– If players get slow join or “Loading Terrain” delay, increase `disable-falling-delay-ms` (for example: `1200`, `1500`, `2000`).<\/p>\n
### Settings Notes<\/p>\n
– `should-rejoin: true` keeps LimboAPI rejoin flow enabled (recommended for stability).
\n– `should-respawn: false` avoids extra respawn packet during join.<\/p>\n
### Fallback System<\/p>\n
Automatically catch players when backend servers crash:<\/p>\n
“`yaml
\nauto-triggers:
\n fallback:
\n enabled: true
\n limbo: “fallback”
\n kick-patterns:
\n – “.*server.*closed.*”
\n – “.*timed out.*”
\n message: “&cServer offline. Moved to fallback.”
\n“`<\/p>\n
### AFK System<\/p>\n
Move idle players to a dedicated limbo:<\/p>\n
“`yaml
\nauto-triggers:
\n afk:
\n enabled: true
\n limbo: “afk”
\n idle-time: 300
\n check-interval: 30
\n exempt-permission: “simplelimbo.afk.exempt”
\n“`<\/p>\n
### Custom World Files<\/p>\n
Load schematic files for limbo environments:<\/p>\n
“`yaml
\nlimbos:
\n lobby:
\n world-file:
\n enabled: true
\n type: “SCHEMATIC”
\n path: “plugins\/simplelimbo\/worlds\/lobby.schem”
\n offset:
\n x: 0
\n y: 64
\n z: 0
\n light-level: 15
\n“`<\/p>\n
## Commands<\/p>\n
| Command | Permission | Description | ## Permissions<\/p>\n | Permission | Description | ## Auth Plugin Compatibility<\/p>\n SimpleLimbo includes compatibility features for authentication plugins that call `player.getCurrentServer()`:<\/p>\n 1. Set `fake-server-name` in your limbo config to a valid Velocity server name Example for JPremium:<\/p>\n “`yaml limbos: “`yaml ## Building from Source<\/p>\n “`bash The compiled JAR will be in `build\/libs\/`.<\/p>\n ## License<\/p>\n MIT License<\/p>\n ## Credits<\/p>\n – LimboAPI by Elytrium A lightweight virtual limbo server plugin for Velocity proxy using LimboAPI.<\/p>\n","protected":false},"featured_media":141075,"template":"","meta":{"_minecraft_slug":"simplelimbo","_minecraft_project_id":"eQR6TEfL","_minecraft_author":"ItsAzni","_minecraft_license":"MIT","_minecraft_downloads":73,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplelimbo.zip","_minecraft_size_bytes":709936,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:21:35.610624Z","_minecraft_date_created":"2026-02-16T06:48:25.398742Z","_minecraft_date_modified":"2026-02-12T16:54:39.699326Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplelimbo","_minecraft_icon_attachment_id":141075,"_minecraft_imported_at":"2026-06-08T09:09:07+00:00","_minecraft_import_hash":"4333bf37f985cf993391217665b636ee","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,126,90,123,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-141074","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-management","mod_category-optimization","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n| ———————————— | ——————- | ———————— |
\n| `\/simplelimbo send
\n| `\/simplelimbo list` | `simplelimbo.admin` | List all limbo servers |
\n| `\/simplelimbo reload` | `simplelimbo.admin` | Reload configuration |<\/p>\n
\n| ———————— | ———————— |
\n| `simplelimbo.admin` | Access to admin commands |
\n| `simplelimbo.afk.exempt` | Exempt from AFK trigger |<\/p>\n
\n2. Enable the velocity-bridge with matching alias
\n3. Configure your auth plugin to use this server name as the limbo server<\/p>\n
\n# SimpleLimbo config.yml
\nvelocity-bridge:
\n aliases:
\n auth: “auth”<\/p>\n
\n auth:
\n fake-server-name: “auth”
\n # … other settings
\n“`<\/p>\n
\n# JPremium configuration.yml
\nlimboServerNames: [auth]
\nmainServerNames: [lobby]
\n“`<\/p>\n
\ngit clone https:\/\/github.com\/ItsAzni\/SimpleLimbo.git
\ncd SimpleLimbo
\n.\/gradlew shadowJar
\n“`<\/p>\n
\n– Velocity by PaperMC<\/p>\n","protected":false},"excerpt":{"rendered":"