================================================================
 Emporium  -  v0.39.1 (beta)
 A smarter Auction House for Return of Reckoning
================================================================

Emporium is an Auction House addon focused on making AH decisions
easier, not just adding more filters. It opens its own AH window and
(by default) takes over the stock Auction House when you talk to an
auctioneer. You can hand control back to the default AH at any time
with /emp restore.


----------------------------------------------------------------
 INSTALLATION
----------------------------------------------------------------

1. Extract the archive.
2. Copy the "Emporium" folder into:
      Warhammer Online - Age of Reckoning\Interface\AddOns
   (so you end up with ...\Interface\AddOns\Emporium\Emporium.mod)
3. Start the game (or type /reloadui if already in).
4. Enable Emporium in the in-game Addons menu if needed.

First launch prints a one-time welcome telling you how to open it
and how to restore the default AH.


----------------------------------------------------------------
 COMMANDS
----------------------------------------------------------------

  /emp              Open / close Emporium.
  /emporium         Same as /emp.
  /emp settings     Open the settings window.
  /emp log          Print your last activity-log entries.
  /emp bug          Print info to paste into a bug report.
  /emp stats <x>    List the client's searchable stat filters.
  /emp restore      Give control back to the DEFAULT Auction House.
  /emp replace      Make Emporium take over the AH again.
  /emp probe        Developer/debug dump (item, gear, auction data).

If anything ever feels wrong with the AH, /emp restore brings the
stock window straight back. The choice is remembered between sessions.


----------------------------------------------------------------
 FEATURES
----------------------------------------------------------------

SEARCH & BROWSE
  Filter auctions by item name, seller, level range, rarity, career,
  item type, equip slot and stat. Item name search is multi-word and
  order-independent ("wind ring" = "ring wind"). Click a column header
  to sort (click again to reverse). Save the current filters from the
  Saved sidebar and click one to re-run it instantly.

BUY (with confirmation)
  Click a result row to arm it, then press Buy; a second click confirms.
  The cheapest current listing is shown at the bottom.

MARKET PRICE MEMORY + VERDICTS
  Every search is recorded into a local price database, per faction. Hover
  an item for a panel showing typical (median) and cheapest price per unit,
  the sample count and how recently it was seen. Listings are labeled Great
  Deal / Fair / Overpriced / Suspicious Low / Thin Market.

GEAR ASSISTANT (Shop)
  A paper-doll of your equipped gear. Click a slot to find upgrades for it,
  or "All slots" for a full sweep that compares every item against what you
  have equipped in its slot and shows only real upgrades. Upgrades are
  ranked for your career role (a healer sees Willpower/Wounds first) across
  all rarities, including blue / purple / set items. Optional "Hide gear
  downgrades" in Settings.

TALISMANS
  Per-career list of the best talismans for each useful stat, in a value-
  ranked view split into "Slottable now" vs "Needs rank N", with tier and
  BiS badges. Includes an Armor talisman option.

CONSUMABLES
  Per-role shortlist of must-have liniments, potions and draughts, sorted
  strongest-usable-first, with a best-deal (cheapest per unit) view.

SELL HELPER
  Pick or drag an item from your bags. Emporium shows the 5 cheapest rivals
  (yours flagged, suspicious undercuts flagged), suggests a price, and lets
  you override it manually. The deposit shown follows your city rank, exactly
  like the native AH. Pricing strategies: undercut, match, median-anchored,
  fixed per-unit, fixed total, vendor multiplier.

  Tick "Remember" to save a per-item rule; review and delete them in the
  Saved sell rules panel. Split a stack and batch-post it in one go. Restock
  posts every ruled item. Cancel a listing and it is marked for repost -
  collect it from the mailbox and Restock relists it competitively.

MY LISTINGS + ACTIVITY LOG
  Your active auctions with a live X/50 counter and a running total of what
  they are worth if they all sell. The Activity log keeps a journal of your
  listings, cancels, restocks and buys.

SETTINGS & THEMES
  A full settings window (/emp settings) with functional options for buying,
  market thresholds, selling confirmations, UI scale, combat pause and more.
  Five selectable themes.


----------------------------------------------------------------
 KNOWN LIMITATIONS (this is a beta)
----------------------------------------------------------------

- Market prices are learned LOCALLY from your own searches; new/unseen items
  show no price context yet.
- Gear comparison focuses on stat bonuses; some special effects may not be
  fully evaluated.
- Talisman ranking is experimental and welcomes feedback.
- Advanced selling tools (batch posting, restock, repost) are functional but
  still need wider testing.
- The client writes saved data to disk only on a clean logout or /reload; a
  crash loses recent changes. Do a quick /reload after saving something
  important.


----------------------------------------------------------------
 REPORTING BUGS
----------------------------------------------------------------

Type /emp bug and paste the output, plus:
  - what you clicked or searched,
  - the item name (if item-related),
  - any Lua error text,
  - a screenshot if possible.

Thanks for testing. The goal is to make the Auction House easier to use,
especially for players who want better decisions without drowning in filters.

See CHANGELOG.txt for the version history.
