Leaderboards
19 ranked categories across Daily, Weekly, Monthly, and All-Time windows — /lb to browse them all.
Imperium tracks 19 ranked categories across 4 time periods (Daily, Weekly, Monthly, All-Time). Every block you break, every Denarius you earn, every kill you score feeds a public leaderboard that the whole server can browse with /leaderboard (or /lb). The top three in each category earn medals — gold, silver, bronze — and bragging rights. Achievements and quests tie directly into leaderboard placement, so climbing the boards is also how you unlock the endgame reward tracks.
How to Check a Leaderboard
The command family is short and tab-completes every option:
| Command | What it does |
|---|---|
/lb | Opens the leaderboard GUI (default: Blocks Mined, All-Time). Browse visually with clicks. |
/lb <category> | Opens the GUI for a specific category (e.g. /lb kills). Defaults to All-Time. |
/lb <category> <period> | Full GUI lookup — e.g. /lb denarius_earned weekly. |
/lb top <category> | Prints the top-10 text leaderboard to chat (great for screenshots and Discord). |
/lb top <category> <period> | Chat top-10 for a specific window — e.g. /lb top prestige_level all_time. |
Category and period names are flexible — case-insensitive, and spaces, hyphens, or underscores are all accepted. denarius earned, Denarius-Earned, and DENARIUS_EARNED all resolve to the same category.
All 19 Categories
Each category is color-coded in chat. Hover any row in the GUI for its current leader and your own rank.
| Category | Color | What it tracks |
|---|---|---|
Blocks MinedBLOCKS_MINED | yellow | Every block broken anywhere — public mines, PVP Mine, enchants that "break" blocks all count. |
Denarius EarnedDENARIUS_EARNED | gold | Total Denarius income from all sources (mining, enchants, bounties, casino wins, etc.). |
Auctoritas EarnedAUCTORITAS_EARNED | green | Auctoritas token income from mining, enchants, and rewards. |
Civitas CollectedCIVITAS_COLLECTED | aqua | Civitas (legion beacons) collected from events, legions, and crates. |
Quests CompletedQUESTS_COMPLETED | light_purple | Daily quests, story chapters, and other quest systems finished. |
Battle Pass TierBATTLE_PASS_TIER | dark_purple | Current-season Battle Pass tier reached. |
PvP KillsKILLS | red | Confirmed PvP kills (general world + Colosseum). |
Legion CivitasLEGION_CIVITAS | blue | Civitas balance of each legion (used to rank the guilds). |
Prestige LevelPRESTIGE_LEVEL | aqua | Current prestige tier — the long-game ladder. |
Pyrobolus UsedBOMB_USES | dark_red | Activations of the Pyrobolus mass-detonate ability. |
Achievement PointsACHIEVEMENT_POINTS | gold | Points earned from unlocking achievements (see Achievements). |
Collection ScoreCOLLECTION_SCORE | green | Percent-complete across every collection category. |
PVP Mine EarningsPVP_MINE_EARNINGS | red | Denarius earned specifically inside the PVP Mine. |
PVP Mine BlocksPVP_MINE_BLOCKS_MINED | dark_red | Blocks mined inside the PVP Mine. |
PVP Mine KillsPVP_MINE_KILLS | dark_red | Kills scored inside the PVP Mine (separate from general PvP Kills). |
Items SoldITEMS_SOLD_TOTAL | gold | Items sold through the Sarcina, /sellall, and the shop. |
Enchant ProcsENCHANT_PROCS_TOTAL | light_purple | Total number of enchant effect triggers across your pickaxe. |
Boosts ActivatedBOOSTS_ACTIVATED_TOTAL | aqua | Personal and server boosters activated. |
Boost Time (s)BOOST_TIME_TOTAL_SECONDS | blue | Total seconds of boosted playtime accumulated. |
The 4 Time Periods
Every category is ranked independently across four windows. The same player can be #1 All-Time and #50 Weekly — periods are completely separate ladders, not just filters.
| Period | Reset window | Best for |
|---|---|---|
DailyDAILY | Resets at 00:00 UTC | Sprint rankings — best for daily grinders and event chasers. |
WeeklyWEEKLY | Resets Monday 00:00 UTC (ISO week) | The most-watched competitive window — most tournaments and rewards roll weekly. |
MonthlyMONTHLY | Resets on the 1st at 00:00 UTC | Long-form grind — rewards the most consistent players. |
All TimeALL_TIME | Never resets | The permanent record. Hall-of-fame rankings. |
All reset times are in UTC. The week boundary uses the ISO standard (Monday-start), and the month boundary is the first day of the calendar month — both at 00:00 UTC.
How Stats Get Recorded
Leaderboard stats are buffered in memory and flushed to the database asynchronously, so they never slow down gameplay. Two paths feed the boards:
- Live events — when you break a block, kill a player, or earn Denarius, the corresponding service calls
LeaderboardService.recordStat(). Small amounts accumulate in memory until they cross a 100-unit threshold, then flush in batch. - Periodic flush — every 5 minutes (6,000 ticks) the scheduler flushes all unflushed session stats and forces a full cache refresh. This is also when the cache invalidates across server processes (Redis pub/sub) so bungee-network stats stay in sync.
This means the leaderboards you see are at most ~5 minutes stale. If you just hit a major milestone and don't see it reflected, wait for the next refresh tick — the data is recorded, just not yet queried.
Caching & Refresh
Each (category, period) pair is cached for 5 minutes after first query. Subsequent lookups in that window are instant and DB-free. The 5-minute scheduler also forces cache.invalidateAll() + a Redis broadcast, so a leaderboard that nobody has viewed in a while might take one extra tick to populate on first read — but it will always be fresh after that.
Admins can force a refresh with the equivalent of /lb refresh (or by reloading). Cross-process invalidation goes through the cache-invalidation Redis channel named leaderboard, so all servers in the network refresh simultaneously.
Rewards for the Top Spots
There is no automatic per-leaderboard Denarius payout, but rank placement unlocks reward paths throughout the server:
- Achievement Points ladder — landing top-3 in any category feeds the Achievement Points leaderboard via achievement unlocks (e.g. "Reach #1 Weekly Blocks Mined").
- Prestige leaderboard — prestige tier directly determines your rank in the Prestige Level board, which gates cosmetics, titles, and endgame enchants.
- Vote Top — voting-related leaderboards (separate system) pay out monthly Aureus prizes; see Voting.
- Killstreak & PVP Mine leaderboards — feed the bounty economy; top killers become prime bounty targets and earn trophy-scaled kill rewards. See Killstreaks and PvP Mine.
- Seasonal festival bonuses — top weekly performers often get bonus Denarius or Civitas during festivals; check Festivals for the active multiplier.
The Top 3 Medals
Chat leaderboards visually highlight the podium:
| Rank | Color | Medal |
|---|---|---|
| #1 | Gold (<gold>) | 🥇 First place — the category leader |
| #2 | Gray (<gray>) | 🥈 Silver |
| #3 | Bronze (<#b87333>) | 🥉 Bronze |
| #4–#10 | White (<white>) | Listed, but not on the podium |
Picking a Category to Climb
Not all categories are equally contested. The All-Time Blocks Mined board is dominated by veterans with months of playtime; the Weekly PVP Mine Kills board turns over completely every Monday. To find a board you can actually win:
- New players — target Daily boards. They reset every 24 hours, so a single focused session can put you on the podium.
- Mid-game miners — the Weekly Blocks Mined and Weekly Denarius Earned boards reward consistent play more than marathon sessions.
- PvPers — PVP Mine Kills (Weekly) and Killstreak milestones are the most dynamic; a single hot streak can carry you.
- Endgame — Prestige Level and Achievement Points are the only true long-game boards; they take months to climb.
Watch the Boosts Activated and Pyrobolus Used boards for early signals of who is going to dominate the next Denarius/Blocks cycle — those activities prime a big mining session.
Quick Reference
| Setting | Value |
|---|---|
| Number of categories | 19 |
| Number of periods | 4 (Daily, Weekly, Monthly, All-Time) |
| Total unique leaderboards | 76 (19 × 4) |
| Cache TTL | 5 minutes per (category, period) |
| Forced refresh interval | 5 minutes (6,000 ticks) |
| Stats flush threshold | 100 units per category, per player |
| Top-N shown | 10 (default) |
| GUI command | /leaderboard (alias /lb) |
| Chat top-10 command | /lb top <category> [period] |
| Reset timezone | UTC |