Pre-generate a Minecraft map with Chunk-Pregenerator
Chunk-Pregenerator is a mod that generates the terrain of a Minecraft world in advance. Without it, the server creates each new area the moment a player explores it, which causes freezes and TPS drops. This guide shows how to install the Chunk Pregenerator mod on a Forge or Fabric server with OuiPanel, the game panel, then lists the Chunk Pregenerator commands for every version. Prefer Chunky? The article Chunky Minecraft: pre-generate your map covers it.
Why pre-generate your map?
Once an area is pre-generated, players explore it without lag from chunk generation.
| Benefit | Description |
|---|---|
| Smooth exploration | no more freezes when discovering new areas |
| Stable TPS | the server no longer computes terrain on the fly |
| Server ready | ideal before opening a new season |
| Less CPU load | fewer spikes during play hours |
Prerequisites and compatibility
| Item | Description |
|---|---|
| Forge or Fabric server | the mod needs a mod loader |
| Chunk-Pregenerator | downloaded from CurseForge |
| Console access or OP rights | to run the commands |
| Disk space | enough storage for the pre-generated area |
Create a backup of your world in Backups before a large pre-generation.
| Minecraft version | Mod version | Command syntax |
|---|---|---|
| 1.7.x to 1.12.2 | legacy | old syntax |
| 1.13 to 1.21+ | modern | new syntax |
The official download is on CurseForge.
Install Chunk-Pregenerator
Your server must run Forge, NeoForge or Fabric. How to install mods on your Minecraft server (Forge/Fabric) explains how to switch server software.
Download from CurseForge the mod version that matches your Minecraft version and your loader.
In OuiPanel, open File Manager, then the
modsfolder.Drag the
.jarfile from your computer onto the page. There is no upload button.Restart the server from Console.
Check in the log that the mod has loaded.

You can also use the Mods Manager: search for Chunk-Pregenerator in the Available mods tab, CurseForge catalog, then install the version offered.
Commands for Minecraft 1.13 and later
Type these commands in game with the slash, or in Console without it (pregen …).

Generate an area by radius
Here is the full syntax.
/pregen start gen radius <name> <shape> <X> <Z> <size>
| Parameter | Description | Possible values |
|---|---|---|
<name> | unique task identifier | free text (e.g. spawn_pregen) |
<shape> | shape of the area | SQUARE or CIRCLE |
<X> | X coordinate of the center | integer (e.g. 0) |
<Z> | Z coordinate of the center | integer (e.g. 0) |
<size> | radius of the area | in chunks, or in blocks with the b suffix |
A few 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 square (note the 'b' at the end)
/pregen start gen radius MainWorld SQUARE 0 0 3000b
Generate the area inside a world border
This method uses Minecraft's world border (WorldBorder) to define the area to generate.
First, set the center of the border.
/worldborder center <X> <Z>
| Parameter | Description |
|---|---|
<X> | X coordinate of the center |
<Z> | Z coordinate of the center |
For example, to center the border on 0, 0.
/worldborder center 0 0
Next, set its size.
/worldborder set <diameter>
| Parameter | Description |
|---|---|
<diameter> | total size in blocks (diameter, not radius) |
For example, for a border 6000 blocks across.
# WorldBorder of 6000 blocks in diameter (3000 blocks in each direction)
/worldborder set 6000
The value is a diameter, not a radius. For an area of 3000 blocks around spawn, enter 6000.
Finally, start the pre-generation. It generates every chunk inside the border.
/pregen start gen worldborder
Control commands
| Command | Action |
|---|---|
/pregen pause | pauses generation |
/pregen resume | resumes a paused generation |
/pregen stop | stops generation for good |
/pregen info listen | shows progress in real time |
/pregen info unlisten | hides progress |
Here is a typical sequence.
# Start pregen
/pregen start gen radius MapSeason1 SQUARE 0 0 3000b
# Monitor progress
/pregen info listen
# Pause if needed (players online)
/pregen pause
# Resume later
/pregen resume
# Stop tracking once finished
/pregen info unlisten
Commands for Minecraft 1.4.3 to 1.12.2
Generate an area by radius (legacy)
Here is the full syntax.
/pregen gen startradius <shape> <X> <Z> <size>
| Parameter | Description | Possible values |
|---|---|---|
<shape> | shape of the area | square or circle |
<X> | X coordinate of the center | integer |
<Z> | Z coordinate of the center | integer |
<size> | radius in chunks or blocks | number, b prefix for blocks |
A few 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
In legacy, the
bprefix goes before the number (b3000). In 1.13 and later, it goes after (3000b).
Generate the area inside a world border (legacy)
First set up the border.
/worldborder center <X> <Z>
/worldborder set <diameter>
Then start the generation.
/pregen gen startWorldBorder
In legacy, the command is spelled
startWorldBorder, with capitals. In 1.13 and later, it isworldborder, in lowercase.
Control commands (legacy)
| Command | Action |
|---|---|
/pregen stop | stops generation |
/pregen continue | resumes a stopped generation |
/pregen clear | stops and fully deletes the task |
/pregen info listen | shows progress |
/pregen info unlisten | hides progress |
Compare commands by version
| Action | Minecraft 1.13+ | Minecraft 1.4.3 to 1.12.2 |
|---|---|---|
| Generate by radius | /pregen start gen radius <name> <shape> <X> <Z> <size> | /pregen gen startradius <shape> <X> <Z> <size> |
| Generate the border | /pregen start gen worldborder | /pregen gen startWorldBorder |
| Pause | /pregen pause | none |
| Resume | /pregen resume | /pregen continue |
| Stop | /pregen stop | /pregen stop |
| Delete the task | none | /pregen clear |
| Track progress | /pregen info listen | /pregen info listen |
| Distance in blocks | b suffix after (3000b) | b prefix before (b3000) |
Work out the pre-generation size
A chunk is 16 blocks wide.
| Chunks | Blocks | Area of a square that wide |
|---|---|---|
| 50 | 800 | about 640,000 blocks² |
| 100 | 1,600 | about 2.5 million blocks² |
| 185 | 3,000 | about 9 million blocks² |
| 250 | 4,000 | about 16 million blocks² |
| 375 | 6,000 | about 36 million blocks² |
| Server type | Recommended radius | Note |
|---|---|---|
| Small survival | 1,500 to 2,000 blocks | enough to get started |
| Classic survival | 3,000 blocks | good balance of size and performance |
| Large community | 5,000 blocks or more | plan for plenty of disk space |
| Limited map (season) | set by the border | generate exactly the playable area |
Good practices
| Moment | Recommendation |
|---|---|
| Empty server | ideal, early morning or late at night |
| Before opening | prepare the map before players arrive |
| Peak hours | avoid, pre-generation uses a lot of CPU |
| No backup | avoid, always back up before a large pre-generation |
During pre-generation, keep an eye on resources. The Live stats in Console and the Global View show CPU, RAM and storage.
| Resource | Where to see it | Warning threshold |
|---|---|---|
| CPU | Live stats | over 90% for a long time |
| RAM | Live stats | over 85% |
| Disk | Global View | check free space regularly |
| TPS | /forge tps on Forge, /neoforge tps on NeoForge, /spark tps with Spark | below 15 TPS |
A large pre-generation can fill your disk space quickly. A world with a 3,000-block radius can take up several GB.
Before opening the server to players, check these points.
The mod is installed and working.
A backup of the world exists.
The world border is set, if you use one.
Pre-generation ran during off-peak hours.
Disk space is sufficient.
Progress was tracked to the end.
If pre-generation causes problems
The command does not work
| Problem | Solution |
|---|---|
| Unknown command | check that the mod is installed and loaded |
| Permission denied | be OP, or use Console |
| Wrong syntax | check the mod version and use the right syntax |
Pre-generation is very slow
| Cause | Solution |
|---|---|
| Overloaded server | wait for a quiet period |
| Not enough RAM | increase the allocated memory |
| Other heavy mods | temporarily disable what is not essential |
The server lags during pre-generation
| Action | Command |
|---|---|
| Pause | /pregen pause (1.13+) |
| Stop | /pregen stop |
| Resume later | /pregen resume or /pregen continue |
Need help?
Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.
Discover our Minecraft hosting plans starting from $2.28/month with automatic mod installation.
Minecraft server hosting →