3 changed files with 83 additions and 5 deletions
@ -1,3 +1,81 @@
|
||||
# TradeSkillMaster |
||||
# TradeSkillMaster (Ascension.gg) |
||||
|
||||
This is the repository for Trade Skill Master (TSM). Modified for 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. |
||||
|
||||
Loading…
Reference in new issue