Warband Integration

Warband.pro Integration

Blizzard Profile API: 14 fields. Warbandeer OpenAPI confirms 0 paths for vault, currency, gold, lockout, mail, bank, bag. Addon is the only source.

Goal: Warband.pro answers "who to play tonight" with location of gear, gold and consumables, usable lockouts, and cap warnings.

Real Use

Not once a month. Four to ten times per night, ambient.

1. Log out -> glance at second monitor -> $ sync -> API 1 minute fresh
2. Loot Spark / open Vault 3/8 to 4/8 / Warband bank 200 Crests / AH mail 20 Phials -> addon snaps in 0.5s, no extra step
3. Tap to export/import -> game on primary monitor, web on second, press i or click Import. If clipboard holds wb1! from 10 seconds ago (you just did /warband Ctrl+C) -> auto-grab via navigator.clipboard.readText() inside the click -> preview instantly, zero Ctrl+V. Otherwise text area is focused.
4. Preview -> confirm -> D1 upserts per character. Missing characters stay stale.
5. Tonight Plan updates using fresh consumables data.

Saturday push: play Monday to Saturday, paste once before +12, all 6 current.

Sink

Top-right MenuBar [ Sync / Import ] on every route. Not tucked in Settings.

Mirrors ghost sync buttons inside blocks. Same data-sync-all handler found by keys.ts so they never disagree.

Bottom line: API 12m · Addon 2h · Warbank 1d (by Vocnar) is the trust signal.

Hotkeys

1-4 routes, i import anywhere, ? help. Scripts initialize from astro:page-load because ClientRouter does not re-execute.

When Data Matters

• 0 Phials fresh -> hard block "hit auction house before raid"
• 0 Phials 5 days old (yellow) -> grey "per last import 5 days ago, verify" not block
• Vault addon often fresher than API if you just opened Vault on alt that API has not fetched
• Crests near cap -> warning
• Warband bank scattered, 47 Sparks across 3 characters -> consolidate
• 120 Phials in Warbank from Vocnar -> do not block Vocgrim +12, just "consolidate first"

Why Not Auto-Upload

Trust. You paste to your own account. No background network. Streamer mode planned to collapse gold to dots.

App Files That Reference This

• App .wiki/wiki/topics/addon-import.md
• src/lib/warband-import.ts pure decoder
• src/components/Sync.astro notes reload versus in-place
• shell-model.md section 10 explains why import was route, then overlay, now rail field