🌟 OGLobby
OGLobby is a professional, high-performance lobby management solution designed specifically for modern Paper, Spigot, and Purpur servers (1.21+). Built with optimization in mind, OGLobby handles core hub requirements natively under a single lightweight footprint—eliminating the need to chain multiple heavy plugins together.
✨ Core Features
- ⚡ Packet-Free Custom Nametags (1.21+): Employs Spigot's native text display transforms to project smooth tracking labels directly beneath a player's nametag. No clunky packet manipulation or scoreboard line-abuse required.
- 🛡️ Comprehensive World Guarding: Secure your hub instantly without heavy chunk-scanning protection engines. Clean event handlers block block breaking, block placing, item drops, item pickups, hunger depletion, and fall damage out of the box.
- 🌌 Velocity-Canceling Void Rescue: Tracks live player positions over the void. The moment a player drops past your designated Y-level, the plugin completely cancels their falling momentum and snaps them back to the hub spawn with configurable spatial audio triggers.
- ⚙️ Advanced Sequential Hotbar Actions: Map intricate multi-line execution trees directly onto your custom interactive items using native prefix handling:
player:<command>— Forces the player to run a command.console:<command>— Fires a backend terminal command.message:<text>— Sends an isolated, clean chat message.sound:<SOUND_ENUM>— Triggers rich audio events directly over the user.
- 📊 Integrated Hub UI Elements: Easily set up an animated sidebar (Scoreboard), clear custom Tablist headers/footers, and welcome titles on join.
🔌 Placeholder Reference
OGLobby features an optimized internal engine for built-in placeholders alongside seamless hooks for external tracking.
🏠 Native Placeholders (Zero Dependencies)
These run natively without requiring any external expansion packs:
%player%— Returns the player's clean username.%oglobby_ping%— Displays real-time client connection latency (ms).%oglobby_health%— Shows the current backend health value of the player.
🌐 PlaceholderAPI Integration (Optional)
If PlaceholderAPI is installed on your server, OGLobby automatically intercepts and hooks into its parser. This allows you to use any external placeholders (e.g., %vault_eco_balance%, %bungee_total%, %luckperms_primary_group_name%) seamlessly inside:
- The animated Scoreboard
- The custom Tablist header/footer
- Below-name player nametags
- Action message blocks
🛠️ Configuration Blueprint (config.yml)
Adjust protection properties, hotbar items, and UI modules smoothly from a single, clean layout:
# OGLobby Protection & Void-Teleport Engine
lobby-protection:
void-teleport: true
void-y-level: 0
teleport-sound: "ENTITY_ENDERMAN_TELEPORT"
block-break: true
block-place: true
item-drop: true
item-pickup: true
hunger-loss: true
fall-damage: true
# Custom Below-Name Tracking Frame
belowname-objective:
enabled: true
text: "&a&lOGNetwork &7Lobby" # Fully supports PlaceholderAPI & %player%
