Quick Start

Get started with LilChunks chunk pregeneration in 5 minutes

Quick Start Guide

Get up and running with LilChunks chunk pregeneration in just a few minutes. This guide will walk you through your first pregeneration task.

This guide assumes you have already installed LilChunks on your server.

Your First Pregeneration

1. Join Your Server

   Connect to your Minecraft server and navigate to the area where you want to pregenerate chunks.

   Choose a central location like spawn or a main base area for your first pregeneration.

2. Start Pregeneration

   Use the start command to begin chunk generation around your current location:

   /lilchunks start 10
   

   This will pregenerate chunks in a 10-chunk radius around your position.

   Chunk Radius Explained: A radius of 10 means chunks will be generated 10 chunks in each direction from your position, creating a 21x21 chunk area (441 total chunks).

3. Monitor Progress

   Check the generation status to see progress:

   /lilchunks status
   

   You’ll see output like:

   Generation Status for world:
   » Status: Running
   » Progress: 156/441 chunks
   

4. Wait for Completion

   Let the pregeneration complete. You can continue playing while it runs in the background.

   Avoid stopping the server during pregeneration unless necessary. Use /lilchunks stop first.

Command Aliases

LilChunks provides convenient aliases for faster command execution:

Full Commands

/lilchunks start 10
/lilchunks status
/lilchunks stop
/lilchunks reload
/lilchunks help

Common Pregeneration Scenarios

Small Area (Spawn Protection)

Perfect for spawn areas and small bases:

# 5 chunk radius (11x11 chunks = 121 total)
/lc start 5

Medium Area (Town/Base)

Good for larger bases and town areas:

# 15 chunk radius (31x31 chunks = 961 total)
/lc start 15

Large Area (World Border)

For major world areas or world borders:

# 50 chunk radius (101x101 chunks = 10,201 total)
/lc start 50

Large pregeneration tasks can take significant time and server resources. Start small and monitor performance.

Understanding the Output

When you start pregeneration, you’ll see colorful status messages:

Successful Start

✓ Started chunk generation in a 10 chunk radius.

Status Check

Generation Status for world:
» Status: Running
» Progress: 156/441 chunks
» Estimated Time: 2m 30s

Completion

✓ Chunk generation completed for world: world
» Total chunks generated: 441
» Time taken: 3m 45s

Managing Multiple Worlds

LilChunks can handle pregeneration in different worlds:

Current World

# Pregenerate in your current world
/lc start 10
/lc status
/lc stop

When using commands from the console, you must specify the world name for stop and status commands.

Performance Monitoring

Check Server Performance

Monitor your server’s performance during pregeneration:

# Check TPS
/tps

# Check memory usage
/memory

# Check LilChunks status
/lc status

Adjust Generation Speed

If pregeneration is causing lag, you can adjust the speed in the configuration:

chunk-generation:
  chunks-per-tick: 2  # Reduce from default 4

Then reload the configuration:

/lc reload

Stopping Pregeneration

Graceful Stop

Always stop pregeneration gracefully when possible:

/lc stop

Emergency Stop

If the server is unresponsive, you can stop from console:

lc stop world_name

Before Server Restart

Always stop pregeneration before restarting your server:

/lc stop
/stop

Tab Completion

LilChunks provides smart tab completion for all commands:

Commands

/lc <TAB>
# Shows: start, stop, status, reload, help

Best Practices

🎯 Start Small

Begin with small radius values (5-10 chunks) to test performance and understand the impact on your server.

⏰ Off-Peak Hours

Run large pregeneration tasks during off-peak hours when fewer players are online.

📊 Monitor Performance

Keep an eye on TPS and memory usage during pregeneration. Stop if performance degrades significantly.

💾 Backup First

Always backup your world before running large pregeneration tasks.

🔄 Gradual Expansion

For very large areas, consider multiple smaller pregeneration sessions rather than one massive task.

Troubleshooting Quick Issues

Command Not Found

Problem: /lilchunks command not recognized

Solutions:

• Check if LilChunks is installed: /plugins
• Verify permissions: /lp user <name> permission check lilchunks.use
• Try aliases: /lc or /chunks

Permission Denied

Problem: “You don’t have permission to use this command”

Solutions:

• Grant permissions: /lp user <name> permission set lilchunks.admin true
• Use OP: /op <username>
• Check permission plugin configuration

Generation Won't Start

Problem: “Failed to start chunk generation”

Solutions:

• Check if generation is already running: /lc status
• Verify world is loaded and accessible
• Check server logs for error messages
• Try a smaller radius first

Server Lag

Problem: Server becomes laggy during pregeneration

Solutions:

• Reduce chunks-per-tick in config
• Stop current generation: /lc stop
• Use smaller radius values
• Run during off-peak hours

What’s Next?

Now that you’ve completed your first pregeneration, explore more advanced features:

Configuration Guide

Optimize LilChunks for your server’s needs

Commands Reference

Learn all available commands and options

Performance Tuning

Maximize performance and minimize lag

Troubleshooting

Solve common issues and problems

Join our community for tips, support, and to share your pregeneration experiences!