Achievements
63 achievements across 10 categories plus 10 story specials — automatic Civitas payouts and achievement points.
The Imperium achievement system is a long-game collection ladder with 63 achievements across 10 categories - plus the ten story specials (gold-bordered rows in the rank and prestige grids) that track your way through the fifty-chapter saga. Every achievement awards achievement points (which rank you on a global leaderboard) and pays out Civitas - by design, achievements are the social-currency faucet, never an income faucet, so they never pay Denarius or Auctoritas. Achievements are tracked automatically - there is no manual claim step. The instant you cross the requirement threshold, the reward lands in your account, a title flashes on your screen, and a sound plays.
How to Open the Achievement GUI
| Command | What it does |
|---|---|
/achievements (aliases /achievement, /ach) | Opens the achievement GUI on the "all" view, page 1. |
/achievements <page> | Jump straight to a page number - e.g. /ach 3. |
/achievements <category> | Filter to one category - e.g. /ach miner. Valid: miner, enchanter, combat, legion, social, rank, prestige, dungeon, collector, season. |
/achievements top | Prints the top-10 achievement-points leaderboard to chat (all-time). |
/achievements admin give <player> <id> | Admin only - force-completes an achievement for a player. |
/achievements admin reload | Admin only - hot-reloads achievements.yml without a restart. |
The GUI itself carries eight category tabs - All, Mining, Rank, Prestige, Enchants, Collection, Combat, and Social. The dungeon, legion, and season grids are reachable from the All view or by filtering from the command.
Achievement Types
Every achievement is one of three types, set in achievements.yml:
| Type | Behavior |
|---|---|
MilestoneMILESTONE | Visible in the GUI with a live progress bar. You can see the requirement and your current progress at any time. |
Hidden (Secret)HIDDEN | Hidden until you complete it - the description and icon are replaced with "???" so the surprise is preserved. |
PrestigePRESTIGE | Ladder achievements capped at the top of their domain - rank tops at 100, prestige at the 8 active eras. |
Hidden achievements are secrets. They render as "???" in the GUI until you complete them. Don't spoil them for other players - half the fun is the surprise unlock animation and broadcast.
The 10 Categories
| Category | Count | Focus |
|---|---|---|
Miningminer | 8 tiers | Lifetime blocks mined - from Fossor (12M blocks) to Breaker of Hills (353.7M). |
Rankrank | 5 tiers + story specials | Rank level reached - Miles (rank 4) up to Censor (rank 100, the summit of the cursus). |
Prestigeprestige | 5 tiers + story specials | Prestige eras - First Era (prestige I) to Triumphator (prestige VIII). |
Enchantsenchanter | 6 tiers | Total pickaxe enchant levels held - First Inscription (9) to Word-Binder (265). |
Combatcombat | 5 tiers | PVP-mine kills - First Blood (340) to Gladiatrix (10,020). |
Dungeonsdungeon | 5 tiers | Dungeon clears - Delver (5) to Aquilifer (100). |
Legionlegion | 5 tiers | Lifetime legion contribution (blocks + civitas + kills) - Recruit’s Due to Signifer Primus (10M). |
Socialsocial | 5 tiers | Civitas given to other players - Open Hand to Benefactor (50,068). |
Collectioncollector | 4 tiers | Collection codex completion percent - Curious (25%) to Voice of Sibyl (100% + 20 tomes). |
Seasonsseason | 5 tiers | Monthly arc capstones completed - First Arc to Season Hall (all 12 arcs). |
Curved categories (miner, enchanter, combat, legion, social) space their tiers on a no-wall polynomial, so each step is demanding but never a cliff. Ladder categories (rank, prestige, dungeon, collector, season) follow authored ladders capped at the top of their domain.
How Unlocks Work
Achievements are purely event-driven. You never press a button to make progress - Imperium listens for the relevant gameplay event and increments the achievement's progress counter automatically. The metrics behind the hooks:
- Blocks mined (lifetime) → the
minergrid - Rank reached → the
rankladder - Prestige era reached → the
prestigeladder - Total enchant levels on the pickaxe →
enchanter - PVP-mine kills (lifetime) →
combat - Dungeon clears (lifetime) →
dungeon - Legion contribution (blocks + civitas + kills) →
legion - Civitas given to other players →
social - Collection codex completion percent →
collector - Monthly arc capstones →
season - Story chapters → the ten gold-bordered
specialrows
Two accumulation modes are used: addProgress (incremental - used for things like block counts that grow forever) and setProgress (absolute - used for things like "current prestige era" or "codex percent complete" where the achievement tracks the highest value seen).
Tracking Progress
In the GUI, every visible (MILESTONE) achievement shows a live progress bar - current value over the requirement. HIDDEN achievements show only "???" until completion. Ladder achievements display their target step.
For an at-a-glance count of how much you've done, look at the top of the GUI: it shows completed count out of total achievements and your total points out of total possible points. The points math is interesting - your points only count achievements you've completed, so the ratio is a real completion percentage.
Progress is persisted to the database every 2 minutes (2,400 ticks) and on quit, so a server crash never loses more than 2 minutes of achievement progress. The same persistence path uses UPSERT semantics, so re-saving an already-completed achievement is safe.
Claiming Rewards
You do not need to claim. The instant an achievement completes:
- Civitas is deposited directly to your account via EconomyService with the reason
achievement:<id>. Check your balance for the credit. - A title tag is granted where the achievement carries one (tags must exist in
tags.yml- the build validates this). - A title flashes on your screen: "Achievement Unlocked!" with the achievement name.
- An action bar message: "+X achievement points earned!"
- A sound plays - the vanilla Minecraft challenge-complete toast sound.
- The achievement-points leaderboard gets your point contribution added (see Leaderboards).
Completions broadcast server-wide at tier 3 and above; lower tiers are personal-only, so the chat stays clean while the big milestones still make noise. If a reward deposit ever fails (e.g. a DB hiccup at the moment of completion), it is logged at WARNING level with your UUID, the amount, and the achievement ID. The achievement is still marked complete in the DB, so you won't lose progress - but you may need to ask an admin to credit the missing Civitas.
Example Achievements
A sample across categories to give you a sense of scale:
| ID | Name | Category | Requirement | Points | Reward |
|---|---|---|---|---|---|
miner_1 | Fossor | miner | 12,000,000 blocks | 25 | 25 Civitas |
rank_5 | Censor | rank | Reach rank 100 | 125 | 2,000 Civitas |
prestige_5 | Triumphator | prestige | Reach prestige VIII | 150 | 3,000 Civitas |
combat_1 | First Blood | combat | 340 PVP-mine kills | 25 | 50 Civitas |
collector_4 | Voice of Sibyl | collector | 100% of the collection codex + 20 tomes | 100 | 2,000 Civitas |
season_5 | Season Hall | season | All 12 monthly arc capstones | 150 | 3,000 Civitas |
story_first | A Name in the Ledger | rank (special) | First story chapter | 50 | 100 Civitas |
story_scholar | Scribe of the Saga | prestige (special) | Every story chapter | 500 | 5,000 Civitas |
The Achievement Points Leaderboard
Achievement points are themselves a ranked stat - the ACHIEVEMENT_POINTS leaderboard category. Every completed achievement contributes its point value to your lifetime total (25 points at tier 1 up to 500 for Scribe of the Saga). The /achievements top command shows the top-10 all-time:
- 🥇 #1 - gold, the server's top collector
- 🥈 #2 - silver
- 🥉 #3 - bronze
Because the story specials award the biggest point values (100-500), the leaderboard is dominated by players who have explored the entire game - not just miners. To climb, aim for breadth across all 10 categories.
Tips for Completionists
- Check the GUI weekly. New achievements are added with content updates and you might already qualify for ones you haven't seen.
- Feed the social grid. Civitas given to other players is the one metric you control directly - gifting is progression.
- Collection is broader than you think. Pets, tags, cosmetics, AND armor sets all count toward the codex percent.
- The story specials are the endgame. Scribe of the Saga (every story chapter) is worth 500 points - nothing else comes close.
- Watch the points ratio. The GUI header shows your points / total points - the higher that percentage, the closer you are to the leaderboard top.
Quick Reference
| Setting | Value |
|---|---|
| Total achievements | 63 (53 grid tiers + 10 story specials) |
| Categories | 10 (miner, rank, prestige, enchanter, combat, dungeon, legion, social, collector, season) |
| Types | MILESTONE, HIDDEN, PRESTIGE |
| Reward currency | Civitas only (+ title tags) - never Denarius or Auctoritas |
| Claim mode | Automatic (no manual claim) |
| Broadcast gate | Tier 3 and above broadcast server-wide |
| Progress save interval | 2 minutes (2,400 ticks) + on quit |
| Open the GUI | /achievements (aliases /achievement, /ach) |
| Top-10 chat board | /achievements top |
| Filter by category | /ach <miner|rank|prestige|enchanter|combat|dungeon|legion|social|collector|season> |
| Config file | plugins/ImperiumMC/achievements.yml |