# Erik – installera AJ Collector 0.10.1 och testa med Hunter

Du behöver en lokal WoW Forever-klient och medlemskap i guilden som är kopplad till er Discord-kanal. GeForce NOW använder i stället det separata makropaketet. Inga API-nycklar eller inloggningsuppgifter ska skrivas in i addonet.

## 1. Installera

1. Hämta: https://bakersguild.se/downloads/AJCollector-0.10.1.zip
2. Stäng spelet och packa upp ZIP-filen. Den innehåller mappen **AJCollector**.
3. I Battle.net: välj **WoW Forever → kugghjulet → Visa i Utforskaren**. Öppna spelversionens mapp där spelprogrammet finns, exempelvis `Wow.exe` eller `WowClassic.exe`, och leta efter `Interface`. Om flera spelversioner finns installerade, välj den som Forever faktiskt startas från.
4. Lägg mappen `AJCollector` direkt i `Interface/AddOns`. Skapa mapparna om de saknas. Slutresultatet ska vara:

   ```text
   Interface/AddOns/AJCollector/AJCollector.toc
   Interface/AddOns/AJCollector/Collector.lua
   Interface/AddOns/AJCollector/Transport.lua
   Interface/AddOns/AJCollector/Commands.lua
   Interface/AddOns/AJCollector/Deaths.lua
   Interface/AddOns/AJCollector/Journal.lua
   Interface/AddOns/AJCollector/JournalMap.lua
   Interface/AddOns/AJCollector/JournalWindow.lua
   Interface/AddOns/AJCollector/Panel.lua
   ```

   Undvik en extra mappnivå som `AddOns/AJCollector/AJCollector/`.
5. Starta spelet igen. På karaktärsvalet: öppna **AddOns**, aktivera **AJ Collector** och logga in på din Hunter. Paketets interface är **16001**, verifierat med GetBuildInfo för version **1.60.1, build 70862**. Den tidigare 0.6.0-filen saknade den sista ettan i interface-numret.
6. Skriv `/aj status`. Du ska få ett meddelande som börjar med **AJ Collector 0.10.1**. Vid uppdatering av en befintlig installation: stäng spelet helt, ersätt hela addon-mappen och starta om klienten så att versionsinformationen läses på nytt.

## 2. Testa en vanlig synkning först

1. Stå utanför strid och skriv `/aj sync`, eller klicka **Sync** i den lilla AJ-panelen.
2. Kontrollera att `AJ1;...`-rapporter syns i guildchatten och sedan i rätt Discord-kanal. PROFILE, POS, PROF, MONEY och EQUIP används när data finns. MONEY är ditt burna saldo i koppar.
3. Öppna https://bakersguild.se, välj din karaktär och kontrollera level, position, professions, guld och utrustning. Webbplatsen hämtar normalt nya rapporter ungefär en gång per minut; ladda om om du vill kontrollera direkt.
4. Upprepa utan förändringar. Det ska inte skapa dubbla level-/equipmilstolpar. Värden och rapporternas aktualitet får uppdateras.

Om positionen saknas i en instans ska övriga insamlare ändå kunna försöka rapportera. Markeringen **Sync \*** försvinner först när den fullständiga insamlingen lyckats och alla förväntade rapporter fått ett eget guild-eko. Panelen ligger kvar och visar minuter sedan senaste bekräftade synk, även när allt är synkat. Det bekräftar guildchatten, inte separat leverans till Discord eller webbplatsen.

## Flytta, skala och pausa

Dra i panelens bakgrund för att flytta den. **...** eller `/aj menu` öppnar inställningarna: **Scale -/+** (60–150 %), **Reset position / scale**, **Pause / Resume** och **Disable / Enable**. Paus stoppar synkningen tillfälligt; Disable sparas per karaktär även efter omstart. Både manuella synkningar, spellmakrot och mount-rapporten stoppas. Enable/Resume skickar inget förrän nästa manuella synk. Position och storlek sparas per karaktär. `/aj enable` återaktiverar och häver paus.

**Last sync: Xm ago** visar minuter sedan senaste bekräftade guild-eko, även för en positionsrapport. Ett misslyckat försök nollställer inte timern. Timern skickar inga meddelanden själv och bekräftar inte separat Discord-leverans.

## 3. Bind synkningen till Hunter's Mark

Rekommendation: **Hunter's Mark**, om den är inlärd. Du använder den ofta på nya mål och kan behålla din vanliga tangent. Skapa ett nytt makro med valfritt namn och frågeteckensikonen:

```text
#showtooltip Hunter's Mark
/cast Hunter's Mark
/aj spellsync
```

Första synken skickar hela karaktären. Efter det skickas position vid varje accepterad synk, men level/profil, professions, pengar och utrustning högst var femte minut. Nästa knapptryck efter fem minuter skickar hela paketet; inget skickas automatiskt av en timer. `/aj sync` kan skicka position oftare. Även misslyckade fullständiga försök omfattas av femminutersgränsen; `/reload` startar ett nytt intervall.

Dra makrot till Hunter's Marks vanliga plats på actionbaren. Makrot ska försöka kasta samma spell och samtidigt anropa addonets synkning, högst en gång per **60 sekunder**. Spellnamnet ovan gäller engelsk klient; använd det exakta namnet från spellboken om klienten är lokaliserad.

Testa först på ett vanligt mål utanför strid, sedan under en normal strid. Kontrollera att både markeringen och guildrapporteringen fungerar i just din klient. Synkningen utlöses av knapptrycket, även om själva spell-casten misslyckas. När du reser utan att använda spellen kan du fortfarande skriva `/aj sync` eller klicka på påminnelsen.

Du behöver **inte** Setup 1–5 eller Setup All när addonet är installerat. De makrona hör till den separata GeForce NOW-lösningen. Spellmakrot ovan använder addonets `/aj`-kommandon direkt.

## Dödsfall i Journey

Addonet observerar dödsfall och lägger dem i nästa fullständiga synk, högst var femte minut. Ingen chatrapport skickas automatiskt vid dödsfallet. Journey visar **Killed by** vid en bekräftad dödande träff i combatloggen, **Last damage** om bara senaste skadan är känd, eller **Cause unknown** om orsaken saknas. Fall och drunkning kan också rapporteras när combatloggen stöder det. Händelserna behöver verifieras i Forever-klienten. Vänta med `/reload` tills rapporten bekräftats; osynkade dödsfall lagras bara i minnet.

## 4. Om något saknas

- **Okänt `/aj`-kommando:** kontrollera spelmapp, extra mappnivåer och att addonet är aktiverat. Starta om klienten om den var öppen när ett nytt addon kopierades in.
- **Lua-fel:** notera hela feltexten och vid vilket steg den uppstod. `/console scriptErrors 1` kan visa Lua-fel; återställ med `/console scriptErrors 0` efter felsökningen.
- **Inga guildrapporter:** kontrollera att synken inte är pausad/avstängd i `/aj menu`, kontrollera guildmedlemskap och prova `/aj sync` utanför strid. `/aj debug` och `/aj status` hjälper till att visa vilka händelser klienten stöder.
- **Guild fungerar men inte Discord:** kontrollera guild→Discord-kopplingen och rätt kanal.
- **Discord fungerar men inte webbplatsen:** vänta en minut, ladda om och kontrollera att rätt karaktär är vald.
- **Sync \* ligger kvar:** vänta på guild-ekona och kontrollera eventuella lokala fel eller meddelandet om fler köade utrustningsbyten. Klicka Sync igen vid behov; lokalt skickat är inte samma sak som mottaget i Discord.

Detta är ett klienttest. Timers skickar inte verifierat guildchat i den testade Forever-klienten, så denna version använder mänskliga Sync-/spellklick. Vi behöver Eriks bekräftelse på installation, Hunter's Mark, guld och leveransvägen innan hela addon-flödet kan kallas verifierat i spelet.

## Journey inne i spelet

Öppna `/aj journey` eller **... → Open Journey**. Välj en hjälte och Journey, Equipment, Professions eller Map. Addonet visar rapporter du själv tagit emot i guildchatten och sparar dem lokalt per karaktär/guild. Det kan inte hämta webbplatsens historik eller Armory direkt. Be andra synka medan du är online om de saknas. Att mutea Guild-fliken stoppar inte mottagningen. Kartor och UI är testade i simulering; kontrollera dem i Forever-klienten.
