================================================================
 Emporium  -  v0.26.5 (beta)
 A smarter Auction House experience 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
can take 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.

This is a beta release. It is usable, but it still needs feedback from
real players, different careers, ranks, item types and selling habits.


----------------------------------------------------------------
 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 game.
4. Enable Emporium in the in-game AddOns menu if needed.


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

  /emp              Open / close Emporium.
  /emporium         Same as /emp.
  /emp restore      Give control back to the default Auction House.
  /emp replace      Make Emporium take over the AH again.
  /emp probe        Developer/debug dump for item, gear and auction data.

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


----------------------------------------------------------------
 CURRENT FEATURES
----------------------------------------------------------------

INTENT-BASED NAVIGATION
  Emporium is organized around player goals instead of only filters:
  Search, Shop, Consumables, Talismans, Sell and Saved.

SEARCH & BROWSE
  Search auctions by item name, seller, level range, rarity, career,
  item type, equip slot and stat. Results show item, seller, quantity,
  price per unit, total buyout and market context where available.

BUY CONFIRMATION
  Buying uses a confirmation step to reduce accidental purchases.

MARKET PRICE MEMORY
  Emporium learns market prices locally from the AH searches you perform.
  It stores typical price, cheapest seen price and sample count per item,
  separated by faction.

DEAL FINDER / VS MARKET
  Listings can be compared against local market data with labels such as
  Thin Market, Suspicious Low, Great Deal, Fair and Overpriced.

GEAR ASSISTANT / SHOP
  Emporium can read your equipped gear and help search for upgrades by
  slot or across all slots. Gear search results can show stat differences
  against your currently equipped item.

TALISMANS
  Role and career-aware talisman suggestions with ranking logic, usable
  now / needs rank separation, tier labels and Best / BiS style badges.

CONSUMABLES
  Career and role-aware consumable suggestions for liniments, potions,
  draughts and other useful restock items, with best-deal style listings.

SAVED SEARCHES
  Save, load, rename and delete frequently used AH searches.

SELL HELPER
  Select items from your bags, scan competing listings, see suggested
  pricing, deposit estimate and post manually.

ADVANCED SELLING TOOLS, BETA
  Emporium includes early power-user selling tools:
  - pricing strategies,
  - minimum price / floor logic,
  - saved per-item sell rules,
  - stack splitting,
  - batch posting,
  - restock from saved rules,
  - My Listings view,
  - undercut scan,
  - cancel selected listing,
  - cancel undercut listings.

These selling tools are beta and should be tested carefully.


----------------------------------------------------------------
 KNOWN LIMITATIONS
----------------------------------------------------------------

- This is a beta release.
- Market prices are learned locally from your own searches, so new or
  unseen items will not have price context yet.
- Gear comparison focuses mainly on primary stat bonuses. Some special
  effects or unusual item data may not be evaluated perfectly.
- Talisman ranking is experimental and needs feedback.
- Advanced selling tools are included but still need wider testing.
- Batch posting, restock and undercut management should be treated as
  beta features.
- Some filters, careers, slots or item categories may need adjustment.
- There is no full settings panel yet. Core behavior is controlled through
  slash commands and in-window controls.


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

Please include:
  - your character career and rank,
  - what you clicked or searched,
  - the item name, if item-related,
  - any Lua error text,
  - a screenshot if possible.

Useful things to test:
  - opening Emporium at the Auction House,
  - /emp restore and /emp replace,
  - gear slot detection,
  - upgrade suggestions,
  - talisman suggestions,
  - consumable suggestions,
  - price per unit and market verdicts,
  - selling, batch posting, restock and undercut handling.

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.
