MAILTRADETRACKER

TRACK • ORGANIZE • REVIEW

Every Trade. Every Mail. Every Transaction.

MailTradeTracker is a lightweight, standalone World of Warcraft addon designed to automatically record and organize your character's mail and player-to-player trade history.

Whether you're sending gold to an alternate character, trading items with another player, or collecting attachments from your mailbox, MailTradeTracker helps you maintain a detailed history of your transactions.

Featuring a compact black-and-red interface, powerful filtering tools, transaction statistics, and customizable settings, MailTradeTracker keeps your records organized without unnecessary complexity.

Your Transactions. Your History. Your Control.

---

FEATURES

Automatic Mail Tracking

MailTradeTracker automatically records mail transactions and stores their details for future reference.

• Records incoming and outgoing mail.
• Tracks gold, silver, and copper.
• Records attached items and quantities.
• Combines matching attachments.
• Groups mailbox pickups received close together.
• Maintains transaction history across characters on the same WoW account.
• Supports filtering by individual character.
• Organizes records by transaction date.

Player Trade Tracking

Keep a detailed history of completed player-to-player trades.

• Automatically records successful trades.
• Tracks items exchanged between players.
• Records gold transferred during trades.
• Supports item quantities and trade enchantment details.
• Identifies the characters involved in transactions.
• Optional trade-summary whispers.
• Optional public, party, and raid announcements.
• Customizable trade item exclusion list.

Battleground and Arena Protection: Trade recording and announcements are disabled in battlegrounds and arenas.

Transaction History

Access your transaction records through a compact, scrollable history window.

Available history categories include:

All Records — Every recorded transaction.

Trade History — Completed player trades.

Mail History — Sent and received mail.

Sent Mail — Outgoing mail transactions.

Received Mail — Incoming mail transactions.

Records can be filtered by character, date, and transaction category.

Transaction Search

Quickly locate specific transactions without manually browsing your entire history.

Search supports:

• Player and character names.
• Item names.
• Transaction dates.
• Currency amounts.

Search results respect your selected history filters.

Search can be enabled or disabled through Settings → Features.

History Pagination

MailTradeTracker uses pagination to keep large transaction histories manageable.

Instead of loading thousands of transactions into the interface simultaneously, records are divided into smaller pages.

Available records per page:

25 | 50 | 100 | 250 | 500

Default: 50 records per page.

Navigate between pages using the previous and next buttons.

Pagination only affects how records are displayed. Older saved transactions remain available according to your retention settings.

Transaction Statistics

View a summary of your recorded transactions.

Statistics include:

• Total gold sent.
• Total gold received.
• Trade transaction counts.
• Mail transaction counts.
• Recent transaction activity.

The Statistics window also displays your five most recent matching transactions.

Statistics can be enabled or disabled independently.

CSV Transaction Export

Export your transaction history for use outside World of Warcraft.

MailTradeTracker supports CSV-formatted transaction exports compatible with spreadsheet applications such as Microsoft Excel and Google Sheets.

Export features:

• Exports records matching your current filters.
• Supports selected characters and transaction categories.
• Includes matching search results.
• Exports records in groups of 200.
• Provides selectable text for copying.

Important: WoW addons cannot directly write arbitrary files. CSV exports must be copied manually from the export window and saved outside the game.

Transaction Notifications

Receive an on-screen confirmation when MailTradeTracker successfully saves a transaction.

Enabled by default.

Notifications can be disabled through Settings → Features.

Calendar and Date Filtering

MailTradeTracker includes a calendar interface for browsing transactions by date.

• Select specific dates.
• Navigate between months.
• Select different years.
• Filter records by character.
• Review transactions associated with the selected date.

Transaction Management

Control how long your transaction history is retained.

History Retention:

Default: 180 days
Adjustable: 1–365 days
Optional: Permanent history

Additional management features include:

• Delete individual transactions.
• Clear a specific character's transaction history.
• Clear all saved transaction history.
• Confirmation safeguards for destructive actions.

Individual transaction deletion requires confirmation within five seconds.

Individual record deletion is enabled by default.

Deleted records cannot be recovered through MailTradeTracker.

Trade Item Exclusions

MailTradeTracker includes an optional exclusion list for trade items you don't want included in transaction details.

The exclusion list is empty by default.

You can manually add or remove excluded items through the settings interface.

Compact Customizable Interface

MailTradeTracker features a custom black-and-red interface designed to remain organized and easy to navigate.

Appearance Settings

Additional customization includes:

• Movable interface windows.
• Organized settings categories.
• Adjustable fonts.
• Interface visibility controls.
• Window position resets.
• Compact navigation.
• Descriptive tooltips for settings and controls.

Optional Feature Controls

Not everyone needs every feature.

MailTradeTracker includes a dedicated Settings → Features section where individual features can be enabled or disabled.

Configurable features include:

Search History
History Pagination
Transaction Statistics
Recent Transactions
CSV Export
Transaction Notifications
Individual Record Deletion

Disabling an optional interface feature does not delete your saved transaction history.

SharedMedia Font Support

MailTradeTracker supports additional fonts through optional SharedMedia integration.

Compatible addons include:

SharedMedia
SharedMediaAdditionalFonts

When available, registered fonts automatically appear in MailTradeTracker's font selection controls.

The addon works without these dependencies and falls back to Blizzard's default fonts when necessary.

No external font libraries are bundled.

Minimap Button

MailTradeTracker includes a movable circular minimap button featuring its custom logo.

The minimap button can also be hidden through settings.

Compatibility Support

MailTradeTracker provides optional compatibility with:

Titan Panel
LibDataBroker
LibDBIcon

When compatible libraries are available, MailTradeTracker can register a launcher for supported display addons.

These integrations are optional.

---

SLASH COMMANDS

MailTradeTracker uses /mtk as its primary slash command.

The following aliases are also supported:

/mailtradetrack
/mailtradetracker

Available Commands

All three primary command prefixes support the same subcommands.

---

INSTALLATION

1. Download MailTradeTracker.
2. Extract the ZIP archive.
3. Place the MailTradeTracker folder inside your WoW installation's Interface\AddOns directory.
4. Launch World of Warcraft or reload your interface.
5. Enter /mtk to open MailTradeTracker's settings.

Optional: Install SharedMedia, SharedMediaAdditionalFonts, or Titan Panel to enable additional integration features.

These addons are not required for MailTradeTracker to function.

---

COMPATIBILITY

MailTradeTracker includes interface declarations for multiple World of Warcraft clients.

Declared Interface Versions:

11509, 20506, 38002, 40402, 16001, 50504, 120100, 120105

MailTradeTracker uses one authoritative TOC file and one Lua file.

Important: Interface declarations do not guarantee identical functionality across every WoW client. Mail and trade APIs can differ between versions. Compatibility should be verified on the specific client being used.

---

PERFORMANCE & DATA STORAGE

MailTradeTracker is designed to remain lightweight while managing large transaction histories.

Performance considerations:

Pagination prevents excessive numbers of history entries from being displayed simultaneously.

Optional interface features can be disabled.

Transaction records are subject to configurable retention settings.

Saved Data

MailTradeTracker stores its transaction history and preferences using:

MailTradeTrackerDB

History is shared between characters on the same WoW account through account-wide SavedVariables.

MailTradeTracker does not import records from other mail or trade logging addons.

For a single authoritative transaction history, avoid running multiple mail or trade trackers simultaneously.

---

IMPORTANT NOTES

MailTradeTracker records transactions using World of Warcraft's available mail and trade APIs.

Some transactions may be processed differently depending on the client version and event timing.

Records are retained according to your selected retention settings.

Individual record deletion and history clearing are permanent.

CSV exports require manual copying.

Optional SharedMedia and Titan Panel integrations require compatible addons or libraries.

---

MAILTRADETRACKER

TRACK • ORGANIZE • REVIEW

Every Trade. Every Mail. Every Transaction.

A compact, customizable transaction-history addon designed to keep your World of Warcraft mail and trade records organized.