Want to support my work? You can do so by buying the plugin from **BuiltByBit**
\nhttps:\/\/builtbybit.com\/resources\/limbomanager.105562\/<\/p>\n
# LimboManager<\/p>\n
**LimboManager** is a versatile, fully-featured management plugin for Velocity that leverages LimboAPI to intuitively weave proxy-side virtual dimensions into your network. <\/p>\n
## \ud83c\udf1f Key Features<\/p>\n
* **Virtual Limbos**: You can create virtual limbo servers, great for auth plugins, like LibreLogin
\n* **Fallback system**: Prevent players from getting kicked from your server when it restarts.
\n* **AFK fallback**: Automatically detects inactive players and sends them to a dedicated AFK limbo
\n* **LimboAPI Schema**: Limbo API provided schema loading, supports schematics, worldedit schematics and structs.
\n* **Fully customizable**: You can edit nearly all strings that the plugin uses, except for console messages, for better support quality, it’s left as English.<\/p>\n
## \ud83d\udce6 Dependencies<\/p>\n
To use LimboManager, you **must** install the following Velocity plugins alongside it:
\n* LimboAPI
\n* PacketEvents (Velocity Version)<\/p>\n
## \u2328\ufe0f Commands & Permissions<\/p>\n
The core command root is `\/limbomanager`.<\/p>\n
| Command | Permission | Description |
\n|—|—|—|
\n| `\/limbomanager help` | None | Lists available commands. |
\n| `\/limbomanager reload` | `limbomanager.command.reload` | Hot-reloads all config spaces and language files. |
\n| `\/limbomanager diagnostics` | `limbomanager.command.diagnostics` | Dumps precise runtime diagnostics (active spaces, AFK module health, aliases) into chat. |
\n| `\/limbomanager send [player] [limbo]` | `limbomanager.command.send` | Forcibly pull a specific player out of their active server and plunge them into an enabled Limbo space. |<\/p>\n
*(Alias mappings defined in your configurations automatically assign proxy-level command intercepts for your users)*<\/p>\n
## Configuration
\n`config.yml`<\/p>\n
“`yml
\n# LimboManager global configuration.
\n# Increment this value when schema changes require user action after updates.
\nconfig-version: 1<\/p>\n
# Active language file name from LimboManager\/language\/ `afk.yml` settings: world: display: sounds: `reconnect.yml` settings: world: commands: display: sounds: `lang.yml` command: player: diagnostics: `server.yml` settings: world: # Optional allow-list of commands that remain executable in this limbo. # Optional display configuration for join\/bossbar\/actionbar\/title. Virtual server manager with AFK and fallback server.<\/p>\n","protected":false},"featured_media":94203,"template":"","meta":{"_minecraft_slug":"limbomanager","_minecraft_project_id":"WpJggRUN","_minecraft_author":"LitcherX","_minecraft_license":"MIT","_minecraft_downloads":14,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"limbomanager.zip","_minecraft_size_bytes":2051816,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:52:06.590409Z","_minecraft_date_created":"2026-04-28T20:20:44.677796Z","_minecraft_date_modified":"2026-04-16T08:57:00.922935Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/limbomanager","_minecraft_icon_attachment_id":94203,"_minecraft_imported_at":"2026-06-05T09:23:43+00:00","_minecraft_import_hash":"a0a43c93f066ff001d07c28641a053dd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[92,985,159],"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,83,167,163],"class_list":["post-94202","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-utility","mod_category-velocity","mod_category-worldgen","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nlang: “en”
\n“`<\/p>\n
\n“`yml
\n# Enables AFK detection and AFK limbo routing.
\nenabled: true<\/p>\n
\n # Idle time in seconds before a player is moved to AFK.
\n idle-time: 300
\n # Sweep interval in seconds used to check idle players.
\n check-interval: 30
\n # Players with this permission bypass AFK handling.
\n exempt-permission: “limbomanager.exempt.afk”
\n # Message shown when player is moved to AFK.
\n message: “&7You have been moved to AFK due to inactivity.”
\n # If false, AFK players are not sent to AFK limbo.
\n use-limbo: true
\n # Enables verbose AFK debug logs.
\n debug: false<\/p>\n
\n # Client view distance while in AFK limbo.
\n view-distance: 2
\n # Server simulation distance while in AFK limbo.
\n simulation-distance: 2
\n # Prevents players from falling immediately after joining AFK limbo.
\n disable-falling: true
\n # Delay (ms) before disabling falling.
\n disable-falling-delay-ms: 800
\n # Limbo world dimension (NETHER, OVERWORLD, THE_END).
\n dimension: “THE_END”
\n # Game mode used inside AFK limbo.
\n gamemode: “SPECTATOR”
\n # Fixed world time shown to AFK players.
\n world-time: 0
\n # Whether AFK players see each other.
\n others-visible: true
\n # Global light level for generated chunks.
\n light-level: 15
\n spawn:
\n # Spawn X coordinate.
\n x: 0.0
\n # Spawn Y coordinate.
\n y: 100.0
\n # Spawn Z coordinate.
\n z: 0.0
\n # Spawn yaw rotation.
\n yaw: 0.0
\n # Spawn pitch rotation.
\n pitch: 0.0
\n schematic:
\n # Enables schematic paste into AFK limbo world.
\n enabled: false
\n # Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
\n type: “SCHEMATIC”
\n # Relative path inside \/schematics.
\n path: “”
\n offset:
\n # Paste offset X.
\n x: 0
\n # Paste offset Y.
\n y: 64
\n # Paste offset Z.
\n z: 0<\/p>\n
\n on-join:
\n # One-time chat message sent when player enters AFK limbo.
\n chat: “&7You are now AFK.”
\n bossbar:
\n # Enables rotating\/static AFK bossbar.
\n enabled: true
\n # Bossbar title text (or list for animation).
\n title: “&6AFK”
\n # Bossbar color.
\n color: “YELLOW”
\n # Bossbar style.
\n style: “SOLID”
\n # Progress from 0.0 to 1.0 (or list for animation).
\n progress: 1.0
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n actionbar:
\n # Enables repeating AFK actionbar.
\n enabled: true
\n # Repeating actionbar text.
\n message: “&7Move to return to your server…”
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n title:
\n # Enables repeating AFK title.
\n enabled: true
\n # Title text (or list for animation).
\n title: “&6AFK”
\n # Subtitle text (or list for animation).
\n subtitle: “”
\n # Fade-in ticks for repeating title.
\n fade-in: 10
\n # Fade-out ticks for repeating title.
\n fade-out: 20
\n # Animation step interval; -1 keeps first value static.
\n animation: -1<\/p>\n
\n away:
\n # Sound played when a player is moved to AFK.
\n name: “entity.experience_orb.pickup”
\n # Sound volume.
\n volume: 1.0
\n # Sound pitch.
\n pitch: 1.0
\n back:
\n # Sound played when a player returns from AFK.
\n name: “entity.player.levelup”
\n # Sound volume.
\n volume: 1.0
\n # Sound pitch.
\n pitch: 1.0
\n“`<\/p>\n
\n“`
\n# Enables reconnect handling for kicked\/disconnected players.
\nenabled: true<\/p>\n
\n # Regex matched against disconnect reason to trigger reconnect flow.
\n trigger-message: ‘((?i)^(server closed|server is restarting|multiplayer\\.disconnect\\.server_shutdown))+$’
\n # Delay (ms) between ping checks while waiting for target server.
\n check-interval: 1000
\n # Ping timeout (ms) for availability checks.
\n ping-timeout: 500
\n # Delay (ms) before reconnecting after server is available.
\n join-delay: 2000
\n # If false, reconnect runs without sending player to limbo.
\n use-limbo: true
\n # Enables verbose reconnect debug logs.
\n debug: false<\/p>\n
\n # Client view distance while in reconnect limbo.
\n view-distance: 2
\n # Server simulation distance while in reconnect limbo.
\n simulation-distance: 2
\n # Prevents players from falling immediately after joining reconnect limbo.
\n disable-falling: true
\n # Delay (ms) before disabling falling.
\n disable-falling-delay-ms: 800
\n # Limbo world dimension (NETHER, OVERWORLD, THE_END).
\n dimension: “THE_END”
\n # Game mode used inside reconnect limbo.
\n gamemode: “SPECTATOR”
\n # Fixed world time shown to players.
\n world-time: 0
\n # Whether reconnect-limbo players are visible to each other.
\n others-visible: true
\n # Global light level for generated chunks.
\n light-level: 15
\n spawn:
\n # Spawn X coordinate.
\n x: 0.0
\n # Spawn Y coordinate.
\n y: 100.0
\n # Spawn Z coordinate.
\n z: 0.0
\n # Spawn yaw rotation.
\n yaw: 0.0
\n # Spawn pitch rotation.
\n pitch: 0.0
\n schematic:
\n # Enables schematic paste into reconnect limbo world.
\n enabled: false
\n # Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
\n type: “SCHEMATIC”
\n # Relative path inside \/schematics.
\n path: “”
\n offset:
\n # Paste offset X.
\n x: 0
\n # Paste offset Y.
\n y: 64
\n # Paste offset Z.
\n z: 0<\/p>\n
\n # Allow-list of commands executable while reconnecting.
\n – “newgen”
\n – “oldgen”<\/p>\n
\n on-join:
\n # One-time chat message sent when player enters reconnect limbo.
\n chat: “&cAll servers are offline.”
\n bossbar:
\n # Enables rotating\/static reconnect bossbar.
\n enabled: true
\n # Bossbar title text (or list for animation).
\n title: “&cFallback Limbo”
\n # Bossbar color.
\n color: “RED”
\n # Bossbar style.
\n style: “SOLID”
\n # Progress from 0.0 to 1.0 (or list for animation).
\n progress: 1.0
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n actionbar:
\n # Enables repeating reconnect actionbar.
\n enabled: true
\n # Repeating actionbar text
\n message: “&7Reconnecting…”
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n title:
\n # Enables repeating reconnect title.
\n enabled: true
\n # Title text (or list for animation).
\n title: “&cServer Offline”
\n # Subtitle text (or list for animation).
\n subtitle: “&7Attempting reconnect…”
\n # Fade-in ticks for repeating title.
\n fade-in: 0
\n # Fade-out ticks for repeating title.
\n fade-out: 0
\n # Animation step interval; -1 keeps first value static.
\n animation: -1<\/p>\n
\n waiting:
\n # Sound played while waiting for target server to come online.
\n name: “entity.experience_orb.pickup”
\n # Sound volume.
\n volume: 1.0
\n # Sound pitch.
\n pitch: 1.0
\n connecting:
\n # Sound played when reconnect handoff begins.
\n name: “entity.player.levelup”
\n # Sound volume.
\n volume: 1.0
\n # Sound pitch.
\n pitch: 1.0
\n“`<\/p>\n
\n“`yml
\ncommon:
\n no-permission: “&cYou do not have permission.”<\/p>\n
\n reload:
\n success: “&aLimboManager reloaded.”
\n failed: “&cFailed to reload LimboManager. Check console.”
\n diagnostics:
\n collecting: “&eCollecting diagnostics…”
\n line: “&7{line}”
\n help: |-
\n &eLimboManager commands:
\n &7\/limbomanager reload &8- &fReload all config files
\n &7\/limbomanager diagnostics &8- &fShow runtime diagnostics
\n &7\/limbomanager send
\n send:
\n usage: “&cUsage: \/limbomanager send
\n player-offline: “&cPlayer ‘&f{player}&c’ is not online.”
\n unknown-limbo: “&cUnknown or disabled limbo ‘&f{limbo}&c’. Only enabled virtual limbos are allowed.”
\n success: “&aSent &f{player} &ato limbo &f{limbo}&a.”
\n target-notice: “&eYou were sent to limbo &f{limbo}&e by an administrator.”
\n no-enabled-limbos: “&7No enabled virtual limbo configs are loaded.”
\n enabled-limbos: “&7Enabled limbos: &f{limbos}”<\/p>\n
\n command-blocked: “&cThis command is blocked while you are in limbo.”<\/p>\n
\n service-not-initialized: “LimboManager service is not initialized yet.”
\n info: |-
\n LimboManager diagnostics:
\n – virtual limbos: {virtual_count}
\n – alias routes: {alias_count}
\n – reconnect module: {reconnect_enabled}
\n – afk module: {afk_enabled}
\n – active limbo sessions: {active_count}
\n – pending initial aliases: {pending_count}
\n – ViaVersion: {via_status} ({via_details})
\n – LibreLogin: {libre_status} ({libre_details})
\n – LibreLogin: {libre_status} ({libre_details})
\n“`<\/p>\n
\n“`
\n# Enables or disables this virtual limbo profile.
\nenabled: false<\/p>\n
\n # Optional alias matched against target server names to override routing.
\n alias: “”
\n # Enables extra debug logging for this profile.
\n debug: false<\/p>\n
\n # Client view distance while in limbo.
\n view-distance: 2
\n # Server simulation distance while in limbo.
\n simulation-distance: 2
\n # Prevents players from falling immediately after joining limbo.
\n disable-falling: true
\n # Delay (ms) before disabling falling.
\n disable-falling-delay-ms: 800
\n # Limbo world dimension (NETHER, OVERWORLD, THE_END).
\n dimension: “THE_END”
\n # Game mode used inside limbo.
\n gamemode: “SPECTATOR”
\n # Fixed world time shown to players.
\n world-time: 0
\n # Whether other limbo players are visible.
\n others-visible: true
\n # Global light level for generated chunks.
\n light-level: 15
\n spawn:
\n # Spawn X coordinate.
\n x: 0.0
\n # Spawn Y coordinate.
\n y: 100.0
\n # Spawn Z coordinate.
\n z: 0.0
\n # Spawn yaw rotation.
\n yaw: 0.0
\n # Spawn pitch rotation.
\n pitch: 0.0
\n schematic:
\n # Enables schematic paste into limbo world.
\n enabled: false
\n # Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
\n type: “SCHEMATIC”
\n # Relative path inside \/schematics.
\n path: “”
\n offset:
\n # Paste offset X.
\n x: 0
\n # Paste offset Y.
\n y: 64
\n # Paste offset Z.
\n z: 0<\/p>\n
\ncommands:
\n – “hub”
\n – “lobby”
\n – “queue”<\/p>\n
\ndisplay:
\n on-join:
\n # One-time chat message sent when player enters limbo.
\n chat: “&cAll servers are offline.”
\n title:
\n # Enables one-time join title.
\n enabled: true
\n # Main join title text.
\n title: “&cHey there!”
\n # Join subtitle text.
\n subtitle: “&7Why are you here?”
\n # Title fade-in ticks.
\n fade-in: 10
\n # Title stay ticks.
\n stay: 80
\n # Title fade-out ticks.
\n fade-out: 20
\n actionbar:
\n # Enables one-time join actionbar.
\n enabled: false
\n # Join actionbar text.
\n message: “Something cool”
\n bossbar:
\n # Enables rotating\/static bossbar while in limbo.
\n enabled: true
\n # Bossbar title text (or list for animation).
\n title: “&cFallback Limbo”
\n # Bossbar color (PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE).
\n color: “RED”
\n # Bossbar style (SOLID, SEGMENTED_*).
\n style: “SOLID”
\n # Progress from 0.0 to 1.0 (or list for animation).
\n progress: 1.0
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n actionbar:
\n # Enables repeating actionbar while in limbo.
\n enabled: false
\n # Repeating actionbar text
\n message: “&7Reconnecting…”
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n title:
\n # Enables repeating title while in limbo.
\n enabled: false
\n # Title text (or list for animation).
\n title: “&cServer Offline”
\n # Subtitle text (or list for animation).
\n subtitle: “&7Attempting reconnect…”
\n # Fade-in ticks for repeating title.
\n fade-in: 0
\n # Fade-out ticks for repeating title.
\n fade-out: 0
\n # Animation step interval; -1 keeps first value static.
\n animation: -1
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"