# TOG Tools — Lightweight Utility Toolkit for World of Warcraft

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.

### Login Digest

Prints a one-line state-of-account summary in chat each time you log in, so you catch the important stuff the moment you're back — without opening anything.

- Choose which fields appear: expiring mail (across all alts), guildies online, hearthstone bind, bag fullness, and time since last logout.
- A field is hidden automatically when it has nothing to report (no expiring mail, no guildies online, and so on), so the line stays short.
- Toggle the whole digest, or any individual field, from its tab.

### 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. One search box matches across every column (message, partner, character); narrow by direction, type, or GM with the dropdowns and a date range, and click any column header to sort. Each row tags Battle.net and Blizzard GM whispers so they stand out at a glance.
- Gathering Log — automatically records everything you mine, herb, skin, fish, extract (gas), and pickpocket: the item, how many, where, when, and what you got it from (the vein, herb, node, pool, or creature, in its own Source column). Click any column header to sort or filter (e.g. just Mining, or zones grouped by continent), and a search box finds any item or source fast. It only logs what you actually gather — mob drops and other loot are left out. (Totals and per-source yield now live on the Graphs sub-tab.)
- 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 use the per-log filter dropdowns to narrow what's charted — Gathering by character / profession / zone / source / item / expansion, Mail and Trade by character and direction / partner. One line per item, with a totals line below that names each series. Hover any point for that day's (or hour's) values.
- Every sub-tab has a date range, a search box, and column-header menus — click a header to sort, or tick a multi-select filter on category columns (Type / Source / Zone / Tab). Filters cascade: narrowing one column trims the others' choices.
- 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; filter the Character column or search a name 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.

### Smack

Make your character talk smack in combat. Build named filters — each one picks a trigger, where to say it, and a pool of lines — then tick the ones you want active. When the trigger hits, a random line from that filter is sent to chat. Think a halfling cleric trash-talking the boss while she keeps the group alive. (Classic only) — Smack isn't offered on Retail/Midnight, where the game keeps the combat data it needs (enemy health, the combat log, automatic public chat) hidden from addons.

- Pick a trigger — your health dropping below a set %, your health recovering above it, your target's health dropping below a %, your mana getting low, a group member getting low, taking a big hit (a single blow past a % of your health), landing a killing blow, a pull starting, surviving a fight, a group member dying, getting feared/stunned, your own death (last words as a ghost), or Bloodlust/Heroism going off.
- Type your lines — one per row; a random one is chosen each time it fires. Drop in `[me]`, `[target]`, `[hp]`, `[targethp]`, or `[member]` and they fill in automatically.
- Choose where — Say, Yell, Party, Raid, Guild, Officer, Instance, or Emote. Channels you're not in are skipped. Note: the game blocks automated Say / Yell / Emote during dungeon and raid boss encounters (open-world combat is fine) — use Party / Raid for boss fights.
- How often — set a cooldown in minutes (minimum 1) per filter so one rough pull doesn't spam your lines.
- Combat only — nothing fires out of combat, and a line won't repeat until the trigger resets (you recover, or a fresh target is pulled).
- Active or passive — the On checkbox in the list turns each filter on or off without deleting it.

### 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 login` — jump straight to the Login Digest 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 and early diagnostics (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.7.1 (2026-07-17) — Battle.net whisper name fix

- Fixed: Battle.net whispers in the Whisper Log could be shown against the wrong person — a message from one friend appearing under another friend's name, especially after a relog. Battle.net senders are now recorded by their real BattleTag / name the moment the whisper arrives, so they stay correct. Whispers logged before this fix show as “Battle.net friend” rather than a wrong name.

v0.7.0 (2026-06-14) — Logs overhaul, Graphs, Diagnostics, Smack & Name Prefix

- New Smack tab (Classic only) — make your character talk smack in combat: filters fire a random line on your own health/mana crossings, a pull, surviving a fight, a killing blow and more — sent to Say / Yell / Party / Raid / Guild / Emote, or bound to a hotkey you press on demand. Not offered on Retail/Midnight, where the game hides the combat data it needs from addons.
- Name Prefix: optional “hide duplicate main name” toggle — if you run Guild Roster Manager (GRM) with main-name-in-chat on and a guildmate's addon also puts their main in the message, this removes the duplicate so you see it once. Off by default; does nothing unless ticked and GRM is present.
- Filter, sort & search on every log. Click any column header to sort, or tick a multi-select filter on category columns (Type / Source / Zone / Tab); filters cascade, so narrowing one column trims the others. Every sub-tab also gets a single magnifying-glass search box that matches across all columns. The old per-field dropdown rows are gone — just a date range, a search box, and the headers.
- Gathering: what each item came from. The Gathering Log now records the source of every pickup — the vein, herb, node, pool, or creature — in its own Source column, with the Zone filter grouped by continent. Gas extraction and pickpocketing are logged too. (The old text stats block moved to the Graphs tab.)
- Graphs: per-log filters. The Graphs sub-tab swapped its long checkbox list for filter dropdowns that change with the chosen log — for Gathering: character, profession, zone, source, item, and expansion — so you can chart exactly what you want.
- Diagnostics (Developer Tools only) — a sub-tab under Logs with a compact, de-duplicated log of Lua errors and warnings (including blocked/forbidden addon-action errors and “saved settings too large” failures), a pop-up alert on new errors, an optional Titan Panel counter, and right-click-to-copy. Errors during loading are caught by the !!TOGT companion from the very start, without interfering with BugGrabber/BugSack. Off unless you enable Developer Tools, so most players see no change.

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.