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/stop stay 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.