🌍 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> [environment] [-g generator]  # Create new world
/world clone <source> <target>                     # Clone existing world
/world load [world]                                # Load world(s)
/world unload [world]                              # Unload world(s)
/world import <name> [environment]                 # Import external world
/world setspawn                                    # Set world spawn
/world setuniversalspawn                           # Set universal spawn
/world info [world]                                # Show world information
/world list                                        # List all worlds

Plugin Commands (/worlds)

/worlds reload [target]                            # 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:

display-name: "Custom Flat World"
type: "FLAT"
generate-structures: true
biomes: ["PLAINS", "FOREST"]
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:

features:
  separate-inventories:
    enabled: true
    separate:
      inventory: true
      health: true
      experience: true
    world-groups:
      survival: ["world", "world_nether", "world_the_end"]
      creative: ["creative_world", "build_world"]

---

🔗 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

• 📖 Documentation - Complete guides and tutorials
• 💬 Discord - Community support
• 🐛 Issues - Bug reports and feature requests
• ⭐ GitHub - Source code and releases

---

LilWorlds - Making world management simple, fast, and powerful.