Chunky
collector-chunky · version 0.6.0 · registers as pregen · CI 2026-09-25
Chunky — pregeneration progress.
SHORT-LIVED METRIC, and that's expected: it's meaningful during a generation, and nothing the rest of the time. A pregeneration runs for hours and saturates disk and CPU; knowing where it stands avoids confusing "the server is lagging" with "the server is working".
CHUNKY DOES NOT EMIT BUKKIT EVENTS. It has its own bus, reached through a Bukkit service, subscribed to via onGenerationProgress. The subscription happens once, at hookup — Chunky offers no way to unsubscribe, which has no consequence here since the module lives as long as the server.
Install
Put vania-metrics-collector-chunky-0.6.0.jar in the plugins folder, next to the core and to Chunky, then restart. The collector depends on both: without Chunky it stays disabled, and the core keeps running.
- Target plugin: Chunky 1.4.40 — latest for Minecraft 1.21.11: 1.4.55
- Built against: core v0.6.0
- Download: vania-metrics-collector-chunky-0.6.0.jar, with its SHA-512, from the v0.6.0 release
- Collects: on events, as they happen
- Tested on: Java 21
- Latest CI: success · 2026-09-25 21:27 UTC · commit
399eebc· run
Platforms
| Platform | Target plugin | Collector | Latest CI |
|---|---|---|---|
| Paper | yes | Passed | paper ✓ |
| Purpur | yes | Passed | purpur ✓ |
| Folia | yes | Passed | folia ✓ |
| Spigot | yes | Passed | spigot ✓ |
| CraftBukkit | yes | Passed | bukkit ✓ |
| Sponge | yes | Not yet | — |
| Velocity | no | n/a | — |
| BungeeCord | no | n/a | — |
| Waterfall | no | n/a | — |
| Geyser | no | n/a | — |
See the compatibility matrix for every collector at once.
Metrics
mc_pregen_chunks_done
gauge world
Chunks generated for the current task.
mc_pregen_chunks_total
gauge world
Chunks to generate for the current task.
mc_pregen_progress_ratio
gauge world
Pregeneration progress, from 0 to 1. Absent when nothing is running.
mc_pregen_tasks_finished_total
counter world
Pregenerations completed.
Configuration
In metrics.properties, or as environment variables. See Configuration.
| Key | Default | Environment variable |
|---|---|---|
collector.pregen | true | VANIA_METRICS_COLLECTOR_PREGEN |