Achievements

How to Open the Achievement GUI

Achievement Types

Every achievement is one of three types, set in achievements.yml:

The 7 Categories

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 event hooks include:

• Block break → increments all mining achievements
• Money / tokens / beacons earned → increments economy
• Prestige up → sets the prestige tier counter
• Enchant applied → increments enchants
• Pet / tag / cosmetic / armor unlocked → sets collection counters
• Quest completed → increments social
• DTC participate / win, event participate → increments events
• Collection category percent-complete → sets a percent milestone

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 tier" or "total pets unlocked" where the value can go up but 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. Prestige-tier achievements display their target tier.

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.

Claiming Rewards

You do not need to claim. The instant an achievement completes:

1. Currency rewards (money, tokens, beacons) are deposited directly to your account via EconomyService with the reason achievement:<id>. Check your balance for the credit.
2. Command rewards (often a server broadcast, sometimes a free item grant) run from the console. {player} in the command is substituted with your name.
3. A title flashes on your screen: "Achievement Unlocked!" with the achievement name.
4. An action bar message: "+X achievement points earned!"
5. A sound plays — the vanilla Minecraft challenge-complete toast sound.
6. The achievement-points leaderboard gets your point contribution added (see Leaderboards).

Example Achievements

A sample across categories to give you a sense of scale:

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. The /ach top command shows the top-10 all-time:

• 🥇 #1 — gold, the server's top collector
• 🥈 #2 — silver
• 🥉 #3 — bronze

Because Hidden achievements award big point values (150, 200, 350, 500), the leaderboard is dominated by players who have explored the entire game — not just miners. To climb, aim for breadth across all 7 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.
• Don't ignore Events. The events tab is one of the smallest categories but the easiest to complete — show up to DTCs, envoys, and drop parties.
• Collection is broader than you think. Pets, tags, cosmetics, AND armor sets all count — buying a full armor set in the token shop is a quick collection milestone.
• The hidden ones are endgame. "Fossor Divinus" (10M blocks) and "Croesus Reborn" ($1B earned) are the two highest-point hiddens — neither will land by accident.
• 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