Scarlet records what you do in WoW Forever and keeps it on your PC
The addon writes a timestamped line for each thing that happens: a step, a cast, a kill, a death, a coin looted. The desktop app reads those lines and draws your character's overview, timeline, maps, charts and loot tables. Uploading to the website is optional and off until you turn it on.
Download for Windows Version 1.0.1 See a character overview All 252 event codes
Scarlet writes 252 kinds of event lines
Every line has a time to the hundredth of a second, a code and its fields. These codes are the whole format. Pick one to read what it records.
K
A mob died to your group, and whether you landed the killing blow.
Combat
What Scarlet never records
Scarlet does not store free text. Where a window holds someone's words, it keeps a count, a name or a price instead.
| Not recorded | Kept instead |
|---|---|
| Chat text and whispers | Message and word counts per channel. |
| Mail subjects and bodies | Who sent or received it, the money and the items. |
| Auction notification text | The item, the count and the price. |
| The text of UI errors | The error's name and how often it appeared. |
| Support ticket and report text, and who a report was about | That a report was sent, and its type. |
| Guild notes, the message of the day and rank names | Your rank number, and whether you are an officer or the leader. |
| Calendar titles, friend notes and group finder comments | Counts: invites waiting, list sizes, listings found. |
| Other players' GUIDs, account names and account friend tags | Character names only: players you group, trade, mail or roll against, players you inspect and the gear they wear, players a /who search lists, other rows of a battleground scoreboard, and the character a hardcore death notice names. |
| Screenshots | The file name and the time. Scarlet takes none and never reads one. |
Your own chat is kept as counts too. Scarlet counts each lol and rip you type and stores the number, not the sentence.
The capture map: 789 of 4,132 client data points are recorded
The capture map lists every function and event the WoW Forever client documents, build 1.60.1.70959, and the globals its own interface calls that the documentation leaves out, sorted by what they are about. A data point is an event, or a function that returns a value. Interface plumbing such as frames, settings and sound is listed on the map and not counted here.
- 4,132
- data points in the capture map
- 3,343
- left out, each with a written reason
- 789
- recorded by Scarlet
recordedleft out, with a reason
The desktop app draws the log as a timeline, a heatmap, maps and loot tables
The app has eight views: Overview, Activity, Timeline, Sessions, Map, Charts, Compress and Settings. The figures here are drawn from the demo session and the demo character on this site.
Timeline: the state you were in at each moment
Activity: play time by day
0over 4h
Loot: drop rates and who looted what
| Creature | Item | Loot rule | Looted | Drops | Rate |
|---|---|---|---|---|---|
| Reed Stalker | Stalker Hide | solo | 212 | 131 | 62% |
| Reed Stalker | Cracked Fang | solo | 212 | 88 | 42% |
| Fellcrag Mauler | Thick Bear Pelt | group loot, 2 players | 64 | 21 | 33% |
| Fellcrag Mauler | Mauler's Clasp | group loot, 2 players | 64 | 3 | 5% |
| Old Rimeclaw | Rimeclaw Talon | group loot, 2 players | 2 | 2 | 100% |
| Character | Items | Uncommon | Rare | Epic | Rolls won | Lost | Passed |
|---|---|---|---|---|---|---|---|
| Maren-Ashlow | 1,904 | 212 | 19 | 1 | 31 | 22 | 14 |
| Tovin-Greywake | 412 | 58 | 7 | 0 | 24 | 27 | 9 |
| Isolde-Fennmoor | 187 | 31 | 4 | 1 | 12 | 10 | 6 |
The log is plain files on your PC
The addon writes compressed chunks
In game, lines collect in a buffer and are sealed into compressed chunks in the addon's SavedVariables file. The game rewrites that file on
/reload, logout or disconnect.The companion exports them
scarlet exportreads every account folder and writes a readablescarlet.txt, compressed payloads and CSV tables underout/Name-Surname/.The app reads the folder
The desktop app opens
out/and can run the export itself. It keeps its settings next to the exe.
out/
Maren-Ashlow/
scarlet.txtevery event, one readable line each
payloads/
412-431.sclone export run, compressed
tables/
events.csvevery event with its place and tags
sessions.csvstart, end, class and levels
names.csvids to names
stats.csvcharacter stats over time
statistics.csvthe client's Statistics panel
drops.csvdrop rates per creature and loot rule
attribution.csvwho looted what
- The addon keeps up to 8 MB of chunks and warns in chat at 6 MB. Past that it drops the oldest, so the companion tracks which chunks it has already exported.
- Lines not yet sealed are saved with the file on reload, logout or disconnect, and sealed at the next login.
- A client crash writes no SavedVariables. Lines since the last save are lost.
- A field the client marks secret is written as
?.
The demo character Maren Ashlow has 96 hours of play on record
The overview shows experience by level and source, gold, dungeon runs, deaths and every session, all drawn from invented data.