Pre-generate Your World with Chunky
Pre-generate your Minecraft server world with Chunky on RealisticNode to stop lag from exploring. Set a radius, start, pause and resume, and estimate time and disk usage.
Generating new terrain is one of the heaviest jobs a Minecraft server does. When players explore, elytra fly or travel far, the server must create new chunks on the fly, and everyone feels the lag. Chunky generates those chunks in advance, so later the server only has to load them from disk, which is much lighter.
Install Chunky
Chunky is free and works on most server types. Pick the right version for yours:
| Server type | What to install | Where |
|---|---|---|
| Paper, Purpur, Spigot, Folia | Chunky plugin | Plugins page (search "Chunky") |
| Fabric | Chunky mod + Fabric API | Mods page |
| Forge, NeoForge | Chunky mod | Mods page |
You can also download it from Modrinth or Hangar. Restart the server after installing it.
All commands below are typed in the Console without the leading /. In-game, add / in front and make sure you are an operator.
Pre-generate the world
Make a backup
Pre-generation writes a lot of data. Create a backup first and check that you have enough free disk space (see the table further down).
Choose the world and the area
By default Chunky works on the Overworld, centered on 0 0. Set the area with a radius in blocks:
chunky world world
chunky center 0 0
chunky radius 5000chunky radius 5000 generates a square from -5,000 to +5,000 on both axes (10,000 × 10,000 blocks). Use chunky spawn to center on the world spawn instead, or chunky shape circle for a round area.
Start
chunky startThe console shows the progress, the speed and the estimated time left. Type chunky progress at any time to see where it is.
Do the Nether and the End (optional)
When the Overworld is done, select another dimension and start again. Nether coordinates are 8 times smaller, so a smaller radius is enough:
chunky world world_nether
chunky radius 1000
chunky startOn Paper the worlds are usually called world_nether and world_the_end. On Fabric and Forge, use minecraft:the_nether and minecraft:the_end.
Pause, continue and cancel
| Command | What it does |
|---|---|
chunky pause | Pauses and saves the progress. Use it when many players are online. |
chunky continue | Continues a paused or interrupted task. |
chunky cancel | Stops the task for good (chunks already made are kept). |
chunky progress | Shows the progress in-game. |
chunky silent | Turns the progress messages on or off. |
chunky quiet 30 | Prints progress only every 30 seconds. |
Restarts stop the task
After a restart (for example a daily restart from Schedules), Chunky doesn't continue on its own. Type chunky continue, or set continue-on-restart: true in plugins/Chunky/config.yml (in the config folder on Fabric/Forge) so it resumes automatically.
Radius or world border?
A pre-generated area doesn't stop players from walking past it. Beyond the edge, chunks are generated live again. To keep everyone inside the area, pair Chunky with a world border:
worldborder center 0 0
worldborder set 10000
chunky worldborder
chunky startchunky worldborder copies the border's center and size into Chunky, so it generates exactly the area players can reach. Note that the world border size is the full width (10,000) while Chunky uses the radius (5,000).
How long and how much space?
It depends on your plan, the Minecraft version, mods and the terrain, so these numbers are only a rough guide for the Overworld:
| Radius | Area | Chunks | Disk space (approx.) |
|---|---|---|---|
| 2,500 | 5,000 × 5,000 | ~98,000 | 0.5–1.5 GB |
| 5,000 | 10,000 × 10,000 | ~390,000 | 2–5 GB |
| 10,000 | 20,000 × 20,000 | ~1,560,000 | 8–20 GB |
A radius of 5,000 often takes from one to several hours. Modded worlds and world-generation datapacks (like Terralith) are slower and bigger. Bigger worlds also make your backups larger and slower.
Best practices
Start pre-generation when few players are online, for example overnight. Keep view-distance reasonable in server.properties, since pre-generation doesn't fix lag from too many entities or redstone. See Lag & Performance for more tips.
Troubleshooting
The plugin or mod didn't load. Check that you installed the version for your server type and Minecraft version (Fabric also needs Fabric API) and restart the server. Look in the console for errors when it starts.
Pause with chunky pause, wait until players are offline, then chunky continue. If you see OutOfMemoryError, the server needs more RAM or a smaller task.
Cancel the task with chunky cancel, delete unused files or old backups, and generate a smaller radius. Chunky can also delete chunks outside a selection with chunky trim (make a backup first, this can't be undone).
Chunks that were already generated keep their old terrain. Only new chunks get new features. To see them close to spawn, you need a new world or to delete the old chunks with MCA Selector.