Realmly Add-on — Retail

0.8.6: Zone/interior notifications no longer break a trail when coordinates
remain on the same map. Flight and indoor movement checkpoints stay connected;
real map changes, login/reload, coordinate loss and long gaps remain separate.
Existing character IDs and records are preserved.

0.8.5: Preserves story events without coordinates; gathering and map pins still
require real positions. Smarter journey samples skip repeated stationary points,
keep five-minute checkpoints and mark recording interruptions. The dashboard's
Today tab summarises UTC quests, gathering, level-ups, deaths, zones and memories.
Both games use release 0.8.5. Existing character IDs and saved records are kept.

Compatibility: WoW Retail 12.1.5 (interface 120105).

Record your World of Warcraft Retail adventures for Realmly. This addon keeps
its data separate from the WoW Forever collector.

Install
-------
1. Extract the ZIP into:
   World of Warcraft\_retail_\Interface\AddOns\
2. Confirm the resulting folder is:
   World of Warcraft\_retail_\Interface\AddOns\Realmly\
3. Launch Retail and enable "Realmly Add-on Retail" from AddOns.

Commands
--------
/rao                 Open the Realmly dashboard.
/rao herb Peacebloom
/rao mining Copper Vein
/rao travel Stormwind Flight Master
/rao rare Example Rare
/rao service Example Vendor
/rao quest Example Quest
/rao export          Open the JSON export window.
/rao count
/rao id
/rao clear confirm

The dashboard shows the current character, level, total discoveries, quest,
profession, gathering and journey counts. It also gives you buttons to export the JSON,
copy the permanent Adventurer ID, or clear this character's local records
(which requires typing CLEAR on Help & tools).

Your two primary professions are recorded automatically when first detected, and
newly learned professions are picked up as you play. Quest acceptance and completion are recorded automatically, including indoors when no map position is available. Herb and mining nodes are also recorded automatically
after a successful gathering cast, using the node you had targeted. Retail's
gathering tracker reads the node from UNIT_SPELLCAST_SENT, with a guarded world
tooltip fallback, and records it only on successful completion. If the client
hides the node name, a confirmed gathering spell is recorded generically.
Interrupted and failed gathers are not counted. Realmly does not request the
restricted combat log; automatic rare-kill detection is unavailable on Retail.
Deaths use PLAYER_DEAD without guessing a killer. Manual commands remain available. Other entries
can still be recorded manually with the commands above. Type /rao, choose Export
JSON, copy the JSON, save it in a .json file, then upload it through Realmly.

Realmly also records level-ups, takes a compact equipped-gear snapshot at export,
and samples your journey once per minute while moving. Stationary positions
are kept only as a five-minute checkpoint; zone changes and interruptions
start separate recorded trail segments. The first
rare and first epic item found after tracking begins are recorded as milestones.

The former /wfar command remains as a compatibility alias.

Every recorded discovery also keeps a snapshot of the other (up to four)
members in your party at that moment: their character name, realm where available,
and class. It does not read friends, guild, or account information.

Exports include a Retail marker so the uploader can keep them separate from
Forever records. Both game versions are supported by Realmly.

Upgrading from the earlier Atlas addon
---------------------------------------
Realmly writes Realmly.lua. Upload your existing
WoWForeverAtlasRetail.lua file once at https://realmly.me/upload before
removing the old add-on if it contains sessions not yet uploaded. Remove the
WoWForeverAtlasRetail folder before installing Realmly, so only one collector
runs.
STORY MOMENTS (0.8.0)
---------------------
First recorded zone/dungeon visits, close calls where health is readable,
new abilities and applied talent choices, recipes, first crafts and recurring
party companions are now tracked where the client exposes the needed APIs.
Use /rao moment Your memory here to add a bookmark (up to 240 characters).
Use /rao diagnostics or the Tracking dashboard button for live tracker status.
No combat-log access is requested on Retail. Existing saved records are kept.
