LedgerGoblin

A high-performance, event-driven mail routing system — it sends gold and items to your alts automatically, by rule.

Overview

LedgerGoblin turns the daily chore of shuffling gold and loot to your alts into a set-and-forget routine. You describe where things should go — by item, by bind type, by quality, or by gold rule — open a mailbox, and it does the rest.

It's built the same way the rest of the toolkit is: event-driven, cached, and tuned for performance, so it stays light on memory and CPU. Mail is irreversible, so every send runs through a stack of safety gates and auto-run is strictly opt-in.

• Rule-based — a clear priority pipeline (specific item → bind type → quality), plus per-item keep reserves and a never-mail exclusion list.
• Safe by design — soulbound / Bind-on-Pickup items are never routed, large sends ask for confirmation, and the queue refuses to spend below postage + a learned repair reserve.
• Hands-off — optional auto-run when the mailbox opens, with a hold-Shift escape hatch.
• Native settings — a clean options panel built on Blizzard's own Settings API, plus a drag-and-drop Rule Editor window.

Installation

Via an addon manager (recommended)

• CurseForge — search for LedgerGoblin and install.

Manual

1. Download the latest release from the Releases page.
2. Extract the LedgerGoblin folder into World of Warcraft\_retail_\Interface\AddOns.
3. Restart the game (or /reload if already in-game).

Auto-run is off by default — nothing is ever mailed until you set up a rule and either click Send or opt in to auto-run. Mail can't be undone, so LedgerGoblin would rather do nothing than do the wrong thing.

Getting Started

You can also use the AddOn Compartment button on the minimap: left-click opens settings, right-click opens the Rule Editor.

Features

Routing rules

LedgerGoblin resolves every item through one priority pipeline, stopping at the first rule that claims it:

1. Exclusions — items on your never-mail list are skipped outright.
2. Specific item rules — route an exact itemID or item name to a chosen alt.
3. Bind routing — send Bind-on-Equip gear (while still unequipped) and account/warband-bound items to your alts.
4. Quality routing — a catch-all by item quality (Poor → Epic).

Gold routing

• Keep a set amount and send the rest, send a fixed amount, or send a percentage of your gold.
• Reserve for repairs — never send gold below your learned full-repair cost, captured automatically at vendors (no flat guess).

Smart mailability

• Soulbound / Bind-on-Pickup and quest items are never routed — they can't leave your character, so the engine won't try. Rules for un-mailable items are blocked the moment you create them, by itemID, link, or name.
• Account/warband-bound items still route to your own alts even though the bag flags them "bound."
• Locked slots (items mid-move) are skipped everywhere — planning, sending, and rule validation.

The Rule Editor

A movable window that coexists with your open bags. Drag an item in, or shift-click it straight from your bags, to fill its ID — no more hunting for itemIDs. Pick a target from a class-coloured roster menu of your alts.

Quality-of-life & safety

• Auto-run on mailbox open (opt-in) — hold Shift as the mailbox opens to skip a given run.
• Confirm large sends — a configurable gold threshold prompts before big transfers.
• Preview & Debug — see exactly what would be sent, and why each item does or doesn't route.
• Paced sending — one mail in flight at a time, advancing only on confirmed delivery, with a small cooldown between sends to keep the mailbox happy.
• Transfer log + stats — recent transfers plus lifetime and daily totals.
• Roster-aware — learns your alts so route targets validate before anything is sent.

Built for the modern client

• Midnight-ready — secret-value safe throughout; never branches on protected combat data.
• Performance-first — file-scope cached APIs, an allocation-light bag scan, and bounded classification caches.

Configuration

Open the panel with /ledger (or through the Blizzard AddOns settings). Settings are grouped into Routing Rules, Gold, Bind Routing, Item Quality Routing, and per-item rules/exclusions. Most toggles apply live. Per-item routing lives in its own movable Rule Editor window (/ledger rules) so it can stay open alongside your bags.

Contributing

Contributions, bug reports and ideas are welcome! Open an issue or a pull request. When filing a bug, including your client version and a /reload-able repro helps a ton.

Support

Appreciate the work that goes into LedgerGoblin? Consider showing your support:

• PayPal — paypal.me/KkthnxTV
• Patreon — patreon.com/Kkthnx
• Battle.net / Balance — Kkthnx#1105 or JRussell20@gmail.com
• In-game gold — Kkthnx on Area 52 (US)

License

Released under the MIT License. See LICENSE for details.

Developed and maintained by Josh "Kkthnx" Russell. Built with love for the default UI.