UltimateLobby

** UltimateLobby - Complete Plugin Documentation --- 📋 Plugin Overview **UltimateLobby** is a powerful, all-in-one hub/lobby management plugin designed for PaperMC servers running Minecraft 1.21.1 - 1.21.4. This plugin replaces the need for 30+ separate plugins by combining all essential lobby features into a single, optimized, and fully configurable solution. --- 🎯 What is UltimateLobby? UltimateLobby transforms your server's hub/lobby into a professional, feature-rich spawn area. Whether you're running a small community server or a large network with multiple game modes, UltimateLobby provides everything you need to create an engaging first impression for your players. Why Choose UltimateLobby? | Problem | UltimateLobby Solution | |---------|------------------------| | Too many plugins causing conflicts | Single plugin handles everything | | High resource usage from multiple plugins | Optimized, lightweight code | | Inconsistent configurations | Unified YAML configuration system | | No in-game editing capabilities | Full in-game GUI editor for items & menus | | Difficult to customize | Every feature is toggleable and configurable | | Complex setup process | Works out of the box with sensible defaults | --- ✨ Complete Feature List 🛡️ World Protection System Protect your lobby world from griefing and unwanted modifications with 30+ configurable protection rules: | Feature | Description | |---------|-------------| | **Block Protection** | Prevent block breaking and placing | | **Fall Damage** | Disable fall damage completely | | **Void Protection** | Teleport players to spawn when falling into void | | **Weather Lock** | Keep weather always clear | | **Hunger Disable** | Players never lose hunger | | **Mob Spawning** | Prevent hostile/all mob spawning | | **Fire Spread** | Stop fire from spreading | | **Leaf Decay** | Prevent leaves from decaying | | **PvP Toggle** | Enable or disable player combat | | **Item Drop/Pickup** | Control item interactions | | **Interaction Block** | Prevent chest/door/container access | | **Explosion Protection** | Block TNT and creeper damage | | **Crop Trampling** | Protect farmland | | **Anti-WDL** | Detect World Downloader mod users | **Key Benefit:** Each rule can be individually toggled, and players with bypass permissions can override protection. --- 🎮 Join Experience Create memorable first impressions with customizable join actions: Welcome Message (MOTD) ```yaml Multi-line welcome message with placeholders - "&6&l★ &eWelcome to &6&lYOUR SERVER&e! &6&l★" - "&7Online: %server_online% | Rank: %vault_prefix%" ``` Title Display - Customizable title and subtitle - Configurable fade-in, stay, and fade-out timings - PlaceholderAPI support Join Sound - Any Minecraft sound effect - Adjustable volume and pitch Firework Effect - Customizable colors and effects - Multiple firework types (Ball, Star, Burst, etc.) - Trail and flicker options First-Time Join - Special welcome message for new players - Automatic firework celebration - Execute commands on first join (give items, etc.) --- 🎒 Lobby Items System Give players interactive hotbar items with the revolutionary **In-Game Editor**: Default Items | Slot | Item | Function | |------|------|----------| | 0 | Compass | Server Selector | | 1 | Chest | Gadgets Menu | | 2 | Player Head | Profile Menu | | 4 | Dye | Player Hider Toggle | | 7 | Comparator | Settings Menu | | 8 | Book | Server Info | In-Game Item Editor ``` /ul setjoinitems ``` 1. Arrange items in your inventory 2. Run the command 3. Items are automatically saved with materials, names, lore, and enchantments! Supported Actions ```yaml server-selector Open a custom menu survival Connect to server (proxy) lifesteal Connect to a world fly Player runs command give %player% Console runs command &aHello! Send message UI_BUTTON_CLICK Play sound Toggle visibility Teleport to spawn https://... Send clickable link ``` --- 📋 Custom Menu System Create unlimited custom GUIs with the powerful **In-Game Menu Editor**: Create Menus ``` /ul createmenu <name> <rows> /ul createmenu shop 6 ``` Edit Menus In-Game ``` /ul editmenu <name> ``` 1. Opens the menu in edit mode 2. Drag and drop items freely 3. Close to auto-save! Set Item Actions ``` /ul setaction <menu> <slot> <action> /ul setaction shop 0 survival ``` Menu Features - 1-6 row support (9-54 slots) - PlaceholderAPI in names/lore - Open sounds - Permission requirements - Pagination support - Confirmation dialogs Pre-Built Menus - **Server Selector** - Connect to game servers - **Gadgets Menu** - Fun cosmetic effects - **Profile Menu** - Player statistics - **Settings Menu** - Toggle preferences - **Language Menu** - Multi-language support --- 📊 Scoreboard System Professional, flicker-f