Better Mailbox & Gold Tracker

# BetterMailbox 0.7

BetterMailbox is a complete replacement for the default World of Warcraft mailbox. It combines a modern and responsive mail interface with a separate Gold Center for tracking character wealth, income, expenses, and Auction House revenue.

The mailbox and Gold Center are part of the same addon while remaining clearly separated into two independent interfaces.

## BETTERMAILBOX – MAILBOX

### Modern Inbox

- Complete replacement for the Blizzard mailbox
- Clean and compact message list
- Displays subject, sender, expiration, attachments, and attached gold
- Live overview showing:
  - Total mail
  - Lootable mail
  - Attached gold
- Custom scrollbar matching the BetterMailbox design
- Optimized list handling with reusable rows for improved performance

### Mail Filters

The inbox can be filtered instantly:

- All
- Lootable
- Letters
- Auction House

### Selection and Bulk Actions

- Select individual messages using checkboxes
- Select-all checkbox in the inbox column header
- Select every message in the current filter with one click
- Click again to clear the filtered selection
- Partial selections are shown with a mixed checkbox state
- Take Selected
- Take Gold
- Take All
- Delete selected empty messages
- Automatically select all empty messages in the current filter

A message is considered empty when it contains no item, gold, or Cash on Delivery payment.

Cash on Delivery messages are skipped by automatic collection. Messages containing unclaimed items or gold cannot be deleted accidentally.

### Safe Bulk Collection

BetterMailbox processes bulk operations one message at a time while respecting the Blizzard mail server state.

- Waits for pending mail commands
- Prevents overlapping collection operations
- Safely retries temporarily blocked actions
- Clear progress and error messages
- Action buttons are locked during processing and reliably reset afterward
- Improved handling of temporary internal mail database errors

### Individual Mail View

- Complete message view
- Sender and expiration information
- Full message body
- Attached items and gold
- Take individual attachments
- Direct reply function
- Automatically prepared recipient and “Re:” subject

## SENDING MAIL

### Custom Send Interface

- Recipient, subject, and message fields
- Up to 12 item attachments
- Send gold, silver, and copper
- Clear success and failure feedback
- Automatic cleanup after a successful delivery

### Convenient Item Handling

- Inventory bags are made available when opening the Send section
- Right-click a bag item to attach it to the mail
- Drag items directly onto attachment slots
- Remove attachments from the message
- Supports Blizzard bags and compatible bag addons

### Recipient Management

- Recently used recipients
- Automatic name suggestions
- Guild member search
- Friend list search
- Directly select a character from the recipient browser

## APPEARANCE AND SETTINGS

### Skins and Colors

Included color schemes:

- Black/Grey
- Premium
- Warrior
- Paladin
- Hunter
- Rogue
- Priest
- Death Knight
- Shaman
- Mage
- Warlock
- Monk
- Druid
- Demon Hunter
- Evoker

### Fonts

BetterMailbox includes 16 selectable fonts. Every font is rendered in its actual typeface directly inside the selection menu.

Included fonts feature:

- Expressway
- Friz Quadrata
- Arial Narrow
- Morpheus
- Skurri
- Xerwo Bold
- Carlito
- El Messiri
- Oswald
- Forced Square

### Additional Display Options

- UI scale from 80% to 135%
- Font size from 10 to 18
- Three row-density modes:
  - Compact
  - Normal
  - Comfortable
- Live preview inside the options panel
- German, English, French, and Russian interface languages
- High-resolution surfaces and custom interface controls

## GOLD CENTER

The Gold Center is a standalone section within BetterMailbox. It can be opened and configured independently from the mailbox.

### Real-Time Tracking

- Event-driven tracking without a permanent OnUpdate loop
- Updates whenever your gold changes
- Current balance of the logged-in character
- Income, expenses, and net profit
- Gold per hour based on a rolling time window
- Automatic storage of known characters
- Formatted gold values with thousands separators
- Local storage inside BetterMailboxDB

### Tracked Periods

- Current Session
- Today
- This Week
- This Month
- All-Time Statistics

Income, expenses, and net profit are stored separately for every period.

### Detected Gold Sources

BetterMailbox automatically assigns gold movements to a source whenever possible:

- Mail
- Auction House
- Merchant
- Trade
- Bank
- Warband Transfer
- World and other sources

Internal transfers between your character and Warband bank are detected and are not treated as regular profit.

### Gold Center Pages

#### Overview

- Current character
- Realm, class, and level
- Current gold balance
- Gold per hour
- Warband bank
- WoW Token price
- Session, daily, weekly, and monthly performance
- Latest gold movements

#### Current Session

- All income and expenses since login
- Session duration
- Net profit
- Gold per hour
- Transactions from the current session

#### Transaction History

- Timestamp
- Source
- Transaction detail
- Balance after the transaction
- Transaction amount
- Filters for:
  - All
  - Income
  - Expenses
- Additional transaction details in tooltips

#### Auction House

- Separate Auction House revenue tracking
- Income collected from Auction House mail
- Session, daily, weekly, and monthly summaries
- Dedicated Auction House history
- Income, expenses, and net result

#### Account Characters

- All previously discovered or imported characters
- Character name
- Realm
- Class
- Faction
- Level
- Last recorded gold balance
- Last update time
- Account-wide total wealth

Characters appear after logging into them with BetterMailbox or importing them from AdvancedGoldTracker.

### Warband Bank and WoW Token

- Live Warband bank balance
- Optionally include Warband gold in total account wealth
- Automatic WoW Token market-price updates
- Internal Warband transfers are tracked separately

### Reset and Data Management

- Reset the current session only
- Delete all statistics and transaction history after confirmation
- Character balances and display settings are preserved during a full statistics reset
- Import existing AdvancedGoldTracker data
- One-time automatic migration of available character data
- No external data transfer – everything remains local

## IN-GAME GOLD BAR

BetterMailbox includes a configurable gold bar for your regular game interface.

### Controls

- Left-click opens the Gold Center
- Right-click opens the Gold Center settings
- Alt + Left-click moves the bar
- The position can be locked
- Hovering opens a detailed wealth overview

### Gold Bar Tooltip

- Known account characters
- Character balances
- Total wealth
- Warband bank
- WoW Token price
- Session, daily, weekly, and monthly performance
- Income, expenses, and net values

### Customization

- Show or hide the Gold Bar
- Lock or unlock its position
- Reset its position
- Scale from 0.60 to 1.60
- Width from 140 to 440 pixels
- Height from 24 to 72 pixels
- Enable or disable the border
- Border colors:
  - Gold
  - Cyan
  - Purple
  - White
  - Class Color
- Background styles:
  - Gold Panel
  - Gold Filigree
  - Gunmetal
  - Obsidian

## COMMANDS

/bm
Opens BetterMailbox.

/bettermailbox
Opens BetterMailbox.

/bm gold
Opens the Gold Center.

/bm g
Short command for the Gold Center.

/bm options
Opens the BetterMailbox settings.

/bm optionen
German alternative for opening the settings.

/bm hide
Closes BetterMailbox and the Gold Center.

/bm close
Closes BetterMailbox and the Gold Center.

## COMPATIBILITY

- World of Warcraft Retail
- Ready for Patch 12.1
- Interface version 120100
- No required dependencies
- AdvancedGoldTracker is only used for optional data migration

## DATA STORAGE

All settings, character balances, statistics, and transaction history are stored locally inside BetterMailboxDB. BetterMailbox does not transmit data to external services.

Author: CRAZUDEMZY
Version: 0.7

---

# BetterMailbox 0.7

BetterMailbox ist ein vollständiger Ersatz für das standardmäßige World-of-Warcraft-Postfach. Das Addon kombiniert eine moderne, schnelle Postverwaltung mit einer eigenständigen Goldzentrale für Charaktervermögen, Einnahmen, Ausgaben und Auktionshaus-Umsätze.

Postfach und Goldzentrale gehören zum selben Addon, bleiben aber als zwei getrennte Bereiche übersichtlich organisiert.

## BETTERMAILBOX – POSTFACH

### Moderner Posteingang

- Vollständiger Ersatz für das Blizzard-Postfach
- Klar strukturierte und kompakte Nachrichtenliste
- Anzeige von Betreff, Absender, Ablaufzeit, Anhängen und Gold
- Direkte Übersicht über:
  - Anzahl der Briefe
  - lootbare Briefe
  - enthaltenes Gold
- Eigene, auf das Design abgestimmte Scrollleiste
- Optimierte Listenverarbeitung mit wiederverwendeten Zeilen für bessere Performance

### Postfilter

Der Posteingang kann direkt gefiltert werden:

- Alle
- Lootbar
- Nur Briefe
- Auktionshaus

### Auswahl und Sammelaktionen

- Einzelne Briefe über Kontrollkästchen auswählen
- Neues Auswahlkästchen im Tabellenkopf
- Alle Briefe des aktuellen Filters mit einem Klick auswählen
- Zweiter Klick hebt die komplette Filterauswahl wieder auf
- Teilweise Auswahl wird optisch als gemischter Zustand angezeigt
- Auswahl nehmen
- Gold nehmen
- Alles nehmen
- Ausgewählte leere Briefe gesammelt löschen
- Alle leeren Briefe des aktuellen Filters automatisch auswählen

Als leer gelten Briefe ohne Gegenstände, Gold oder Nachnahme.

Briefe mit Nachnahme werden von automatischen Sammelaktionen übersprungen. Briefe mit nicht abgeholten Anhängen oder Gold werden nicht versehentlich gelöscht.

### Sicheres Abholen mehrerer Briefe

BetterMailbox verarbeitet Sammelaktionen kontrolliert nacheinander und berücksichtigt den Status des Blizzard-Mailservers.

- Wartet auf noch laufende Mailbefehle
- Verhindert mehrere gleichzeitige Abholvorgänge
- Wiederholt vorübergehend blockierte Aktionen kontrolliert
- Verständliche Status- und Fehlermeldungen
- Buttons werden während eines Vorgangs gesperrt und danach zuverlässig zurückgesetzt
- Sicherer Umgang mit vorübergehenden internen Mail-Datenbankfehlern

### Einzelne Briefe öffnen

- Vollständige Briefansicht
- Anzeige von Absender und Ablaufzeit
- Anzeige des Nachrichtentextes
- Übersicht über Gegenstände und angehängtes Gold
- Anhänge einzeln entnehmen
- Direkte Antwortfunktion
- Automatische Vorbereitung von Empfänger und „Re:“-Betreff

## POST SENDEN

### Eigene Senden-Oberfläche

- Empfänger, Betreff und Nachricht
- Bis zu 12 Gegenstandsanhänge
- Gold, Silber und Kupfer versenden
- Deutliche Erfolgs- und Fehlermeldungen
- Automatisches Zurücksetzen nach erfolgreichem Versand

### Komfortable Gegenstandsauswahl

- Taschen werden beim Öffnen des Senden-Bereichs bereitgestellt
- Rechtsklick auf einen Gegenstand fügt ihn der Post hinzu
- Gegenstände können auf die Anhang-Slots gezogen werden
- Anhänge lassen sich wieder aus der Post entfernen
- Unterstützung für Blizzard-Taschen und kompatible Taschen-Addons

### Empfängerverwaltung

- Zuletzt verwendete Empfänger
- Automatische Namensvorschläge
- Suche in der Gildenliste
- Suche in der Freundesliste
- Direkte Übernahme eines gefundenen Charakters

## DARSTELLUNG UND EINSTELLUNGEN

### Skins und Farben

Enthaltene Farbschemata:

- Black/Grey
- Premium
- Warrior
- Paladin
- Hunter
- Rogue
- Priest
- Death Knight
- Shaman
- Mage
- Warlock
- Monk
- Druid
- Demon Hunter
- Evoker

### Schriftarten

BetterMailbox enthält 16 auswählbare Schriftarten. Jede Schriftart wird bereits im Auswahlmenü mit ihrer tatsächlichen Darstellung angezeigt.

Enthalten sind unter anderem:

- Expressway
- Friz Quadrata
- Arial Narrow
- Morpheus
- Skurri
- Xerwo Bold
- Carlito
- El Messiri
- Oswald
- Forced Square

### Weitere Darstellungsoptionen

- UI-Skalierung von 80 % bis 135 %
- Schriftgröße von 10 bis 18
- Drei Zeilendichten:
  - Kompakt
  - Normal
  - Großzügig
- Live-Vorschau im Optionsmenü
- Deutsche, englische, französische und russische Benutzeroberfläche
- Hochauflösende Oberflächen und eigene Bedienelemente

## GOLDZENTRALE

Die Goldzentrale ist ein eigenständiger Bereich innerhalb von BetterMailbox. Sie kann unabhängig vom Postfach geöffnet und konfiguriert werden.

### Echtzeit-Tracking

- Ereignisbasiertes Tracking ohne dauerhaft laufendes OnUpdate
- Aktualisierung bei jeder Goldbewegung
- Aktueller Goldstand des eingeloggten Charakters
- Einnahmen, Ausgaben und Nettogewinn
- Gold pro Stunde auf Basis eines rollenden Zeitfensters
- Automatische Speicherung bekannter Charaktere
- Formatierte Goldwerte mit Tausendertrennzeichen
- Lokale Speicherung in BetterMailboxDB

### Erfasste Zeiträume

- Aktuelle Sitzung
- Heute
- Diese Woche
- Dieser Monat
- Gesamte Statistik

Für jeden Zeitraum werden Einnahmen, Ausgaben und Nettogewinn getrennt gespeichert.

### Erkannte Goldquellen

BetterMailbox ordnet Goldbewegungen nach Möglichkeit automatisch einer Quelle zu:

- Post
- Auktionshaus
- Händler
- Handel
- Bank
- Kriegsmeutentransfer
- Welt und sonstige Quellen

Interne Transfers zwischen Charakter und Kriegsmeutenbank werden erkannt und nicht als normaler Gewinn behandelt.

### Bereiche der Goldzentrale

#### Gesamtübersicht

- Aktueller Charakter
- Realm, Klasse und Stufe
- Aktueller Goldstand
- Gold pro Stunde
- Kriegsmeutenbank
- WoW-Markenpreis
- Sitzung, Tag, Woche und Monat
- Letzte Goldbewegungen

#### Aktuelle Sitzung

- Alle Einnahmen und Ausgaben seit dem Login
- Sitzungsdauer
- Nettogewinn
- Gold pro Stunde
- Transaktionen der aktuellen Sitzung

#### Transaktionsverlauf

- Zeitpunkt
- Quelle
- Detail
- Kontostand nach der Bewegung
- Betrag
- Filter für:
  - Alle
  - Einnahmen
  - Ausgaben
- Zusätzliche Details im Tooltip

#### Auktionshaus

- Separat erfasster Auktionshaus-Umsatz
- Einnahmen aus Auktionshaus-Post
- Übersicht für Sitzung, Tag, Woche und Monat
- Eigene Auktionshaus-Historie
- Einnahmen, Ausgaben und Nettoergebnis

#### Account-Charaktere

- Alle bereits bekannten oder importierten Charaktere
- Charaktername
- Realm
- Klasse
- Fraktion
- Stufe
- Letzter gespeicherter Goldstand
- Zeitpunkt der letzten Aktualisierung
- Accountweites Gesamtvermögen

Charaktere erscheinen, nachdem sie mit BetterMailbox eingeloggt oder aus AdvancedGoldTracker übernommen wurden.

### Kriegsmeutenbank und WoW-Marke

- Live-Abfrage des Goldes in der Kriegsmeutenbank
- Kriegsmeutengold kann optional in das Gesamtvermögen einbezogen werden
- Automatische Aktualisierung des aktuellen WoW-Markenpreises
- Interne Kriegsmeutentransfers werden separat gekennzeichnet

### Zurücksetzen und Datenverwaltung

- Nur die aktuelle Sitzung zurücksetzen
- Komplette Statistik und den Transaktionsverlauf nach Bestätigung löschen
- Charakter-Goldstände und Einstellungen bleiben beim vollständigen Statistik-Reset erhalten
- Alte AdvancedGoldTracker-Daten können importiert werden
- Einmalige automatische Übernahme vorhandener Charakterdaten
- Keine externe Übertragung – sämtliche Daten bleiben lokal

## INGAME-GOLDLEISTE

BetterMailbox enthält eine frei konfigurierbare Goldleiste für das normale Interface.

### Bedienung

- Linksklick öffnet die Goldzentrale
- Rechtsklick öffnet direkt die Goldzentrale-Einstellungen
- Alt + Linksklick verschiebt die Leiste
- Position kann gesperrt werden
- Hover öffnet eine ausführliche Vermögensübersicht

### Tooltip der Goldleiste

- Bekannte Account-Charaktere
- Goldstände der Charaktere
- Gesamtvermögen
- Kriegsmeutenbank
- WoW-Markenpreis
- Sitzung, Tag, Woche und Monat
- Einnahmen, Ausgaben und Nettowerte

### Anpassungsmöglichkeiten

- Goldleiste ein- oder ausblenden
- Position sperren oder freigeben
- Position zurücksetzen
- Skalierung von 0,60 bis 1,60
- Breite von 140 bis 440 Pixel
- Höhe von 24 bis 72 Pixel
- Rahmen ein- oder ausschalten
- Rahmenfarben:
  - Gold
  - Cyan
  - Violett
  - Weiß
  - Klassenfarbe
- Hintergrundvarianten:
  - Goldpaneel
  - Goldfiligran
  - Kanonenmetall
  - Obsidian

## BEFEHLE

/bm
Öffnet BetterMailbox.

/bettermailbox
Öffnet BetterMailbox.

/bm gold
Öffnet die Goldzentrale.

/bm g
Kurzform für die Goldzentrale.

/bm options
Öffnet die BetterMailbox-Einstellungen.

/bm optionen
Deutsche Alternative für die Einstellungen.

/bm hide
Schließt BetterMailbox und die Goldzentrale.

/bm close
Schließt BetterMailbox und die Goldzentrale.

## KOMPATIBILITÄT

- World of Warcraft Retail
- Vorbereitet für Patch 12.1
- Interface-Version 120100
- Keine zwingend benötigten Abhängigkeiten
- AdvancedGoldTracker ist ausschließlich für den optionalen Datenimport vorgesehen

## DATENSPEICHERUNG

Alle Einstellungen, Charakterstände, Statistiken und Transaktionen werden lokal in BetterMailboxDB gespeichert. BetterMailbox sendet keine Daten an externe Dienste.

Autor: CRAZUDEMZY
Version: 0.7

---

Part of the CRAZUDEMZY Addons collection