Auc-Util-SearchUI

SearchUI Documentation

Auc-Util-SearchUI is a tool that allows you to find bargains in the current AH snapshot.

SearchUI uses modular filters or evaluators, known internally as "Searchers", to help the user determine if an auction is worth buying.

Some Searchers are included, but the system is modular to allow users to make their own Searchers and, or, modify the existing Searchers.

SearchUI ships with a default set of Searchers.

At present, those are:

Converter Evaluator- determine whether items are posted that can be easily transformed into their other forms and sold at a profit. e.g. Greater Essences morphed into Lesser Essences
Disenchant Evaluator- determine is an item is worth buying in order to disenchant with an Enchanter.
General Evaluator- a simple filter, for the most basic searches.
Resale Evaluator- determine if an item is priced such that you can bid or buyout the auction, relist, and potentially still make a profit.
Vendor Evaluator- determine if a game NPC will purchase an item for more than the current list price- buyout, bid, or both.

an evaluator can be added by stating: local lib, parent, private = AucSearchUI.NewSearcher("name of evaluator")
lib.Search(data) will be called
- data is a table, with the layout of the AucAdv ScanDb.
- refer to CoreConst.lua in AucAdv main folder for specifics on table layout (eg: data[Const.BUYOUT])
Return values are: buyorbid, value, [pct, [reason]]
- buyorbid:
  - "buy"
  - "bid"
  - true: buy it, but don't care whether buy/bid - useful for general searching
  - false (don't buy)
- value: the worth of the item (~= BottomScan's valuation) - this is used to calculate expected profit. Not needed if buyorbid is boolean
- pct: string - generally percent of value, though can be something else
- reason: optional string explaining purchase reason. Note: do not pass name of evaluator or bid/buy here. Those are already available.