Chunksmith
An adaptive chunk pre-generator that paces generation to your server's disk - build large areas ahead of time without saturating I/O or freezing the server. A maintained fork of Chunky.
📖About Chunksmith
Chunksmith is a Minecraft chunk pre-generator that paces generation to keep your server healthy — it builds large areas ahead of time without saturating your disk or freezing the server.
A hardened fork of Chunky by pop4959, GPL-3.0, maintained by Kishku7.
Why Chunksmith?
A heavy pre-generation can peg disk I/O and leave a server unresponsive to pause/stop — or, on an empty server, send it to sleep mid-run. Chunksmith is built to generate safely under real-world conditions:
- Adaptive I/O throttle — concurrency is steered by live server tick-health (Fabric, NeoForge, Paper): it backs off the instant the server falls behind and ramps back up as it recovers, with a per-chunk latency backstop against disk stalls.
- Run it 24/7 — even with players online. Generation yields capacity the moment the server gets busy and reclaims it as load eases. No scheduling for off-hours, no emptying the server first — leave it running and it stays out of players' way.
- Memory-stable on huge runs — entity-section retention is bounded, so heap stays flat through multi-thousand-block radii (even with mobs loaded) instead of ballooning into a watchdog crash.
- Write-queue backpressure — it holds off dispatch when the deferred region-write backlog grows, so generation can't outrun your disk;
pause/stopstay instant and a crash can't strand a huge write queue. - Conflict-safe & drop-in — adopts your existing configuration on first run, and if the original generator is present it steps aside automatically (disables it on Paper/Bukkit, warns on Fabric/NeoForge).
Real-world impact
Pre-generating a multi-million-chunk overworld on a spinning HDD:
| Stock Chunky | Chunksmith | |
|---|---|---|
| Disk during pre-gen | ~95-100% (pegged) | ~2-5% |
pause under load |
seconds-to-minutes of lag | instant |
| Generation rate | choked by disk thrash | higher |
Same hardware, same world — Chunksmith generates faster while leaving the disk almost idle.
Commands
/cs (with /chunksmith as a full alias).
/cs start— pre-generate the selected area/cs pause— pause (resumable)/cs continue— resume a paused task/cs progress— rate / ETA / throttle status
Licensed under GPL-3.0. Original work by pop4959; Chunksmith maintained by Kishku7.