Command Overview

LilWorlds provides comprehensive world management through the /world (or /w) command system. All commands support tab completion and include detailed help information.

Aliases: You can use /w as a shortcut for /world in all commands.

Basic Commands

World Information

# Get detailed information about a world
/world info <world_name>
/w info spawn

# Get info about current world
/world info

World Creation

Basic Creation

# Create a simple world
/world create <world_name>
/w create myworld

# Create with specific environment
/world create <world_name> <environment>
/w create nether_world NETHER
/w create end_world THE_END

Advanced Creation

# Create with custom generator
/world create <world_name> <environment> -g <generator>
/w create void_world NORMAL -g VoidGenerator

# Create with seed
/world create <world_name> <environment> -s <seed>
/w create seeded_world NORMAL -s 12345

# Create with multiple options
/world create <world_name> <environment> -g <generator> -s <seed>
/w create custom_world NORMAL -g MyGenerator -s 67890

# Disable structure generation
/world create <world_name> <environment> --no-structures
/w create flat_world NORMAL -g FlatGenerator --no-structures

Environment Types

EnvironmentDescriptionExample
NORMALStandard overworld/w create overworld NORMAL
NETHERNether dimension/w create nether NETHER
THE_ENDEnd dimension/w create end THE_END

Generator Options

# Built-in generators
/w create void_world NORMAL -g VoidGenerator

# Custom generators (from generators/ folder)
/w create custom_world NORMAL -g MyCustomGenerator

# Plugin generators (if available)
/w create terra_world NORMAL -g Terra:OVERWORLD

World Loading and Unloading

Loading Worlds

# Load a specific world
/world load <world_name>
/w load myworld

# Load all configured worlds
/world load
/w load

# Force load (ignore errors)
/world load <world_name> --force
/w load problematic_world --force

Unloading Worlds

# Unload a specific world
/world unload <world_name>
/w unload myworld

# Unload all worlds (requires confirmation)
/world unload
/w unload

# Force unload (move players immediately)
/world unload <world_name> --force
/w unload myworld --force

# Unload empty worlds only
/world unload --empty
/w unload --empty

Player Safety: Players in unloaded worlds are automatically moved to the spawn world.

World Cloning

Basic Cloning

# Clone a world
/world clone <source_world> <target_world>
/w clone spawn spawn_backup

# Clone with different environment
/world clone <source> <target> <environment>
/w clone overworld nether_copy NETHER

Advanced Cloning

# Clone and unload source
/world clone <source> <target> --unload-source
/w clone old_world new_world --unload-source

# Clone with custom settings
/world clone <source> <target> --generator <generator>
/w clone creative creative_void -g VoidGenerator

Cloning Process: Players are temporarily moved out of the source world during cloning to prevent data corruption.

World Importing

Basic Import

# Import existing world folder
/world import <world_name>
/w import existing_world

# Import with specific environment
/world import <world_name> <environment>
/w import nether_world NETHER

Advanced Import

# Import with custom generator
/world import <world_name> <environment> -g <generator>
/w import custom_world NORMAL -g MyGenerator

# Import and configure
/world import <world_name> --configure
/w import new_world --configure

# Bulk import
/world import --scan
/w import --pattern "world_*"

World Deletion

Warning: World deletion is permanent and includes comprehensive configuration purging!

Safe Deletion

# Delete with confirmation required
/world remove <world_name>
/w remove old_world

# Alternative command
/world delete <world_name>
/w delete old_world

Advanced Deletion

# Force delete (admin only, no confirmation)
/world remove <world_name> --force
/w remove old_world --force

# Delete with backup first
/world remove <world_name> --backup
/w remove old_world --backup

# Delete multiple worlds
/world remove <world1> <world2> <world3>
/w remove temp1 temp2 temp3

# Bulk deletion by pattern (admin only)
/world remove --pattern "temp_*"
/w remove --pattern "backup_*"

What Gets Deleted

The deletion process removes:

  • ✗ All world files and folders
  • ✗ All configuration entries (config.yml, worlds.yml)
  • ✗ Inventory group memberships
  • ✗ World-specific settings and data

Spawn Management

World Spawn

# Set spawn for current world at your location
/world setspawn
/w setspawn

# Set spawn for specific world
/world setspawn <world_name>
/w setspawn myworld

# Set spawn at specific coordinates
/world setspawn <world_name> <x> <y> <z>
/w setspawn myworld 100 64 200

Universal Spawn

# Set universal spawn (applies to all worlds)
/world setuniversalspawn
/w setuniversalspawn

# Set universal spawn at coordinates
/world setuniversalspawn <x> <y> <z>
/w setuniversalspawn 0 64 0

World Configuration

View Configuration

# List all world settings
/world config list
/w config list

# View specific setting
/world config get <key>
/w config get difficulty

Modify Configuration

# Set string values
/world config set <key> <value>
/w config set difficulty hard
/w config set generator VoidGenerator

# Enable boolean options
/world config enable <option>
/w config enable pvp
/w config enable keepInventory

# Disable boolean options
/world config disable <option>
/w config disable pvp
/w config disable doDaylightCycle

# Set numeric values
/world config set <key> <number>
/w config set spawn-radius 16
/w config set border-size 1000

Common Configuration Options

SettingTypeExampleDescription
difficultyStringeasy, normal, hardWorld difficulty
pvpBooleantrue, falsePlayer vs Player combat
spawn-animalsBooleantrue, falseAnimal spawning
spawn-monstersBooleantrue, falseMonster spawning
keepInventoryBooleantrue, falseKeep items on death
doDaylightCycleBooleantrue, falseDay/night cycle
spawn-radiusNumber16Spawn protection radius

Teleportation

Basic Teleportation

# Teleport to a world's spawn
/world tp <world_name>
/w tp creative_world

# Teleport another player
/world tp <player> <world_name>
/w tp Steve creative_world

# Teleport to specific coordinates
/world tp <world_name> <x> <y> <z>
/w tp myworld 100 64 200

Advanced Teleportation

# Teleport with specific facing direction
/world tp <world_name> <x> <y> <z> <yaw> <pitch>
/w tp myworld 0 64 0 90 0

# Teleport all players in current world
/world tp @a <target_world>
/w tp @a spawn

# Safe teleportation (find safe location)
/world tp <world_name> --safe
/w tp dangerous_world --safe

Backup and Restore

Manual Backups

# Create backup (clone)
/world backup <world_name>
/w backup important_world

# Create timestamped backup
/world backup <world_name> --timestamp
/w backup myworld --timestamp

# Backup multiple worlds
/world backup <world1> <world2> <world3>
/w backup survival creative minigames

Restore Operations

# Restore from backup
/world restore <backup_name> <target_name>
/w restore myworld_backup_20240612 myworld_restored

# Restore and replace existing
/world restore <backup_name> <target_name> --replace
/w restore backup_world myworld --replace

Batch Operations

Multiple World Commands

# Load multiple worlds
/world load world1 world2 world3
/w load survival creative minigames

# Unload multiple worlds
/world unload world1 world2 world3
/w unload temp1 temp2 temp3

# Configure multiple worlds
/world config set difficulty hard world1 world2
/w config enable pvp survival creative

Pattern-Based Operations

# Operations on worlds matching pattern
/world load --pattern "survival_*"
/w unload --pattern "temp_*"
/w remove --pattern "backup_*" --confirm

Administrative Commands

World Statistics

# View world statistics
/world stats
/w stats

# Detailed world information
/world stats <world_name>
/w stats myworld

# Performance statistics
/world stats --performance
/w stats --memory

Maintenance Operations

# Validate world integrity
/world validate <world_name>
/w validate myworld

# Repair world if possible
/world repair <world_name>
/w repair corrupted_world

# Optimize world files
/world optimize <world_name>
/w optimize large_world

Tab Completion

LilWorlds provides comprehensive tab completion for all commands:

World Names

  • Tab complete existing world names
  • Shows both loaded and unloaded worlds
  • Filters based on permissions

Command Arguments

  • Environment types: NORMAL, NETHER, THE_END
  • Generator names from generators folder
  • Configuration keys and values
  • Player names for teleportation

Advanced Completion

  • File paths for import operations
  • Coordinate suggestions for teleportation
  • Pattern matching for bulk operations

Permission Requirements

Basic Permissions

# Basic world commands
lilworlds.world.info          # View world information
lilworlds.world.list          # List worlds
lilworlds.world.tp            # Teleport to worlds

# World management
lilworlds.world.create        # Create worlds
lilworlds.world.load          # Load worlds
lilworlds.world.unload        # Unload worlds
lilworlds.world.clone         # Clone worlds
lilworlds.world.import        # Import worlds

Advanced Permissions

# Dangerous operations
lilworlds.world.remove        # Delete worlds
lilworlds.world.remove.force  # Force delete without confirmation
lilworlds.world.config        # Modify world configuration

# Administrative
lilworlds.admin.backup        # Create backups
lilworlds.admin.restore       # Restore from backups
lilworlds.admin.maintenance   # Maintenance operations
lilworlds.admin.bulk          # Bulk operations

Error Handling

Common Error Messages

Command Examples

Complete Workflows

Next Steps