TYR LOOT 0.1.1 — FIRST TEST RELEASE
WoW Forever addon + Windows companion that runs only when you open it.

1. INSTALL THE ADDON
Close World of Warcraft. Copy the TyrLoot folder into the Forever client's
Interface\AddOns folder. The correct client folder contains its own WoW
application, Interface, and WTF folders. Do not install it into Retail.
Enable Tyr Loot at character selection. In-game, type /tyrloot to open it.
This first release targets Forever 1.60.x (Interface 16001).

2. CONNECT TO YOUR DISCORD CHANNEL
Visit https://tyr.seventhlightadventures.com/rosters and sign in with Discord.
Open “Tyr Loot addon & sync”, choose your server and loot library channel,
and select “Download connection file”. Keep the JSON file private: it is
an access credential. It is not a Discord bot token or Blizzard password.
You can revoke the connection on the same page.

3. RECORD AND SYNC
Play a dungeon or raid and open its loot windows. The addon records readable
item drops inside that instance. It does not guess bosses or unseen loot.
Reload the interface (/reload) or log out to save observations to disk.
Open the Windows companion manually, choose the connection JSON, select
WTF\Account\<your account>\SavedVariables\TyrLoot.lua, and select the installed
Interface\AddOns\TyrLoot folder. Click Sync now.

The companion uploads a bounded batch of new observations and downloads the
shared library. If it reports remaining observations, click Sync now again
when instructed. It never schedules itself or keeps syncing after a run.
Close it when done. Reload WoW again to see the downloaded library.

4. OPTIONAL GUILD ROSTER SYNC
In WoW, open /tyrguild and click Capture roster. Tyr reads your own guild's
character names, classes, levels, and rank names. It excludes member notes,
officer notes, and online status. Wait for a successful complete capture;
if the game is still loading guild data, try Capture roster again.
Use /reload to save the capture. In the Windows companion, check
Include captured guild roster, then click Sync now. The checkbox starts off.
Large rosters may need more than one manual sync. The previous shared roster
stays visible until the entire new roster finishes uploading.

View the saved roster with /tyr guild in your sharing channel or in the
website's addon panel. Ranks are shown as captured, not as live guild data.
This does not verify Discord character ownership or assign Discord roles.
The uploader or someone with Manage Server can remove a shared roster on
the website. Clear capture inside the addon removes its local export only.

5. VIEW LOOT
In WoW: /tyrloot opens the searchable local and shared loot browser.
In Discord: /tyr loot in your chosen channel, optionally with search or channel.
On the website: the same addon panel shows the shared loot library.
Only Discord members who can read that channel may access its shared loot.
Revocation prevents future server access; already downloaded files are local
copies, so avoid sharing connection files or private cached libraries.

IMPORTANT LIMITS
Observed drops are unverified observations, not complete loot tables or drop
rates. They do not automatically become event wishlist choices. Reviewed
catalog imports remain a separate step. Raid data can only be recorded when
that content is actually available and the game exposes its loot.

The addon has no internet connection. Transfers require the companion to be
opened by you. Game file updates require /reload or logout. This release has
automated checks but still needs testing inside your actual Forever client
and on Windows. Restricted or missing client APIs may prevent collection.

See the companion's included README for launch instructions and requirements.

UPGRADING FROM 0.1.0
Close WoW and the companion. Replace Core.lua, Browser.lua, TyrLoot.toc and
README.md in the installed TyrLoot folder, and add Guild.lua. Keep your
existing SyncData.lua to retain the downloaded loot library. Replace the
Windows companion files. Your existing connection JSON still works.
Do not delete WTF SavedVariables; your collected loot stays there.
