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

- Universal spawn system with custom environments and generators - Universal spawn system with all their data - Universal spawn system dynamically - Universal spawn system seamlessly - Universal spawn system for cross-world teleportation

📦 Separate Inventories

- Configurable separation - Players can have different inventories in different worlds - Configurable separation - 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:

```yaml 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:

```yaml 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

- Dependencies: 1.16 - 1.21.5 (Bukkit/Spigot/Paper) - Dependencies: 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.