AutoSellPlus

Mark junk at loot. Farm without full bags. Sell in one click across alts.
_{A World of Warcraft addon}

Why AutoSellPlus · Quick Start · Features · Commands · Integrations · Development · Releasing

   

Tired of Scrap/Aardvark breaking every patch? Or hopping vendors mid-farm because your bags
exploded from old raid greens? AutoSellPlus marks while you loot, auto-keeps space open,
and sells safe—no more accidental BoE/transmog losses.

Midnight ready • Works post-patch • Farmer approved

  Key Features

Mark Junk Fast

• ALT+Click bags/loot → Instant mark (visual glow/border)
• Drag to target button under bags
• Auto-mark grays/low-ilvl on pickup
• Bulk /asp mark mode (no ALT needed)

Smart Sell Rules

• ilvl/quality/expansion filters (e.g. sell TBC greens <180)
• Protect transmog (ATT/CanIMogIt hooks)
• BoE/sets/refundables safe
• Epic/high-gold confirm dialogs

Vendor Flow

• Popup preview → checkboxes/sort → Sell Selected
• One-click auto-sell on open
• Auto-repair (guild first)
• Mute vendor mount spam

Farmer Tools

• Bag space guard: Auto-sell cheapest junk at threshold
• Alt totals: Minimap tooltip shows "Bag junk: 2k gold ready"
• Undo buyback (5 min window)
• Session GPH tracker

  Slash Commands

Command	Description
/asp	Show help
/asp config	Open settings panel
/asp sell	Sell at vendor now
/asp preview	Dry run (nothing sold)
/asp undo	Buyback last sale
/asp template	Load preset (raidfarmer/transmoghunter/etc)
/asp toggle	Enable / disable
/asp mark	Toggle bulk-mark mode
/asp add <id>	Never sell this item
/asp remove <id>	Remove from never-sell list
/asp list	Show never-sell and always-sell lists
/asp profile save <name>	Save current settings as profile

Tip

/autosell works as an alias for /asp

---

  Why This Over Scrap/Aardvark/Legacy Vendor?

Issue	AutoSellPlus	Others
Patch breaks	Self-tests on login, API fallbacks	Dies every xpack
Full bags mid-run	Auto-evict junk to keep slots free	Vendor babysitting
Alt hassle	Sync rules account-wide	Per-char redo
Oops sells	Loot-mark + ATT exclude	Weak safeties
Spam popups	One-click bulk	Transaction hell

"Set once on main. Every alt farms clean." – Real farmer QoL.

  Quick Start

1. Install via CurseForge or Wago → /reload
2. /asp config → Pick "Raid Farmer" template
3. ALT+Click loot/bags to mark junk (glows red)
4. Visit a vendor → One button Sell All (preview first)

Minimap button for stats/toggle. Rules stick across chars/sessions.

  Integrations

Addon	Integration
TSM / Auctionator	AH price warnings in tooltips
Bagnon / AdiBags / ArkInventory / Baganator	Mark overlays in bag frames
AllTheThings / CanIMogIt	Transmog protection hooks
Leatrix Plus	No conflicts

---

  Development

Note

See CONTRIBUTING.md for guidelines on submitting changes.

Project Structure

AutoSellPlus/
├── AutoSellPlus/            # Addon source
│   ├── AutoSellPlus.toc     # Table of contents (loaded by WoW)
│   ├── Config.lua           # Defaults, DB init, migration, profiles, templates
│   ├── Helpers.lua          # Utilities (ilvl, money formatting, bag iteration)
│   ├── Protection.lua       # Item protection (transmog, BoE, sets, ShouldSellItem)
│   ├── BagAdapters.lua      # Bag addon compatibility (Bagnon, AdiBags, etc.)
│   ├── Overlays.lua         # Bag overlays, tooltip hooks, gold display
│   ├── Marking.lua          # Mark toggling, alt-click, loot auto-mark
│   ├── History.lua          # Session tracking, sale history (data layer)
│   ├── HistoryUI.lua        # Sale history panel (UI)
│   ├── MinimapButton.lua    # Minimap button, alt stats tracking
│   ├── Wizard.lua           # First-run setup wizard
│   ├── UI.lua               # Settings panel (Options > AddOns)
│   ├── PopupFilters.lua     # Display list building, filter logic, sorting
│   ├── Popup.lua            # Merchant popup frame, item rows, sell actions
│   ├── Selling.lua          # Sell queue, batch processing, undo, auto-sell
│   └── Core.lua             # Event handling, slash commands, auto-repair
├── assets/                  # Images for README (excluded from package)
├── .pkgmeta                 # BigWigsMods packager config
├── .luacheckrc              # Luacheck linting rules
├── install.sh               # macOS install script
└── .github/workflows/       # CI/CD pipeline

Local Testing

Symlink the addon into your WoW addons folder:

./install.sh

Or manually copy AutoSellPlus/ to:

World of Warcraft/_retail_/Interface/AddOns/AutoSellPlus/

Reload the UI in-game with /reload.

Linting

Run luacheck locally before pushing:

luacheck AutoSellPlus/

The CI pipeline runs luacheck automatically on every push.

  Releasing

Releases are fully automated via GitHub Actions using BigWigsMods/packager.

How to Release

1. Tag the commit and push:

   git tag v1.2.3
   git push origin v1.2.3

2. The pipeline will automatically:
   • Run luacheck
   • Package the addon (respecting .pkgmeta ignores)
   • Upload to CurseForge and Wago
   • Create a GitHub release with the zip attached

Required Secrets

Set these in GitHub > Settings > Secrets and variables > Actions:

Secret	Source
CF_API_KEY	CurseForge API tokens
WAGO_API_TOKEN	Wago developer settings

Important

GITHUB_TOKEN is provided automatically. Make sure Settings > Actions > General > Workflow permissions is set to Read and write.

Version Token

The .toc file uses @project-version@ which the packager replaces with the git tag at build time. Do not hardcode a version number.

---

Made by Cloudsail Digital Solutions