** UltimateLobby – Complete Plugin Documentation<\/p>\n
—<\/p>\n
\ud83d\udccb Plugin Overview<\/p>\n
**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.<\/p>\n
—<\/p>\n
\ud83c\udfaf What is UltimateLobby?<\/p>\n
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.<\/p>\n
Why Choose UltimateLobby?<\/p>\n
| Problem | UltimateLobby Solution |
\n|———|————————|
\n| Too many plugins causing conflicts | Single plugin handles everything |
\n| High resource usage from multiple plugins | Optimized, lightweight code |
\n| Inconsistent configurations | Unified YAML configuration system |
\n| No in-game editing capabilities | Full in-game GUI editor for items & menus |
\n| Difficult to customize | Every feature is toggleable and configurable |
\n| Complex setup process | Works out of the box with sensible defaults |<\/p>\n
—<\/p>\n
\u2728 Complete Feature List<\/p>\n
\ud83d\udee1\ufe0f World Protection System<\/p>\n
Protect your lobby world from griefing and unwanted modifications with 30+ configurable protection rules:<\/p>\n
| Feature | Description |
\n|———|————-|
\n| **Block Protection** | Prevent block breaking and placing |
\n| **Fall Damage** | Disable fall damage completely |
\n| **Void Protection** | Teleport players to spawn when falling into void |
\n| **Weather Lock** | Keep weather always clear |
\n| **Hunger Disable** | Players never lose hunger |
\n| **Mob Spawning** | Prevent hostile\/all mob spawning |
\n| **Fire Spread** | Stop fire from spreading |
\n| **Leaf Decay** | Prevent leaves from decaying |
\n| **PvP Toggle** | Enable or disable player combat |
\n| **Item Drop\/Pickup** | Control item interactions |
\n| **Interaction Block** | Prevent chest\/door\/container access |
\n| **Explosion Protection** | Block TNT and creeper damage |
\n| **Crop Trampling** | Protect farmland |
\n| **Anti-WDL** | Detect World Downloader mod users |<\/p>\n
**Key Benefit:** Each rule can be individually toggled, and players with bypass permissions can override protection.<\/p>\n
—<\/p>\n
\ud83c\udfae Join Experience<\/p>\n
Create memorable first impressions with customizable join actions:<\/p>\n
Welcome Message (MOTD)
\n“`yaml
\n Multi-line welcome message with placeholders
\n– “&6&l\u2605 &eWelcome to &6&lYOUR SERVER&e! &6&l\u2605”
\n– “&7Online: %server_online% | Rank: %vault_prefix%”
\n“`<\/p>\n
Title Display
\n– Customizable title and subtitle
\n– Configurable fade-in, stay, and fade-out timings
\n– PlaceholderAPI support<\/p>\n
Join Sound
\n– Any Minecraft sound effect
\n– Adjustable volume and pitch<\/p>\n
Firework Effect
\n– Customizable colors and effects
\n– Multiple firework types (Ball, Star, Burst, etc.)
\n– Trail and flicker options<\/p>\n
First-Time Join
\n– Special welcome message for new players
\n– Automatic firework celebration
\n– Execute commands on first join (give items, etc.)<\/p>\n
—<\/p>\n
\ud83c\udf92 Lobby Items System<\/p>\n
Give players interactive hotbar items with the revolutionary **In-Game Editor**:<\/p>\n
Default Items
\n| Slot | Item | Function |
\n|——|——|———-|
\n| 0 | Compass | Server Selector |
\n| 1 | Chest | Gadgets Menu |
\n| 2 | Player Head | Profile Menu |
\n| 4 | Dye | Player Hider Toggle |
\n| 7 | Comparator | Settings Menu |
\n| 8 | Book | Server Info |<\/p>\n
In-Game Item Editor
\n“`
\n\/ul setjoinitems
\n“`
\n1. Arrange items in your inventory
\n2. Run the command
\n3. Items are automatically saved with materials, names, lore, and enchantments!<\/p>\n
Supported Actions
\n“`yaml
\n[menu] server-selector Open a custom menu
\n[server] survival Connect to server (proxy)
\n[world] lifesteal Connect to a world
\n[command] fly Player runs command
\n[console] give %player% Console runs command
\n[message] &aHello! Send message
\n[sound] UI_BUTTON_CLICK Play sound
\n[player-hider] Toggle visibility
\n[spawn] Teleport to spawn
\n[url] https:\/\/… Send clickable link
\n“`<\/p>\n
—<\/p>\n
\ud83d\udccb Custom Menu System<\/p>\n
Create unlimited custom GUIs with the powerful **In-Game Menu Editor**:<\/p>\n
Create Menus Edit Menus In-Game Set Item Actions
\n“`
\n\/ul createmenu
\n\/ul createmenu shop 6
\n“`<\/p>\n
\n“`
\n\/ul editmenu
\n“`
\n1. Opens the menu in edit mode
\n2. Drag and drop items freely
\n3. Close to auto-save!<\/p>\n
\n“`
\n\/ul setaction <\/p>\n