Architecture

Data plugins own disk writes. Display plugins read through accessors. The client writes SavedVariables; those files leave the machine, land in the warehouses, and AI reads them for theorycrafting.

System

High level — two paths off the same files. Top: files ingested straight to the warehouse. Bottom: a resident service exposes the same files through an API, which reads and writes the same database.

WoW Client
Anniversary client
→
Addon
DMK suite
→
File System
WTF\…\SavedVariables
→
Database
the warehouse
→
AI theorycrafting
Web — wow-dmk-web
Reporting tools
reads / writes
WoW Client
another session
→
Addon
DMK suite
→
File System
WTF\…\SavedVariables
→
Service
picks up SavedVariables
→
API
queries + commits

In the client

The client stack is three layers. Nothing skips a layer; nothing writes upward. Hover a display plugin to trace what it requires.

Display plugins

14 · render only · own no suite data
↑ read via accessors — never the DBs directly

Data plugins

6 · own disk writes
writes →

SavedVariables

Disk write on logout or /reload only. One DB per data plugin, account-wide or per-character.

{{ savedNote }}
↑ built on

DMK core

lib layer · the one root addon

Config (DMKCoreDB), suite profiles — settings plus window layouts, per-character active profile — and the UI, window-manager, and form libraries every plugin builds from. Plugins publish modules through the shared DMK namespace.

One exception at the edge: Questie, the single third-party runtime source — a read-only bridge in DMK_Map, toggle-gated, native API fallback when absent.

Off the client

The export pipeline. The addon never phones home — the files it writes are picked up from disk.

01 · Disk
SavedVariables

WTF\Account\<Account>\… files land on logout or /reload. Full paths on Documentation.

→
02 · Ingest
Armory + AH ingest

Armory ingest reads the CharData, CharLogs, and RealtimeData files. wow-ah-gen ingests DMKAHDB and clears it after warehouse commit — AHSync never reads its own DB back.

→
03 · Warehouse
My databases

Character snapshots, activity and gold/xp series, combat events, and AH scans committed as queryable history.

→
04 · Consumers
Web + AI

wow-dmk-web is this site. AI reads the warehouse for theorycrafting.

Round trip back into the game: generated DB2 exports (spell data for DamageSimulation; AHCatalog, AHSuffixes, AHLookups for AHSearch) ship inside the addon as static data.

AI theorycrafting

What the models get and what comes back. Placeholder wording — to be replaced with the real pipeline description.

Inputs
Warehouse reads

Character snapshots (gear, stats, talents, professions), combat event history and fight breakdowns, gold/xp series, and current AH pricing per item and suffix.

Processing
Analysis passes

Placeholder — describe what actually runs: models, prompts or jobs, how often, and what questions they answer against the warehouse.

Outputs
Theorycrafting

Placeholder — e.g. gear and loadout evaluation against real prices, spell-rank and rotation analysis from logged fights, upgrade paths per character.