WorldGuard

collector-worldguard · version 0.6.0 · registers as region · ✓CI 2026-09-25

WorldGuard — protected regions, and what they deny.

Two kinds in one module, deliberately: region COUNT is state, polled; denied PvP is an event, counted. Splitting them would mean two jars for one plugin, which the "one jar per plugin" layout forbids.

Region count is polled in the background: RegionManager.size() is cheap, but it requires walking every world, and a region created ten seconds ago doesn't matter to the second.

Install

Put vania-metrics-collector-worldguard-0.6.0.jar in the plugins folder, next to the core and to WorldGuard, then restart. The collector depends on both: without WorldGuard it stays disabled, and the core keeps running.

• Target plugin: WorldGuard 7.0.17 — latest for Minecraft 1.21.11: 7.0.17 (7.0.18+ drops 1.21.11)
• Built against: core v0.6.0
• Download: vania-metrics-collector-worldguard-0.6.0.jar, with its SHA-512, from the v0.6.0 release
• Collects: in the background, every 60 s — reading the plugin's state never blocks a scrape
• Tested on: Java 25
• Latest CI: success · 2026-09-25 21:34 UTC · commit 3f8dba3 · 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	no	–n/a	—
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_region_count

gauge world

Declared protected regions, per world.

mc_region_pvp_denied_total

counter

Player-vs-player attacks denied by a region. A FRICTION counter: if it climbs, players are fighting where they can't.

Configuration

In metrics.properties, or as environment variables. See Configuration.

Key	Default	Environment variable
collector.region	true	VANIA_METRICS_COLLECTOR_REGION
collector.region.interval	60	VANIA_METRICS_COLLECTOR_REGION_INTERVAL