Changelog

All notable changes to AchievementTracker are documented in this file.

The format is based on Keep a Changelog, and the project adheres to Semantic Versioning.

Unreleased

0.1.0 - 2026-06-08

First release. Sibling project to MountTracker, reusing the same architecture (Core sandbox/DB/version/waypoint shell, virtualized list UI, minimap button, slash commands, CI + release pipeline), with a difficulty-curation roadmap on top.

Added

• Project skeleton mirroring MountTracker. .toc, shared namespace, SavedVariables, slash commands (/achtrack, /atr, /achievementtracker), minimap button and the scrollable roadmap window — but without the glow (achievements have no "hidden eligibility") and without the 3D model (achievements have no model; the detail panel uses the large icon + the criteria list).
• Achievement scanner (Logic/AchievementScanner.lua): walks every category (GetCategoryList / GetCategoryInfo / GetCategoryNumAchievements), reads each achievement's account-wide completion and partial criteria progress (GetAchievementCriteriaInfo), and attaches the curated overlay by achievementID.
• Difficulty model — the heart (Logic/Difficulty.lua): derives a tier and a difficulty score from the curated dimensions (group/effort/rng/access/skill
  • gated prerequisites) plus live progress. Lower score = easier/solo = top of the roadmap. Tiers: Easy·Solo, Medium, Grind/Long-term, Group, Hard/RNG, Unobtainable, Uncurated.
• Roadmap ordering (Logic/Roadmap.lua): sorts by score (easiest/solo first), with near-complete achievements bubbling up on ties; filters by category, expansion, current zone, and the toggles Solo only / Show completed / Show unobtainable.
• Curated difficulty overlay schema (Data/Schema.lua) + a seed sample (Data/Achievements_Sample.lua). Uncurated achievements still appear, in a neutral tier, until classified.
• Curation validator (tools/validate.lua) + CI (Lua 5.1 syntax + data integrity) and a tag-driven Release workflow (GitHub Release + CurseForge), matching the MountTracker pipeline.
• Incremental (non-freezing) scan. The roadmap is built in the background with a per-frame time budget (coroutine), so the window opens instantly and fills in as it loads — even across thousands of achievements. Completed achievements skip the costly criteria read. The scan runs once on first open and only rebuilds when you earn an achievement (no constant re-scanning).
• Category → Subcategory filter (resolved from the game's category tree) plus a Current zone filter — so the filter bar no longer overflows with one giant list.
• Obtained = colored, missing = gray icons, matching the MountTracker convention.
• Old-content-soloable rule: an achievement curated as legacy-soloable (e.g. an old raid boss you can solo today) counts as solo in the score and tier, so it ranks as an easy win. Optional effortMinutes (estimated from comments) breaks ties among the easy ones.
• Curation toolkit (tools/atcurate/, mirroring MountTracker's mtcurate/): polite cached HTTP, and extractors that read Wowhead comments for the average time to finish and difficulty hints (solo/group/RNG), emitting reviewable Lua suggestions.
• First real curated batch — Fishing (Data/Achievements_Fishing.lua, 49 entries): generated from the live dump + Wowhead comments, then normalized by domain rules (fishing is solo, no mechanical skill; conservative accessibility).
• English (en-US) interface throughout.

Notes

• Targets Midnight 12.0.5 (## Interface: 120005).
• Zero dependencies (pure Blizzard API). Handles Midnight "Secret Values" safely.
• Errors are sandboxed — no mid-screen Lua error popups.
• Difficulty curation is incremental: only Fishing is curated so far; other categories appear in a neutral Uncurated tier until classified.