Want to support my work? You can do so by buying the plugin from BuiltByBit https://builtbybit.com/resources/limbomanager.105562/
LimboManager
LimboManager is a versatile, fully-featured management plugin for Velocity that leverages LimboManager to intuitively weave proxy-side virtual dimensions into your network.
🌟 Key Features
* Fully customizable: You can create virtual limbo servers, great for auth plugins, like LibreLogin * Fully customizable: Prevent players from getting kicked from your server when it restarts. * Fully customizable: Automatically detects inactive players and sends them to a dedicated AFK limbo * Fully customizable: Limbo API provided schema loading, supports schematics, worldedit schematics and structs. * 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.
📦 Dependencies
To use LimboManager, you must install the following Velocity plugins alongside it: * must * %%MD1%%
⌨️ Commands & Permissions
The core command root is `/limbomanager`.
| Command | Permission | Description | |---|---|---| | `/limbomanager help` | None | Lists available commands. | | `/limbomanager reload` | `limbomanager.command.reload` | Hot-reloads all config spaces and language files. | | `/limbomanager diagnostics` | `limbomanager.command.diagnostics` | Dumps precise runtime diagnostics (active spaces, AFK module health, aliases) into chat. | | `/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. |
*(Alias mappings defined in your configurations automatically assign proxy-level command intercepts for your users)*
Configuration
`config.yml`
```yml
LimboManager global configuration.
Increment this value when schema changes require user action after updates.
config-version: 1
Active language file name from LimboManager/language/<lang>.yml
lang: "en" ```
`afk.yml` ```yml
Enables AFK detection and AFK limbo routing.
enabled: true
settings:
Idle time in seconds before a player is moved to AFK.
idle-time: 300
Sweep interval in seconds used to check idle players.
check-interval: 30
Players with this permission bypass AFK handling.
exempt-permission: "limbomanager.exempt.afk"
Message shown when player is moved to AFK.
message: "&7You have been moved to AFK due to inactivity."
If false, AFK players are not sent to AFK limbo.
use-limbo: true
Enables verbose AFK debug logs.
debug: false
world:
Client view distance while in AFK limbo.
view-distance: 2
Server simulation distance while in AFK limbo.
simulation-distance: 2
Prevents players from falling immediately after joining AFK limbo.
disable-falling: true
Delay (ms) before disabling falling.
disable-falling-delay-ms: 800
Limbo world dimension (NETHER, OVERWORLD, THE_END).
dimension: "THE_END"
Game mode used inside AFK limbo.
gamemode: "SPECTATOR"
Fixed world time shown to AFK players.
world-time: 0
Whether AFK players see each other.
others-visible: true
Global light level for generated chunks.
light-level: 15 spawn:
Spawn X coordinate.
x: 0.0
Spawn Y coordinate.
y: 100.0
Spawn Z coordinate.
z: 0.0
Spawn yaw rotation.
yaw: 0.0
Spawn pitch rotation.
pitch: 0.0 schematic:
Enables schematic paste into AFK limbo world.
enabled: false
Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
type: "SCHEMATIC"
Relative path inside /schematics.
path: "" offset:
Paste offset X.
x: 0
Paste offset Y.
y: 64
Paste offset Z.
z: 0
display: on-join:
One-time chat message sent when player enters AFK limbo.
chat: "&7You are now AFK." bossbar:
Enables rotating/static AFK bossbar.
enabled: true
Bossbar title text (or list for animation).
title: "&6AFK"
Bossbar color.
color: "YELLOW"
Bossbar style.
style: "SOLID"
Progress from 0.0 to 1.0 (or list for animation).
progress: 1.0
Animation step interval; -1 keeps first value static.
animation: -1 actionbar:
Enables repeating AFK actionbar.
enabled: true
Repeating actionbar text.
message: "&7Move to return to your server..."
Animation step interval; -1 keeps first value static.
animation: -1 title:
Enables repeating AFK title.
enabled: true
Title text (or list for animation).
title: "&6AFK"
Subtitle text (or list for animation).
subtitle: ""
Fade-in ticks for repeating title.
fade-in: 10
Fade-out ticks for repeating title.
fade-out: 20
Animation step interval; -1 keeps first value static.
animation: -1
sounds: away:
Sound played when a player is moved to AFK.
name: "entity.experience_orb.pickup"
Sound volume.
volume: 1.0
Sound pitch.
pitch: 1.0 back:
Sound played when a player returns from AFK.
name: "entity.player.levelup"
Sound volume.
volume: 1.0
Sound pitch.
pitch: 1.0 ```
`reconnect.yml` ```
Enables reconnect handling for kicked/disconnected players.
enabled: true
settings:
Regex matched against disconnect reason to trigger reconnect flow.
trigger-message: '((?i)^(server closed|server is restarting|multiplayer\.disconnect\.server_shutdown))+$'
Delay (ms) between ping checks while waiting for target server.
check-interval: 1000
Ping timeout (ms) for availability checks.
ping-timeout: 500
Delay (ms) before reconnecting after server is available.
join-delay: 2000
If false, reconnect runs without sending player to limbo.
use-limbo: true
Enables verbose reconnect debug logs.
debug: false
world:
Client view distance while in reconnect limbo.
view-distance: 2
Server simulation distance while in reconnect limbo.
simulation-distance: 2
Prevents players from falling immediately after joining reconnect limbo.
disable-falling: true
Delay (ms) before disabling falling.
disable-falling-delay-ms: 800
Limbo world dimension (NETHER, OVERWORLD, THE_END).
dimension: "THE_END"
Game mode used inside reconnect limbo.
gamemode: "SPECTATOR"
Fixed world time shown to players.
world-time: 0
Whether reconnect-limbo players are visible to each other.
others-visible: true
Global light level for generated chunks.
light-level: 15 spawn:
Spawn X coordinate.
x: 0.0
Spawn Y coordinate.
y: 100.0
Spawn Z coordinate.
z: 0.0
Spawn yaw rotation.
yaw: 0.0
Spawn pitch rotation.
pitch: 0.0 schematic:
Enables schematic paste into reconnect limbo world.
enabled: false
Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
type: "SCHEMATIC"
Relative path inside /schematics.
path: "" offset:
Paste offset X.
x: 0
Paste offset Y.
y: 64
Paste offset Z.
z: 0
commands:
Allow-list of commands executable while reconnecting.
- "newgen" - "oldgen"
display: on-join:
One-time chat message sent when player enters reconnect limbo.
chat: "&cAll servers are offline." bossbar:
Enables rotating/static reconnect bossbar.
enabled: true
Bossbar title text (or list for animation).
title: "&cFallback Limbo"
Bossbar color.
color: "RED"
Bossbar style.
style: "SOLID"
Progress from 0.0 to 1.0 (or list for animation).
progress: 1.0
Animation step interval; -1 keeps first value static.
animation: -1 actionbar:
Enables repeating reconnect actionbar.
enabled: true
Repeating actionbar text
message: "&7Reconnecting..."
Animation step interval; -1 keeps first value static.
animation: -1 title:
Enables repeating reconnect title.
enabled: true
Title text (or list for animation).
title: "&cServer Offline"
Subtitle text (or list for animation).
subtitle: "&7Attempting reconnect..."
Fade-in ticks for repeating title.
fade-in: 0
Fade-out ticks for repeating title.
fade-out: 0
Animation step interval; -1 keeps first value static.
animation: -1
sounds: waiting:
Sound played while waiting for target server to come online.
name: "entity.experience_orb.pickup"
Sound volume.
volume: 1.0
Sound pitch.
pitch: 1.0 connecting:
Sound played when reconnect handoff begins.
name: "entity.player.levelup"
Sound volume.
volume: 1.0
Sound pitch.
pitch: 1.0 ```
`lang.yml` ```yml common: no-permission: "&cYou do not have permission."
command: reload: success: "&aLimboManager reloaded." failed: "&cFailed to reload LimboManager. Check console." diagnostics: collecting: "&eCollecting diagnostics..." line: "&7{line}" help: |- &eLimboManager commands: &7/limbomanager reload &8- &fReload all config files &7/limbomanager diagnostics &8- &fShow runtime diagnostics &7/limbomanager send <player> <limbo> &8- &fSend a player to an enabled virtual limbo send: usage: "&cUsage: /limbomanager send <player> <limbo>" player-offline: "&cPlayer '&f{player}&c' is not online." unknown-limbo: "&cUnknown or disabled limbo '&f{limbo}&c'. Only enabled virtual limbos are allowed." success: "&aSent &f{player} &ato limbo &f{limbo}&a." target-notice: "&eYou were sent to limbo &f{limbo}&e by an administrator." no-enabled-limbos: "&7No enabled virtual limbo configs are loaded." enabled-limbos: "&7Enabled limbos: &f{limbos}"
player: command-blocked: "&cThis command is blocked while you are in limbo."
diagnostics: service-not-initialized: "LimboManager service is not initialized yet." info: |- LimboManager diagnostics: - virtual limbos: {virtual_count} - alias routes: {alias_count} - reconnect module: {reconnect_enabled} - afk module: {afk_enabled} - active limbo sessions: {active_count} - pending initial aliases: {pending_count} - ViaVersion: {via_status} ({via_details}) - LibreLogin: {libre_status} ({libre_details}) - LibreLogin: {libre_status} ({libre_details}) ```
`server.yml` ```
Enables or disables this virtual limbo profile.
enabled: false
settings:
Optional alias matched against target server names to override routing.
alias: ""
Enables extra debug logging for this profile.
debug: false
world:
Client view distance while in limbo.
view-distance: 2
Server simulation distance while in limbo.
simulation-distance: 2
Prevents players from falling immediately after joining limbo.
disable-falling: true
Delay (ms) before disabling falling.
disable-falling-delay-ms: 800
Limbo world dimension (NETHER, OVERWORLD, THE_END).
dimension: "THE_END"
Game mode used inside limbo.
gamemode: "SPECTATOR"
Fixed world time shown to players.
world-time: 0
Whether other limbo players are visible.
others-visible: true
Global light level for generated chunks.
light-level: 15 spawn:
Spawn X coordinate.
x: 0.0
Spawn Y coordinate.
y: 100.0
Spawn Z coordinate.
z: 0.0
Spawn yaw rotation.
yaw: 0.0
Spawn pitch rotation.
pitch: 0.0 schematic:
Enables schematic paste into limbo world.
enabled: false
Built-in format type (SCHEMATIC, STRUCTURE, WORLDEDIT_SCHEM).
type: "SCHEMATIC"
Relative path inside /schematics.
path: "" offset:
Paste offset X.
x: 0
Paste offset Y.
y: 64
Paste offset Z.
z: 0
Optional allow-list of commands that remain executable in this limbo.
commands: - "hub" - "lobby" - "queue"
Optional display configuration for join/bossbar/actionbar/title.
display: on-join:
One-time chat message sent when player enters limbo.
chat: "&cAll servers are offline." title:
Enables one-time join title.
enabled: true
Main join title text.
title: "&cHey there!"
Join subtitle text.
subtitle: "&7Why are you here?"
Title fade-in ticks.
fade-in: 10
Title stay ticks.
stay: 80
Title fade-out ticks.
fade-out: 20 actionbar:
Enables one-time join actionbar.
enabled: false
Join actionbar text.
message: "Something cool" bossbar:
Enables rotating/static bossbar while in limbo.
enabled: true
Bossbar title text (or list for animation).
title: "&cFallback Limbo"
Bossbar color (PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE).
color: "RED"
Bossbar style (SOLID, SEGMENTED_*).
style: "SOLID"
Progress from 0.0 to 1.0 (or list for animation).
progress: 1.0
Animation step interval; -1 keeps first value static.
animation: -1 actionbar:
Enables repeating actionbar while in limbo.
enabled: false
Repeating actionbar text
message: "&7Reconnecting..."
Animation step interval; -1 keeps first value static.
animation: -1 title:
Enables repeating title while in limbo.
enabled: false
Title text (or list for animation).
title: "&cServer Offline"
Subtitle text (or list for animation).
subtitle: "&7Attempting reconnect..."
Fade-in ticks for repeating title.
fade-in: 0
Fade-out ticks for repeating title.
fade-out: 0
Animation step interval; -1 keeps first value static.
animation: -1 ```
