Skip to content

Pregeneration

pop4959 edited this page Jan 2, 2023 · 12 revisions

Set-up

Pre-generating chunks using Chunky is extremely easy. Most servers pre-generate to avoid unnecessary lag loading chunks and for creating clean looking map renders of their world.

If you haven't already, install Chunky.

A few notes before continuing:

  • Try to pre-generate before players join your server. Not only is it usually faster, but you avoid any possible gameplay impact.
  • Be mindful that larger worlds tend to use a significant amount of disk space and take a very long time to generate. If in doubt start with a smaller radius like 5000 first and increase it later if you need to. You can also use a tool like tgb's World Size Calculator to get a rough estimation of world size.
  • Chunky commands are usually run through the server console. If you don't have access to the console or you are using Chunky in-game, don't forget to add a leading slash / before each command.
  • If you have a map plugin installed, you may want to disable it temporarily while pre-generating. This will usually make the process faster and produce better looking maps. See map rendering for more details.

Start your server, and type chunky to make sure it installed successfully.

When everything is working normally you will see a help menu show up. If you don't see this, double check that everything was installed properly, and that you have permission to access the command.

Pre-generating

To start pre-generating, you need to select the region first that you want to pre-generate.

The world, shape, center, and radius can all be changed as part of your region selection.

Here's a simple example if you just want to select and pre-generate a radius of 5000 blocks:

chunky radius 5000
chunky start

Let's also start pre-generating the nether with the same radius.

To do this, you just need to change the world.

The exact world or dimension name may vary depending on your setup and the version of Chunky you installed, however it will generally either be:

  • world or overworld for the overworld
  • world_nether or the_nether for the nether
  • world_the_end or the_end for the end
chunky world world_nether
chunky start

Yeah, it's actually just that easy.

For more advanced usage refer to the full list of commands.

For questions, visit us in the #chunky channel on our Discord server.

Checking progress

When you run chunky start you will start receiving update messages in console that report pre-generation progress. This includes information such as the number of chunks processed, percent to completion, ETA (estimated time remaining in hours:minutes:seconds), the generation rate in chunks per second (cps), and the location of the current chunk being generated.

Not seeing update messages? These are usually shown in the server console. If you are using a client to pre-generate, you may need to enable the "output log" in your launcher, or use the chunky progress command.

Large selections can take a very long time to pre-generate. Take a look at the ETA, and if it seems unreasonable consider restarting the task with a smaller radius.

You can pause tasks at any time using the chunky pause command. When you're ready to continue, type chunky continue.