MMO Skill Tree & Abilities

v0.16.0

Achievements

WoW-style long-term progression that tracks silently as you play — kill mobs, break blocks, craft, level up, catch fish, complete quests, take fall damage, earn XP. No "accept" step. Open with /mmoachievements or the new tab on /xp.

• ~200 defaults across Combat / Gathering / Crafting / Exploration / Misc, plus a five-tier leveling track (Novice → Master) auto-generated for every registered skill — including custom ones
• Chained tiered achievements - Related tiers (First Blood → Warlord, and similar chains for mining, woodcutting, fishing, harvesting, crafting, building, elite kills, and mob-specific tracks) group into named chains. Your list shows only the current active tier — unlock Tier 1 and Tier 2 takes its place. Pinning keeps any specific tier visible; search finds any tier. Keeps the list clean over hundreds of hours
• "Unlocks Next" on the detail page - Previews the next tier's name, requirement, and rewards. Side panel shows every tier of the chain with checkmarks
• 35+ new quest / survival / progression achievements - Complete quests (1 → 1,000), dailies (5 → 1,000), weeklies (1 → 250), repeatables (10 → 10,000), fall damage (100 HP → 250K HP), deaths (1 → 2,000), total XP (10K → 100M). Daily/weekly/repeatable classification is derived from each quest's cooldown — existing quest configs just work
• Points + milestone rewards - Each unlock grants points. Crossing 300 / 1,500 / 5,000 / 12,000 / 22,000 thresholds unlocks bronze / silver / gold / platinum / diamond reward bundles (XP shards and global XP boosts). Thresholds are scaled to the ~27,000-point pool across the 238 default achievements — Bronze for a casual few unlocks, Diamond for ~80% completion. Customisable in mods/mmoskilltree/achievements/point-milestones.json
• Manual reward claiming with inventory check - Achievement and milestone rewards now split into two lists: auto rewards (XP, boost tokens, broadcast commands) fire on unlock, while manual rewards (item drops) wait for a yellow CLAIM REWARDS button. Pressing CLAIM runs a combined inventory-space check across every /give in the bundle — if you don't have room, you'll see "Not enough inventory space to claim!" and the rewards stay pending. No more lost loot from a packed inventory at unlock time. Reward rows on the details page show inline tags (Auto / Pending / Claimed / Locked); milestone cards show three states (progress / READY / CLAIMED)
• Meta-achievements - Chain smaller goals into a capstone that unlocks when every child is unlocked. Cascades through meta-of-metas; cycles and missing children are caught at load and disabled with a clear log line
• Multi-criteria achievements - Require multiple different conditions — e.g. Renaissance Warrior (100 melee kills AND 50 Skeletons AND Defense 25). Each criterion tracks its own progress and label; unlocks only when ALL complete
• Server-First achievements - First player on the server to complete one earns a gold "SERVER FIRST" badge; everyone else sees "Claimed by ". Persistent across restarts
• Feats of Strength - Rare trophy achievements that don't count toward your point total or milestones. Appear in their own section, hidden until earned
• Hidden, pinned, searchable - hidden: true keeps secret goals off the list until unlocked. Pin up to 5 in-progress achievements to rise to the top of the list and show on the /xp Tracked panel. Search by name, description, or criterion text
• Subcategories - Categories split into subs (Combat → Melee / Ranged / Bosses; Gathering → Mining / Woodcutting / Fishing / Harvesting; Misc → Quests / Survival / Progression). A second tab row narrows browsing
• Per-achievement broadcast commands - Each achievement can run a console command on unlock with {player} and {achievement} placeholders. Silent by default; difficult defaults broadcast server-wide
• Achievement-gated quests - Require one or more achievements via "requiredAchievements": ["ach_id"] or a structured prerequisites block with AND/OR alongside quest and permission prereqs. Locked quests show the requirement on their row
• Public API - Subscribe via MMOSkillTreeAPI.addAchievementListener(...) and read progress through isAchievementUnlocked, getAchievementProgress, getAchievementPoints. Events fire on the world tick thread — Store/Ref ops safe without world.execute
• Off-thread progress tracking - Progress updates in an in-memory cache on a worker thread and flushes every 30s + on disconnect. A busy server with many achievements pays almost nothing in tick time
• /mmoconfig achievement admin commands - award [--force], revoke, reset, progress, reload, list, pin / unpin
• Global master toggle - The admin settings page gains an Enable Achievements switch alongside the existing Enable Quests / Enable Item Rewards toggles. Flip off to instantly freeze the whole achievement subsystem (no tracking, no unlocks, no claim button, the Achievements tab disappears from cross-page nav); flip on to resume immediately — no restart
• Config directory - mods/mmoskilltree/achievements/ with _defaults/ regenerated every start as a reference. Drop your own JSON to override; defaults are skipped when user files exist

Default Achievement Overhaul

The full achievement default set has been rebalanced and expanded:

• Per-skill leveling chains - Every skill's five milestones (Novice / Apprentice / Veteran / Expert / Master at levels 10 / 25 / 50 / 75 / 100) now group into a single chain per skill, so the list stays clean as you climb. Tiers 1–4 grant flat skill XP (250 / 1,500 / 10,000 / 50,000 XP); Tier 5 (level 100) grants both 250,000 XP and a 2.5× celebratory boost for 2 hours
• 23 Server-First achievements - Race for Crown of the Realm (first to level 50 in every skill), Sovereign of Skills (first to 75 in every skill), Master of All (first to 100 in every skill — hidden), plus one per-skill server-first at level 100 for all 20 skills ("First Mining Master", "First Swords Master", etc.). Each winner gets a gold badge; the all-skills firsts grant huge flat XP bundles plus multi-hour boosts
• Six new ore-mining chains - Copper, Iron, Silver, Gold, Mithril, and Adamantite each get a four-tier progression (Novice → Legendary at 200 / 1,000 / 5,000 / 25,000 ore mined). All variants of each ore (biome-specific blocks like basalt or shale) now correctly count toward progress
• Legendary tier extensions - Legendary Lumberjack (100,000 wood), Legendary Angler (25,000 fish), and Legendary Harvester (50,000 crops) join the existing Legendary Miner as the top tier of each gathering chain
• Two new meta-achievements - Legendary Gatherer (unlocks when you complete Legendary Miner, Lumberjack, Angler, and Harvester) and Legendary Warrior (unlocks via Warlord, Force of Nature, and Legendary Slayer). Each awards 1,000,000 All XP and a 3× All Skills boost for 4 hours on claim
• Reward mix rebalanced toward flat XP - Most mid-tier achievements now grant permanent flat skill XP instead of temporary boost tokens. Temporary boosts are reserved for top-tier chain caps, meta-achievements, server-firsts, and the Silver / Gold / Platinum / Diamond point milestones — and every one of those celebratory rewards now also grants flat XP alongside the boost, so claiming them always leaves you with something permanent

Persistent Statistics

• Lifetime per-player counters across 11 categories: mobs defeated, blocks broken/placed, items crafted / picked up, damage dealt/taken, deaths, fish caught, XP earned, seconds played. Per-item breakdowns track which mobs, blocks, and skills — ready for reporting UIs and leaderboards via the public API

Three-column Menu UI

The four main menu pages (/xp, /mmoachievements, /boosts, /mmoquests) widen and gain a context-specific right-side panel. Left stays cross-page navigation, centre keeps list/content, right shows "at a glance" info:

• Achievements — lifetime statistics with top-3 breakdowns (mobs, blocks, fish, crafted items, per-skill XP)
• XP — up to 5 pinned achievements and up to 5 tracked quests, each with live progress bars; click a row to jump to its page
• Boosts — active-boost stack, always visible
• Quests — tracked quests with live progress bars (same tracker surfaced on the XP page)

Also added:

• Overview landing - /mmoachievements opens to a summary: recent unlocks with dates, achievements closest to completion, category completion grid, progress toward the next milestone. Browse All is one click away
• Rich rows + detail view - Unlock dates (ISO), compact reward previews on every row, "Details >" button to a full page with per-criterion bars, clickable meta-child chips, and related achievements. Multi-criteria rows now show each criterion inline under the aggregate bar. Back from a Details page returns to your exact filter state
• Navigation parity - All four menu pages expose the same full nav (Overview, skill categories, Leaderboard, Boosts, Quests, Achievements, Settings, Admin)

Quest Tracking

• Track up to 5 quests - Track button on each active quest row. Tracked quests show on the /xp side panel below tracked achievements, with a completed/total objectives bar. Over-cap toast at the limit; auto-disappear on complete or abandon. Clicking a tracked quest opens the Quests page directly

Bug Fixes

• Fixed false "total level X item rewards available" notification spam - The notification was firing on nearly every level-up once a player reached a configured total-level reward threshold, even when every reward at that tier was already claimed or when the configured rewards wouldn't appear on the Rewards page at all. Opening /xp > Rewards would show nothing to claim. The notification now matches the Rewards page exactly — it only fires when there's a reward you can actually see and click CLAIM on. The same fix applies to per-skill level-up reward notifications