GILDED CHRONICLE 0.2.0
======================

Your character's story, recorded as you play: levels, achievements, loot
(green and up), bosses, rares, dungeon runs, quests, deaths, new zones,
discoveries, professions, reputation, mounts, pets, toys, play sessions,
gold and currencies, each with the time, your level and where you were
(map and coordinates). The big moments also take a screenshot.

Works on WoW Forever (1.60.x) and Retail (12.x), on its own or next to
Gilded UI.


OPEN IT
-------
  /chronicle (or /chron)     open or close the Chronicle
  /chronicle settings        which moments take a screenshot
  /chronicle status          what has been recorded, and any errors
  Minimap button             click: open, right-click: settings, drag: move
  Key Bindings > Gilded Chronicle   a key for it

The window: your character on the left, with Timeline, Milestones,
Screenshots and Settings, and filters for the timeline. Moments are
newest first, grouped by day. Hover one for the date, place, coordinates
and level (loot shows the item). Shift-click loot to link it in chat.
Type in Search to find a boss, item, quest or zone.


SCREENSHOTS
-----------
Taken about a second after the moment, so the toast or glow is in it.
Moments close together share one picture. On by default:
  level ups, dungeon and raid bosses, rares/rare elites/world bosses,
  achievements, epic and better loot, first visit to a zone.
Off by default: dungeon or raid finished, random moments (every 30-90
minutes, out of combat and not away). At most 30 per hour, 5 seconds apart.

Your own screenshots (Print Screen) are noted too, with the place and
your target. The game saves the pictures in the Screenshots folder next to
WTF; addons can't read them back, so each note keeps the expected file
name for the desktop companion to pair them up.


WHAT IT CAN'T SEE
-----------------
- Who killed you: the combat log is closed to addons on the modern
  client, so deaths name your hostile target, if you had one.
- In Retail dungeons some chat lines are hidden from addons in combat;
  loot that arrives then can be missed.
- Coordinates: most instances have none; the map is still recorded.
- Zones and played time: counted from the day the addon is installed
  (played time asks the game once per character, which prints one line).


SAVED DATA (for the website and the desktop companion)
------------------------------------------------------
File: WTF\Account\<account>\SavedVariables\GildedChronicle.lua, written
by the game on logout or /reload. Forever and Retail each have their own
WTF folder.

GildedChronicleDB = {
  format = 1,
  settings = { ... },
  maps = { [uiMapID] = { name, parent (uiMapID), type } },
  currencies = { [currencyID] = { name, icon } },
  chars = {
    ["Name-Realm"] = {
      name, realm, class, race, faction, flavor ("forever" / "retail"),
      first = time the Chronicle first saw this character,
      played = { total = seconds, at = time },
      log = { moment, moment, ... },   -- only ever added to: position = id
      daily = { ["2026-11-01"] = {
        played = seconds,
        goldIn  = { loot, quest, vendor, mail, auction, trade, other = copper },
        goldOut = { vendor, mail, auction, training, flights, trade, other = copper },
        items = { [0] = greys, [1] = whites },
        curIn = { [currencyID] = n }, curOut = { [currencyID] = n },
        skill = { [profession] = skill-ups },
      } },
      seen = { zones = { [uiMapID or zone name] = time } },
      run = the dungeon run in progress, session = the session in progress,
    },
  },
}

Every moment has:
  k   kind (below)          t   time (Unix seconds)      lv  your level
  m   uiMapID               x, y  0-10000 (4523 = 45.23%)
  z   zone name             s   subzone name
  shot  screenshot file name, when the moment took one

Kinds and their own fields:
  level    n (new level), played (seconds)
  ach      id, name, pts, desc, icon, account (already earned on the account)
  loot     link, id, q (quality 2-7), n (count, if more than 1),
           src (loot, quest, crafted, bought, mail, fishing, container,
           object, item), from (mob, boss or quest name)
  quest    id, name, xp, money (copper)
  boss     id (encounter), name, diff, size, tries, inst
  rare     name, cls (rare, rareelite, worldboss), level
  run      name, inst, diff, diffName, size, start, dur, bosses {names},
           deaths, wipes, group {"Name:CLASS"} (place = the instance)
  death    by, inst
  zone     name                     area   name, xp (a "Discovered" area)
  skill    name, rank (1 = learned, then every 25)
  rep      faction, standing
  mount / pet / toy   id, name, icon
  shot     file (WoWScrnShot_MMDDYY_HHMMSS.jpg), why (level, boss, rare,
           achievement, epic, zone, run, random, manual; joined by commas),
           target
  session  start, dur, gold (net copper), lv0, lv1 (no place)
