Loading...
Install and use Chunky to pre-generate Minecraft chunks, reduce exploration lag, set a world, center, shape, and radius, and monitor or pause generation.
Install Chunky through the GaleniusNodes Plugin Installer on Paper, Purpur, or Spigot, then select the world, center, shape, and radius before running `chunky start` from the console. Start with a smaller radius, monitor disk usage and progress, and use `chunky pause` if the server becomes overloaded.
Minecraft normally generates terrain as players explore. Generating chunks can create CPU and storage spikes, especially when several players travel quickly in different directions. Chunky pre-generates a selected region so that terrain already exists when players reach it.
Pre-generation does not increase the server's view distance or keep every chunk loaded. It creates terrain files in advance so the server does less generation work during exploration.
Create a complete backup before installing Chunky or starting a large generation task. Pre-generated worlds can consume significant disk space, and the required space grows rapidly as the radius increases.
A radius is measured from the center to the edge, not across the full width. A square with a 5,000-block radius covers approximately 10,000 by 10,000 blocks.
For Paper, Purpur, and Spigot servers, use the GaleniusNodes Plugin Installer to search for Chunky and install a release compatible with the server's Minecraft version. If the required release is unavailable, use the manual method.
| Server platform | Chunky file location | Additional requirement |
|---|---|---|
| Paper, Purpur, Spigot, Bukkit | /plugins/ | Use the Bukkit-compatible Chunky release |
| Fabric | /mods/ | Fabric API is also required |
| Forge or NeoForge | /mods/ | Use the build made for the loader and Minecraft version |
| Folia or Sponge | Platform-specific plugin or mod folder | Confirm support on the Chunky download page |
chunky in the console to confirm that the help menu appearschunkyConsole commands do not need a leading slash. When running Chunky commands in-game, use /chunky and make sure your account is an operator or has the required permissions.
Chunky pre-generates one selected world at a time. Select the overworld or another dimension before configuring the region.
chunky world world| Dimension | Common world names |
|---|---|
| Overworld | world or overworld |
| Nether | world_nether or the_nether |
| End | world_the_end or the_end |
World names vary by server software, configuration, and modpack. Use the exact folder or world name used by your server.
Define the region that Chunky should generate. A typical public survival server uses the world spawn or coordinates 0 0 as the center, a square or circle shape, and a radius based on the intended world border.
chunky center 0 0
chunky shape square
chunky radius 5000
chunky selection| Command | Purpose |
|---|---|
chunky center 0 0 | Centers the region at X 0, Z 0 |
chunky spawn | Centers the region at the selected world's spawn |
chunky shape square | Generates a square region |
chunky shape circle | Generates a circular region |
chunky radius 5000 | Sets a 5,000-block radius |
chunky selection | Displays the current selection before starting |
After reviewing the selected world, center, shape, and radius, start the task from the server console.
chunky startThe console reports chunks processed, completion percentage, estimated time remaining, chunks per second, and the current generation location. Large selections may run for hours or longer.
Do not repeatedly restart the server during generation. If you need to stop the task safely, pause it first and wait for the confirmation message.
| Command | Action |
|---|---|
chunky progress | Displays current task progress |
chunky pause | Pauses tasks and saves their progress |
chunky continue | Resumes current or saved tasks |
chunky cancel | Cancels tasks; generated chunks remain on disk |
chunky quiet 5 | Limits progress messages to one update every five seconds |
chunky progress
chunky pause
chunky continueThe Nether and End are separate worlds and are not generated by an overworld task. Select each dimension and start another task. A smaller Nether radius is often sufficient because one Nether block corresponds to eight overworld blocks for portal coordinate scaling.
chunky world world_nether
chunky shape square
chunky center 0 0
chunky radius 625
chunky startWhen the server already has a vanilla world border, Chunky can copy its center and radius into the current selection.
worldborder center 0 0
worldborder set 10000
chunky worldborder
chunky selection
chunky startThe vanilla worldborder set command uses the full diameter, while chunky radius uses the distance from the center to the edge.
| Symptom | Likely cause | What to do |
|---|---|---|
| Unknown command | Chunky did not load or the wrong platform build was installed | Check startup logs and install the compatible Chunky release |
| No permission | The in-game account is not an operator or lacks Chunky permissions | Run commands from the console or grant the required permission |
| Generation is extremely slow | Large radius, complex generator, active players, map renderer, or limited resources | Pause the task, reduce load, or restart with a smaller radius |
| Disk usage is too high | The selected area is larger than expected | Pause generation, review the radius, and increase storage or use a smaller selection |
| Progress messages are missing | Messages are hidden or the task is not active | Run chunky progress and check the server console |
| Wrong world is generating | The selected Chunky world is incorrect | Pause or cancel the task, run chunky world <name>, review the selection, and restart |
| Server becomes unresponsive | Pre-generation is competing with gameplay or other heavy tasks | Pause Chunky and continue during a maintenance window |
Pre-generation is complete when Chunky reports 100%, the server remains stable, and players can explore the selected region without triggering large amounts of new terrain generation.
Chunky generates Minecraft chunks before players explore them. This moves expensive world generation to a controlled task and can reduce lag spikes when players travel into new terrain.
Chunky mainly reduces lag caused by generating new terrain during exploration. It does not fix entity overload, slow plugins, insufficient hardware, excessive view distance, or other performance problems.
Start with a radius that matches the area players realistically need. The official Chunky guide recommends starting smaller, such as 5,000 blocks, when uncertain. Larger radii take longer and consume substantially more disk space.
They can, but pre-generation consumes CPU, storage, and memory resources. Running it before launch or during a quiet maintenance period usually completes faster and avoids gameplay impact.
Use `chunky pause` to save and pause current tasks. Resume them later with `chunky continue`. Use `chunky cancel` only when you want to cancel the task; already generated chunks remain on disk.
Progress is normally displayed in the server console. You can also run `chunky progress` to view active tasks, completion percentage, estimated remaining time, and generation rate.
Yes. Chunky publishes builds for multiple platforms, including Bukkit-based servers, Fabric, Forge, NeoForge, Folia, Sponge, and others. Install the build made for your exact platform and Minecraft version.
Yes. Each world or dimension is a separate generation target. Select the Nether or End world with `chunky world`, choose an appropriate radius, and start another task.
Generation speed depends on CPU performance, storage speed, world-generation complexity, other plugins or mods, active players, and the selected radius. Disable unnecessary map rendering during generation and consider a smaller area.
Chunky has a separate trim command, but trimming deletes generated chunks and should not be treated as part of normal pre-generation. Create a backup and follow Chunky's official trimming documentation before using it.
How to Install Plugins on a Minecraft Server
Install Minecraft plugins with the GaleniusNodes plugin installer or manually on Paper, Purpur, and Spigot. Includes compatibility checks and troubleshooting.
Read guideHow to Change Your Minecraft Server Version
Change your Minecraft server version with the GaleniusNodes version changer. Learn how to back up your world, choose compatible server software, and fix common startup errors.
Read guideHow to Use SFTP on a Minecraft Server
Connect to your Minecraft server with SFTP and FileZilla. Learn where to find GaleniusNodes credentials, upload worlds and server files, and fix connection errors.
Read guideInclude your Minecraft version, server software or loader, plugin or mod URL, and the first console error.