RealisticNode Docs

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 typeWhat to installWhere
Paper, Purpur, Spigot, FoliaChunky pluginPlugins page (search "Chunky")
FabricChunky mod + Fabric APIMods page
Forge, NeoForgeChunky modMods 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 5000

chunky 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 start

The 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 start

On 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

CommandWhat it does
chunky pausePauses and saves the progress. Use it when many players are online.
chunky continueContinues a paused or interrupted task.
chunky cancelStops the task for good (chunks already made are kept).
chunky progressShows the progress in-game.
chunky silentTurns the progress messages on or off.
chunky quiet 30Prints 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 start

chunky 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:

RadiusAreaChunksDisk space (approx.)
2,5005,000 × 5,000~98,0000.5–1.5 GB
5,00010,000 × 10,000~390,0002–5 GB
10,00020,000 × 20,000~1,560,0008–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

On this page