Logo

Pre-generating a Minecraft Map with Chunk-Pregenerator

Pre-generating a Minecraft Map with Chunk-Pregenerator

This guide explains how to use the Chunk Pregenerator mod to generate your map in advance, ensuring a smooth gaming experience without CPU latency spikes.

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?

AdvantageImpact
Smooth explorationEliminates freezes when discovering new areas
Stable TPSServer maintains optimal TPS (≥18) even under heavy load
CPU reductionDecreases load spikes by 40 to 60% during gameplay hours
Server preparationAllows proper map configuration before a season opening
Better gameplaySignificantly improves user experience

Prerequisites

Before starting, verify that you have:

ElementDescription
Forge or Fabric serverThe mod requires a mod loader (Minecraft 1.7.10 to 1.21+)
Chunk-PregeneratorVersion compatible with your server (CurseForge download)
Administrator accessOP permissions or console access to execute commands
Sufficient disk spacePlan for 2 to 8 GB depending on pre-generation size
Off-peak periodIdeally, 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 VersionMod VersionCommand Syntax
1.7.10 - 1.12.2LegacyOld syntax (startradius)
1.13 - 1.21+ModernNew syntax (start gen radius)

Mod Installation

Step 1: Download

  1. Go to CurseForge
  2. Select the version matching your Minecraft server
  3. Download the .jar file

Step 2: Installation

  1. Log in to your VeryCloud client area
  2. Access your server's file manager
  3. Place the .jar file in the mods/ folder
  4. 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:

ParameterDescriptionPossible Values
<name>Unique task identifierFree text (e.g., spawn_zone)
<shape>Shape of area to generateSQUARE (square) or CIRCLE (circle)
<X>X coordinate of centerInteger (e.g., 0)
<Z>Z coordinate of centerInteger (e.g., 0)
<size>Radius of areaIn 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

CommandAction
/pregen pausePauses generation
/pregen resumeResumes a paused generation
/pregen stopPermanently stops the current generation
/pregen info listenDisplays real-time progress in chat
/pregen info unlistenDisables 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:

ParameterDescriptionPossible Values
<shape>Area shapesquare (square) or circle (circle)
<X>X coordinate of centerInteger
<Z>Z coordinate of centerInteger
<size>Radius in chunks or blocksNumber, 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 b prefix 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, versus worldborder (lowercase) in 1.13+.


Control Commands (legacy)

CommandAction
/pregen stopStops generation
/pregen continueResumes a stopped generation
/pregen clearStops and completely removes the task
/pregen info listenDisplays progress
/pregen info unlistenHides progress

Command Comparison Table

ActionMinecraft 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 pauseN/A
Resume/pregen resume/pregen continue
Stop/pregen stop/pregen stop
Remove taskN/A/pregen clear
Monitor progress/pregen info listen/pregen info listen
Distance in blocksSuffix b after (3000b)Prefix b before (b3000)

Calculating Pre-generation Size

Chunk / Block Correspondence

Chunks (radius)Blocks (diameter)Approximate Surface
50800~640,000 blocks²
1001,600~2.5 million blocks²
1853,000~9 million blocks²
2504,000~16 million blocks²
3756,000~36 million blocks²

💡 Reminder: 1 chunk = 16 blocks per side

Recommendations by Usage

Server TypeRecommended RadiusNote
Small survival (5-10 players)1500-2000 blocksSufficient to start
Classic survival (10-30 players)3000 blocksGood size/performance compromise
Large community (30+ players)5000+ blocksPlan for substantial disk space
Limited map (season)According to WorldBorderGenerate exactly the playable area

Best Practices

When to Launch Pre-generation?

TimingRecommendation
Empty serverIdeal: early morning or late night
Before openingPrepare the map before welcoming players
Maintenance periodTake advantage of scheduled maintenance
Peak hoursAvoid: pre-gen consumes enormous CPU
Without backupAlways perform a complete backup beforehand

Resource Monitoring

During pre-generation, monitor resources via your VeryCloud client area:

ResourceMonitoring ToolAlert Threshold
CPUVeryCloud Panel> 90% prolonged
RAMVeryCloud Panel> 85%
DiskVeryCloud PanelCheck 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

ProblemSolution
Unknown commandVerify the mod is properly installed in /mods/ and loaded at startup
Permission deniedEnsure you are OP (/op <your_username>) or using server console
Wrong syntaxCheck mod version and use corresponding syntax (legacy vs modern)

Pre-generation Very Slow

CauseSolution
Overloaded serverWait for off-peak period or increase resources
Insufficient RAMIncrease Java memory allocation in server settings
Heavy pluginsTemporarily disable non-essential plugins (WorldEdit, Dynmap, etc.)
Slow SSD storageConsider 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

SizeVPS SSDVPS NVMeVPS 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:

  1. Always perform a backup before launching pre-generation
  2. Choose an off-peak period to minimize impact on players
  3. Monitor CPU/RAM resources via the VeryCloud panel
  4. Adapt pre-generation size to your server's capacity
  5. Test TPS after completion to validate performance

Need Help?

If you encounter difficulties with Chunk-Pregenerator on your VeryCloud server:

Join our Discord community server

For any questions, suggestions, or just to chat with the community, join us on Discord!

900+Members