Atlas Companion v1 — Setup Instructions
========================================

This does two things:
  1. A WoW addon (AtlasTracker) that logs your position and quest
     progress as you play.
  2. A small program that runs on your PC alongside WoW, reads what
     the addon saved, and sends it to our shared database so we're
     building up map/quest/boss-ability knowledge as a guild.

Nothing here reads game memory or automates anything — it only reads
files WoW itself already writes (same category of thing tools like
Details! or Warcraft Logs rely on), and only sends data out over a
normal HTTPS connection, same as any website.


STEP 1 — Install the addon
---------------------------
Copy the "AtlasTracker-addon" folder into your WoW AddOns folder, and
rename it to just "AtlasTracker" (drop the "-addon" part). It should
end up looking like:

  World of Warcraft\_classic_beta_\Interface\AddOns\AtlasTracker\
      AtlasTracker.lua
      AtlasTracker.toc

Then in-game, type /reload (or just log in fresh). You should see a
message in chat: "Atlas Tracker loaded, X position samples, Y quest
events saved so far."

If it shows as disabled/out-of-date in your AddOns list at character
select, there's a checkbox there to allow out-of-date addons — check
it and it'll load fine.


STEP 2 — Install Python (skip if you already have it)
--------------------------------------------------------
The companion program needs Python. If you don't have it:
  1. Go to python.org/downloads
  2. Download and run the Windows installer
  3. IMPORTANT: on the first install screen, check the box that says
     "Add Python to PATH" before clicking Install


STEP 3 — Configure the companion program
-------------------------------------------
Open "config.ini" in this folder with Notepad. Check that "wow_path"
matches where WoW is actually installed on your PC — the default
assumes the normal install location, but if you installed it
somewhere else, update that line to match. Leave api_url and
api_token as they are.


STEP 4 — Run it
-----------------
Double-click "run_atlas_companion.bat". A window will open and stay
running — leave it open in the background while you play WoW. It
checks for new data every 10 seconds and uploads it automatically.
You'll see lines like "uploaded 12 position samples" when it finds
new data to send.

Close the window (or Ctrl+C) when you're done playing. It's safe to
just leave it running the whole time you're in WoW, or start/stop it
whenever.


Questions? Ask in the guild Discord.
