MinecraftPublished on January 16, 20266 min read

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.

BenefitDescription
Smooth explorationno more freezes when discovering new areas
Stable TPSthe server no longer computes terrain on the fly
Server readyideal before opening a new season
Less CPU loadfewer spikes during play hours

Prerequisites and compatibility

ItemDescription
Forge or Fabric serverthe mod needs a mod loader
Chunk-Pregeneratordownloaded from CurseForge
Console access or OP rightsto run the commands
Disk spaceenough storage for the pre-generated area

Create a backup of your world in Backups before a large pre-generation.

Minecraft versionMod versionCommand syntax
1.7.x to 1.12.2legacyold syntax
1.13 to 1.21+modernnew 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.

  1. Download from CurseForge the mod version that matches your Minecraft version and your loader.

  2. In OuiPanel, open File Manager, then the mods folder.

  3. Drag the .jar file from your computer onto the page. There is no upload button.

  4. Restart the server from Console.

  5. Check in the log that the mod has loaded.

mods folder open in the File Manager with the list of jar files

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 …).

Console of a running server with a command typed in the field, without a slash

Generate an area by radius

Here is the full syntax.

/pregen start gen radius <name> <shape> <X> <Z> <size>
ParameterDescriptionPossible values
<name>unique task identifierfree text (e.g. spawn_pregen)
<shape>shape of the areaSQUARE or CIRCLE
<X>X coordinate of the centerinteger (e.g. 0)
<Z>Z coordinate of the centerinteger (e.g. 0)
<size>radius of the areain 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>
ParameterDescription
<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>
ParameterDescription
<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

CommandAction
/pregen pausepauses generation
/pregen resumeresumes a paused generation
/pregen stopstops generation for good
/pregen info listenshows progress in real time
/pregen info unlistenhides 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>
ParameterDescriptionPossible values
<shape>shape of the areasquare or circle
<X>X coordinate of the centerinteger
<Z>Z coordinate of the centerinteger
<size>radius in chunks or blocksnumber, 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 b prefix 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 is worldborder, in lowercase.

Control commands (legacy)

CommandAction
/pregen stopstops generation
/pregen continueresumes a stopped generation
/pregen clearstops and fully deletes the task
/pregen info listenshows progress
/pregen info unlistenhides progress

Compare commands by version

ActionMinecraft 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 pausenone
Resume/pregen resume/pregen continue
Stop/pregen stop/pregen stop
Delete the tasknone/pregen clear
Track progress/pregen info listen/pregen info listen
Distance in blocksb suffix after (3000b)b prefix before (b3000)

Work out the pre-generation size

A chunk is 16 blocks wide.

ChunksBlocksArea of a square that wide
50800about 640,000 blocks²
1001,600about 2.5 million blocks²
1853,000about 9 million blocks²
2504,000about 16 million blocks²
3756,000about 36 million blocks²
Server typeRecommended radiusNote
Small survival1,500 to 2,000 blocksenough to get started
Classic survival3,000 blocksgood balance of size and performance
Large community5,000 blocks or moreplan for plenty of disk space
Limited map (season)set by the bordergenerate exactly the playable area

Good practices

MomentRecommendation
Empty serverideal, early morning or late at night
Before openingprepare the map before players arrive
Peak hoursavoid, pre-generation uses a lot of CPU
No backupavoid, 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.

ResourceWhere to see itWarning threshold
CPULive statsover 90% for a long time
RAMLive statsover 85%
DiskGlobal Viewcheck free space regularly
TPS/forge tps on Forge, /neoforge tps on NeoForge, /spark tps with Sparkbelow 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

ProblemSolution
Unknown commandcheck that the mod is installed and loaded
Permission deniedbe OP, or use Console
Wrong syntaxcheck the mod version and use the right syntax

Pre-generation is very slow

CauseSolution
Overloaded serverwait for a quiet period
Not enough RAMincrease the allocated memory
Other heavy modstemporarily disable what is not essential

The server lags during pre-generation

ActionCommand
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.

Was this article helpful?

1,460 views
Share this article
Minecraft
Need a Minecraft server?

Discover our Minecraft hosting plans starting from $2.28/month with automatic mod installation.

Minecraft server hosting →

Related Articles