GW2 Advisor

An intelligent companion for Guild Wars 2: a per-pixel-transparent in-game overlay (with a full in-game command center) that reads your account through the official API and tell you what to do next — backed by an AI advisor that runs on your own machine (or your own cloud API key) and verifies its answers against the wiki.

Built where the existing ecosystem stops: tools like gw2efficiency display your account; Blish HUD renders community content. GW2 Advisor advises — inventory triage that says what to salvage, a gear planner that prices the cheapest path, a readiness coach that says which raid wing to try first, and a chat that answers "what should I do tonight?" from your actual account.

Not affiliated with ArenaNet. Uses only the official Web API and MumbleLink (no game-client injection, no automation, no memory reading) — the same compliance posture as Blish HUD/TacO under ArenaNet's third-party policy.

In-game overlay (glass mode — true per-pixel transparency)

• Context-aware widgets: city → vault/routine/events; combat → encounter timers + coach; raid/fractal/dungeon → wiki-verified mechanics briefs; PvP → live game plan with match clock
• Command center (Ctrl+Shift+A): the entire dashboard in-game — 14 tabs
• AI advisor: chat with live wiki lookup tools, voice push-to-talk (Ctrl+Shift+V), and "what am I looking at?" screenshot analysis (Ctrl+Shift+Q) with a 21k-item icon-recognition database
• TacO/Blish marker packs: drop packs in dist\markers (POIs, v1)
• Boss-spawn toasts, automatic play-session tracking with debriefs
• Blish HUD coexistence: auto-detects Blish, yields overlapping widgets, and publishes a local data feed for Blish modules (docs/BLISH-BRIDGE.md)

Dashboard (also inside the overlay)

• Goal-driven recommendations, returning-player "what changed" timeline
• Inventory triage: deposit/vendor/salvage/sell/keep advice for every item across bank + all characters, with totals
• Gear acquisition planner (cheapest source per slot + ascended timegate calendar) and endgame readiness coach (weekly clears, killproof count, start-here recommendation)
• Legendary planner with live TP pricing, universal crafting calculator,
• Trading: net worth + history, undercut/outbid alerts, market pulse, and a full-market flip scanner
• Wizard's Vault tracker + acclaim-value optimizer, daily routine board with GW2-correct resets, homestead decoration planner, PvP analytics with match movement replay, guides for every opaque game system

AI backends — pick in Settings: LM Studio / Ollama / any local OpenAI-compatible server (free, private), or your own Anthropic Claude / Google Gemini / OpenAI key.

• Your API key is immediately traded for a scoped 30-day subtoken (official createsubtoken endpoint), which is what gets persisted — falls back to storing the root key only if a private API proxy doesn't implement createsubtoken
• Keys/subtokens are sent only to api.guildwars2.com; cloud LLM keys are relayed only to that vendor's official host (server-side allowlist)
• Local LLM endpoints are restricted to loopback/private LAN (SSRF guard) — account data and screenshots cannot leave your network
• The ArcDPS forwarder sends only your own combat events over a local named pipe ACL'd to your user

1. Install the prerequisites once: WebView2 Runtime (preinstalled on Windows 11) — that's it; Node and .NET are bundled
2. Download/build the dist folder (see Building) and run GW2AdvisorShell.exe — it starts everything and lives in your tray
3. Run Guild Wars 2 in Windowed Fullscreen
4. Press Ctrl+Shift+A in-game, paste your API key once (create one at https://account.arena.net/applications with all permissions)

Hotkeys (remappable in Settings): Ctrl+Shift+A command center · Ctrl+Shift+O hide overlay · Ctrl+Shift+Q what am I looking at · Ctrl+Shift+V push-to-talk

Optional — combat coach: copy arc-plugin\gw2advisor_arc.dll next to Gw2-64.exe (requires ArcDPS).

npm install
powershell -File scripts\build-web.ps1     # Next.js standalone + bundled node → dist\web
powershell -File scripts\publish-shell.ps1 # self-contained WPF shell → dist\
# optional combat plugin (zig cc, no Visual Studio needed):
powershell -File arc-plugin\build-plugin.ps1

Development: npm run dev (overlay sim at localhost:3000/overlay); point the shell at it with a dist\overlay-url.txt containing http://localhost:3000/overlay?shell=1. Tests: npx vitest run.

All curated GW2 facts are wiki/API-sourced with provenance records (docs/KNOWLEDGE-PROVENANCE.md). After game patches:

node scripts/knowledge-check.mjs      # 115 live validations against API + wiki
node scripts/sync-event-timers.mjs    # pull updated boss schedules from the wiki

• app/, components/, lib/ — Next.js dashboard + overlay page (the overlay UI is the same web app, hosted by the shell)
• shell/ — WPF host: DirectComposition glass window (per-pixel alpha over the game), MumbleLink reader + 30Hz camera stream, marker pack loader, global hotkeys, web-server supervisor, tray icon, ArcDPS pipe server
• arc-plugin/ — minimal C forwarder (ring buffer + writer thread)
• data/ — curated, provenance-tracked game knowledge
• docs/ — design notes, audit log, bridge schema, research

MIT — see LICENSE.