OGLobby

# 🌟 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: 1. The animated Scoreboard 2. The custom Tablist header/footer 3. Below-name player nametags 4. Action message blocks --- ## 🛠️ Configuration Blueprint (`config.yml`) Adjust protection properties, hotbar items, and UI modules smoothly from a single, clean layout: ```yaml # 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%