ChunkMill

# ChunkMill A **fast, efficient, and easy-to-manage** chunk pregenerator — generate your world **on command** or **on a schedule**, without lagging the players who are online. ChunkMill is a lightweight, **server-side** mod with its **own** high-throughput generation engine. Define reusable pregeneration *tasks*, run them whenever you like (or queue several up), and let ChunkMill grind through them at a pace that keeps your server smooth. Big runs even **resume automatically after a restart**. A map view of what's already been generated is planned for a future update. --- ## Why ChunkMill - **Fast** — generates chunks in tightly-batched bursts and keeps multiple chunks in flight at once, so it pushes hard when there's headroom. - **Efficient** — generated chunks are released as it goes, so a huge run won't balloon memory; it only does the work that's actually needed. - **Manageable** — everything is named, listed, and controllable: define tasks once, run/queue/pause/cancel them, and watch live progress from a clean in-game panel. - **Safe for players** — optional auto-pause means pregeneration never competes with people who are actually playing. --- ## Features - **Named tasks** — define a job once (`dimension`, `square`/`circle`, center, radius) and reuse it: `task add spawn overworld square 0 0 5000`. - **Run on demand or queue** — `run <task>` starts it now, or lines it up behind the current run. - **Time scheduler** — fire tasks (or `pause`/`resume`/`cancel`) on `HH:mm` rules for any days (`all`, `mon-fri`, `sat,sun`, …), timezone-aware. - **Smart throttling** — pick **adaptive** (auto-paces to hold a target ms/tick) or **fixed** (set chunks/tick); both cap how many chunks are generated at once. - **Player-aware** — optionally auto-pause the whole run while players are online, and resume when the server empties. - **Restart-safe** — an in-progress run saves its progress and continues where it left off after a restart or crash. - **In-game control panel** — just `/chunkmill` opens a live, tabbed screen that **doesn't pause your world**, so you watch generation happen in real time: - **Dashboard** — progress bar with a live **chunks/sec rate and ETA**, plus pause/resume/cancel and the upcoming queue. - **Tasks** — run, delete, or **edit** any task in a dedicated form (name, dimension, shape, center, radius). - **Schedule** — build rules with **hour/minute sliders** and clickable **day toggles** (no typing); pick the task from a list that shows each one's details. - **Settings** — engine, throttle, auto-pause, scheduler, and timezone. - **Multi-loader** — one mod for Fabric, Forge, and NeoForge. --- ## Quick start ``` /chunkmill enable /chunkmill task add spawn overworld square 0 0 5000 /chunkmill run spawn /chunkmill status ``` Want it to run itself overnight? ``` /chunkmill settings scheduler true /chunkmill schedule add 01:00 run spawn mon-fri ``` --- ## Commands - `/chunkmill enable | disable | status` - `/chunkmill task add <name> <dimension> <square|circle> <cx> <cz> <radius>` · `task remove|list|info` - `/chunkmill run <task> | pause | resume | cancel` - `/chunkmill queue list | clear` - `/chunkmill settings throttle <adaptive|fixed>` · `mspt` · `chunkspertick` · `maxconcurrent` · `autopause` · `scheduler` · `timezone` - `/chunkmill schedule add <HH:mm> <run|pause|resume|cancel> ` · `list|remove|clear|next` - `/chunkmill` (no arguments) — open the in-game control panel; `/chunkmill help` for the text list --- ## Requirements - **CodxLib** — required companion library (listed under Dependencies; most launchers install it automatically). Make sure it's present, or the mod won't load. - Works on **Fabric**, **Forge**, and **NeoForge** for Minecraft 26.1.2.