EssentialsX (+ VaultUnlocked 2.20.3)
collector-essentials · version 0.6.0 · registers as essentials · CI 2026-09-25
EssentialsX collector.
Runs in the background because of the balance top ranking: calculateBalanceTopMapAsync() reads every account. We don't trigger it — EssentialsX refreshes it on its own — we read its cache and publish its age, so a stale total shows up instead of passing for a stable economy.
The Gini coefficient says in one number whether the economy is concentrated in a handful of players. 0 = everyone has the same, 1 = one player has everything. It's the kind of thing a top-ten ranking never shows.
Install
Put vania-metrics-collector-essentials-0.6.0.jar in the plugins folder, next to the core and to EssentialsX (+ VaultUnlocked 2.20.3), then restart. The collector depends on both: without EssentialsX (+ VaultUnlocked 2.20.3) it stays disabled, and the core keeps running.
- Target plugin: EssentialsX (+ VaultUnlocked 2.20.3) 2.22.0 — latest for Minecraft 1.21.11: 2.22.0
- Built against: core v0.6.0
- Download: vania-metrics-collector-essentials-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 21
- Latest CI: success · 2026-09-25 21:29 UTC · commit
20cf404· run
Platforms
| Platform | Target plugin | Collector | Latest CI |
|---|---|---|---|
| Paper | yes | Passed | paper ✓ |
| Purpur | yes | Passed | purpur ✓ |
| Folia | no | n/a | — |
| 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_economy_accounts
gauge currency
Accounts with a balance.
mc_economy_balance
gauge currency quantile
Balance distribution. quantile = p50|p90|p99|max.
mc_economy_cache_age_seconds
gauge currency
Age of EssentialsX's ranking cache. If it keeps rising, the displayed total is stale.
mc_economy_gini
gauge currency
Wealth concentration, from 0 (equal) to 1 (one holder).
mc_economy_total
gauge currency
Money in circulation, across all accounts.
mc_server_players_afk
gauge
Players connected but idle.
mc_server_players_afk_seconds
histogram
How long they've been idle. Distinguishes "three players away for two minutes" from "three players away for six hours".
Configuration
In metrics.properties, or as environment variables. See Configuration.
| Key | Default | Environment variable |
|---|---|---|
collector.essentials | true | VANIA_METRICS_COLLECTOR_ESSENTIALS |
collector.essentials.interval | 60 | VANIA_METRICS_COLLECTOR_ESSENTIALS_INTERVAL |