Chunky Minecraft: Complete Plugin and Mod Guide
Learn to use Chunky to pre-generate your Minecraft world. Complete guide: plugin/mod installation, commands, configuration, and server optimization.
Complete Guide to Chunky Minecraft: Pre-generation Plugin and Mod
Pre-generate your Minecraft world for optimal performance
Introduction
Chunky is an essential tool for server administrators and players looking to pre-generate their Minecraft world. Pre-generating chunks eliminates lag caused by real-time generation when players explore new areas.
Why use Chunky?
- Lag reduction — No more freezes while exploring
- Server performance — Less CPU load during gameplay
- Smooth experience — World ready to be explored instantly
- Precise control — Define exactly the area to generate
- Compatibility — Works with Spigot, Paper, Fabric, and Forge
Chunky Plugin (Servers)
Compatibility
| Platform | Version | Support |
|---|---|---|
| Spigot | 1.13 - 1.21+ | ✅ Full |
| Paper | 1.13 - 1.21+ | ✅ Recommended |
| Purpur | 1.16 - 1.21+ | ✅ Full |
| Folia | 1.19.4+ | ✅ Full |
Plugin Installation
Step 1: Download
Download Chunky from the official sources:
Step 2: Installation
1. Stop your server
2. Place the Chunky-X.X.X.jar file in the /plugins/ folder
3. Restart the server
4. Check with /plugins that Chunky is loaded (green)
Step 3: Verification
/chunky
If the installation is successful, you will see the Chunky help menu.
Basic Plugin Usage
Pre-generate a radius around the spawn
# Set the target world
/chunky world world
Set the center (default spawn)
/chunky center 0 0
Set the radius in blocks
/chunky radius 5000
Start pre-generation
/chunky start
Pre-generate all worlds
# Main world (Overworld)
/chunky world world
/chunky radius 5000
/chunky start
Wait for completion, then Nether
/chunky world world_nether
/chunky radius 2500
/chunky start
Then the End
/chunky world world_the_end
/chunky radius 2500
/chunky start
Note: The Nether has a 1:8 scale, so 2500 blocks in the Nether equals 20000 blocks in the Overworld.
Chunky Mod (Solo/Fabric/Forge)
Mod Compatibility
| Mod Loader | Minecraft Version | Support |
|---|---|---|
| Fabric | 1.16 - 1.21+ | ✅ Full |
| Forge | 1.16 - 1.21+ | ✅ Full |
| NeoForge | 1.20.1+ | ✅ Full |
| Quilt | 1.18 - 1.21+ | ✅ Full |
Fabric Mod Installation
Prerequisites:
- Fabric Loader installed
- Fabric API
Step 1: Download
Download from:
Step 2: Installation
1. Close Minecraft
2. Place Chunky-X.X.X.jar in the .minecraft/mods/ folder
3. Ensure that Fabric API is also present
4. Launch Minecraft with the Fabric profile
Forge Mod Installation
Prerequisites:
- Forge Mod Loader installed
Step 1: Download
Download the Forge version from the same sources.
Step 2: Installation
1. Close Minecraft
2. Place Chunky-X.X.X.jar in the .minecraft/mods/ folder
3. Launch Minecraft with the Forge profile
Single Player Usage
The commands are identical to the server version. Open the chat and use:
/chunky radius 3000
/chunky start
Essential Commands
Main Commands Table
| Command | Description |
|---|---|
/chunky start |
Starts the pre-generation |
/chunky pause |
Pauses |
/chunky continue |
Resumes generation |
/chunky cancel |
Cancels permanently |
/chunky world <world> |
Selects the world |
/chunky center <x> <z> |
Sets the center |
/chunky radius <blocks> |
Sets the radius |
/chunky spawn |
Centers on the spawn |
/chunky worldborder |
Uses the existing border |
/chunky shape <shape> |
Sets the shape |
/chunky quiet <interval> |
Message interval |
/chunky progress |
Displays progress |
/chunky pattern <pattern> |
Generation pattern |
/chunky selection |
Displays the current selection |
/chunky trim |
Removes out-of-bounds chunks |
/chunky reload |
Reloads the configuration |
Available Shapes
/chunky shape <shape>
| Shape | Description | Usage |
|---|---|---|
square |
Square | Default, simple |
circle |
Circle | Natural round world |
rectangle |
Rectangle | Custom areas |
ellipse |
Ellipse | Oval shapes |
pentagon |
Pentagon | Decorative |
star |
Star | Decorative |
Example with shape:
/chunky shape circle
/chunky center 0 0
/chunky radius 10000
/chunky start
Generation Patterns
/chunky pattern <pattern>
| Pattern | Description |
|---|---|
concentric |
From the center outwards (default) |
loop |
In a spiral |
region |
By region (.mca files) |
Advanced Configuration
Configuration File
Location: /plugins/Chunky/config.yml (plugin) or /config/chunky.json (mod)
# config.yml - Example configuration
language: en
tasks:
world:
cancelled: false
center-x: 0
center-z: 0
radius: 5000
shape: circle
pattern: concentric
Performance Settings
Limit CPU usage
# Reduce generation speed
/chunky quiet 5
Background generation
For servers with active players:
# In config.yml
generation:
# Chunks per second (reduce if lag)
rate: 100
Using the World Border
If you have already set up a world border:
# Automatically uses the existing border
/chunky worldborder
/chunky start
Custom Coordinates
For a specific rectangle:
/chunky shape rectangle
/chunky center 1000 2000
/chunky radius 500 800
/chunky start
This generates a rectangle of 1000x1600 blocks centered on (1000, 2000).
Optimization and Tips
World Size Calculation
| Radius (blocks) | Diameter | Chunks | Estimated Size |
|---|---|---|---|
| 1,000 | 2 km | ~4,000 | ~50 MB |
| 2,500 | 5 km | ~25,000 | ~300 MB |
| 5,000 | 10 km | ~100,000 | ~1.2 GB |
| 10,000 | 20 km | ~400,000 | ~5 GB |
| 25,000 | 50 km | ~2,500,000 | ~30 GB |
Estimated Generation Time
Times vary depending on your hardware:
| Configuration | Chunks/second | 10,000 radius |
|---|---|---|
| Low PC | 50-100 | 2-4 hours |
| Medium PC | 150-300 | 30-60 min |
| High PC | 400-800 | 10-20 min |
| Dedicated Server | 500-1000+ | 5-15 min |
Best Practices
1. Generate during off-peak hours
# Start at night or when the server is empty
/chunky start
2. Use Paper/Purpur
Paper significantly optimizes chunk generation compared to vanilla Spigot.
3. Increase allocated RAM
# In your startup script
java -Xmx8G -Xms8G -jar server.jar
4. Temporarily disable heavy plugins
Protection, economy, etc. plugins can slow down generation.
5. Monitor progress
/chunky progress
6. Plan in stages
For very large worlds, generate in sections:
# Phase 1: Central area
/chunky radius 5000
/chunky start
Phase 2: Expand
/chunky radius 10000
/chunky continue
Integration with Other Plugins
Chunky Border (Extension)
Chunky Border adds integrated world border management.
Installation:
- Download from Modrinth
Commands:
# Create a border
/chunkyborder add circle
Set behavior
/chunkyborder wrap # Teleportation to the other side
/chunkyborder block # Blocks passage
Compatibility with Other Mods
| Mod/Plugin | Compatibility | Notes |
|---|---|---|
| WorldEdit | ✅ | No conflict |
| Dynmap | ✅ | Generate before rendering |
| BlueMap | ✅ | Same |
| Multiverse | ✅ | Specify the world |
| Terra | ✅ | Custom generator supported |
| Iris | ✅ | Custom generator supported |
Troubleshooting
Common Issues
Generation is very slow
Solutions:
- Increase server RAM
- Use Paper instead of Spigot
- Disable non-essential plugins
- Check that the disk is not full
Error "World not found"
# Check the exact world name
/chunky world world # Overworld
/chunky world world_nether # Nether
/chunky world world_the_end # End
The server crashes during generation
Solutions:
- Reduce the radius and proceed in stages
- Increase RAM (-Xmx)
- Add to the startup flags:
-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200
Chunks are not saving
# Force save
/save-all
Then continue
/chunky continue
Logs and Debugging
Check the logs to identify issues:
/logs/latest.log
Look for lines containing "Chunky" for diagnostics.
Quick Commands - Cheat Sheet
Standard Generation (5000 blocks)
/chunky world world
/chunky center 0 0
/chunky radius 5000
/chunky shape circle
/chunky start
Quick Generation (World Border)
/worldborder set 10000
/chunky worldborder
/chunky start
Multi-World Generation
# Complete script
/chunky world world && /chunky radius 5000 && /chunky start
# Wait...
/chunky world world_nether && /chunky radius 1250 && /chunky start
# Wait...
/chunky world world_the_end && /chunky radius 2500 && /chunky start
Conclusion
Chunky is an essential tool for any Minecraft server looking to provide a smooth experience for its players. Pre-generation eliminates performance issues related to exploration and allows for precise planning of your world size.
Key points to remember:
- Always generate before opening the server to the public
- Adjust the radius to your actual needs
- Use Paper/Purpur for better performance
- Regularly monitor progress