​
Overview

The /worlds command provides administrative functions for managing the LilWorlds plugin itself, including configuration reloading, system maintenance, and global operations.
Admin Only: Most /worlds commands require administrative permissions and should be used carefully.

​
Plugin Management

​
Reload Commands

# Reload all configurations and components
/worlds reload
/worlds rl

# Reload everything including worlds
/worlds reload all

​
Configuration Management

# View current configuration
/worlds config show

# Validate configuration files
/worlds config validate

# Reset configuration to defaults
/worlds config reset --confirm

# Export configuration
/worlds config export backup.yml

​
System Information

​
Plugin Status

# View plugin information
/worlds info

# Check system health
/worlds health

# Performance statistics
/worlds performance
/worlds perf

​
World Statistics

# Global world statistics
/worlds stats

# Memory usage breakdown
/worlds memory

# Chunk loading statistics
/worlds chunks

# Player distribution
/worlds players

​
Maintenance Operations

​
Cleanup Commands

# Clean up orphaned world files
/worlds cleanup --orphaned

# Remove empty world folders
/worlds cleanup --empty

# Clean configuration entries
/worlds cleanup --config

# Interactive cleanup mode
/worlds cleanup --interactive

# Complete system cleanup
/worlds cleanup --all --confirm

​
Optimization

# Optimize world loading
/worlds optimize --loading

# Optimize memory usage
/worlds optimize --memory

# Optimize configuration files
/worlds optimize --config

# Full system optimization
/worlds optimize --all

​
Validation

# Validate all worlds
/worlds validate

# Validate specific world
/worlds validate <world_name>

# Validate configuration integrity
/worlds validate --config

# Validate generator definitions
/worlds validate --generators

​
Security Management

​
Rate Limiting

# View current rate limits
/worlds security limits

# Reset rate limits for all players
/worlds security reset-limits

# Reset rate limits for specific player
/worlds security reset-limits <player>

# View security log
/worlds security log

​
Access Control

# View permission assignments
/worlds security permissions

# Check player permissions
/worlds security check <player>

# View security events
/worlds security events --recent 24h

​
Backup and Recovery

​
System Backups

# Create full system backup
/worlds backup --system

# Backup all worlds
/worlds backup --all-worlds

# Backup configuration only
/worlds backup --config

# Scheduled backup
/worlds backup --schedule daily

​
Recovery Operations

# Restore from system backup
/worlds restore --system <backup_name>

# Restore configuration
/worlds restore --config <backup_name>

# Emergency recovery mode
/worlds recovery --emergency

​
Integration Management

​
PlaceholderAPI

# Reload PlaceholderAPI integration
/worlds integration reload placeholderapi

# Test placeholder expansion
/worlds integration test %lilworlds_current_world%

# View available placeholders
/worlds integration placeholders

​
bStats

# View metrics status
/worlds integration bstats status

# Toggle metrics collection
/worlds integration bstats toggle

# Force metrics update
/worlds integration bstats update

​
Generator Management

​
Custom Generators

# List all generators
/worlds generators list

# Reload generator definitions
/worlds generators reload

# Validate generator configuration
/worlds generators validate <generator_name>

# Test generator
/worlds generators test <generator_name>

​
Generator Operations

# Create new generator template
/worlds generators create <name> --template flat

# Import generator from file
/worlds generators import <file_path>

# Export generator definition
/worlds generators export <name> <file_path>

# Remove generator
/worlds generators remove <name> --confirm

​
Monitoring and Logging

​
Log Management

# View recent logs
/worlds logs --recent 1h

# Filter logs by type
/worlds logs --filter error
/worlds logs --filter security
/worlds logs --filter performance

# Export logs
/worlds logs export --since yesterday

​
Real-time Monitoring

# Start monitoring mode
/worlds monitor --start

# Stop monitoring
/worlds monitor --stop

# Monitor specific metrics
/worlds monitor --memory
/worlds monitor --performance
/worlds monitor --security

​
Database Operations

​
Data Management

# View database statistics
/worlds database stats

# Optimize database
/worlds database optimize

# Backup database
/worlds database backup

# Repair database
/worlds database repair --confirm

​
Migration

# Migrate from other plugins
/worlds migrate --from multiverse

# Export data for migration
/worlds migrate --export

# Import data from backup
/worlds migrate --import <backup_file>

​
Advanced Administration

​
Debug Mode

# Enable debug logging
/worlds debug enable

# Disable debug logging
/worlds debug disable

# View debug information
/worlds debug info

# Debug specific component
/worlds debug world-manager
/worlds debug security-manager

​
Emergency Commands

# Emergency stop (unload all worlds)
/worlds emergency stop

# Emergency reload
/worlds emergency reload

# Safe mode (minimal functionality)
/worlds emergency safe-mode

# Force cleanup
/worlds emergency cleanup --force

​
System Diagnostics

# Run full diagnostic
/worlds diagnostic --full

# Check system compatibility
/worlds diagnostic --compatibility

# Performance analysis
/worlds diagnostic --performance

# Generate diagnostic report
/worlds diagnostic --report

​
Configuration Commands

​
Global Settings

# Enable/disable features globally
/worlds config enable inventory-separation
/worlds config disable auto-load-worlds

# Set global limits
/worlds config set max-worlds-per-player 15
/worlds config set rate-limit-window 3600

# View all settings
/worlds config list --all

​
Feature Toggles

# Toggle async operations
/worlds feature toggle async-operations

# Enable experimental features
/worlds feature enable experimental

# List available features
/worlds feature list

​
Scheduled Operations

​
Automation

# Schedule automatic backups
/worlds schedule backup daily 03:00

# Schedule cleanup operations
/worlds schedule cleanup weekly sunday 02:00

# Schedule optimization
/worlds schedule optimize monthly 1st 01:00

# View scheduled tasks
/worlds schedule list

​
Task Management

# Cancel scheduled task
/worlds schedule cancel <task_id>

# Modify schedule
/worlds schedule modify <task_id> --time 04:00

# Run task immediately
/worlds schedule run <task_id> --now

​
API and Development

​
Developer Tools

# View API information
/worlds api info

# Test API endpoints
/worlds api test <endpoint>

# Generate API documentation
/worlds api docs --export

# View plugin hooks
/worlds api hooks

​
Plugin Integration

# List integrated plugins
/worlds integrations list

# Test integration
/worlds integrations test <plugin_name>

# Reload integration
/worlds integrations reload <plugin_name>

​
Permissions for Admin Commands

​
Core Administration

# Basic admin commands
lilworlds.admin.reload         # Reload configurations
lilworlds.admin.info           # View plugin information
lilworlds.admin.stats          # View statistics

# System management
lilworlds.admin.cleanup        # Cleanup operations
lilworlds.admin.optimize       # Optimization commands
lilworlds.admin.validate       # Validation operations

​
Advanced Administration

# Security management
lilworlds.admin.security       # Security commands
lilworlds.admin.security.reset # Reset rate limits

# Backup and recovery
lilworlds.admin.backup         # Backup operations
lilworlds.admin.restore        # Restore operations
lilworlds.admin.emergency      # Emergency commands

# Development
lilworlds.admin.debug          # Debug commands
lilworlds.admin.diagnostic     # Diagnostic tools

​
Best Practices

​
Regular Maintenance

Recommended Schedule:
  • Daily: Check system health and performance
  • Weekly: Run cleanup operations and validate worlds
  • Monthly: Full system backup and optimization
  • Quarterly: Review security logs and update configurations

​
Monitoring Checklist

# Daily health check
/worlds health
/worlds performance
/worlds security events --recent 24h

# Weekly maintenance
/worlds cleanup --orphaned
/worlds validate
/worlds optimize --memory

# Monthly tasks
/worlds backup --system
/worlds diagnostic --full
/worlds logs export --archive

​
Emergency Procedures

​
Troubleshooting

​
Common Issues

​
Next Steps

Permissions Guide

Complete permissions setup and management

Security Features

Advanced security configuration and monitoring

Performance Guide

Optimize LilWorlds for maximum performance

API Documentation

Developer API reference and integration