Introduction
When your players explore new areas on your Minecraft server, the server must generate terrain in real-time. This operation consumes enormous CPU resources and frequently causes freezes, TPS (Ticks Per Second) drops, and a severely degraded gaming experience.
Chunk-Pregenerator solves this problem by generating terrain in advance during off-peak periods. Once the area is pre-generated, your players can explore freely without any lag related to chunk generation.
Why Pre-generate Your Map?
| Advantage | Impact |
|---|---|
| Smooth exploration | Eliminates freezes when discovering new areas |
| Stable TPS | Server maintains optimal TPS (≥18) even under heavy load |
| CPU reduction | Decreases load spikes by 40 to 60% during gameplay hours |
| Server preparation | Allows proper map configuration before a season opening |
| Better gameplay | Significantly improves user experience |
Prerequisites
Before starting, verify that you have:
| Element | Description |
|---|---|
| Forge or Fabric server | The mod requires a mod loader (Minecraft 1.7.10 to 1.21+) |
| Chunk-Pregenerator | Version compatible with your server (CurseForge download) |
| Administrator access | OP permissions or console access to execute commands |
| Sufficient disk space | Plan for 2 to 8 GB depending on pre-generation size |
| Off-peak period | Ideally, perform pre-gen when the server is empty |
⚠️ Important: Always perform a complete backup of your world before launching a massive pre-generation.
Version Compatibility
| Minecraft Version | Mod Version | Command Syntax |
|---|---|---|
| 1.7.10 - 1.12.2 | Legacy | Old syntax (startradius) |
| 1.13 - 1.21+ | Modern | New syntax (start gen radius) |
Mod Installation
Step 1: Download
- Go to CurseForge
- Select the version matching your Minecraft server
- Download the
.jarfile
Step 2: Installation
- Log in to your VeryCloud client area
- Access your server's file manager
- Place the
.jarfile in themods/folder - Restart your server
Step 3: Verification
Check in the startup logs that the mod is properly loaded:
[Server thread/INFO] [FML]: Loaded mod Chunk-Pregenerator version X.X.X
Commands for Minecraft 1.13 and Later Versions
Method 1: Radius Generation
Complete syntax:
/pregen start gen radius <name> <shape> <X> <Z> <size>
Detailed parameters:
| Parameter | Description | Possible Values |
|---|---|---|
<name> | Unique task identifier | Free text (e.g., spawn_zone) |
<shape> | Shape of area to generate | SQUARE (square) or CIRCLE (circle) |
<X> | X coordinate of center | Integer (e.g., 0) |
<Z> | Z coordinate of center | Integer (e.g., 0) |
<size> | Radius of area | In chunks, or in blocks with b suffix |
Concrete examples:
# Generate a 100-chunk square around spawn
/pregen start gen radius SpawnZone SQUARE 0 0 100
# Generate a 50-chunk circle centered at 500, 500
/pregen start gen radius BaseZone CIRCLE 500 500 50
# Generate a 3000-block radius square (note the 'b')
/pregen start gen radius MainWorld SQUARE 0 0 3000b
Method 2: WorldBorder Generation
This method uses Minecraft's native world border to automatically define the area to generate.
Step 1: Set WorldBorder Center
/worldborder center <X> <Z>
Example:
/worldborder center 0 0
Step 2: Set WorldBorder Size
/worldborder set <diameter>
💡 Attention: The value is a diameter, not a radius. For a 3000-block area around spawn, enter
6000.
Example:
# WorldBorder with 6000-block diameter (3000 blocks in each direction)
/worldborder set 6000
Step 3: Launch Pre-generation
/pregen start gen worldborder
This command automatically generates all chunks inside the defined WorldBorder.
Control Commands
| Command | Action |
|---|---|
/pregen pause | Pauses generation |
/pregen resume | Resumes a paused generation |
/pregen stop | Permanently stops the current generation |
/pregen info listen | Displays real-time progress in chat |
/pregen info unlisten | Disables progress display |
Complete workflow example:
# 1. Launch pre-generation
/pregen start gen radius Season1 SQUARE 0 0 3000b
# 2. Monitor progress
/pregen info listen
# 3. Pause if necessary (connected players)
/pregen pause
# 4. Resume later
/pregen resume
# 5. Stop monitoring once complete
/pregen info unlisten
Commands for Minecraft 1.7.10 to 1.12.2
Method 1: Radius Generation (legacy)
Complete syntax:
/pregen gen startradius <shape> <X> <Z> <size>
Detailed parameters:
| Parameter | Description | Possible Values |
|---|---|---|
<shape> | Area shape | square (square) or circle (circle) |
<X> | X coordinate of center | Integer |
<Z> | Z coordinate of center | Integer |
<size> | Radius in chunks or blocks | Number, with b prefix for blocks |
Concrete examples:
# Generate a 100-chunk square around spawn
/pregen gen startradius square 0 0 100
# Generate a 50-chunk circle
/pregen gen startradius circle 0 0 50
# Generate a 3000-block area (note the 'b' BEFORE the number)
/pregen gen startradius square 0 0 b3000
📝 Important difference: In legacy version, the
bprefix goes before the number (b3000), while in 1.13+ it goes after (3000b).
Method 2: WorldBorder Generation (legacy)
Step 1: Configure WorldBorder
/worldborder center <X> <Z>
/worldborder set <diameter>
Step 2: Launch Generation
/pregen gen startWorldBorder
⚠️ Attention: The command is written
startWorldBorder(with capitals) in legacy, versusworldborder(lowercase) in 1.13+.
Control Commands (legacy)
| Command | Action |
|---|---|
/pregen stop | Stops generation |
/pregen continue | Resumes a stopped generation |
/pregen clear | Stops and completely removes the task |
/pregen info listen | Displays progress |
/pregen info unlisten | Hides progress |
Command Comparison Table
| Action | Minecraft 1.13+ | Minecraft 1.7.10 - 1.12.2 |
|---|---|---|
| Generate by radius | /pregen start gen radius <name> <shape> <X> <Z> <size> | /pregen gen startradius <shape> <X> <Z> <size> |
| Generate via WorldBorder | /pregen start gen worldborder | /pregen gen startWorldBorder |
| Pause | /pregen pause | N/A |
| Resume | /pregen resume | /pregen continue |
| Stop | /pregen stop | /pregen stop |
| Remove task | N/A | /pregen clear |
| Monitor progress | /pregen info listen | /pregen info listen |
| Distance in blocks | Suffix b after (3000b) | Prefix b before (b3000) |
Calculating Pre-generation Size
Chunk / Block Correspondence
| Chunks (radius) | Blocks (diameter) | Approximate Surface |
|---|---|---|
| 50 | 800 | ~640,000 blocks² |
| 100 | 1,600 | ~2.5 million blocks² |
| 185 | 3,000 | ~9 million blocks² |
| 250 | 4,000 | ~16 million blocks² |
| 375 | 6,000 | ~36 million blocks² |
💡 Reminder: 1 chunk = 16 blocks per side
Recommendations by Usage
| Server Type | Recommended Radius | Note |
|---|---|---|
| Small survival (5-10 players) | 1500-2000 blocks | Sufficient to start |
| Classic survival (10-30 players) | 3000 blocks | Good size/performance compromise |
| Large community (30+ players) | 5000+ blocks | Plan for substantial disk space |
| Limited map (season) | According to WorldBorder | Generate exactly the playable area |
Best Practices
When to Launch Pre-generation?
| Timing | Recommendation |
|---|---|
| ✅ Empty server | Ideal: early morning or late night |
| ✅ Before opening | Prepare the map before welcoming players |
| ✅ Maintenance period | Take advantage of scheduled maintenance |
| ❌ Peak hours | Avoid: pre-gen consumes enormous CPU |
| ❌ Without backup | Always perform a complete backup beforehand |
Resource Monitoring
During pre-generation, monitor resources via your VeryCloud client area:
| Resource | Monitoring Tool | Alert Threshold |
|---|---|---|
| CPU | VeryCloud Panel | > 90% prolonged |
| RAM | VeryCloud Panel | > 85% |
| Disk | VeryCloud Panel | Check free space regularly |
| TPS | /tps command in-game | < 15 TPS |
⚠️ Attention: Large pre-generation can quickly fill your disk space. A Minecraft world with a 3000-block radius can easily reach 4 to 6 GB.
Pre-generation Optimization
For a VeryCloud VPS:
- VPS KVM SSD: Pre-generation of 1500-2500 blocks recommended
- VPS KVM NVMe: Pre-generation up to 3500 blocks without issues
- VPS KVM Ryzen: Optimal performance, up to 5000+ blocks
Tip: Launch pre-generation overnight and check logs the next morning.
Troubleshooting
Command Not Working
| Problem | Solution |
|---|---|
| Unknown command | Verify the mod is properly installed in /mods/ and loaded at startup |
| Permission denied | Ensure you are OP (/op <your_username>) or using server console |
| Wrong syntax | Check mod version and use corresponding syntax (legacy vs modern) |
Pre-generation Very Slow
| Cause | Solution |
|---|---|
| Overloaded server | Wait for off-peak period or increase resources |
| Insufficient RAM | Increase Java memory allocation in server settings |
| Heavy plugins | Temporarily disable non-essential plugins (WorldEdit, Dynmap, etc.) |
| Slow SSD storage | Consider migrating to a VPS NVMe or Ryzen VeryCloud |
Server Lags During Pre-generation
Immediate actions:
# Pause pre-generation
/pregen pause
# Check TPS
/tps
# If TPS < 15, stop pre-gen
/pregen stop
Long-term solutions:
- Perform pre-generation only at night
- Divide pre-generation into multiple sessions
- Upgrade to a VeryCloud server with more CPU/RAM
Pre-generation Time Estimates
| Size | VPS SSD | VPS NVMe | VPS Ryzen |
|---|---|---|---|
| 1500 blocks | ~30-45 min | ~20-30 min | ~15-20 min |
| 3000 blocks | ~2-3h | ~1-2h | ~45min-1h |
| 5000 blocks | ~6-8h | ~4-5h | ~2-3h |
Estimates based on standard VeryCloud configurations with optimal RAM allocation
Pre-launch Server Checklist
Use this checklist to ensure everything is ready:
- Chunk-Pregenerator mod installed and functional
- Complete world backup performed
- WorldBorder configured (if used)
- Pre-generation launched during off-peak period
- Disk space verified (at least 10 GB free recommended)
- Progress monitored to 100% completion
- TPS test performed after pre-generation (
/tps> 18) - Player connection test on pre-generated areas
Summary
Chunk-Pregenerator is an essential tool for any Minecraft server hosted on VeryCloud wishing to offer smooth, lag-free exploration. By generating terrain in advance, you eliminate freezes, maintain stable TPS, and provide an optimal gaming experience to your community.
Key points to remember:
- Always perform a backup before launching pre-generation
- Choose an off-peak period to minimize impact on players
- Monitor CPU/RAM resources via the VeryCloud panel
- Adapt pre-generation size to your server's capacity
- Test TPS after completion to validate performance
Need Help?
If you encounter difficulties with Chunk-Pregenerator on your VeryCloud server:
- Documentation: docs.verycloud.fr
- 24/7 Technical Support: Open a ticket from your client area
- Discord Community: Join our Discord server (600+ members)
- Service Status: status.verycloud.fr