|
|
|
|
# TradeSkillMaster (Ascension.gg)
|
|
|
|
|
|
|
|
|
|
TradeSkillMaster (TSM) is a World of Warcraft addon suite. This fork is tailored for Ascension.gg and includes the core addon plus feature modules.
|
|
|
|
|
|
|
|
|
|
## Modules
|
|
|
|
|
Each module lives in its own top-level folder and is loaded by its `.toc` manifest:
|
|
|
|
|
- `TradeSkillMaster` (core)
|
|
|
|
|
- `TradeSkillMaster_Accounting`
|
|
|
|
|
- `TradeSkillMaster_AuctionDB`
|
|
|
|
|
- `TradeSkillMaster_Auctioning`
|
|
|
|
|
- `TradeSkillMaster_Crafting`
|
|
|
|
|
- `TradeSkillMaster_Destroying`
|
|
|
|
|
- `TradeSkillMaster_ItemTracker`
|
|
|
|
|
- `TradeSkillMaster_Mailing`
|
|
|
|
|
- `TradeSkillMaster_Shopping`
|
|
|
|
|
- `TradeSkillMaster_Warehousing`
|
|
|
|
|
|
|
|
|
|
## Install (Local)
|
|
|
|
|
Copy the desired module folders into your AddOns directory and reload the game:
|
|
|
|
|
- AddOns: `/home/zalox/Games/ascension-wow/drive_c/Program Files/Ascension Launcher/resources/client/Interface/AddOns`
|
|
|
|
|
- SavedVariables: `/home/zalox/Games/ascension-wow/drive_c/Program Files/Ascension Launcher/resources/client/WTF/Account/omanfred/SavedVariables`
|
|
|
|
|
|
|
|
|
|
In-game, use `/reload` after changes.
|
|
|
|
|
|
|
|
|
|
## Development Notes
|
|
|
|
|
- Lua files use tab indentation.
|
|
|
|
|
- Keep `.toc` and primary `.lua` filenames aligned with the module name.
|
|
|
|
|
- If adding files, list them in the module `.toc`.
|
|
|
|
|
- Versions are tracked in `TradeSkillMaster/TradeSkillMaster.toc` and `TradeSkillMaster_AuctionDB/TradeSkillMaster_AuctionDB.toc`.
|
|
|
|
|
|
|
|
|
|
## Custom Price Sources (Full Reference)
|
|
|
|
|
TSM price strings can reference built-in data sources and combine them with math. Source names are case-insensitive.
|
|
|
|
|
|
|
|
|
|
### Core sources
|
|
|
|
|
- `VendorBuy`: Buy from vendor.
|
|
|
|
|
- `VendorSell`: Sell to vendor.
|
|
|
|
|
- `Disenchant`: Disenchant value (if available).
|
|
|
|
|
|
|
|
|
|
### AuctionDB sources
|
|
|
|
|
- `DBMarket`: AuctionDB market value (scan/app historical average).
|
|
|
|
|
- `DBMinBuyout`: AuctionDB minimum buyout from the most recent scan data.
|
|
|
|
|
|
|
|
|
|
### Accounting sources
|
|
|
|
|
- `avgSell`: Average sell price.
|
|
|
|
|
- `avgBuy`: Average buy price.
|
|
|
|
|
- `maxSell`: Maximum sell price.
|
|
|
|
|
- `maxBuy`: Maximum buy price.
|
|
|
|
|
- `minSell`: Minimum sell price.
|
|
|
|
|
- `minBuy`: Minimum buy price.
|
|
|
|
|
|
|
|
|
|
### Crafting sources
|
|
|
|
|
- `Crafting`: Crafting cost.
|
|
|
|
|
- `matPrice`: Crafting material cost.
|
|
|
|
|
|
|
|
|
|
### Optional addon sources
|
|
|
|
|
Available only if the addon is installed and enabled.
|
|
|
|
|
- `AucAppraiser`: Auctioneer - Appraiser.
|
|
|
|
|
- `AucMinBuyout`: Auctioneer - Minimum Buyout.
|
|
|
|
|
- `AucMarket`: Auctioneer - Market Value.
|
|
|
|
|
- `AtrValue`: Auctionator - Auction Value.
|
|
|
|
|
|
|
|
|
|
### Functions and syntax
|
|
|
|
|
- Math operators: `+`, `-`, `*`, `/`, `^`
|
|
|
|
|
- Money literals: `100g`, `50s`, `25c`, or combined `12g 34s 56c`
|
|
|
|
|
- Functions: `min`, `max`, `avg`, `first`, `check`, `ifgt`, `ifgte`, `iflt`, `iflte`, `ifeq`, `round`, `roundup`, `rounddown`
|
|
|
|
|
- Convert another item: `convert(priceSource, itemLink)` or `convert(priceSource, item:12345)`
|
|
|
|
|
|
|
|
|
|
### Examples
|
|
|
|
|
- `dbmarket * 0.9` (90% of market value)
|
|
|
|
|
- `max(dbminbuyout, 100g)` (at least 100g)
|
|
|
|
|
- `min(dbmarket, 250g)` (cap at 250g)
|
|
|
|
|
- `ifgt(dbminbuyout, 200g, dbminbuyout, dbmarket)` (prefer min buyout if above 200g)
|
|
|
|
|
|
|
|
|
|
Notes:
|
|
|
|
|
- Sources return values only when their module has data (for example, no AuctionDB scan means empty values).
|
|
|
|
|
- Use `DBMarket` for stable pricing and `DBMinBuyout` for recent lows.
|
|
|
|
|
|
|
|
|
|
## Testing
|
|
|
|
|
There is no automated test framework. Validate changes in-game by:
|
|
|
|
|
1. Logging in / reloading to verify module initialization.
|
|
|
|
|
2. Exercising the relevant UI workflows.
|
