LilWorlds

# 🌍 LilWorlds - Advanced World Management **A performant and modular world management plugin for Minecraft servers supporting versions 1.16 to 1.21.6.** --- ## ✨ Key Features ### 🌍 **World Management** - **Create worlds** with custom environments and generators - **Clone existing worlds** with all their data - **Load/unload worlds** dynamically - **Import external worlds** seamlessly - **Universal spawn system** for cross-world teleportation ### 📦 **Separate Inventories** - **Per-world/group inventories** - Players can have different inventories in different worlds - **World groups** - Share inventories between worlds in the same group - **Configurable separation** - Choose what to separate: inventory, health, experience, gamemode, flight, effects, location, ender chest ### ⚡ **Performance Focused** - Optimized world loading/unloading - Asynchronous operations where possible - Minimal server impact - Rate limiting protection ### 🔧 **Modular Design** - Custom generator system with YAML configuration - Complete configuration options - PlaceholderAPI integration - bStats metrics integration --- ## 🎮 Commands ### World Commands (`/world` or `/w`) ``` /world create <name> # Create new world /world clone <source> <target> # Clone existing world /world load # Load world(s) /world unload # Unload world(s) /world import <name> # Import external world /world setspawn # Set world spawn /world setuniversalspawn # Set universal spawn /world info # Show world information /world list # List all worlds ``` ### Plugin Commands (`/worlds`) ``` /worlds reload # Reload plugin components /worlds inventory <action> # Manage separate inventories /worlds groups <action> # Manage world groups ``` --- ## 🛠️ Custom Generators Create custom world generators using YAML files in the `generators/` folder: ```yaml display-name: "Custom Flat World" type: "FLAT" generate-structures: true biomes: layers: - "minecraft:bedrock" - "minecraft:stone:5" - "minecraft:dirt:3" - "minecraft:grass_block" ``` --- ## 📊 Separate Inventories System Advanced inventory separation system allowing players to have different inventories in different worlds or world groups: ```yaml features: separate-inventories: enabled: true separate: inventory: true health: true experience: true world-groups: survival: creative: ``` --- ## 🔗 PlaceholderAPI Support Extensive placeholder support for integration with other plugins: - `%lilworlds_current_world%` - Current world name - `%lilworlds_total_worlds%` - Total loaded worlds - `%lilworlds_world_players_<world>%` - Players in specific world - And many more... --- ## 📋 Requirements - **Minecraft**: 1.16 - 1.21.5 (Bukkit/Spigot/Paper) - **Java**: 8 or higher - **Dependencies**: None (PlaceholderAPI optional) --- ## 🚀 Quick Start 1. Download and place in `plugins/` folder 2. Restart server 3. Create your first world: `/world create myworld` 4. Enable separate inventories: `/worlds inventory enable` 5. Configure in `plugins/LilWorlds/config.yml` --- ## 📚 Links - **(https://hydr4.mintlify.app/lilworlds)** - Complete guides and tutorials - **(https://discord.gg/phVzDFAZ3v)** - Community support - **(https://github.com/QQuantumBits/LilWorlds/issues)** - Bug reports and feature requests - **(https://github.com/QQuantumBits/LilWorlds)** - Source code and releases --- **LilWorlds** - Making world management simple, fast, and powerful.