A World of Warcraft addon for automating item handling and mailing during transmog farming runs (mog runs).
Description
# Mogrun Helper
A World of Warcraft addon for automating item handling and mailing during transmog farming runs (mog runs).
## Features
- **Rule-Based Decision Making**: Automatically evaluates items based on transmog status, quantity, and value
- **Transmog Awareness**: Always keeps items that teach new transmog appearances
- **Duplicate Management**: Automatically identifies duplicate items and marks them for mailing
- **TSM Integration**: Uses TradeSkillMaster pricing data to evaluate item values (optional)
- **Smart Mailing**: Separate mail queues for AH alts and vendor alts
- **Configurable Rules**: Customize thresholds for duplicates and item values
## How It Works
The addon follows this decision flow for each item:
1. **Can I learn it?** → If yes, KEEP the item
2. **Do I have more than X copies?** → If yes, MAIL to vendor alt
3. **Is the market value ≥ Y gold?** → If yes, MAIL to AH alt, otherwise MAIL to vendor alt
## Installation
1. Extract the addon folder to your WoW AddOns directory:
- `World of Warcraft\_retail_\Interface\AddOns\MogRunHelper\`
2. Restart WoW or reload UI (`/reload`)
## Configuration
### Open Settings
```
/mrh
/mrh config
```
### Settings Available
- **Enable/Disable Addon**: Toggle the addon on/off
- **Max Item Duplicates**: How many copies to keep before mailing extras (default: 1)
- **Minimum AH Value**: Items worth more than this (in gold) go to AH alt (default: 10g)
- **Vendor Alt Name**: Character name to send low-value/duplicate items to
- **AH Alt Name**: Character name to send high-value items to
- **Auto-Mail**: Automatically process mailing when opening a mailbox
- **Auto-Scan**: Automatically scan bags after looting (waits 1.5s, max once per 3s)
- **Ignore Common Items**: Skip white quality items (default: disabled)
- **Ignore Soulbound**: Skip items that are already soulbound (default: enabled)
- **Announce New Transmog**: Show chat message when finding unlearned transmog (default: enabled)
## Commands
- `/mrh` or `/mrh config` - Open configuration window
- `/mrh scan` - Manually scan bags now
- `/mrh mail` - Process mailing (requires open mailbox)
- `/mrh toggle` - Enable/disable addon
- `/mrh debug` - Toggle debug mode
## Usage Workflow
1. **Set up your alt names** in the configuration
2. **Run your transmog dungeons** as normal
3. **Scan your bags** (automatic or manual with `/mrh scan`)
4. **Open a mailbox** and either:
- Click "Mail Items" in the config window, or
- Run `/mrh mail` command, or
- Let auto-mail handle it if enabled
## TSM Integration
If TradeSkillMaster is installed, the addon will automatically use TSM's `DBMarket` price source for item valuation. If TSM is not available, it falls back to vendor prices.
## Requirements
- World of Warcraft Retail (The War Within 11.0.2+)
- Optional: TradeSkillMaster (for better price data)
## Tips
- Set **Max Duplicates** to 0 if you want to mail all duplicates except one
- Set **Min AH Value** higher if you only want truly valuable items sent to AH alt
- Enable **Auto-Scan** for real-time evaluation as you loot
- Use **Debug Mode** (`/mrh debug`) to see detailed decision-making in chat
## Known Limitations
- Only processes items in your main bags (bag 0-4), not bank
- Requires mailbox to be open for mailing operations
- Mail attachments limited to 12 items per mail (WoW limitation)
- Soulbound check may not work perfectly on all item types
## Support
For issues, suggestions, or feature requests, please contact the addon author.
## Version
Current Version: 1.0.0
## License
This addon is provided as-is for personal use.