Chunksmith

# Chunksmith **Need help or found a bug?** Report it at the (https://github.com/Kishku7/mod_support/issues). Chunksmith is a Minecraft chunk pre-generator that generates chunks quickly, efficiently, and **safely**. On top of fast pre-generation it adds an adaptive I/O throttle (so it keeps generating around the clock even with players online), region write-backpressure protection, and worldgen diagnostics (overreach detection and structure-fault attribution). Ships as a **Fabric, Forge, and NeoForge mod** and a **Paper / Spigot / Folia plugin**. Originally derived from Chunky by pop4959; now developed independently. Licensed GPL-3.0. **Environment:** required on the server (or in singleplayer, where "server" is the integrated server running inside your own game); the client install is **optional**. Pre-generation alone needs nothing on the client. But if you want **multiplayer LOD** - players seeing pregenerated Distant Horizons / voxy terrain at a distance without having walked it - Chunksmith has to be on the client too, no separate mod. See (#lod-see-what-you-pregenerated) below, especially (#one-mod-all-of-it). **Running the plugin with modded clients works.** A Paper / Spigot / Purpur / Folia server with the Chunksmith **plugin**, and players on Fabric or NeoForge with the Chunksmith **mod** plus Distant Horizons or voxy, is a supported setup: the plugin serves LOD to those clients, from **3.15.0** onwards. You do not need a modded server to get multiplayer LOD. (Before 3.15.0 the plugin built the LOD data but had no way to send it, so this looked broken - if you are on an older build, update the server.) **Source code:** (https://github.com/Kishku7/Chunksmith/tree/CSv3) - the 3.x line, where current development happens. The 2.x line is frozen on (https://github.com/Kishku7/Chunksmith/tree/CSv2_archive). ## Why Chunksmith - **Fast.** Pre-generates chunks ahead of time so they are ready before players arrive, eliminating the lag of on-demand generation. - **Safe under load.** An adaptive throttle watches server tick-health and backs off automatically, so generation can run while players are online without tanking TPS. - **Tunable throughput.** `dispatchMaxConcurrent` controls how many chunk requests stay in flight. It defaults to a value scaled to your CPU and is settable live with `/cs set` - on an 8-core dedicated server, raising it from the old fixed 50 to 200 measured **+39%** (31.6 to 43.9 chunks/sec). - **It stops when your server cannot take it, and starts again when it can.** Instead of stuttering along under load, a run pauses with a stated reason and resumes once the server has been healthy for a grace period. A manual `/cs pause` always outranks it. - **Flexible shapes.** Generate by square, circle, diamond, triangle, star, and more - centered on coordinates, world spawn, or the world border, by radius or diameter. - **Multi-world**, with live progress, rate, ETA, and an optional boss bar. - **Resumable.** Pause, continue, cancel, and continue-on-restart - progress is saved. - **World trimming.** Delete chunks outside a selected region. - **LOD generation, on by default.** Install Distant Horizons or Voxy and Chunksmith builds their distant-horizon data while it pregenerates. No config file to find first - see below. - **A re-run fills LOD holes automatically.** Pregenerated the world before you installed the renderer? Run the same pregen again and Chunksmith builds the LODs from the chunks it already has - it does not regenerate them, and it skips everything that is already done. - **Multiplayer LOD, built in.** Players joining your server download the pregenerated LOD data and see the whole world at distance, without ever having walked it. **No companion mod** - the same Chunksmith jar does it, on the server and on the client. - **Developer API** for generation progress and completion events. ## LOD: see what you pregenerated Chunksmith emits level-of-detail data while it pregenerates, in its own neutral format (CSLOD), and hands it straight to a LOD renderer. ### It turns itself on **If a LOD renderer is installed, LOD generation is ON.** Chunksmith looks for **Distant Horizons**, **Voxy**, or a **Voxy fork** in the game when the server starts, and if one is there it builds the LOD data as it pregenerates. There is no config key to find, nothing to switch on, and no "why are there no LODs?" - install the renderer, install Chunksmith, pregenerate, and the distant terrain is there. It is **also on for a dedicated server**, which is the one case where nothing local can draw an LOD: a dedicated server runs no renderer of its own, but the store it builds is exactly what it serves to its players (see multiplayer, below). Building it is the whole reason it is there. If nothing in the game can use LOD data - no renderer, and not a dedicated server - C