# 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, and guild events — a single tab with sub-tabs for each log type. Everything you send and receive is captured automatically so you can answer “who mailed me that Black Lotus last week?” or “did anyone get kicked from the guild while I was away?” 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.
- 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.

### 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 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 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.4.0 (2026-05-24) — Logs Nexus, per-module toggles, Retail compatibility

- New Logs tab with three sub-tabs — Mail, Trade, and Guild. Captures everything that comes in and out so you can search, sort, and filter mail history, trade history, and guild roster events long after the fact. See the Logs section above for details.
- New per-module on/off toggles in the addon settings. Don't want the Mailbox Stale Watcher? Turn it off — the tab disappears from the main window and its background engine stops. Re-enable any time without losing data.
- Two new icons in the main window's bottom-right strip: a help (i) icon that shows tab-specific help on hover, and a settings (gear) icon that opens the addon settings panel directly. Hover any column header in the data tables for column-specific tooltips too.
- Fixed TOG Tools not loading on the current Retail (Midnight 12.0.x) client — the supported game-version list now covers the current Retail patch range. Same fix shipped for the !TOGT companion in v0.1.1.
- Fixed the addon settings panel crashing on Retail when opened via the new gear icon (was passing a string category name to an API that now requires the numeric ID).

v0.3.5 (2026-05-23) — Name Prefix duplicate-on-recall fix

- Fixed Name Prefix doubling your nickname when ElvUI's Up-arrow chat history recalled a previously-sent message. Pressing Up → Enter to re-send a message now ships it once with a single prefix instead of (YourName): (YourName): hi.

v0.3.4 (2026-05-22) — TBC chat-typed logout fix

- Fixed /camp, /exit, and /logout being blocked when typed in chat on The Burning Crusade and Anniversary realms with Name Prefix active. The v0.3.3 attempt didn't fully clear the issue on those clients; the Name Prefix hook has been reworked to use a different chat input event that leaves Blizzard's logout chain completely untouched, so typing those commands in chat now logs you out as expected.

v0.3.3 (2026-05-18) — Name Prefix /say + TBC fix

- Added /say as a new toggleable channel in the Name Prefix tab — your nickname now prepends to /say messages alongside the existing channels.
- Fixed Name Prefix not firing on The Burning Crusade and Anniversary after the in-progress v0.3.3 work briefly regressed it. Prefixing fires reliably on every supported game version again.
- Fixed /logout being blocked by the Blizzard secure-action guard when typed in chat while Name Prefix was active.
- All Name Prefix channel toggles now default to off for fresh installs — turn on the ones you want. Existing setups keep their current choices.
- New Verbose debug output toggle in the addon settings panel (off by default). Turn it on to see hook diagnostics in chat when reporting issues.

v0.3.2 (2026-05-17) — Name Prefix fix for TBC & Anniversary

- Fixed the Name Prefix nickname insert not working on The Burning Crusade and the Anniversary realms. Your nickname now correctly prepends to outgoing chat on every supported game version.
- Name Prefix is now account-wide. Set your nickname once and it applies to every alt — no more configuring it for each character. Characters whose own name matches the nickname automatically skip the prefix (this safeguard is on by default).
- The main window now remembers the last tab you had open. Click the minimap button and you land back where you left off — handy if you only use one tool from the suite.