Quick Start Guide

Get started with LilWorlds in minutes

Your First World

Let’s create your first world with LilWorlds! This guide will walk you through the essential commands and workflows.

Prerequisites: Make sure you have installed LilWorlds and have the necessary permissions.

Basic Commands Overview

LilWorlds uses two main command categories:

/world (or /w)

World Management

Create, delete, clone, and manage individual worlds

/worlds

Plugin Administration

Reload configs, manage plugin settings

Creating Your First World

Simple World Creation

The easiest way to create a world is with the basic create command:

/world create myworld

This creates a normal overworld with default settings.

Advanced World Creation

For more control, use additional parameters:

# Create a nether world
/world create nether_world NETHER

# Create with custom generator
/world create void_world NORMAL -g VoidGenerator

# Create with custom seed
/world create seed_world NORMAL -s 12345

# Combine multiple options
/world create custom_world NORMAL -g VoidGenerator -s 67890

Available World Types

• NORMAL - Standard overworld
• NETHER - Nether dimension
• THE_END - End dimension

Managing Worlds

Listing Worlds

See all your worlds with detailed information:

/world list

Example Output

=== World List ===

Loaded Worlds (3):
● world [NORMAL] Players: 5 Chunks: 234 Weather: ☀ Time: Day
● nether_world [NETHER] Players: 1 Chunks: 45 Weather: ☀ Time: Day
● void_world [NORMAL] Players: 0 Chunks: 12 Weather: ☀ Time: Morning

Unloaded Worlds (1):
● old_world [UNLOADED]

Total: 4 worlds

World Information

Get detailed information about a specific world:

/world info myworld

Loading and Unloading

# Load a specific world
/world load myworld

# Load all configured worlds
/world load

# Unload a specific world
/world unload myworld

# Unload all worlds (with confirmation)
/world unload

Cloning Worlds

Create exact copies of existing worlds:

# Clone a world
/world clone source_world target_world

# Example: Create a backup
/world clone spawn spawn_backup

Important: Players will be moved out of the source world during cloning to prevent data corruption.

Importing Existing Worlds

Import worlds that already exist in your server folder:

# Import with default settings
/world import existing_world

# Import with specific dimension
/world import existing_world NETHER

# Import with custom generator
/world import existing_world NORMAL -g CustomGenerator

World Deletion

Warning: World deletion is permanent and cannot be undone. Always create backups first!

LilWorlds provides safe world deletion with confirmation:

# Delete a world (requires confirmation)
/world remove myworld

# Alternative command
/world delete myworld

The deletion process:

1. Confirmation required - Type the command again to confirm
2. Player evacuation - All players moved to spawn
3. World unloading - World safely unloaded
4. File deletion - World files permanently removed
5. Configuration cleanup - All references removed from configs

Spawn Management

Setting World Spawn

Set the spawn point for a specific world:

# Set spawn at your current location
/world setspawn

# This affects the world you're currently in

Universal Spawn

Set a universal spawn point that applies to all worlds:

/world setuniversalspawn

Configuration Commands

World-Specific Configuration

Modify settings for individual worlds:

# Disable a boolean option
/world config disable pvp

# Set a string value
/world config set difficulty hard

# Set numeric values
/world config set spawn-radius 16

Plugin Configuration

Manage plugin-wide settings:

# Reload all configurations
/worlds reload

# Reload specific components
/worlds reload config
/worlds reload generators
/worlds reload worlds

# Quick reload alias
/worlds rl

Working with Custom Generators

Built-in Generators

LilWorlds comes with a built-in VoidGenerator:

# Create a void world
/world create void_world NORMAL -g VoidGenerator

Adding Custom Generators

1. Create a generator file in plugins/LilWorlds/generators/
2. Configure the generator settings
3. Reload generators: /worlds reload generators
4. Use in world creation: /world create myworld NORMAL -g MyGenerator

Example Generator Configuration

# plugins/LilWorlds/generators/MyGenerator.yml
name: "MyGenerator"
type: "FLAT"
settings:
  layers:
    - "minecraft:bedrock"
    - "minecraft:stone,10"
    - "minecraft:grass_block"
  structures: false
  decorations: false

Inventory Separation

LilWorlds supports separate inventories per world or world groups:

Enable Inventory Separation

# Enable for all worlds
/worlds config enable inventory-separation

# Configure world groups in config.yml

World Groups

Group worlds to share inventories:

# config.yml
inventory-groups:
  survival:
    - world
    - world_nether
    - world_the_end
  creative:
    - creative_world
    - build_world

Common Workflows

Setting Up a Multi-World Server

1. Create Main Worlds

   /world create survival NORMAL
   /world create survival_nether NETHER
   /world create survival_the_end THE_END
   /world create creative NORMAL
   

2. Configure Inventory Groups

   Edit config.yml to group related worlds

3. Set Spawn Points

   # Go to each world and set spawn
   /world setspawn
   

4. Configure Permissions

   Set up appropriate permissions for different player groups

Creating a Backup System

1. Create Backup Worlds

   /world clone survival survival_backup_$(date)
   /world clone creative creative_backup_$(date)
   

2. Unload Backups

   /world unload survival_backup_$(date)
   /world unload creative_backup_$(date)
   

3. Automate with Scripts

   Create server scripts to automate regular backups

Tips and Best Practices

Performance Tips

• Use /world unload for unused worlds to save memory
• Enable async world creation in config
• Limit the number of loaded worlds based on your server resources
• Use void generators for creative/testing worlds

Security Best Practices

• Regularly backup important worlds before major changes
• Use rate limiting to prevent abuse
• Set appropriate permissions for different user groups
• Monitor world creation/deletion through logs

Organization Tips

• Use consistent naming conventions for worlds
• Group related worlds with inventory separation
• Document your world purposes and configurations
• Keep generators organized in the generators folder

Next Steps

Now that you know the basics, explore more advanced features:

World Management

Deep dive into advanced world management features

Custom Generators

Learn to create and configure custom world generators

World Deletion

Learn about safe world deletion with configuration purging

Commands Reference

Complete command reference and examples