# 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.