🌟 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:

# 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%