Usage

Usage — In-Game

One-key flow

/warband → edit box auto-focused + auto-selected → Ctrl+C → second monitor Import.

Commands

/warband                panel + bundle freshness line
/warband copy           bundle wb1! (multi-char by default, 4-7KB 6 chars)
/warband copy current   single-char only (streaming / testing)
/warband dump           raw json (debug, printed to chat frame)
/warband clear <name>   prune char from WarbandProDB
/warband status         debug counts / bundle len / lastSeen
/warband optimize       prune chars not seen 90d

UI

Trigger:

• AddonCompartment click (WarbandPro_OnAddonCompartmentClick)
• Slash /warband
• Keybind (optional, set in Keybindings → AddOns)

Panel WarbandProExportFrame (520×460, draggable, Esc to close, BackdropTemplate):

• Header: freshness summary: 6 chars · freshest 12m ago · Warbank 1h ago (by Vocnar) — so you know before copying it's not stale
• Middle: ScrollFrame + EditBox
  • SetMultiLine(true) SetMaxLetters(0) (0=no limit)
  • SetAutoFocus(true) + HighlightText() on Show — Ctrl-C alone works
  • SetFontObject(GameFontHighlightSmall) mono
  • OnEscapePressed hides frame
• Bottom: [ Select All ] re-highlights, [ Copy Close ] closes after (you still do Ctrl-C)
• Helper text:

  1. Press Ctrl+A then Ctrl+C (auto-selected)
  2. In warband.pro hit Import (i) or Ctrl+V
  3. Esc closes this
  

Why not StaticPopupDialogs? Its EditBox capped historically at ~1024 and steals focus. Custom frame = less taint.

Long bundles >20KB (future if we add full recipe lists): we would chunk wb1.1/3 — v1 targets 4-7KB so not needed. Guard shows second page fallback.

What it snapshots

Fires silently (no OnUpdate scanner):

• BAG_UPDATE throttled .5s → bags
• BANKFRAME_OPENED → bank + bank bags
• ACCOUNT_BANK_TAB_* → warband bank tabs (shared account-wide)
• CURRENCY_DISPLAY_UPDATE → currencies with caps
• PLAYER_MONEY, MAIL_INBOX_UPDATE, AUCTION_HOUSE_SHOW
• INSTANCE_LOCK_UPDATE, GARRISON_SOULBIND_TRACKER_CHANGED (vault), CHALLENGE_MODE_COMPLETED

Account-wide WarbandProDB:

WarbandProDB = {
  [guid] = { name, realmSlug, faction, class, level, gold, bags[], ..., seenAt{} },
  version = 1,
}

<200KB for 6 chars.

Safety

• In combat: panel blocks, shows red bar "cannot export in combat", queues reopen after PLAYER_REGEN_ENABLED. No taint.
• Privacy: No network calls — verify .toc 9 files. Export is copy-only, you paste to your own account.

Streamer mode (planned)

Collapse gold to ••• if settings.StreamSafe. Default shows gold.

Proof it's easy (from QA.md)

• Compartment → click opens ≤2 clicks
• Auto-highlighted on open without drag
• Ctrl-A + Ctrl-C pastes into Notepad startsWith wb1! exact len shown at bottom
• Esc closes, second open same
• Multi 6 still in single box, scrollbar appears but highlight all