ChunkGenerator

ChunkGenerator is a focused pre-generation plugin for Paper, Purpur and Folia. It generates world chunks in a chosen shape around any center point, adapts to your server's actual TPS in real time, and keeps the BossBar honest about progress, speed and ETA — without crashing the server when the chunk system saturates.

---

Why ChunkGenerator

• Adaptive, not reckless. A TPS-aware controller scales the inflight chunk pipeline up while your TPS holds and down the moment it slips. No fixed chunks-per-tick budget to misconfigure.
• Auto-tunes to your host. Start it with all defaults: the plugin reads availableProcessors() and maxMemory() at boot and picks a safe pipeline depth for your CPU and JVM heap. The resolved values are logged at startup along with the Paper tuning recommendation for your core count.
• OOM-safe. A memory-pressure circuit breaker scales the pipeline down past a configurable heap threshold and pauses new submissions entirely past the next, resuming automatically once the GC catches up. Specifically designed to survive container hosts (Pterodactyl, Docker) with aggressive MaxRAMPercentage.
• Survives restarts. Per-world progress is persisted atomically to YAML and resumed automatically when the server comes back up.

Features

• Pre-generation jobs over square, circle or rectangle zones with an optional explicit center (defaults to world spawn).
• One job per world; multiple worlds generate in parallel.
• Live BossBar for staff (chunkgenerator.bossbar), compact ActionBar for the player who launched the job, and a periodic console progress line with inflight/target, chunk/s, TPS, CPU and RAM readings.
• /cg status snapshots with progress percent, speed, ETA, server TPS, process CPU and JVM RAM usage.
• Pause / resume / cancel mid-flight with state preserved across restarts.
• Paper, Purpur and Folia all supported. Folia is handled through a reflection-based scheduler bridge so the plugin keeps a pure Paper-API compile classpath.
• LuckPerms integration with /op fallback when LuckPerms is absent.

Commands

Command	What it does
/cg start <world> <shape> <size> [centerX centerZ]	Start a job (shape = square / circle / rectangle).
/cg stop <world>	Pause a running job (state preserved).
/cg resume <world>	Resume a paused job.
/cg cancel <world>	Cancel and discard a job's state.
/cg status [world]	Live snapshot of progress, perf and pipeline.
/cg list	List all known jobs.
/cg reload	Reload config.yml and messages.yml.

Alias: /chunkgen.

Configuration

config.yml is split into a short Basics block (target-tps, bossbar / actionbar / console toggles, auto-resume) and an Advanced throttle section that most servers never need to touch. All player-facing strings live in messages.yml with the standard & color codes.

Maximising throughput

The plugin keeps Paper's chunk request queue saturated, but the real ceiling is Paper's chunk worker count, not the plugin's queue depth. Open config/paper-global.yml and raise:

chunk-system:
  worker-threads: <cores - 1>   # e.g. 5 on a 6-core host
  io-threads:     3

The default -1 is "auto", which usually allocates only around
cores / 2 workers — perfectly safe for a populated survival
server, but leaves most of the CPU idle during pre-generation. The
plugin prints the recommended values for your host in the startup
log.