# TOG Tools — Lightweight Utility Toolkit for WoW Classic

TOG Tools is a small collection of quality-of-life utilities that don't need a full addon of their own. Each tool lives in its own tab inside a single tidy window — open with `/togt`. New tools will be added over time.

## Features

### Name Prefix

Automatically adds a nickname in front of your chat messages so guildmates know who is talking, even when your character name doesn't match the name everyone knows you by. Useful for shared accounts, alts, or anyone who goes by a different name in their community.

- Set any nickname you like — it will be inserted at the start of your message before it is sent
- Fully configurable format: choose between (Name):, [Name], Name —, or any pattern you want using a simple format string
- Live preview updates as you type so you always see exactly what your messages will look like
- Enable per channel: Say, Guild, Officer, Party, Raid, Instance / Battleground, or a specific custom channel by name
- Option to skip messages that start with ! so addon commands like `!keys` or `!roll` are never prefixed
- Option to suppress the prefix automatically on characters where your nickname already matches your character's name
- Works on all supported WoW versions — Classic Era, TBC, Wrath, Cataclysm, Mists, and Retail

### Mailbox Stale Watcher

Track when mail is about to expire across every alt on your account, so a stack of Black Lotus or a hard-earned BoE never gets auto-deleted because you forgot to visit the mailbox in time.

- Captures a snapshot of every alt's mailbox each time that character opens a mailbox — no need to log into each alt to check.
- One-line chat alert when you log in if any alt has mail close to expiration. Threshold is configurable (default 2 days, adjustable 1–7).
- Tab lists every alt with expiring mail, showing each mail's sender, subject, and time remaining so you know exactly which character to switch to.
- Shows how recent each alt's snapshot is — snapshots more than a week old are flagged so you know to refresh them by visiting the mailbox.
- Account-wide: data is shared across all your alts on every realm.
- Read-only — this tab tells you what's about to expire, but does not open, reply, or delete mail. You handle that in-game like normal.

### Logs

Persistent history of mail, trades, guild events, guild bank transactions, whispers, and gathering — a single tab with sub-tabs for each log type, plus a Graphs sub-tab that charts the data over time. Everything you send, receive, and gather is captured automatically so you can answer “who mailed me that Black Lotus last week?” or “how much ore did I farm this weekend?” weeks after the fact.

- Mail Log — every mail received and sent: sender / recipient, subject, items, money. Multi-item Take-All mails merge into one entry so a 12-item mail doesn't produce 12 rows.
- Trade Log — every completed player-to-player trade: both sides of items and money, plus a dedicated column for enchants applied via the trade window's enchant slot. Arena and battleground trades are skipped to avoid noise.
- Guild Log — snapshots your guild's event history (joins, leaves, kicks, promotes, demotes, invites) and keeps entries beyond the in-game ~100-event cap. Per-guild buckets so alts in different guilds keep independent histories.
- Guild Bank Log — snapshots every guild bank transaction (deposits, withdrawals, moves between tabs, repairs, money in / out) the moment you open the guild bank, and keeps entries beyond the short rolling window the game itself retains. Per-guild buckets, item links you can shift-click into chat, and built-in support for syncing entries with other tools down the road. Guild banks were added in TBC, so this sub-tab is empty on Classic Era for now — a planned integration with a future companion tool will fill that in.
- Whisper Log — every whisper sent or received, both in-game and Battle.net. Search the message body or the partner name with substring filters, scope by character / direction / date range, or narrow to just GM whispers or just Battle.net. Each row tags Battle.net whispers and Blizzard GM whispers in the Other column so they stand out at a glance.
- Gathering Log — automatically records everything you mine, herb, skin, and fish: the item, how many, where, and when. A stats panel shows totals per item, nodes worked and average yield per node, a per-zone breakdown, and items gathered per hour. Filter by character, profession, or zone. It only logs what you actually gather — mob drops and other loot are left out.
- Graphs — line charts of your log data over time. Pick a log (Gathering, Mail, or Trade), choose a period (last 24 hours, 7 / 14 / 30 days, or all time), and toggle individual lines on or off; a totals line sums each visible series. Hover any point on the chart for a tooltip of that day's (or hour's) values. The Gathering chart draws one line per gathered item and can be scoped to a single expansion, so you can track each expansion's ores separately.
- Per-sub-tab filters: filter by character / alt, date range, and event type or direction. Click any column header to sort.
- Date range presets — Last 24 hours / 7 days / 30 days / All — plus a Custom day picker that expands an inline calendar grid so you can jump to any specific date.
- Account-wide: every alt's activity lands in the same store; switch the Character filter to scope to one alt.
- Old entries past the retention threshold (default 90 days) are pruned automatically.
- Each log type can be turned on or off independently in the addon settings.

### Gratz

Auto-congratulate guildmates and partymates when something gratz-worthy happens. Create named profiles — each one names a trigger type, criteria, destination channels, and a message template — then turn the ones you want firing on.

- Trigger: Achievement — Retail only. Fires when a guildmate (or anyone visible) earns an achievement. Filter by minimum point value so you only celebrate the big ones.
- Trigger: Level up (party) — Fires when a party member levels up inside a configurable min/max level band. Works on every WoW version.
- Trigger: Level up (guild) — Fires when a guildmate levels up. Optional “only every Nth level” filter for milestone-only gratzing (e.g. 10 / 20 / 30 / ...).
- Template placeholders — `[player]`, `[achievement]`, `[link]`, `[points]`, `[category]`, `[level]`. Mix and match.
- Channels per profile — Guild, Officer, Party, Raid, Say, Yell, Instance. Channels you're not connected to are silently skipped.
- Cooldown per profile — prevents the same gratz firing twice when an event accidentally duplicates (e.g. across a loading screen). Default 5 minutes.
- Skip-self is automatic — the engine never congratulates you on your own events.
- Combat-safe — messages composed during combat queue and flush automatically when combat ends.

### Addon Load Monitor

A diagnostic tab that shows every installed addon at a glance — how much memory it uses, whether it loaded successfully, and how long it took to load during the loading screen. Helpful for spotting heavy or slow addons, missing dependencies, or addons that failed to load.

- One row per installed addon: name, memory used, load time, and status
- Sort by any column — click the header. Status sorts failures first so you spot problems immediately
- Status badges: Loaded, On Demand, Disabled, Missing, Dep Missing, Wrong Version, Corrupt TOC, Outdated
- Summary bar shows total addons, how many loaded / failed / disabled, total memory used, and the overall loading-screen duration
- Accurate sub-millisecond load times for every addon when the !TOGT companion is installed (a tiny no-UI helper that loads first and records the timing — auto-installed via CurseForge)
- Window resizes gracefully — columns compact and text truncates instead of wrapping

## Slash Commands

- `/togt` — open the main window
- `/togt np` — jump straight to the Name Prefix settings tab
- `/togt al` — jump straight to the Addon Load Monitor tab
- `/togt mail` — jump straight to the Mailbox Stale Watcher tab
- `/togt gratz` — open the Gratz tab (also `/togt gz`)
- `/togt logs` — open the Logs tab (last viewed sub-tab)
- `/togt logs mail` — jump straight to Logs > Mail (also `/togt ml`)
- `/togt logs trade` — jump straight to Logs > Trade
- `/togt logs guild` — jump straight to Logs > Guild
- `/togt logs guildbank` — jump straight to Logs > Guild Bank (also `/togt gb`)
- `/togt logs whispers` — jump straight to Logs > Whispers (also `/togt wl`)
- `/togt settings` — open the addon settings panel
- `/togt vc` — check addon versions across the guild (Classic only)

## Requirements

- Ace3 (AceAddon-3.0, AceDB-3.0, AceGUI-3.0, AceConsole-3.0) — auto-installed by CurseForge
- !TOGT companion — tiny helper that records full addon load timing (auto-installed by CurseForge)
- WoW Classic Era, TBC, Wrath, Cataclysm, Mists of Pandaria, or Retail — all versions supported

## Support

If you have any questions, bug reports, or feature requests, please feel free to reach out on Discord!

## Recent Updates

v0.6.4 (2026-06-04) — Mail & Trade log fixes (Retail)

- Fixed: on Retail, mail you sent was logged without the gold or items you attached — the Mail log now records them.
- Fixed: on Retail, completed trades weren't being recorded in the Trade log at all (including trading loot after dungeons and Mythic+) — they're now logged with both sides' items, gold, and enchants.

v0.6.3 (2026-05-31) — Gathering Log & Graphs

- New: a Gathering Log under the Logs tab that automatically records everything you mine, herb, skin, and fish — item, quantity, zone, and time — with a stats panel (totals per item, nodes worked and average yield, by-zone, items per hour).
- New: a Graphs sub-tab (first under Logs) that charts your log data over time. Pick a log (Gathering, Mail, or Trade), choose a period, and toggle lines on or off. The Gathering chart draws one line per gathered item and can be scoped to a single expansion.
- Fixed: Gratz never fired for guildmates leveling up (the party-member trigger was unaffected).
- Fixed: a large Item DB (Developer Tools) could grow big enough that the addon's saved data failed to load, taking your logs with it until reload. Its storage was reworked so it loads at any size. If you had already built an Item DB, you'll need to rebuild it once.

v0.6.2 (2026-05-30) — Item DB tool: item stats

- The Item DB developer tool now also records each item's item level and stats (not just its name) — groundwork for a companion item-database library. It's still off unless you turn on Developer Tools, so most players see no change.

v0.6.1 (2026-05-30) — Whisper Log fix (Classic)

- Fixed a Lua error on Classic when right-clicking a name in the Whispers log and choosing Whisper — it now opens a whisper correctly. (Retail was unaffected.)

v0.6.0 (2026-05-29) — Developer Tools: Item Database

- New: a Developer Tools switch in the addon settings (off by default). When enabled it reveals an Item DB tab — a tool aimed at addon developers that builds a searchable local catalog of the game's items, so you can look any item up by name and grab its link. Most players won't need it; leave Developer Tools off and nothing changes. Everything else in TOG Tools is exactly as before.