SMP Lobby v2.1.1

What is SMP Lobby?

SMP Lobby is a complete, configurable lobby and limbo system for survival networks, PvP servers, multi-server communities, and competitive Minecraft networks.

It replaces the need to combine multiple small lobby plugins by providing one integrated system for spawn handling, server selection, proxy transfers, region kits, MacePvP gameplay, Karma rewards, shops, parkour, portals, protection, announcements, visual displays, chest refills, NPCs, holograms, and modular player management.

The bundled default setup gives players a protected spawn, a Server Selector book in the center hotbar slot, a polished server-selection menu, an SMP destination, a PvP destination, a configurable MacePvP warzone kit, a Karma economy, and a combat-focused shop.

Every major system can be enabled, disabled, reloaded, and configured independently.


Built for Real Lobby and Limbo Servers

• Build a complete network lobby — provide server selection, automatic redirects, spawn control, menus, protection, messages, and visual information from one plugin.
• Create a playable limbo — players can earn Karma, use a shop, complete parkour, enter a warzone, and interact with NPCs instead of waiting in an empty world.
• Connect multiple backend servers — transfer players through the standard BungeeCord plugin-message channel used by BungeeCord and Velocity.
• Control every region — apply different kits, hotbar items, movement rules, action bars, portals, regeneration rules, and gameplay behavior by SMPRegions region.
• Run MacePvP directly in the lobby — equip players with configurable modern combat gear, keep warzone inventories on death, and return them cleanly to spawn.
• Reward activity — grant Karma for kills, hits, mob kills, movement, pickups, parkour completion, and playtime.
• Reduce plugin clutter — replace separate selector, spawn, lobby protection, shop, announcer, parkour, and chest-refill plugins.
• Keep compatibility broad — Java 8 target, legacy material aliases, optional modern items, capability-based Folia scheduling, and graceful skipping of unsupported content.

Core Feature Overview

• Configurable Server Selector hotbar item.
• Data-driven inventory menus.
• BungeeCord and Velocity server transfers.
• Proxy server player-count and status tracking infrastructure.
• SMPRegions region detection with exact and trailing-wildcard patterns.
• Spawn and warzone region kits.
• Bundled modern MacePvP loadout.
• Karma economy with optional Vault registration.
• 54-slot combat shop.
• Persistent default and named spawns.
• Persistent chest-refill snapshots.
• Parkour rewards and checkpoints.
• Configurable portals with safe redirect flow.
• Join, quit, MOTD, announcer, death, actionbar, title, and visual systems.
• Block, interaction, damage, PvP, item, explosion, mob, fall-damage, durability, and advancement controls.
• Spawn-only regeneration and hunger protection.
• Optional movement, NPC, hologram, gadget, anti-WDL, Bedrock-form, visibility, queue, and hub-combat modules.
• Compiled action engine for menus and hotbar interactions.
• Independent module lifecycle and reload support.

Server Selector Hotbar Item

The default configuration gives every player a Server Selector book in hotbar slot 4.

• Default item — BOOK named “Server Selector.”
• Center hotbar placement — configured at slot 4.
• Join delivery — automatically given when the player joins.
• Respawn delivery — restored after respawn.
• World-change delivery — reapplied when changing worlds.
• Region-change delivery — updated when the player enters or leaves its configured scope.
• Region scope — available in spawn regions by default.
• Both-click support — left click and right click can open the selector.
• Immovable — optionally prevents inventory movement.
• Drop protected — optionally prevents dropping.
• Keep on death — can remain part of the player’s lobby state.
• Replace existing — can reclaim its configured slot when another item occupies it.
• Priority control — multiple hotbar definitions can resolve predictably.
• Permission support — restrict individual hotbar items.
• Cooldown support — prevent duplicate interaction spam.
• Custom actions — assign separate left-click and right-click action chains.

The region-kit and hotbar systems are ordered so a kit may clear and replace the inventory first, then the selector item is reapplied when appropriate. This prevents the Server Selector from disappearing after returning from the warzone or receiving a spawn kit.


Default Server Selector Menu

The bundled selector is a clean 27-slot menu with two configurable network destinations.

• SMP — grass-block icon that transfers the player to the configured SMP backend.
• PVP — Netherite Sword icon with Diamond Sword fallback that transfers the player to the configured PvP backend.
• Legacy material aliases — GRASS_BLOCK falls back to GRASS; NETHERITE_SWORD falls back to DIAMOND_SWORD.
• Decorative filler — gray stained-glass filler with legacy stained-glass fallback.
• Left and right click — both supported for destination entries.
• Automatic close — the menu closes after a transfer action.
• Region restriction — the default selector is available in spawn regions.

Open it manually with:



Generic Menu System

SMP Lobby includes a reusable menu engine, not a hardcoded one-menu implementation.

• Create unlimited menus — define menu IDs in menus.yml.
• Configurable titles — style every inventory independently.
• Standard inventory sizes — normalized between 9 and 54 slots.
• Filler items — fill empty slots while preserving real entries.
• Per-menu permissions — restrict an entire menu.
• Per-entry permissions — restrict individual buttons.
• Region scopes — allow menus or entries only in selected regions.
• Click-type filters — control left, right, shift, and supported click behavior.
• Compiled action chains — execute multiple actions without parsing YAML on every click.
• Refresh scheduling — selected menu entries can refresh while the inventory remains open.
• Safe ownership tracking — each opened menu is associated with the correct player and menu holder.
• Duplicate-slot protection — conflicting entries are detected instead of silently replacing each other.
• Legacy trigger compatibility — old command/action definitions can still be compiled.
• Bedrock renderer path — optional form rendering is available through the Bedrock forms module.

Compiled Action Engine

Menus and hotbar items can execute configurable action chains.

Supported action types include:

• Player messages.
• Global broadcasts.
• Titles and subtitles.
• Action bars.
• Sounds.
• Player commands.
• Console commands.
• Gamemode changes.
• Potion effects.
• Open another menu.
• Transfer through the proxy.
• Close the current menu.
• Delayed continuation.
• Teleport to a configured location.
• Teleport to default or named spawn.
• Give configured items.
• Clear inventory.
• Spawn a firework.
• Play particle/effect feedback.

Actions are compiled during load or reload. Runtime interaction becomes direct dispatch instead of repeated YAML parsing.

Safety limits protect action definitions from excessive nesting, oversized commands, oversized messages, and unbounded action lists.


BungeeCord and Velocity Network Transfers

SMP Lobby uses the standard Bukkit outgoing plugin-message channel:

• BungeeCord support — sends players to configured backend server names.
• Velocity support — uses the same BungeeCord-compatible backend channel.
• Configurable server IDs — menu-facing IDs can map to different proxy target names.
• Safe target validation — invalid proxy target strings are rejected.
• Unknown-server protection — invalid server IDs do not send malformed messages.
• Payload size cap — incoming plugin messages over 32 KiB are ignored.
• Malformed-message protection — malformed proxy responses are categorized and warned once.
• Entity-owned sending — player plugin messages are sent through the correct scheduler context.

For Velocity, enable BungeeCord-compatible plugin messaging in velocity.toml:



Proxy Status Tracking

The proxy module includes player-count polling and server-state snapshots.

• Requests backend player counts through the BungeeCord PlayerCount subchannel.
• Polls configured servers in round-robin order using online players as message carriers.
• Tracks online count per configured server.
• Tracks ONLINE, STALE, and UNKNOWN states.
• Marks old snapshots stale when they are no longer refreshed.
• Keeps configured server IDs separate from arbitrary proxy responses.

Automatic and Idle Redirects

Automatic transfers are optional and disabled by default.

• Timed redirects — send players to a target server after a configurable interval.
• Region-aware redirects — restrict automatic transfer to configured SMPRegions regions.
• Stillness requirement — optionally reset the redirect when a player moves too far.
• Countdown titles — display alerts at 60, 30, 15, and final configured seconds.
• Countdown action bar — show remaining time continuously.
• Idle redirect — start a separate countdown after the player remains still for a configured time.
• Independent module gates — normal redirect and idle redirect can be enabled separately.

SMPRegions Integration

SMP Lobby can use SMPRegions as the central source of region context.

• Spawn-region detection.
• Warzone-region detection.
• Region kits.
• Portal triggers.
• Parkour start, checkpoint, and finish regions.
• Hotbar scopes.
• Menu scopes.
• Movement rules.
• Region-aware hologram mode.
• Redirect-region restrictions.
• Immediate region updates after player movement.
• One-second safety polling for missed transitions.

Region patterns support:

• Case-insensitive exact names — spawn matches Spawn or SPAWN.
• One trailing wildcard — warzone* matches warzone, warzone_east, and Warzone-2.
• Strict validation — lone or interior wildcards do not match.
• Region priority — the highest-priority applicable SMPRegions region controls the result.

Spawn regions take priority over warzone regions when both overlap at the same coordinates.


Spawn Management

• Persistent main spawn — save the lobby spawn with /setspawn.
• Named spawns — create additional spawn destinations with /setspawn <name>.
• Teleport command — use /spawn or /spawn <name>.
• Join teleport — automatically move joining players to spawn.
• Repeated join attempts — configurable retry delays handle proxy and join-order races.
• Respawn teleport — safely return players after death.
• Folia-aware respawn handling — retries until the player is alive and the teleport future succeeds.
• Void return — teleport players back when they fall below the configured Y level.
• Forced gamemode — apply a configured gamemode on join.

Region Kit System

Define kits that are automatically applied when a player enters a matching region.

• Unlimited kit entries.
• Exact or wildcard region lists.
• Optional module dependency per kit.
• Inventory clearing.
• Armor equipment.
• Offhand equipment.
• Exact inventory slots.
• Selected hotbar slot.
• Custom materials and aliases.
• Amounts and legacy durability/data values.
• Display names and lore.
• Unbreakable state.
• Item flags.
• Enchantments.
• Modern armor trims where supported.
• SMP Weapons item IDs.
• Entry messages.
• Unsupported item/enchantment warnings without aborting the remaining kit.

A kit is applied only when its resolved region state changes, preventing constant inventory replacement every tick.


Bundled Modern MacePvP Warzone Kit

The default warzone configuration includes a complete modern PvP loadout.

• Flowguard armor — Netherite armor with Diamond fallbacks, Protection, Unbreaking, Mending, utility enchantments, and Flow/Amethyst trims where supported.
• Flowguard Shield — configurable offhand shield with SMP Weapons integration.
• Netherite Sword — primary grounded weapon with Sharpness V and Fire Aspect II.
• Lunge Spear — modern spear with Lunge III and legacy-safe material handling.
• Wind Charges — launch and vertical-combat utility.
• Ender Pearls — mobility and chase utility.
• MacePvP Elytra — movement and aerial setup.
• Golden Apples — sustain during combat.
• Breach Mace — armor-breaking grounded finisher.
• Density Mace — high smash-damage alternative.
• Shieldbreaker Axe — anti-shield pressure tool.
• Additional supplies — crossbow, arrows, food, rockets, cobwebs, blocks, and repair utility can be configured in the kit and shop.

Modern-only materials and enchantments are skipped cleanly on unsupported legacy servers while the compatible remainder of the kit still loads.


Warzone Behavior

• Region entry detection — automatically recognizes configured warzone regions.
• Warzone title — configurable title, subtitle, fade-in, stay, and fade-out.
• Warzone action bar — tells players how to return to spawn.
• Automatic warzone kit — equips the configured MacePvP loadout.
• Spawn return — /spawn returns the player to the lobby flow.
• Keep inventory on death — optional warzone-only inventory preservation.
• Drop suppression — clears death drops when warzone keep-inventory is active.
• Selector scope cleanup — removes the spawn-only selector when the player enters a non-selector region.
• Selector restoration — gives the selector back after the spawn kit is applied.

Death Messages and Effects

• Custom generic death messages.
• Rotating killer death-message templates.
• Victim and killer placeholders.
• Killing-item suffix.
• Custom item display-name detection.
• Fallback text for empty-hand kills.
• Optional victim personal messages.
• Visual-only lightning effect.
• Optional real lightning.
• Configurable blood-style block particles.
• Configurable particle material, count, and spread.
• Karma reward for player kills.

Karma Economy

SMP Lobby includes an internal persistent economy named Karma.

• Exact decimal handling — balances and prices use decimal-safe amounts.
• Persistent balances — saved between restarts.
• Optional Vault provider — expose Karma through Vault when Vault is installed.
• Player-kill rewards — configurable amount and message.
• Entity-hit rewards — grant Karma for valid combat interactions with cooldown control.
• Mob-kill rewards — reward killing non-player entities.
• Pickup rewards — reward item collection.
• Movement rewards — grant Karma after a configured number of legitimate movement meters.
• Playtime rewards — grant Karma at configurable intervals.
• Parkour rewards — pay players when they complete a configured course.
• Actionbar or chat feedback — choose how rewards are shown.
• Admin balance commands — give, take, or set Karma.

Combat-Focused Karma Shop

The default shop is a configurable 54-slot inventory designed around the bundled MacePvP experience.

• Live balance title — show the player’s Karma balance in the inventory title.
• Configurable filler — style unused slots.
• Purchasable and display-only entries — create headers and real products.
• Exact decimal prices — no floating-point balance errors.
• Inventory-space validation — purchases require room for the resulting item.
• Instant balance deduction — safely withdraw after validation.
• Purchase feedback — display item, price, and remaining balance.
• Insufficient-funds feedback — show required price and current balance.
• Refresh after purchase — update the menu after a transaction.
• Modern material aliases — use newer visuals while retaining legacy fallbacks.
• SMP Weapons integration — configured shop entries can resolve real custom weapons.

Bundled shop categories include:

• Quick supplies: arrows, wind charges, pearls, golden apples, carrots, rockets, cobwebs, repair bottles, water buckets, and blocks.
• Weapons: crossbow, shield, Netherite Sword, Netherite Axe, Breach Mace, Density Mace, and Lunge Spear.
• Armor: Flowguard helmet, chestplate, leggings, and boots.
• High-value utility: Elytra, Totem of Undying, enchanted golden apples, and bulk combat supplies.

SMP Weapons Integration

When SMP Weapons is installed, kit and shop entries can reference custom weapon IDs instead of producing only ordinary Bukkit items.

The bundled configuration connects selected items to weapon IDs such as:

• dash_sword
• wind_spear
• slam_mace
• dash_mace
• cobweb_axe
• repell_shield
• boom_crossbow
• ultratotem

A configurable command fallback can be used when the direct hook cannot resolve an item.

SMP Weapons is optional. Standard item creation remains available without it.


Parkour System

• Unlimited parkour courses.
• Optional start region.
• Required finish region.
• Optional ordered checkpoint requirements.
• Per-player active-run state.
• Per-player elapsed-time tracking.
• Configurable Karma reward.
• Configurable completion message.
• Optional teleport back to a configured start location.
• Automatic cleanup when a player quits.

Portal System

Create region-driven portals that transfer players to network servers.

• Unlimited portal entries.
• Exact and wildcard region matching.
• Configurable target server per portal.
• Join grace period to prevent immediate re-trigger loops.
• Per-player portal state and cooldown handling.
• Optional local teleport to spawn before proxy transfer.
• Configurable delay between local spawn teleport and network transfer.
• Immediate movement-based region checks plus periodic safety checks.

The local spawn-before-send flow prevents players from returning to the lobby while still standing inside the same portal trigger.


Queue Module

The optional queue module can process configured per-player transfer entries.

• Queue entries keyed by player UUID.
• Target server per entry.
• Priority ordering.
• Optional local teleport location.
• Optional queue message.
• Automatic processing after join.
• Removal after successful processing.
• Local in-memory runtime state.

Persistent Chest Refills

Turn any chest into a reusable refill chest.

• Look at a chest and register its current contents.
• Persist chest location and inventory snapshot.
• Restore the configured snapshot whenever the chest is opened.
• Remove registered refill chests.
• List every registered refill chest.
• Save changes immediately and again during shutdown/reload.

Commands:



Lobby Protection

• Block-break protection.
• Block-place protection.
• Bucket, fire, and build-like interaction protection.
• General interaction protection.
• Damage protection.
• PvP protection.
• Configurable protected or excluded worlds.
• Bypass permission.
• Configurable denial messages.
• Global denial-message cooldown to prevent chat spam.
• Separate dedicated protection.yml policies.

Additional Lobby Controls

• Item drops — prevent players from dropping lobby items.
• Item pickup — allow or block pickup independently.
• Inventory movement — optionally prevent moving protected items outside shop interfaces.
• Mob spawning — block ordinary, spawner, and custom spawns independently.
• Fall damage — disable fall damage.
• Explosions — cancel entity and block explosions and clear affected blocks.
• Durability — optionally cancel item-damage events on supported versions.
• Advancements — disable advancement announcements and optionally revoke earned advancements.
• Time lock — hold configured worlds at a fixed time.
• Weather lock — prevent rain and thunder and disable weather cycling.
• Gamemode enforcement — place players in the configured gamemode when joining.

Spawn Regeneration and Food Control

The regen-task module safely restores players only inside configured spawn regions.

• Instant health and food restoration when entering spawn.
• Configurable repeating interval.
• Configurable health amount per interval.
• Configurable target food level.
• Configurable saturation restoration.
• Post-respawn delay before restoration.
• Never mutates offline players.
• Never mutates dead players.
• Never mutates players at zero or invalid health.
• Never lowers food level.
• Never lowers saturation.
• Never exceeds maximum health.

Food-decay modes:

• REGIONS — suppress hunger loss only inside configured spawn-style regions.
• GLOBAL — suppress hunger loss everywhere.

The default behavior keeps spawn safe while allowing hunger to function normally in the warzone.


Join, Quit, MOTD, and Announcements

• Custom join message.
• Custom quit message.
• Delayed multi-line MOTD.
• Player-name placeholders.
• Periodic rotating announcements.
• Independent announcement interval.
• Dedicated announcements.yml configuration.

Chat and Command Policies

• Configurable chat format.
• Player-name and message placeholders.
• Optional permission-controlled formatting.
• Command blacklist.
• Command preprocessing before execution.
• Configurable denied message.
• Command cooldowns.
• Click cooldowns.
• Denied-message cooldowns.
• Optional command-conflict override so SMP Lobby commands retain their configured labels.
• Automatic command rebind after other plugins enable.
• Restoration of displaced commands when SMP Lobby disables.

Visual Display System

• Action bar — configurable repeating status message.
• Warzone action bar — overrides the standard lobby message inside warzone regions.
• Tablist — configurable header and footer.
• Scoreboard — configurable title and lines.
• Boss bar — optional display service.
• Placeholders — online players and Karma values can be rendered in visual content.
• Entity-owned delivery — player display updates are scheduled safely.

NPC Support

The optional NPC module integrates with Citizens when it is available.

• Unlimited NPC definitions.
• Configurable entity type.
• Configurable location.
• Custom display name.
• Command executed on click.
• Bundled Server Selector NPC definition.
• Graceful no-op behavior when Citizens is not installed.
• Runtime NPC tracking and cleanup.

Holograms

• Unlimited hologram entries.
• Multi-line holograms.
• Configurable locations.
• Armor-stand implementation for broad server compatibility.
• Configurable GLOBAL or REGION scope mode.
• Live line updates through the runtime abstraction.
• Deterministic cleanup when the module disables or reloads.

Gadgets

• Define custom gadget items.
• Match configured item identity.
• Per-gadget cooldowns.
• Execute a configured player command when used.
• Custom material, slot, name, and item configuration.
• Optional module, disabled by default.

Movement Rules

The optional movement module can apply different movement settings by region.

• Global flight permission state.
• Global walk speed.
• Global fly speed.
• Region-specific flight state.
• Region-specific walk speed.
• Region-specific fly speed.
• Exact and wildcard region matching.
• Automatic application on join and movement.
• Safe speed clamping to Bukkit limits.

Player Settings and Languages

• Per-player settings map.
• Default scoreboard preference.
• Default tablist preference.
• Default bossbar preference.
• Default actionbar preference.
• Sound and particle preferences.
• Chat visibility preference.
• Vanish preference storage.
• Default language selection.
• Per-player language selection API.
• Bundled language files for English, Spanish, Dutch, Portuguese, Russian, and Chinese.

Player Visibility

• Per-player vanish state.
• Hide vanished players from current viewers.
• Hide existing vanished players from new joiners.
• Restore visibility when vanish is disabled.
• Permission-protected visibility control.
• Automatic cleanup on quit and module disable.

Optional Hub Combat State

• Configurable combat duration.
• Configurable hit threshold.
• Per-player combat state.
• Preserved armor and inventory loadout.
• Optional loadout restoration when combat ends.
• Folia-safe player inventory restoration.
• Disabled by default so normal protected-lobby behavior remains unchanged.

Optional Anti-WDL / Map Protection

The optional anti-WDL module removes initialized map renderers while protection is active for non-bypass players. It is disabled by default and can be controlled independently from the other lobby systems.


Storage and Persistence

• YAML storage — default local player-data provider.
• JDBC/MySQL storage — configurable database provider for player profile data.
• Async I/O execution — storage work runs outside gameplay threads.
• Schema initialization — JDBC provider initializes its required table.
• Player profile fields — UUID, name, first join, last seen, kills, and deaths.
• Persistent Karma — saved separately through the Karma service.
• Persistent spawn locations — default and named spawns.
• Persistent chest snapshots — registered refill chests survive reloads and restarts.

PlaceholderAPI Support

Available placeholders:

• %smplobby_balance% — player Karma balance.
• %smplobby_currency% — configured currency name.
• %smplobby_current_region% — current SMPRegions region.
• %smplobby_spawn_set% — whether the main spawn is configured.

Internal menu and message systems also use placeholders such as player name, balance, price, item, target, amount, action, and countdown seconds where applicable.


Commands

• /smplobby help — show SMP Lobby administration help.
• /smplobby reload — reload configuration and all module state.
• /smplobby set <path> <value> — update a config value and reload.
• /smplobby toggle <module> [true|false] — enable or disable a configured module.
• /smplobby menu open <menu> — open a configured menu.
• /smplobby chestrefill add — register the targeted chest.
• /smplobby chestrefill remove — remove the targeted refill chest.
• /smplobby chestrefill list — list registered refill chests.
• /smplobby givekarma <player> <amount> — add Karma.
• /smplobby takekarma <player> <amount> — remove Karma.
• /smplobby setkarma <player> <amount> — replace a balance.
• /spawn [name] — teleport to main or named spawn.
• /setspawn [name] — save main or named spawn.
• /shop — open the Karma shop.

Aliases for the main command:



Permissions

• smplobby.admin — administrative permission root.
• smplobby.reload — reload the plugin.
• smplobby.set — edit configuration and toggle modules.
• smplobby.setspawn — set main or named spawns.
• smplobby.bypass — bypass lobby protection.
• smplobby.chestrefill — manage refill chests.
• smplobby.economy.admin — manage Karma balances.
• smplobby.spawn — use /spawn.
• smplobby.shop — open the shop.
• smplobby.menu.open — open public configured menus.
• smplobby.visibility — control player visibility/vanish state.

Menus, hotbar items, and action-driven content may define additional custom permission nodes in configuration.


Configuration Files

SMP Lobby separates major systems into dedicated YAML files:

• config.yml — primary module gates, spawn, regions, kits, warzone, economy, shop, portals, parkour, and core behavior.
• hotbar.yml — hotbar item definitions and triggers.
• menus.yml — generic menus and Server Selector.
• proxy.yml — proxy servers, status, and transfer settings.
• protection.yml — build, damage, PvP, and interaction policies.
• announcements.yml — MOTD and repeating announcements.
• chat.yml — chat formatting and chat limits.
• commands.yml — command blacklist and command policies.
• combat.yml — optional hub-combat settings.
• gadgets.yml — gadget definitions and items.
• holograms.yml — hologram definitions.
• movement.yml — global and regional movement rules.
• npcs.yml — NPC definitions.
• players.yml — player preferences and language defaults.
• storage.yml — YAML or JDBC/MySQL provider settings.
• visuals.yml — actionbar, tablist, scoreboard, and bossbar settings.
• messages.yml — shared user-facing messages.
• language/*.yml — translated locale files.

Reload and Validation Safety

• Immutable configuration snapshots.
• Dedicated configuration repository.
• Automatic copying of missing default files.
• Syntax and material validation.
• Canonical module IDs with legacy alias support.
• Warnings for unsupported materials and enchantments.
• Per-entry failure isolation.
• Previous valid snapshot protection when a reload fails.
• Deterministic module disable and re-enable order.
• Task cancellation during reload.
• Listener cleanup during module shutdown.
• Menu, proxy, kit, hotbar, shop, and hook recompilation.
• Persistent service flush before reload.

Folia and Threading Support

SMP Lobby declares Folia support and centralizes scheduling through a compatibility runtime.

• Entity scheduler — player teleports, inventory changes, messages, and plugin-message sending.
• Region scheduler — location-owned operations where required.
• Global scheduler — global repeating tasks and server-wide coordination.
• Async scheduler — storage and non-Bukkit background work.
• Real teleport futures — asynchronous teleports preserve their real completion result.
• Classic Bukkit fallback — the same codebase works on non-Folia Bukkit-family servers.
• Capability verification — required scheduler methods are resolved and checked during startup.
• No raw thread creation — scheduled work remains owned by the plugin lifecycle.

Legacy and Modern Version Compatibility

• Java 8 bytecode target.
• Built against the Bukkit/Spigot 1.8.8 API surface.
• Modern material aliases with legacy fallbacks.
• Legacy item data support.
• Optional modern enchantments and armor trims.
• Modern-only content skipped cleanly on unsupported servers.
• Reflection isolated for APIs that do not exist on every version.
• No mandatory packet library.
• No mandatory menu plugin.
• No mandatory economy plugin.
• Optional Vault, PlaceholderAPI, SMPRegions, SMP Weapons, and Citizens hooks.

Best Uses

• Survival SMP Networks — give players a polished entry point before joining the survival server.
• MacePvP Networks — combine server selection with a playable warzone and modern combat shop.
• Limbo Servers — keep players engaged while a backend server is unavailable or restarting.
• Multi-Server Hubs — connect SMP, PvP, events, dungeons, and seasonal servers.
• Practice and Event Networks — use region kits, shops, parkour, portals, NPCs, and custom menus.
• Box/SMP Hybrids — create a central hub with progression rewards and combat supplies.
• Legacy Networks — retain 1.8 compatibility while enabling modern content where supported.
• Folia Networks — use a lobby plugin designed around correct scheduler ownership.

Why Server Owners Choose SMP Lobby

• One integrated product — selector, protection, economy, shop, regions, spawn, parkour, portals, and visual systems work together.
• Playable lobby design — players can fight, earn, shop, complete parkour, and explore instead of standing still.
• Strong default experience — Server Selector, SMP/PvP menu, MacePvP kit, Karma rewards, and combat shop are already configured.
• Deep owner control — every important item, message, region, price, reward, module, and action is configurable.
• Network-ready — standard proxy messaging works with BungeeCord and Velocity.
• Clean modularity — disable features you do not need without removing unrelated systems.
• Broad compatibility — Java 8, legacy materials, modern fallbacks, and Folia-aware scheduling.
• Operational safety — cooldowns, validation, task ownership, reload cleanup, payload caps, and failure isolation reduce messy runtime states.

FAQ

What kind of server is SMP Lobby for?
It is designed for SMP networks, PvP networks, lobby servers, limbo servers, multi-server communities, event networks, and hybrid survival/combat servers.

Does it include a Server Selector?
Yes. The default setup gives players a Server Selector book in slot 4 and opens a configurable SMP/PvP inventory menu.

Does the selector survive inventory-clearing kits?
Yes. Region kits are processed before the hotbar selector is reapplied, so returning to the spawn kit restores the selector item.

Does it support BungeeCord?
Yes. It uses the standard BungeeCord Connect plugin-message subchannel.

Does it support Velocity?
Yes. Enable bungee-plugin-message-channel in velocity.toml so the standard BungeeCord-compatible messages are forwarded.

Does it require SMPRegions?
No for basic lobby behavior. SMPRegions is required for advanced region-aware kits, portals, parkour, hotbar scopes, and warzone automation.

Does it require SMP Weapons?
No. Standard Bukkit items work without it. SMP Weapons adds direct custom-weapon resolution for selected kit and shop entries.

Does it require Vault?
No. Karma works internally. Vault is an optional integration.

Does it require PlaceholderAPI?
No. PlaceholderAPI is optional.

Does it require Citizens?
Only when using Citizens-backed NPC spawning. The plugin remains functional without it.

Can I change the SMP and PvP server names?
Yes. Configure menu actions and proxy server targets to match your proxy configuration.

Can I add more servers to the selector?
Yes. Add more proxy server definitions and menu entries.

Can I create more menus?
Yes. The menu system is generic and supports multiple configurable menus.

Can I create custom hotbar items?
Yes. Define items, slots, scopes, triggers, permissions, cooldowns, and action chains in hotbar.yml.

Can I disable the MacePvP warzone?
Yes. Disable the warzone or region-kit module independently.

Does the warzone keep inventory?
It can. The bundled default keeps inventory and suppresses drops for deaths inside configured warzone regions.

Can I change the warzone kit?
Yes. Every armor piece, item, slot, enchantment, trim, amount, name, lore, and custom weapon ID is configurable.

What happens to modern items on 1.8?
Unsupported materials and enchantments are skipped with warnings. Compatible fallback items and the rest of the kit continue loading.

Can I use my own economy?
Karma is the internal economy. It can register through Vault for compatibility with Vault-aware plugins.

Can I change shop prices and products?
Yes. The shop inventory, products, materials, prices, slots, names, lore, enchantments, and custom weapon IDs are configurable.

Does it support Folia?
Yes. The plugin declares Folia support and routes entity, region, global, and async work through a centralized scheduler compatibility layer.

Can I reload it without restarting the server?
Yes. /smplobby reload rebuilds configuration snapshots, modules, menus, hotbar definitions, hooks, services, and scheduled tasks.




SEO keywords: SMP Lobby, Minecraft lobby plugin, Minecraft limbo plugin, server selector plugin, Minecraft hub plugin, Bukkit lobby plugin, Spigot lobby plugin, Paper lobby plugin, Purpur lobby plugin, Folia lobby plugin, BungeeCord server selector, Velocity server selector, Minecraft network hub, MacePvP plugin, Minecraft warzone plugin, Karma economy plugin, lobby shop plugin, region kit plugin, SMPRegions integration, SMP Weapons integration, Minecraft parkour rewards, Minecraft portal plugin, chest refill plugin, Minecraft NPC lobby, hologram lobby plugin, configurable hotbar plugin, multi-version lobby plugin, Minecraft 1.8 lobby plugin, Minecraft 1.21 lobby plugin, Java 8 Minecraft plugin.