AltProgress — Addon Overview

AltProgress is a lightweight, account-wide weekly progress tracker for World of Warcraft (Interface 120100 / 120105). The game client can only read data for the character you are currently logged in on — AltProgress snapshots each alt's data on login and stores it locally, so you can check every character's weekly status from anywhere, without logging out and back in.

Why it exists

If you play multiple alts, answering "who still has vault slots open, who hasn't spent their crests, who still needs a raid clear" normally means logging into each character one by one. AltProgress turns that into one window.

What it tracks (6 modules)

How you open it

• Slash commands: /ap or /altprogress (also /ap collect, /ap minimap, /ap lang, /ap font, /ap wipe, /ap debug, /ap raid)
• Minimap icon: left-click toggles the window, right-click forces a re-collect

Interface

A single left-hand menu holds everything: Overview (one row per character, all six data points side by side), one entry per character (sectioned detail page), and Settings. Chinese and English locales are both built in and switchable in-game.

Design notes worth knowing

• Version-resilient. Crests are matched by name, not hardcoded currency IDs, so a new season does not break collection. Raids are driven by a single whitelist table; Mythic+ dungeon short names have a suffix-stripping fallback.
• Server data is requested, then collected on a delay. Vault, raid lockouts, and M+ are empty at login — each module requests first, collects after 1–6 s, and re-checks once more as a safety net.
• Weekly reset aware. Stale data is discarded at render time using the server's weekly reset timestamp, so Monday's numbers never linger into Wednesday.
• Collection and UI are decoupled. Modules only write to the saved-variable table and then announce a tab name; the UI decides whether a redraw is actually needed. Adding a data source never requires touching the UI, and vice versa.
• Safe with Chinese clients. All files are UTF-8 without BOM, and fonts are mirrored from system font objects rather than hardcoded Latin font paths.

AltProgress — 插件简介

AltProgress 是一款轻量级的《魔兽世界》账号级周常进度追踪插件（支持 Interface 120100 / 120105）。游戏客户端只能读取当前登录角色的数据，AltProgress 在每个角色登录时把关键数据快照存到本地，之后在任意角色上都能一眼看清所有小号本周还差什么，不必反复切号。

解决什么问题

多号玩家每周都要回答"谁宝库还没开、谁纹章还没花、谁团本还没清"。传统做法是一个个登录确认，AltProgress 把它压缩成一个窗口、一张表。

采集六项数据

打开方式

• 斜杠命令：/ap 或 /altprogress（另有 /ap collect、minimap、lang、font、wipe、debug、raid）
• 小地图图标：左键开关窗口，右键立即重新采集

界面结构

左侧一列菜单搞定全部导航：总览（每个角色一行，六项数据横向排开）、各角色详情页（分区明细）、设置。内置中英双语，可在游戏内切换。

设计亮点

• 不怕版本更新：纹章按名称关键词识别，不硬编码 currencyID；团本由一张白名单表驱动；大米副本简写带后缀剥离兜底。赛季轮换不必查数据库改代码。
• 服务器数据一律"先请求、再延迟采集"：宝库、团本锁定、大米数据在登录瞬间都是空的，各模块先 Request，延迟 1~6 秒采集，并追加一次兜底重采。
• 周重置严格判定：用服务端周重置时刻在渲染前二次校验，跨过重置的旧数据整块丢弃。
• 采集层与 UI 解耦：模块只写存档表并声明一个页签名，由主窗口判断是否真的需要重绘 —— 加采集项不用改 UI，加页面不用改采集。
• 中文客户端安全：全部文件 UTF-8 无 BOM，字体采用镜像系统字体对象的做法，不硬编码拉丁字体路径。