​
Requirements

Before installing LilWorlds, ensure your server meets these requirements:

Minecraft Version

1.16 - 1.21.5Supports all modern Minecraft versions

Server Software

Spigot, Paper, or PurpurAny Spigot-based server software

Java Version

Java 8 or higherJava 17+ recommended for best performance

Memory

Minimum 2GB RAMMore RAM recommended for multiple worlds

​
Download

​
Latest Release

Download the latest version of LilWorlds from our GitHub releases page:

Download LilWorlds v1.2.0

Get the latest stable release with all features

​
Development Builds

Development builds may contain bugs and are not recommended for production servers.
You can find development builds in the GitHub Actions artifacts or build from source.

​
Installation Steps

​
1. Download the Plugin

  1. Go to the releases page
  2. Download lilworlds-1.2.0.jar from the latest release
  3. Verify the file size is approximately 130KB

​
2. Install the Plugin

  1. Stop your server if it’s currently running
  2. Place lilworlds-1.2.0.jar in your server’s plugins/ folder
  3. Start your server
# Example server structure
server/
├── plugins/
│   ├── lilworlds-1.2.0.jar  ← Place the JAR here
│   └── other-plugins.jar
├── worlds/
├── server.jar
└── start.sh

​
3. Verify Installation

After starting your server, check that LilWorlds loaded successfully:
  1. Look for LilWorlds startup messages in your console
  2. Run /plugins to see if LilWorlds is listed
  3. Try running /world to test the command

​
Optional Dependencies

LilWorlds works great on its own, but you can enhance it with these optional plugins:

​
PlaceholderAPI

Adds placeholder support for other plugins to display LilWorlds information.
1

Install PlaceholderAPI

Download from SpigotMC
2

Restart Server

LilWorlds will automatically detect and integrate with PlaceholderAPI
3

Use Placeholders

Use placeholders like %lilworlds_current_world% in other plugins

​
Available Placeholders

PlaceholderDescription
%lilworlds_current_world%Player’s current world name
%lilworlds_world_count%Total number of loaded worlds
%lilworlds_world_players%Players in current world

​
First-Time Setup

​
1. Check Default Configuration

After installation, LilWorlds creates several configuration files: 
plugins/LilWorlds/
├── config.yml          # Main configuration
├── worlds.yml           # World-specific settings
├── messages.yml         # Customizable messages
└── generators/          # Custom generator definitions
    └── VoidGenerator.yml

​
2. Configure Basic Settings

Edit config.yml to customize basic settings: 
# Basic configuration
settings:
  auto-load-worlds: true
  default-world-type: NORMAL
  enable-inventory-separation: true
  
# Security settings
security:
  enable-rate-limiting: true
  max-worlds-per-player: 10
  
# Performance settings
performance:
  async-world-creation: true
  chunk-loading-optimization: true

​
3. Set Permissions

Configure permissions for your players and staff: 
# Example permissions.yml
groups:
  default:
    permissions:
    - lilworlds.world.info
    - lilworlds.world.list
    
  moderator:
    permissions:
    - lilworlds.world.*
    
  admin:
    permissions:
    - lilworlds.*

​
Troubleshooting

​
Common Issues

​
Getting Help

If you encounter issues not covered here:
  1. Check the console for error messages
  2. Review configuration files for syntax errors
  3. Search existing issues on GitHub
  4. Create a new issue with detailed information

Report Issues

Found a bug? Report it on our GitHub issues page

​
Next Steps

Now that LilWorlds is installed, you’re ready to start managing worlds:

Quick Start Guide

Learn the basic commands and workflows

Configuration

Customize LilWorlds for your server