Commands Reference

Complete reference for all LilChunks commands

Commands Reference

Complete guide to all LilChunks commands, their usage, and examples.

Command Overview

LilChunks provides a simple yet powerful command interface with multiple aliases for convenience:

Primary

/lilchunks

Short Alias

/lc

Alternative

/chunks

All examples in this guide use /lc for brevity, but you can use any of the three command forms.

Command Structure

/lc <subcommand> [arguments] [options]

Available Subcommands

Command	Description	Permission Required
start	Start chunk pregeneration	lilchunks.admin
stop	Stop chunk pregeneration	lilchunks.admin
status	Check generation status	lilchunks.use
reload	Reload configuration	lilchunks.admin
help	Show help information	lilchunks.use

Detailed Command Reference

Start Command

Start chunk pregeneration around your current location or a specified area.

Syntax

/lc start <radius> [world]

Parameters

• radius (required): Number of chunks to generate in each direction
• world (optional): Target world name (console only)

Examples

In-Game

# Start with 5 chunk radius
/lc start 5

# Start with 10 chunk radius
/lc start 10

# Start with 25 chunk radius
/lc start 25

Radius Guidelines

Small (1-10 chunks)

Use Cases: Spawn protection, small bases, testing

Chunks Generated: 9-441 chunks

Time Estimate: 30 seconds - 2 minutes

/lc start 5   # 11x11 = 121 chunks
/lc start 10  # 21x21 = 441 chunks

Medium (11-25 chunks)

Use Cases: Towns, large bases, faction areas

Chunks Generated: 529-2,601 chunks

Time Estimate: 2-10 minutes

/lc start 15  # 31x31 = 961 chunks
/lc start 25  # 51x51 = 2,601 chunks

Large (26-50 chunks)

Use Cases: World borders, major areas

Chunks Generated: 2,809-10,201 chunks

Time Estimate: 10-45 minutes

/lc start 30  # 61x61 = 3,721 chunks
/lc start 50  # 101x101 = 10,201 chunks

Massive (51+ chunks)

Use Cases: Full world pregeneration

Chunks Generated: 10,000+ chunks

Time Estimate: 45+ minutes

/lc start 100  # 201x201 = 40,401 chunks
/lc start 200  # 401x401 = 160,801 chunks

Large pregeneration tasks require significant server resources and time. Monitor performance carefully.

Success Response

✓ Started chunk generation in a 10 chunk radius.

Error Responses

✗ Invalid radius. Please use a positive number.
✗ Chunk generation is already in progress for this world.
✗ Failed to start chunk generation.

Stop Command

Stop active chunk pregeneration in the current or specified world.

Syntax

/lc stop [world]

Parameters

• world (optional): Target world name (required for console)

Examples

In-Game

# Stop generation in current world
/lc stop

Success Response

✓ Stopped chunk generation for world: world

Error Response

⚠ No active generation found for world: world

Always stop pregeneration gracefully before restarting your server to avoid potential issues.

Status Command

Check the current status of chunk pregeneration in your world.

Syntax

/lc status [world]

Parameters

• world (optional): Target world name (required for console)

Examples

In-Game

# Check status in current world
/lc status

Response Examples

Active Generation

Generation Status for world:
» Status: Running
» Progress: 156/441 chunks (35%)
» Estimated Time: 2m 15s
» Speed: 12 chunks/second

Reload Command

Reload the LilChunks configuration without restarting the server.

Syntax

/lc reload

Examples

# Reload configuration
/lc reload

Success Response

✓ Configuration reloaded successfully.

The reload command applies most configuration changes immediately, but some changes may require a server restart.

Help Command

Display help information and available commands.

Syntax

/lc help

Examples

# Show help
/lc help
/lilchunks help
/chunks help

Response

LilChunks Help:
» /lilchunks start [radius] - Start chunk generation
» /lilchunks stop [world] - Stop chunk generation  
» /lilchunks status [world] - Check generation status
» /lilchunks reload - Reload configuration
» /lilchunks help - Show this help message

Tab Completion

LilChunks provides intelligent tab completion for all commands and parameters:

Command Completion

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

Radius Completion

/lc start <TAB>
# Suggests: 5, 10, 20, 50

World Completion

/lc stop <TAB>
# Suggests: world, world_nether, world_the_end, [custom worlds]

Permission-Based Usage

Basic User (lilchunks.use)

/lc status    ✓ Allowed
/lc help      ✓ Allowed
/lc start     ✗ Denied
/lc stop      ✗ Denied
/lc reload    ✗ Denied

Administrator (lilchunks.admin)

/lc status    ✓ Allowed
/lc help      ✓ Allowed
/lc start     ✓ Allowed
/lc stop      ✓ Allowed
/lc reload    ✓ Allowed

The lilchunks.admin permission includes all lilchunks.use permissions.

Console vs In-Game Usage

In-Game Commands

When used by players in-game:

• World parameter is optional (uses current world)
• Player location is used for generation center
• Colorful chat messages with formatting

Console Commands

When used from server console:

• World parameter is required for stop/status commands
• Generation center must be specified or uses world spawn
• Plain text output without color formatting

Player Usage

# Player at spawn in "world"
/lc start 10        # Generates around player location
/lc status          # Checks current world
/lc stop            # Stops current world

Advanced Usage Examples

Batch Operations

# Start generation in multiple worlds
lc start 15 world
lc start 10 world_nether
lc start 5 world_the_end

# Check all world statuses
lc status world
lc status world_nether
lc status world_the_end

Scheduled Generation

# Using server scheduling or cron
# Generate during off-peak hours
0 2 * * * lc start 50 world
0 3 * * * lc stop world

Performance Monitoring

# Monitor generation with status checks
/lc start 25
# Wait 30 seconds
/lc status
# Check TPS: /tps
# Adjust if needed: /lc stop

Error Handling

LilChunks provides clear error messages for common issues:

Permission Errors

✗ You don't have permission to use this command.

Solution: Grant appropriate permissions or use OP

Invalid Parameters

✗ Invalid radius. Please use a positive number.
✗ Please specify a valid world.

Solution: Check command syntax and parameters

Generation Conflicts

✗ Chunk generation is already in progress for this world.

Solution: Stop existing generation first or wait for completion

Server Issues

✗ Failed to start chunk generation.

Solution: Check server logs, verify world accessibility, try smaller radius

Best Practices

Start Small

Begin with small radius values to test performance and understand impact.

Monitor Progress

Use /lc status regularly to monitor generation progress and performance.

Graceful Stops

Always use /lc stop before server restarts or maintenance.

Off-Peak Hours

Run large pregeneration tasks during low-activity periods.

Next Steps

Permissions Guide

Learn about LilChunks permission system

Performance Tuning

Optimize commands for better performance