Skip to content
Plugins

Chunkizev1.1.0

Pythonby ozorical, niko-at-chalupaChunkize is essentially 'Chunky' but for MCBE-Endstone Servers.

pip install https://github.com/ozorical/Chunkize/releases/download/v1.1.0/endstone_chunkize-1.1.0-py3-none-any.whl
Stars
9

PLUGINSCHUNKIZE

# Install

C:\Users\you\bedrock_server\plugins\endstone_chunkize-1.1.0-py3-none-any.whl

Use the animation for reference. Follow the plugin's README for exact steps.

# README

Chunk pregeneration for Endstone Bedrock servers, made by ozz.

Generate your world ahead of time so players never hit chunk generation lag. Works like Chunky does for Java edition, but built for Bedrock Dedicated Server.

How it works

Bedrock Dedicated Server has no API to load or generate chunks directly. Chunkize works around that by driving the vanilla /tickingarea command. The target region is split into chunk-aligned batches, and each batch gets a temporary ticking area which forces the server to generate those chunks. Chunkize listens for chunk load events to know when a batch has loaded, then holds the area for a settle period so generation can fully finish, and stamps every chunk with a touch-and-restore block write so the server is guaranteed to save it to disk. Only then is the ticking area removed and the next batch started, spiraling outward from the center until the whole region is generated.

Progress is saved to disk, so a server restart or crash picks up right where it left off.

Installation

  1. Download the latest .whl from the releases page.
  2. Drop it into the plugins folder of your Endstone server.
  3. Restart the server.

Or build it yourself:

pip install build
python -m build

The wheel lands in dist/.

Commands

CommandDescription
/chunkize start <radius> [dimension] [centerX] [centerZ] [shape]Start pregenerating. Radius is in blocks. Run as a player and it defaults to your position and dimension, from console it defaults to overworld around 0, 0. Shape is square (default) or circle.
/chunkize pausePause the current task.
/chunkize resumeResume a paused task, even after a restart.
/chunkize cancelCancel the task and wipe saved progress.
/chunkize statusShow progress, speed and ETA.
/chunkize configOpen the speed mode picker (in game), or /chunkize config <light|medium|intense> from the console.

Examples:

/chunkize start 5000
/chunkize start 3000 nether
/chunkize start 10000 overworld 0 0 circle

Chunkize running in game

Speed modes

/chunkize config opens a pop up to choose how hard Chunkize works the server. The choice is saved and used for every future generation. Medium is the default until you pick one.

The /chunkize config mode picker

ModeRateUse it when
Light~10 chunks/sThe server has players on and you want generation barely noticeable.
Medium~50 chunks/sBalanced, the default.
Intense~150 chunks/sEmpty server or strong hardware, generate as fast as the server allows.

Rates are approximate and depend on your hardware. Each mode sets the underlying generation settings below; you can still override any individual key in config.toml for fine control.

Configuration

plugins/chunkize/config.toml is created on first run. The speed keys are set by the chosen mode, listing them here only for advanced overrides.

KeyDefaultDescription
cellChunks8Side length of each batch in chunks. A batch plus its margin has to fit a ticking area, which caps out at 100 chunks, so this is capped at 10 - 2 x edgeMargin.
edgeMargin1Extra chunks loaded around every batch. Bedrock only finalizes a chunk once its neighbours are loaded too, so without a margin the chunks on each batch edge stay unfinished and show up as holes. Leave this at 1.
minActiveAreas1Fewest ticking areas to keep running, even when the server is busy. The generator never throttles below this.
maxActiveAreas8Most ticking areas to run at once. Chunkize ramps up toward this while the server has headroom and backs off when it doesn't. Bedrock allows 10 per world, leave headroom if your server uses its own.
targetMspt45Server load target in milliseconds per tick. The generator adds ticking areas while the server stays under this and sheds them when it goes over. 50 ms is the 20 TPS budget, so a lower value keeps more headroom for players.
checkIntervalTicks5How often the generator checks progress and rotates batches.
cellTimeoutSeconds60How long to wait on a batch before retrying it, then skipping it.
settleSeconds2How long a batch keeps its ticking area after every chunk in it and its margin has loaded, so the server can finish and persist them. Raise it if you still see patchy spots.
maxRadius50000Safety cap for the radius argument.
flushIntervalChunks512Flush the world save to disk after this many generated chunks, so unsaved chunks cannot pile up in memory. 0 disables the cycle.
autoResumetrueContinue an interrupted task automatically after a restart.
logIntervalSeconds30Progress log interval in the console, 0 to disable.
saveIntervalSeconds30How often progress is written to disk.

CRABSMP mode

Set under [crabsmp] in config.toml. With it on, Chunkize never loads, generates or touches anything within crabsmpRadius blocks of x=0 z=0, no matter what you pass to /chunkize start. Start from 0 0 and it simply begins outside the zone.

KeyDefaultDescription
enabledfalseTurn the exclusion zone on.
crabsmpRadius400Half-width of the protected square around 0, 0, in blocks. The protected area is rounded outwards to whole chunks.

The batch margins respect the zone as well, so nothing inside it is loaded even as a neighbour. Chunks right against the zone edge can never be finalized (the neighbours they need are inside the zone), so Chunkize leaves them alone rather than half generating them. They generate normally if a player ever walks there.

Permissions

PermissionDefaultDescription
chunkize.commandopAccess to /chunkize.

Good to know

  • Generation speed self-tunes to the server. Chunkize watches milliseconds per tick and runs more ticking areas in parallel while there is headroom, then backs off as load rises, so it goes fast on an idle server and gets out of the way when players are on. Raise maxActiveAreas for more top speed on strong hardware, or lower targetMspt to keep it gentler.
  • Generated chunks stay in RAM until the server saves them. Chunkize flushes the save on a cycle so the backlog stays bounded, if you still see memory pressure lower flushIntervalChunks or maxActiveAreas.
  • The flush uses the vanilla save hold / save resume cycle. If you run a backup tool that uses the same commands, schedule backups outside generation runs.
  • The world keeps its ticking area budget while Chunkize runs. If your server already uses several ticking areas, lower maxActiveAreas so the total stays under 10. Areas left behind by a crash are cleared on startup.
  • Every batch loads a one chunk margin around itself, because Bedrock will not finalize a chunk until its neighbours are loaded. That is what keeps the edges of each batch from being written half finished.
  • Already generated regions are processed much faster than fresh terrain, since loading is cheaper than generating.
  • Nether radius is in nether blocks. A 1000 block nether radius covers the same map area as 8000 overworld blocks.

License

MIT, see LICENSE.

© 2023–2026 EndstoneMC

Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.