Skip to content

Commit f857fe1

Browse files
author
Mikolaj Graf
committed
add readme
1 parent a50f4b6 commit f857fe1

5 files changed

Lines changed: 100 additions & 35 deletions

File tree

CURSEFORGE_DESCRIPTION.md

Lines changed: 93 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,16 @@
1-
AutoSellPlus sells your junk at vendors with configurable quality and ilvl filters, transmog protection, and per-character profiles. Mark items as junk while looting, preview what will be sold before confirming, and protect gear you want to keep -- including uncollected appearances, BoEs, and equipment sets.
1+
Smart junk selling for WoW Retail. Configure quality and ilvl filters, protect uncollected transmog and BoEs, mark items as junk from your bags, and preview everything before it's sold. Profiles sync account-wide so you set up once and every alt just works.
22

3-
Lightweight, modular, and self-testing on login so it keeps working through patches.
3+
Self-tests on login — if a WoW API changes after a patch, only the affected feature disables while everything else keeps running.
44

55
![AutoSellPlus popup](https://media.forgecdn.net/attachments/1567/371/screenshot-2026-03-06-at-11-21-55a-am-png.png)
66

77
---
88

9+
 
10+
911
## Selling
1012

13+
<<<<<<< Updated upstream
1114
- **Popup preview** -- sortable columns (name, ilvl, vendor price, AH value), checkboxes, one-click Sell All
1215
- **Three sell modes** -- interactive popup (default), one-click, or fully automatic with configurable delay
1316
- **Quality filters** -- gray through epic, each with independent ilvl thresholds
@@ -17,87 +20,143 @@ Lightweight, modular, and self-testing on login so it keeps working through patc
1720
- **Buyback safety** -- items beyond the 12-item buyback limit are flagged visually
1821
- **Dry run** -- preview what would be sold without actually selling
1922
- **Auto-repair** -- repairs gear at vendors, guild funds first
23+
=======
24+
| | |
25+
|:---|:---|
26+
| **Popup preview** | Sortable columns (name, ilvl, vendor price, AH value) with per-item checkboxes |
27+
| **In-popup settings** | Items / Settings tabs — change any setting without leaving the vendor |
28+
| **Three sell modes** | Interactive popup (default), one-click, or fully automatic with delay |
29+
| **Quality filters** | Gray through epic, each with an independent ilvl threshold |
30+
| **Category filters** | Consumables, trade goods, quest items, miscellaneous |
31+
| **Expansion & slot filters** | Narrow results by expansion or equipment slot |
32+
| **Confirmations** | Epic, high-value, and Sell All show a dialog with item count and gold total |
33+
| **Buyback safety** | Most valuable items sold first so buyback slots hold the expensive ones |
34+
| **Dry run** | Preview what would be sold without actually selling |
35+
| **Auto-repair** | Repairs gear at vendors, guild funds first |
36+
| **Key binding** | Bind a key to open the popup at any vendor |
37+
>>>>>>> Stashed changes
2038
2139
---
2240

41+
&nbsp;
42+
2343
## Protection
2444

45+
<<<<<<< Updated upstream
2546
- **Never-sell / Always-sell lists** -- global and per-character
2647
- **Transmog** -- source-level appearance checking; uncollected items are never sold
2748
- **Equipment sets** -- items in any saved gear set are protected
2849
- **BoE** -- unbound Bind on Equip items are protected
2950
- **Refundable** -- items in the vendor refund window are skipped
3051
- **Addon hooks** -- AllTheThings and CanIMogIt integration for enhanced transmog detection
52+
=======
53+
| | |
54+
|:---|:---|
55+
| **Never-sell / Always-sell lists** | Global and per-character |
56+
| **Transmog** | Source-level appearance checking — uncollected items are never sold |
57+
| **Equipment sets** | Items in any saved gear set are protected |
58+
| **BoE** | Unbound Bind on Equip items are protected |
59+
| **Soulbound-only mode** | Skip all unbound BoE items — useful for keeping drops for the AH |
60+
| **Quest items** | Quest Items category protected by default |
61+
| **Current expansion materials** | Optionally protect Trade Goods from the current expansion |
62+
| **Refundable** | Items in the vendor refund window are skipped |
63+
| **Addon hooks** | AllTheThings and CanIMogIt for enhanced transmog detection |
64+
>>>>>>> Stashed changes
3165
3266
---
3367

68+
&nbsp;
69+
3470
## Marking
3571

36-
- **ALT+Click** -- mark/unmark items in bags as junk (configurable overlay: border, tint, or both)
37-
- **Drag-to-mark** -- button appears above bags
38-
- **Auto-mark on loot** -- gray items and equippable items below an ilvl threshold
39-
- **Bulk mark mode** -- `/asp mark` to mark multiple items without holding ALT
40-
- **Bag addon support** -- Bagnon, AdiBags, ArkInventory, Baganator
72+
- **ALT+Click** items in bags to mark or unmark as junk (overlay: border, tint, or both)
73+
- **Drag-to-mark** button above bags
74+
- **Auto-mark on loot** for gray items and equippable gear below an ilvl threshold
75+
- **Bulk mark mode** via `/asp mark` — no need to hold ALT
76+
- Works with **Bagnon**, **AdiBags**, **ArkInventory**, and **Baganator**
4177

4278
---
4379

80+
&nbsp;
81+
4482
## Bag Management
4583

46-
- **Bag space guard** -- automatically suggests selling the cheapest junk when free slots are low
47-
- **Stack limits** -- set max quantities per item, excess goes into the sell queue
48-
- **Free slot alerts** -- chat message or on-screen warning when bag space is low
49-
- **Bag gold display** -- total vendor value shown above the backpack button
84+
- **Bag space guard** suggests selling the cheapest junk when free slots are low
85+
- **Stack limits** set max quantities per item; excess goes into the sell queue
86+
- **Free slot alerts** via chat or on-screen warning
87+
- **Bag gold display** total vendor value shown above the backpack button
5088

5189
---
5290

91+
&nbsp;
92+
5393
## Tracking
5494

95+
<<<<<<< Updated upstream
5596
- **Session tracker** -- gold/hour calculation in the minimap button tooltip
5697
- **Sale history** -- scrollable panel showing the last 200 sales
5798
- **Per-character stats** -- lifetime sales totals visible across alts
5899
- **Undo** -- 5-minute buyback window with visual toast notification
100+
=======
101+
- **Session tracker** with gold/hour calculation in the minimap tooltip
102+
- **Sale history** — scrollable panel of the last 200 sales; shift-click to link items in chat
103+
- **Per-character stats** — lifetime totals visible across alts
104+
- **Undo** — 5-minute buyback window with a visual toast notification
105+
>>>>>>> Stashed changes
59106
60107
---
61108

109+
&nbsp;
110+
62111
## Profiles
63112

113+
<<<<<<< Updated upstream
64114
- **Built-in templates** -- Raid Farmer, Transmog Hunter, Leveling Alt, Gold Farmer
65115
- **Named profiles** -- save and load settings that persist across sessions
66116
- **Auto-load** -- last loaded profile restores automatically on login
67117
- **Import / Export** -- share never-sell and always-sell lists as strings
118+
=======
119+
- **Built-in templates:** Raid Farmer, Transmog Hunter, Leveling Alt, Gold Farmer
120+
- **Named profiles** that save and load across sessions
121+
- **Auto-load** — last loaded profile restores on login
122+
- **Instance auto-profiles** — switch automatically for raids, dungeons, battlegrounds, or open world
123+
- **Import / Export** never-sell and always-sell lists as shareable strings
124+
>>>>>>> Stashed changes
68125
69126
---
70127

71-
## Slash Commands
128+
&nbsp;
72129

73-
Type `/asp` or `/autosell` for the full command list. Key commands:
130+
## Slash Commands
74131

75-
- `/asp config` -- Open settings
76-
- `/asp sell` -- Sell at vendor
77-
- `/asp preview` -- Dry run
78-
- `/asp undo` -- Buyback last sale
79-
- `/asp mark` -- Toggle bulk-mark mode
80-
- `/asp template [name]` -- Apply a preset
81-
- `/asp profile save/load [name]` -- Manage profiles
82-
- `/asp session` -- View session stats
83-
- `/asp log ui` -- Open sale history
84-
- `/asp keep [id] [count]` -- Set stack limits
85-
- `/asp wizard` -- Re-run setup wizard
132+
Type `/asp` or `/autosell` for the full list.
133+
134+
| Command | |
135+
|:---|:---|
136+
| `/asp config` | Open settings |
137+
| `/asp sell` | Sell at vendor |
138+
| `/asp preview` | Dry run |
139+
| `/asp undo` | Buyback last sale |
140+
| `/asp mark` | Toggle bulk-mark mode |
141+
| `/asp template [name]` | Apply a preset |
142+
| `/asp profile save/load [name]` | Manage profiles |
143+
| `/asp session` | View session stats |
144+
| `/asp log ui` | Open sale history |
145+
| `/asp keep [id] [count]` | Set stack limits |
146+
| `/asp wizard` | Re-run setup wizard |
86147

87148
---
88149

89-
## Integrations
90-
91-
- **TSM / Auctionator** -- AH price column in popup
92-
- **Bagnon / AdiBags / ArkInventory / Baganator** -- junk mark overlays in bag frames
93-
- **AllTheThings / CanIMogIt** -- enhanced transmog protection
94-
- **Leatrix Plus** -- conflict detection
150+
&nbsp;
95151

96-
---
97-
98-
## Resilience
152+
## Integrations
99153

100-
AutoSellPlus runs a self-test on login. If a WoW API is missing after a patch, the affected feature is disabled individually while everything else keeps working. No full addon breakage from a single API change.
154+
| Addon | |
155+
|:---|:---|
156+
| **TSM / Auctionator** | AH price column in the popup |
157+
| **Bagnon / AdiBags / ArkInventory / Baganator** | Junk mark overlays in bag frames |
158+
| **AllTheThings / CanIMogIt** | Enhanced transmog protection |
159+
| **Leatrix Plus** | Conflict detection |
101160

102161
---
103162

README.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,13 @@
3939
</p>
4040

4141
<p align="center">
42-
<img src="assets/screenshot.png" alt="AutoSellPlus popup" width="640">
42+
<img src="assets/1.png" alt="Items tab — filters and item list" width="420">
43+
&nbsp;&nbsp;
44+
<img src="assets/2.png" alt="Settings tab — General, Automation, Protection" width="420">
45+
</p>
46+
47+
<p align="center">
48+
<img src="assets/3.png" alt="Settings tab — Marking, Display, Bag Maintenance, Auto-Destroy" width="420">
4349
</p>
4450

4551
<br>

assets/1.png

576 KB
Loading

assets/2.png

326 KB
Loading

assets/3.png

294 KB
Loading

0 commit comments

Comments
 (0)